Sandbox de pruebas
Crea tu propio sandbox de pruebas, sin intervencion comercial, y emite tu primer
comprobante contra el ambiente de pruebas. El alta se hace desde el wizard
/sandbox del Portal del Cliente en STAGING.
Solo STAGING. El sandbox existe unicamente en el ambiente de pruebas:
https://staging-portal.mynexusapi.com/sandbox. En produccion la ruta/sandboxresponde404y no hay alta autoservicio; la credencial de produccion se solicita por el canal comercial.
Antes de empezar#
- RUC del emisor de pruebas (el wizard exige 13 digitos).
- Razon social del emisor.
- Certificado digital en formato
.p12o.pfxy su password. - Un correo que puedas revisar (recibiras ahi la API Key y el enlace de confirmacion).
- Un cliente HTTP (cURL, .NET, JavaScript o PHP).
1. Datos del emisor#
Abre https://staging-portal.mynexusapi.com/sandbox y completa el paso Emisor:
| Campo | Regla |
|---|---|
| RUC | 13 digitos |
| Razon social | Obligatoria |
| Nombre comercial, direccion, telefono | Opcionales |
Establecimiento (estab), punto de emision (ptoEmi) |
3 digitos; por defecto 001 y 001 |
El wizard registra la IP desde la que haces la solicitud y la asocia al sandbox; las peticiones al API deberan salir desde esa IP.
2. Certificado digital#
Carga tu certificado .p12 o .pfx y su password. El wizard valida el archivo y
comprueba que el certificado corresponda al RUC del emisor. El certificado queda
asociado al emisor de pruebas.
3. Cuenta y verificacion de correo#
Completa el paso Cuenta con tu correo y tu nombre. Si el captcha (Cloudflare Turnstile) esta habilitado, resolveselo en el momento. Al continuar, el wizard envia un correo de verificacion; abrelo y pulsa el enlace para confirmar la cuenta. El enlace vence en 60 minutos; si expira, reenvia la verificacion desde el mismo paso.
4. Confirmar el sandbox#
Al confirmar el enlace se crea el sandbox de una sola vez:
- Cliente de pruebas con plan "Sandbox MyNexusApi" (5.000 documentos, 2 meses).
- API Key de la integracion.
- Usuario del Portal del Cliente (rol owner) con clave autogenerada.
- Certificado del emisor registrado en el cliente.
- Correo de bienvenida con la API Key, la URL del API de pruebas, la URL de la documentacion y el usuario y clave del portal.
El sandbox vence a los 2 meses. Antes del vencimiento recibes un aviso por correo; los sandboxes vencidos se desactivan.
Que recibes#
| Dato | Donde llega |
|---|---|
| API Key | Correo de bienvenida (guardala como secreto) |
| URL del API de pruebas | https://staging-api.mynexusapi.com |
| Usuario y clave del Portal del Cliente | Correo de bienvenida |
| Plan | "Sandbox MyNexusApi": 5.000 documentos, 2 meses |
Primeros pasos de emision#
Con la API Key del correo y una IP registrada, sigue el quickstart de
Primeros pasos: consulta tu contexto,
emite con POST /v1/contribuyentes/{identificacion}/comprobantes y sigue la
operacion con GET /v1/operaciones/{id} o por webhook. El
detalle del cuerpo y de cada tipo esta en Comprobantes electronicos.
Ambiente de pruebas. Los comprobantes del sandbox no tienen validez fiscal.
Estados de este flujo#
| Codigo | HTTP | Cuando ocurre | Que hacer |
|---|---|---|---|
| - | 404 |
Abres /sandbox en produccion |
Usa la URL de STAGING o solicita la credencial de produccion |
| - | Formulario | El RUC no tiene 13 digitos o falta la razon social | Corrige el dato |
| - | Formulario | El captcha no valida | Resuelve el captcha de nuevo |
| - | Formulario | El certificado o su password no son validos, o el RUC no coincide | Revisa el archivo, el password y el RUC |
| - | Formulario | El enlace de verificacion vencio | Reenvia la verificacion |
103 |
403 |
Consumes el API desde una IP no registrada | Emite desde la IP del alta o actualizala |
101 |
401 |
API Key ausente o invalida | Revisa la cabecera X-Api-Key |
El catalogo del API esta en Errores.
Siguientes pasos#
- Primeros pasos: de cero al primer comprobante.
- Autenticacion: API Key e IP.
- Comprobantes electronicos: tipos y campos.
- Errores: codigos y que hacer.