Ir al contenido

Beta privada · apertura 23 de diciembre

Consulta una guía

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

Detalle y estado ante SUNAT de una guía de remisión.

Dato Valor
Permiso comprobantes:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP guia_ver (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor.
id path Sí string Identificador que empieza con gre_.
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/guias/gre_8f2c1a7d9e" \
-H "Authorization: Bearer onx_test_…"

Guía.

Campo Tipo Requerido Descripción
id string Sí Identificador que empieza con gre_.
emisor_ruc string Sí RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT).
serie string Sí
numero integer Sí
numero_completo string Sí
fecha_emision string (date) Sí Fecha AAAA-MM-DD (día en Lima).
estado “en_cola” | “aceptada” | “rechazada” Sí
destinatario object Sí
destinatario.tipo_documento string Sí
destinatario.numero_documento string Sí
destinatario.nombre string Sí
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í
enlaces object Sí
enlaces.xml string Sí
enlaces.cdr string | null Sí
enlaces.pdf string Sí
creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
actualizada_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.