Ir al contenido

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

Contra el sandbox, con una clave onx_test_…:

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

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.

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