Ver compra
GET /api/purchases/{purchase_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve la compra con sus ítems, pagos, total pagado y saldo 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.
Errores: 404; 403 si es de otro vendedor.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
purchase_id |
ruta | sí | 1 |
Respuestas
200 — Detalle
{
"success": true,
"data": {
"id": 77,
"external_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
"document_type_id": "01",
"document_type_description": "FACTURA ELECTRÓNICA",
"series": "F001",
"number": "4587",
"number_full": "F001-4587",
"date_of_issue": "2026-11-07",
"date_of_due": "2026-12-07",
"state_type_id": "01",
"state_type_description": "Registrado",
"supplier_id": 14,
"supplier": {
"name": "DISTRIBUIDORA DEL SUR S.A.C.",
"number": "20456789123"
},
"currency_type_id": "PEN",
"exchange_rate_sale": 1.0,
"total": 118.0,
"total_paid": 50.0,
"total_pending": 68.0,
"observation": "Entrega en almacén central",
"user_id": 5,
"establishment_id": 1,
"items": [
{
"id": 301,
"item_id": 120,
"description": "GASEOSA 500ML",
"quantity": 50.0,
"unit_price": 2.36,
"total": 118.0,
"warehouse_id": 1,
"lot_code": null
}
],
"payments": [
{
"id": 51,
"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-99812",
"payment": 50.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.