Saltar al contenido
Facturador

Listar resúmenes diarios

GET /api/summaries

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

Lista los resúmenes diarios enviados (de boletas y sus notas): de adición (summary_status_type_id = 1), modificación (2) y anulación (3), del más reciente al más antiguo.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

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

Parámetros de la URL (query):

Campo Tipo Obligatorio Descripción / valores permitidos
date_start / date_end date No Rango de la fecha de envío (date_of_issue, YYYY-MM-DD).
date_of_reference date No Fecha de emisión de los comprobantes incluidos.
state_type_id string No 01, 03, 05 o 09.
search string No Coincidencia parcial en el identificador (RC-... / RA-...) o el ticket.
limit / cursor integer / string No Paginación por cursor (más recientes primero).
summary_status_type_id string No 1 adicionar, 2 modificar, 3 anular.

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.

Campos de cada fila: id (para Ver), external_id y ticket (para .../status), identifier, date_of_issue (envío), date_of_reference (emisión de los comprobantes), soap_type_id (01 demo, 02 producción), state_type_id / state_type_description, documents_count, pending_ticket, links.xml y links.cdr (el CDR solo cuando hay respuesta: 05 o 09), created_at, updated_at. Además: summary_status_type_id / summary_status_type_description, unknown_error_status_response (SUNAT respondió con un error desconocido) y manually_regularized (regularizado a mano en el sistema).

Estados (state_type_id): 01 registrado, 03 enviado (esperando respuesta: falta consultar el ticket), 05 aceptado, 09 rechazado. pending_ticket: true indica que el envío está en 03.

Errores:

  • 422 si una fecha no es válida o summary_status_type_id no es 1, 2 ni 3.
  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
date_start query no 2026-11-01 Desde esta fecha de envío (YYYY-MM-DD).
date_end query no 2026-11-30 Hasta esta fecha de envío.
date_of_reference query no 2026-11-06 Fecha de emisión de las boletas incluidas.
state_type_id query no 03 01, 03, 05 o 09.
summary_status_type_id query no 1 1 adicionar, 2 modificar, 3 anular.
search query no Identificador (RC-...) o ticket.
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": 12,
      "external_id": "a65c9dcc-477e-4b3f-884a-971c56b3d923",
      "identifier": "RC-20261107-1",
      "date_of_issue": "2026-11-07",
      "date_of_reference": "2026-11-06",
      "soap_type_id": "02",
      "state_type_id": "05",
      "state_type_description": "Aceptado",
      "ticket": "1793296089424",
      "documents_count": 2,
      "pending_ticket": false,
      "links": {
        "xml": "https://empresa.dominio/downloads/summary/xml/a65c9dcc-477e-4b3f-884a-971c56b3d923",
        "cdr": "https://empresa.dominio/downloads/summary/cdr/a65c9dcc-477e-4b3f-884a-971c56b3d923"
      },
      "summary_status_type_id": "1",
      "summary_status_type_description": "Adicionar",
      "unknown_error_status_response": false,
      "manually_regularized": false,
      "created_at": "2026-11-07 08:30:12",
      "updated_at": "2026-11-07 08:31:02"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "has_more": true
  }
}

422 — Fecha inválida

{
  "success": false,
  "message": {
    "date_start": [
      "date start no es una fecha válida."
    ]
  }
}

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.