Ordenar métodos de pago
POST /api/payment-method-types/sort-order
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Guarda el orden en que se muestran los métodos de pago (en los formularios de cobro y en los reportes).
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Formato de respuesta: estándar {success, data, message?} (registro único). data trae los métodos enviados con su nueva posición.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
ids |
array de string | Sí | Códigos en el orden deseado. Cada uno debe existir y no repetirse. |
Reglas:
- Se guardan como posiciones 10, 20, 30... en el orden recibido.
- Los métodos que no envías conservan su posición actual: para un orden completo envía todos.
Errores:
403si el usuario no es administrador.422{success: false, message: {campo: [errores]}}si falla la validación de campos. (lista vacía, código inexistente o repetido).401sin token o con un token inválido.
Cuerpo
Content-Type: application/json
{
"ids": [
"01",
"13",
"21",
"04"
]
}
Respuestas
200 — Ordenado
{
"success": true,
"data": [
{
"id": "01",
"description": "Efectivo",
"sort_order": 10
},
{
"id": "13",
"description": "Yape",
"sort_order": 20
},
{
"id": "21",
"description": "Plin",
"sort_order": 30
},
{
"id": "04",
"description": "Transferencia",
"sort_order": 40
}
],
"message": "Orden actualizado con éxito"
}
422 — Código inexistente
{
"success": false,
"message": {
"ids.0": [
"El campo ids.0 seleccionado no existe."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.