Beta privada · apertura 23 de diciembre
Lista comprobantes de un emisor
GET /v1/emisores/{ruc}/comprobantes
Comprobantes del RUC, del más reciente al más antiguo, con filtros por tipo, serie, estado y fechas.
| Dato | Valor |
|---|---|
| Permiso | comprobantes:leer |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | comprobante_listar (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
ruc |
path | Sí | string | RUC del emisor o contribuyente. |
cursor |
query | No | string | Cursor opaco que devolvió la página anterior en siguiente_cursor. |
limite |
query | No | integer | Cuántos elementos traer (1 a 100; por defecto 20). |
tipo |
query | No | string | 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito. |
serie |
query | No | string | |
estado |
query | No | string | en_cola: guardado y esperando a SUNAT. observado: aceptado con observaciones. en_baja: anulación en curso. |
desde |
query | No | string | Emitidos desde este día (incluido). |
hasta |
query | No | string | Emitidos hasta este día (incluido). |
cliente_documento |
query | No | string | Número de documento del cliente. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/emisores/20000000001/comprobantes" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Página de comprobantes.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
elementos |
object[] | Sí | |
elementos[].id |
string | Sí | Identificador que empieza con cmp_. |
elementos[].emisor_ruc |
string | Sí | RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT). |
elementos[].tipo |
“01” | “03” | “07” | “08” | Sí | 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito. |
elementos[].serie |
string | Sí | |
elementos[].numero |
integer | Sí | Asignado por el servidor. |
elementos[].numero_completo |
string | Sí | Serie y número, por ejemplo F001-124. |
elementos[].fecha_emision |
string (date) | Sí | Fecha AAAA-MM-DD (día en Lima). |
elementos[].moneda |
“PEN” | “USD” | Sí | Código ISO 4217: PEN (soles) o USD (dólares). |
elementos[].tipo_cambio |
string | null | Sí | |
elementos[].cliente |
object | Sí | A quién se le emite. |
elementos[].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. |
elementos[].cliente.numero_documento |
string | Sí | Número del documento; en tipo 0 puede ir «-». |
elementos[].cliente.nombre |
string | Sí | Razón social o nombre completo. |
elementos[].cliente.direccion |
string | No | |
elementos[].cliente.correo |
string (email) | No | Si lo envías, le mandamos el PDF y el XML. |
elementos[].items |
object[] | Sí | |
elementos[].items[].descripcion |
string | Sí | |
elementos[].items[].cantidad |
string | Sí | Cantidad como texto, mayor que cero, con hasta 6 decimales. |
elementos[].items[].unidad |
string | No | Unidad del catálogo 03, por ejemplo NIU (bienes) o ZZ (servicios). Por defecto NIU. |
elementos[].items[].codigo |
string | No | Tu código interno del producto. |
elementos[].items[].codigo_sunat |
string | No | Código de producto SUNAT (catálogo 25). |
elementos[].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). |
elementos[].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. |
elementos[].items[].icbper |
boolean | No | true si la línea son bolsas plásticas: se suma el ICBPER por bolsa. |
elementos[].forma_pago |
object | object | Sí | Contado o crédito con cuotas. Si no la envías, es al contado. |
elementos[].totales |
object | Sí | Totales calculados por el servidor. |
elementos[].totales.gravado |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
elementos[].totales.exonerado |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
elementos[].totales.inafecto |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
elementos[].totales.gratuito |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
elementos[].totales.igv |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
elementos[].totales.icbper |
string | Sí | Monto como texto con dos decimales y punto decimal, sin separador de miles. “1250.50” es S/ 1,250.50. |
elementos[].totales.total |
string | Sí | Importe total que paga el cliente. |
elementos[].referencia |
object | null | Sí | |
elementos[].referencia.tipo |
“01” | “03” | Sí | |
elementos[].referencia.serie |
string | Sí | |
elementos[].referencia.numero |
integer | Sí | |
elementos[].motivo |
object | null | Sí | |
elementos[].motivo.codigo |
string | Sí | Catálogo 09 (crédito) o 10 (débito), por ejemplo 01. |
elementos[].motivo.descripcion |
string | Sí | |
elementos[].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. |
elementos[].sunat |
object | null | Sí | |
elementos[].sunat.codigo |
string | Sí | Código de respuesta de SUNAT; 0 es aceptado. |
elementos[].sunat.descripcion |
string | Sí | |
elementos[].sunat.observaciones |
string[] | Sí | |
elementos[].hash |
string | null | Sí | Valor del resumen (DigestValue) de la firma, el que va en el QR. |
elementos[].enlaces |
object | Sí | |
elementos[].enlaces.xml |
string | Sí | |
elementos[].enlaces.cdr |
string | null | Sí | null mientras SUNAT no responde. |
elementos[].enlaces.pdf |
string | Sí | |
elementos[].creado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
elementos[].actualizado_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
siguiente_cursor |
string | null | Sí | Pásalo como cursor para la página siguiente; null si ya no hay más. |
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 - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible