Datos y credenciales de prueba
Todo lo necesario para tu primera emision en el ambiente de pruebas, de punta a punta.
Ambiente de pruebas. Los comprobantes no tienen validez fiscal y no se transmiten al SRI en produccion.
Ambiente#
| Ambiente | Base URL |
|---|---|
| Pruebas (sandbox) | https://staging-api.mynexusapi.com |
| Produccion | https://api.mynexusapi.com |
Datos de ejemplo#
Usa estos valores para probar; el contribuyente de ejemplo existe en pruebas.
| Dato | Valor | Donde |
|---|---|---|
| Identificacion del emisor | 0123456789 |
ruta contribuyentes/{identificacion} |
| RUC completo | 0123456789001 |
infoTributaria.ruc |
| Tipo de identificacion (RUC) | 04 |
tipoIdentificacionComprador |
| Tipo de identificacion (cedula) | 05 |
tipoIdentificacionComprador |
En pruebas puedes enviar secuencial de 9 ceros (000000000) y una clave de
acceso de 49 ceros para ensayar rapido.
Como obtener una credencial#
- Probar sin credencial: abre la Consola de prueba. La API Key de demostracion se aplica del lado del servidor.
- Credencial propia: crea una API Key en el portal del cliente (seccion Acceso API) o solicita el alta indicando tu RUC y las IP de salida (Autenticacion).
Empezar#
El paso a paso (contexto, emision, seguimiento y descarga del RIDE/XML) esta en Primeros pasos. Aqui tienes los datos y los casos.
Casos de prueba#
| Escenario | Como | Respuesta esperada |
|---|---|---|
| Emision exitosa | POST con Idempotency-Key nueva |
202 (codigo 200), con idOperacion |
| Reintento idempotente | Repite la misma Idempotency-Key y cuerpo |
202 (codigo 201), misma operacion |
| Conflicto de idempotencia | Misma Idempotency-Key, otro cuerpo |
409 (codigo 403) |
| Duplicado | Numero o clave ya registrados | 409 (codigo 401) |
| Validacion de campos | Falta Idempotency-Key o campos mal formados |
400 (codigo 301), con errores |
| Regla fiscal | Totales o impuestos inconsistentes | 422 (codigo 302) |
| Cupo agotado | Plan sin documentos | 429 (codigo 501) |
| Limite de solicitudes | Supera 200/min | 429 (codigo 104) + Retry-After |
| Rechazo del SRI | Comprobante rechazado | estadoAutorizacion=error y webhook document.rejected |
El catalogo completo esta en Errores.