Ir al contenido

Beta privada · apertura 23 de diciembre

Consulta un comprobante

GET /v1/emisores/{ruc}/comprobantes/{id}

Detalle, estado ante SUNAT y enlaces de descarga de un comprobante.

Dato Valor
Permiso comprobantes:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP comprobante_ver (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.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/emisores/20000000001/comprobantes/cmp_8f2c1a7d9e" \
-H "Authorization: Bearer onx_test_…"

Comprobante.

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.