Saltar al contenido
Facturador

Ver comunicación de baja

GET /api/voided/{voided_id}

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

Devuelve una comunicación de baja con su estado, la respuesta de SUNAT y los comprobantes que anula (con su motivo).

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

Formato de respuesta: estándar {success, data, message?} (registro único).

Parámetros de la ruta:

Campo Tipo Obligatorio Descripción / valores permitidos
voided_id integer Sí Id interno de la baja (data[].id del listado).

Campos del detalle (además de los del listado):

Campo Tipo Descripción
response objeto o null Última respuesta de SUNAT: code (0 = aceptado), description y notes (observaciones). null si aún no hay respuesta.
documents[] array Comprobantes incluidos: id, external_id, document_type_id, series, number, number_full, date_of_issue, customer_number, customer_name, currency_type_id, total, state_type_id (estado actual del comprobante), state_type_description y description (en una baja, el motivo).

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:

  • 404 si no existe.
  • 401 sin token o con un token inválido.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
voided_id ruta sí ``

Respuestas

200 — Detalle

{
  "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",
    "response": {
      "code": "0",
      "description": "La Comunicacion de baja RA-20261107-1, ha sido aceptada",
      "notes": []
    },
    "documents": [
      {
        "id": 2988,
        "external_id": "0c4b1e7a-55d2-4c8e-9f1a-2b3c4d5e6f70",
        "document_type_id": "01",
        "series": "F001",
        "number": 845,
        "number_full": "F001-845",
        "date_of_issue": "2026-11-06",
        "customer_number": "20456789123",
        "customer_name": "SERVICIOS GENERALES S.A.C.",
        "currency_type_id": "PEN",
        "total": 1180.0,
        "state_type_id": "11",
        "state_type_description": "Anulado",
        "description": "ERROR EN EL RUC DEL CLIENTE"
      }
    ]
  }
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

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.