Beta privada · apertura 23 de diciembre
Da de baja un comprobante
POST /v1/emisores/{ruc}/comprobantes/{id}/anular
Comunicación de baja para facturas y resumen diario para boletas, dentro del plazo de SUNAT. La baja es asíncrona (202 en_cola). Según tu clave, puede esperar la aprobación de una persona.
| Dato | Valor |
|---|---|
| Permiso | comprobantes:anular |
| Cobro | No cobra. |
Idempotency-Key |
Obligatoria |
| Aprobación humana | Según la configuración de tu clave puede responder 202 requiere_confirmacion. |
| Credenciales en la llamada | Si envías credenciales, la clave necesita credenciales:por_llamada. |
| Herramienta MCP | comprobante_anular (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
ruc |
path | Sí | string | RUC del emisor. |
id |
path | Sí | string | Identificador que empieza con cmp_. |
Idempotency-Key |
header | Sí | string | Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
application/json, obligatorio. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
motivo |
string | Sí | Motivo de la baja que verá SUNAT. |
credenciales |
object | No | Credenciales por llamada: se usan solo en esta petición y no se guardan. Requiere el permiso credenciales:por_llamada. Si tu RUC usa la bóveda, no las envíes. Para emitir, dar de baja y resúmenes. |
credenciales.certificado |
object | Sí | Certificado digital del emisor. Nunca se guarda en registros ni se devuelve. |
credenciales.certificado.pfx_base64 |
string (base64) | Sí | Archivo .pfx o .p12 del certificado digital, en base64. |
credenciales.certificado.clave |
string (password) | Sí | Contraseña del archivo .pfx. |
credenciales.sol |
object | Sí | Usuario secundario SOL del emisor. Nunca se guarda en registros ni se devuelve. |
credenciales.sol.usuario |
string | Sí | Usuario secundario SOL, sin el RUC (lo agregamos con el RUC del emisor). |
credenciales.sol.clave |
string (password) | Sí | Clave SOL del usuario secundario. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X POST "https://api-sandbox.opennexum.com/v1/emisores/20000000001/comprobantes/cmp_8f2c1a7d9e/anular" \ -H "Authorization: Bearer onx_test_…" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "motivo": "texto"}'Respuestas
Sección titulada «Respuestas»Baja en cola o esperando aprobación.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
estado |
“requiere_confirmacion” | Sí | |
operacion_id |
string | No | Úsalo en GET /v1/confirmaciones/{id} para saber si se aprobó. |
confirmacion_url |
string (uri) | No | Enlace del panel donde una persona aprueba o rechaza. Pásaselo tal cual. |
consulta_url |
string | Sí | Ruta para consultar el estado. |
expira_en |
string (date-time) | No | Antes de esta hora hay que aprobarla Y repetir la petición; si no, vence y no se hace. |
mensaje |
string | Sí | Qué falta, en palabras para una persona. |
recurso |
object | No | Lo que se creó y queda en proceso. |
recurso.tipo |
“comprobante” | “baja” | “resumen” | “guia” | “sire_propuesta” | “mensaje” | “entrega” | “clave” | “conexion” | “webhook” | No | |
recurso.id |
string | No | |
reintento_en |
string (date-time) | No | Próximo intento estimado, si aplica. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 409
idempotencia_en_conflicto - 409
solicitud_en_curso - 409
boveda_inactiva - 409
estado_no_permite - 409
plazo_vencido - 422
credenciales_sunat - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible