Ir al contenido

Beta privada · apertura 23 de diciembre

Pregunta a SUNAT el estado de un comprobante

POST /v1/emisores/{ruc}/comprobantes/{id}/consultar-sunat

Consulta el estado en SUNAT, guarda el CDR si llega y devuelve el comprobante actualizado.

Dato Valor
Permiso comprobantes:leer
Cobro No cobra.
Idempotency-Key No aplica
Credenciales en la llamada Si envías credenciales, la clave necesita credenciales:por_llamada.
Herramienta MCP comprobante_consultar_sunat (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor.
id path Sí string Identificador que empieza con cmp_.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

application/json, opcional. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.

Campo Tipo Requerido Descripción
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 consultar el estado en SUNAT.
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/consultar-sunat" \
-H "Authorization: Bearer onx_test_…" \
-H "Content-Type: application/json" \
-d '{}'

Comprobante con el estado que dio SUNAT.

Campo Tipo Requerido Descripción
id string Sí Identificador que empieza con cmp_.
emisor_ruc string Sí RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT).
tipo “01” | “03” | “07” | “08” Sí 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito.
serie string Sí
numero integer Sí Asignado por el servidor.
numero_completo string Sí Serie y número, por ejemplo F001-124.
fecha_emision string (date) Sí Fecha AAAA-MM-DD (día en Lima).
moneda “PEN” | “USD” Sí Código ISO 4217: PEN (soles) o USD (dólares).
tipo_cambio string | null Sí
cliente object Sí A quién se le emite.
cliente.tipo_documento “0” | “1” | “4” | “6” | “7” Sí Catálogo 06: 0 sin documento, 1 DNI, 4 carné de extranjería, 6 RUC, 7 pasaporte.
cliente.numero_documento string Sí Número del documento; en tipo 0 puede ir «-».
cliente.nombre string Sí Razón social o nombre completo.
cliente.direccion string No
cliente.correo string (email) No Si lo envías, le mandamos el PDF y el XML.
items object[] Sí
items[].descripcion string Sí
items[].cantidad string Sí Cantidad como texto, mayor que cero, con hasta 6 decimales.
items[].unidad string No Unidad del catálogo 03, por ejemplo NIU (bienes) o ZZ (servicios). Por defecto NIU.
items[].codigo string No Tu código interno del producto.
items[].codigo_sunat string No Código de producto SUNAT (catálogo 25).
items[].precio_unitario string Sí Precio por unidad con IGV incluido, el que paga tu cliente. En exonerado e inafecto es el valor por unidad; en gratuitas, el valor referencial (mayor que cero).
items[].afectacion_igv “10” | “11” | “12” | “13” | “14” | “15” | “16” | “20” | “30” | “31” | “32” | “33” | “34” | “35” | “36” | “37” Sí Catálogo 07: 10 gravado, 20 exonerado, 30 inafecto; 11–16 y 31–37 son transferencias gratuitas.
items[].icbper boolean No true si la línea son bolsas plásticas: se suma el ICBPER por bolsa.
forma_pago object | object Sí Contado o crédito con cuotas. Si no la envías, es al contado.
totales object Sí Totales calculados por el servidor.
totales.gravado string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
totales.exonerado string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
totales.inafecto string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
totales.gratuito string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
totales.igv string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
totales.icbper string Sí Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50.
totales.total string Sí Importe total que paga el cliente.
referencia object | null Sí
referencia.tipo “01” | “03” Sí
referencia.serie string Sí
referencia.numero integer Sí
motivo object | null Sí
motivo.codigo string Sí Catálogo 09 (crédito) o 10 (débito), por ejemplo 01.
motivo.descripcion string Sí
estado “en_cola” | “aceptado” | “observado” | “rechazado” | “en_baja” | “anulado” Sí en_cola: guardado y esperando a SUNAT. observado: aceptado con observaciones. en_baja: anulación en curso.
sunat object | null Sí
sunat.codigo string Sí Código de respuesta de SUNAT; 0 es aceptado.
sunat.descripcion string Sí
sunat.observaciones string[] Sí
hash string | null Sí Valor del resumen (DigestValue) de la firma, el que va en el QR.
enlaces object Sí
enlaces.xml string Sí
enlaces.cdr string | null Sí null mientras SUNAT no responde.
enlaces.pdf string Sí
creado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
actualizado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).

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