Saltar al contenido
Facturador

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:

  • 403 si 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).
  • 401 sin 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.