NexoID

Casos de uso /

Estudios contables

Lo que un estudio contable consulta cada mes, dentro de su sistema

Qué vence esta semana para cada cliente, a cuánto está el dólar hoy y si un RUC sigue activo y habido. Tres consultas que hoy se hacen a mano en tres webs distintas.

El problema

  • Cada cliente vence en otra fecha según el último dígito de su RUC, y la tabla se busca cada año.
  • El tipo de cambio del día se copia a mano de una web.
  • Un cliente cambia de condición en SUNAT y el estudio se entera tarde.

Con NexoID

  • Los próximos vencimientos de un RUC en una llamada, con la regla de la RS 281-2022 y las tablas publicadas por SUNAT.
  • El dólar y el euro oficiales, gratis: el tipo de cambio y el cronograma no descuentan consultas.
  • La ficha de RUC con su estado y su condición; con la bolsa Crecimiento, la vigilancia te avisa cuando cambian.

En tu código

La petición funciona tal cual, con el token público del sandbox: responde empresas de prueba, nunca datos reales. Cuando lo integres, cambias el token por el tuyo y nada más.

Petición
curl "https://nexoid.victorllerena.com/id/v1/vencimientos/proximos?digito=5" \
  -H "Authorization: Bearer nxid_test_sandboxpublicodenexoidpruebas001"
Con el SDK de JavaScript
const nexoid = new NexoId({ token: process.env.NEXOID_TOKEN! });

// Con el RUC, el SDK se queda con su último dígito: el RUC no viaja.
const vence = await nexoid.proximosVencimientos(cliente.ruc, { cantidad: 3 });
const dolar = await nexoid.tipoCambio();

La bolsa que encaja

Bolsa Micro

S/ 19por 50,000 consultas

El tipo de cambio y el cronograma no descuentan consultas: la bolsa solo paga las fichas de RUC, y 50,000 son muchos clientes.

Dura 12 meses. Precios en soles, con IGV incluido. Las primeras 1,000 consultas de cada mes son gratis.

¿Otro volumen? Mueve la barra con tus consultas al mes:

10,000

500500,000

Las primeras 1,000 de cada mes son gratis, y el tipo de cambio no cuenta.

Te conviene la bolsa

Inicial S/ 59

Consultas
250,000
Cada una
S/ 0.00024
Te dura
Los 12 meses
Al año, con IGV
S/ 59
Quiero la Inicial

Preguntas frecuentes

¿Hay una API del tipo de cambio de SUNAT?
El tipo de cambio que publica SUNAT es el de la SBS. NexoID lo toma del BCRP y, si no responde, de SUNAT, y cada valor dice de cuál viene. Es gratis: no descuenta consultas de tu bolsa.
¿El cronograma sirve para los buenos contribuyentes?
Sí: los buenos contribuyentes tienen su propia fecha, y la API la devuelve si se lo indicas. Los feriados ya están descontados, y los días no laborables no cambian las fechas, porque para SUNAT son hábiles.
¿Puedo usarlo sin programar?
Sí: el cronograma, los días hábiles, el validador de RUC y el conversor están gratis en las herramientas de esta web, sin cuenta. La API es para tenerlo dentro de tu sistema.
¿Mando el RUC de mis clientes?
Para los vencimientos, no: basta el último dígito, y los SDKs se quedan solo con él. Para la ficha de RUC sí, y si es de una persona (RUC 10), su nombre se sirve solo bajo contrato de tratamiento.