Saltar al contenido
Facturador

Listar pagos de compra

GET /api/purchases/{purchase_id}/payments

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Devuelve los pagos registrados y el resumen de lo pagado y pendiente.

Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.

summary trae total (total del registro), total_paid (suma de pagos) y total_difference (saldo pendiente).

Errores: 404 si el registro no existe; 403 si es de otro vendedor.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
purchase_id ruta sí 1

Respuestas

200 — Pagos

{
  "success": true,
  "data": {
    "summary": {
      "total": 50.0,
      "total_paid": 20.0,
      "total_difference": 30.0
    },
    "payments": [
      {
        "id": 31,
        "date_of_payment": "2026-11-07",
        "payment_method_type_id": "04",
        "payment_method_type_description": "Transferencia",
        "destination_type": "BankAccount",
        "destination_id": 3,
        "destination_description": "BCP SOLES",
        "reference": "OP-458721",
        "payment": 20.0
      }
    ]
  }
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

403 — Registro de otro vendedor

{
  "success": false,
  "message": "No tienes permiso para acceder a este registro."
}

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.