Ambientes y contribuyentes

La API funciona en dos ambientes independientes. Elige la URL segun el momento de tu integracion.

Ambientes#

Ambiente	Base URL	Uso
Pruebas (sandbox)	`https://staging-api.mynexusapi.com`	Desarrollar y probar. No tiene validez fiscal.
Produccion	`https://api.mynexusapi.com`	Emitir comprobantes reales ante el SRI.

Empieza siempre en pruebas. Cuando tu integracion funcione, solicita el acceso a produccion.

En pruebas existe una excepcion para ensayar rapido: puedes enviar secuencial de 9 ceros y una clave de acceso de 49 ceros. No aplica a produccion.

Contribuyentes#

Una integracion puede emitir y consultar para varios contribuyentes habilitados. Para saber cuales tienes disponibles, y si pueden emitir, recibir o ambos, consulta el contexto de tu API Key:

Mas informacion sobre el contexto

El contexto devuelve, por cada contribuyente:

identificacion: el valor que usas en la ruta de emision y consulta.
identificacionCompleta: el RUC completo de 13 digitos.
puedeEmitir, puedeRecibir: si puede emitir o recibir.
tiposComprobante: los tipos de comprobante habilitados.

Identificacion en la ruta#

En las rutas que terminan en contribuyentes/{identificacion} usa el valor identificacion que devuelve el contexto. El RUC completo de 13 digitos se informa aparte, dentro de la solicitud, en infoTributaria.ruc.

Si un contribuyente no aparece en el contexto, no esta habilitado para tu integracion: solicita su alta.

Clave de acceso#

Cada comprobante tiene una clave de acceso: un identificador unico de 49 digitos que asigna la plataforma. No la envias en la solicitud; la recibes en el seguimiento de la operacion o en el webhook.

Errores de este apartado#

Codigo	HTTP	Cuando ocurre	Que hacer
`103`	403	El contribuyente no esta habilitado para tu integracion	Solicita su alta
`102`	403	Origen de la solicitud no autorizado	Revisa la IP registrada para tu API Key