Saltar al contenido
Facturador

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.