Skip to main content
GET
/
api
/
compras
Listar Compras
curl --request GET \
  --url https://api.example.com/api/compras \
  --header 'Authorization: <authorization>'
{
  "500": {},
  "success": true,
  "data": [
    {
      "id_compra": 123,
      "documento": "<string>",
      "serie": "<string>",
      "numero": 123,
      "fecha_emision": "<string>",
      "fecha_vencimiento": "<string>",
      "proveedor": {
        "proveedor_id": 123,
        "ruc": "<string>",
        "razon_social": "<string>"
      },
      "tipo_pago": "<string>",
      "id_tipo_pago": 123,
      "moneda": "<string>",
      "total": "<string>",
      "estado": "<string>",
      "estado_nombre": "<string>",
      "usuario": "<string>",
      "created_at": "<string>"
    }
  ]
}
Obtiene el listado completo de compras registradas de la empresa, incluyendo información del proveedor y usuario que registró la compra.

​
Autenticación

Requiere token Bearer y permiso compras.view.

​
Headers

​
Authorization
string
required
Token de autenticación Bearer

​
Respuesta Exitosa

​
success
boolean
Indica si la operación fue exitosa
​
data
array
Listado de compras ordenadas por ID descendente

​
Ejemplo de Respuesta

{
  "success": true,
  "data": [
    {
      "id_compra": 87,
      "documento": "F001-00000087",
      "serie": "F001",
      "numero": 87,
      "fecha_emision": "2026-03-05",
      "fecha_vencimiento": "2026-04-05",
      "proveedor": {
        "proveedor_id": 12,
        "ruc": "20456789012",
        "razon_social": "DISTRIBUIDORA MAYORISTA SAC"
      },
      "tipo_pago": "Crédito",
      "id_tipo_pago": 2,
      "moneda": "PEN",
      "total": "15,480.00",
      "estado": "1",
      "estado_nombre": "Activo",
      "usuario": "Carlos Mendoza",
      "created_at": "2026-03-05 14:30:25"
    }
  ]
}

​
Códigos de Error

​
500
error
Error interno del servidor al obtener compras

​
Notas de Implementación

  • Las compras se filtran automáticamente por id_empresa del usuario autenticado
  • El listado incluye relaciones eager-loaded con proveedor y usuario para evitar consultas N+1
  • Para ver el detalle completo de una compra (productos, cuotas, empresas asociadas), usa GET /api/compras/{id}

Build docs developers (and LLMs) love

Get started for freeTalk to us