Ir al contenido

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

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
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"
}'

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.

Cada código tiene su explicación en Errores.