Saltar al contenido
Facturador

Últimos comprobantes

GET /api/documents/lists

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

Devuelve los últimos 50 comprobantes (facturas, boletas y notas) ordenados por fecha de emisión descendente. No acepta filtros: para listados completos usa Listar comprobantes con cursor.

Quién puede usarlo: cualquier usuario autenticado. Un administrador ve todos los registros; un vendedor solo los que registró él.

Formato de respuesta: listado de cantidad fija (take/limit): devuelve como máximo N registros, sin metadatos de paginación. Respuesta {data: [...]} (máximo 50 filas, sin success).

Cada fila trae además indicadores de interfaz (btn_*), estados de envío y relaciones (notas, guías, pedidos); el ejemplo muestra los campos principales. Las fechas date_of_issue y date_of_due vienen en formato DD-MM-YYYY.

Respuestas

200 — Listado

{
  "data": [
    {
      "id": 1520,
      "external_id": "9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
      "group_id": "01",
      "soap_type_id": "02",
      "soap_type_description": "Producción",
      "date_of_issue": "07-11-2026",
      "date_of_due": "07-11-2026",
      "number": "F001-1520",
      "filename": "20123456789-01-F001-1520",
      "document_type_id": "01",
      "document_type_description": "FACTURA ELECTRÓNICA",
      "customer_name": "EMPRESA XYZ S.A.C.",
      "customer_number": "20501973522",
      "customer_identity_document_type_description": "RUC",
      "customer_telephone": "014271148",
      "customer_email": "facturacion@xyz.com.pe",
      "currency_type_id": "PEN",
      "exchange_rate_sale": "1.000",
      "total_exportation": "0.00",
      "total_free": "0.00",
      "total_unaffected": "0.00",
      "total_exonerated": "0.00",
      "total_taxed": "100.00",
      "total_igv": "18.00",
      "total_charge": "0.00",
      "total": "118.00",
      "balance": "0.00",
      "date_of_payment": "2026-11-07",
      "state_type_id": "05",
      "state_type_description": "Aceptado",
      "has_xml": true,
      "has_pdf": true,
      "has_cdr": true,
      "download_xml": "https://empresa.dominio/downloads/document/xml/9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
      "download_pdf": "https://empresa.dominio/downloads/document/pdf/9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
      "download_cdr": "https://empresa.dominio/downloads/document/cdr/9b2f6c1e-7a44-4d0b-9a55-0f3c2a1d8e77",
      "affected_document": null,
      "notes": [],
      "sales_note": [],
      "order_note": [],
      "dispatches": [],
      "guides": null,
      "purchase_order": "OC-2026-0045",
      "user_id": 5,
      "user_name": "JUAN PEREZ",
      "source_module": "API",
      "regularize_shipping": false,
      "message_regularize_shipping": null,
      "created_at": "2026-11-07 10:11:11",
      "updated_at": "2026-11-07 10:11:15"
    }
  ]
}

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.