Saltar al contenido
Facturador

Listar comunicaciones de baja

GET /api/voided

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

Lista las comunicaciones de baja enviadas (anulación de facturas y sus notas), de la más reciente a la más antigua. Las anulaciones de boletas se hacen por resumen diario: consúltalas en Listar resúmenes diarios con summary_status_type_id=3.

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).

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.

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.
  • 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.
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 facturas incluidas.
state_type_id query no 05 01, 03, 05 o 09.
search query no Identificador (RA-...) 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": 4,
      "external_id": "7d3e9f10-2a4b-4c6d-8e0f-1a2b3c4d5e6f",
      "identifier": "RA-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": 1,
      "pending_ticket": false,
      "links": {
        "xml": "https://empresa.dominio/downloads/voided/xml/7d3e9f10-2a4b-4c6d-8e0f-1a2b3c4d5e6f",
        "cdr": "https://empresa.dominio/downloads/voided/cdr/7d3e9f10-2a4b-4c6d-8e0f-1a2b3c4d5e6f"
      },
      "created_at": "2026-11-07 08:30:12",
      "updated_at": "2026-11-07 08:31:02"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false
  }
}

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.