Saltar al contenido
Facturador

Listar guías con cursor

GET /api/dispatches/records-scroll

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

Listado paginado por cursor de guías remitente (09) y transportista (31), más recientes primero.

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

Formato de respuesta: listado con paginación por cursor {success, data[], pagination: {next_cursor, has_more}}.

Paginación por cursor: envía limit (1 a 100, por defecto 15). La respuesta trae pagination.next_cursor; para la página siguiente repite la misma consulta agregando cursor=<next_cursor>. Cuando pagination.has_more es false no hay más páginas.

En guías 31, customer_* son los datos del destinatario y sender_* los del remitente.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
document_type_id query no 09 09 remitente, 31 transportista. Sin valor: ambas.
state_type_id query no 05 Estado.
input query no T001 Serie o número (coincidencia parcial).
date_start query no 2026-11-01 Desde (requiere date_end).
date_end query no 2026-11-30 Hasta.
limit query no 15 Registros por página, de 1 a 100. Por defecto 15.
cursor query no Valor de pagination.next_cursor de la respuesta anterior para obtener la página siguiente.

Respuestas

200 — Listado

{
  "success": true,
  "data": [
    {
      "id": 15,
      "external_id": "3f0e5a52-6c1b-4f0e-9d0a-1c2b3d4e5f60",
      "document_type_id": "09",
      "series": "T001",
      "number": 15,
      "number_full": "T001-15",
      "filename": "20123456789-09-T001-15",
      "date_of_issue": "2026-11-07",
      "date_of_shipping": "2026-11-07",
      "transport_mode_type_id": "02",
      "transfer_reason_type_id": "01",
      "transfer_reason_description": "Venta",
      "total_weight": 12.5,
      "unit_type_id": "KGM",
      "packages_number": 2,
      "customer_id": 1,
      "customer_name": "EMPRESA XYZ S.A.C.",
      "customer_number": "20501973522",
      "sender_name": null,
      "sender_number": null,
      "state_type_id": "05",
      "state_type_description": "Aceptado",
      "has_xml": true,
      "has_pdf": true,
      "has_cdr": true,
      "download_external_pdf": "https://empresa.dominio/downloads/dispatch/pdf/3f0e5a52-6c1b-4f0e-9d0a-1c2b3d4e5f60",
      "download_external_xml": "https://empresa.dominio/downloads/dispatch/xml/3f0e5a52-6c1b-4f0e-9d0a-1c2b3d4e5f60",
      "download_external_cdr": "https://empresa.dominio/downloads/dispatch/cdr/3f0e5a52-6c1b-4f0e-9d0a-1c2b3d4e5f60",
      "sunat_error_response": null,
      "created_at": "2026-11-07 10:11:11"
    }
  ],
  "pagination": {
    "next_cursor": "eyJkYXRlX29mX2lzc3VlIjoiMjAyNi0xMS0wNyIsImlkIjoxNX0",
    "has_more": true
  }
}

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.