NexoID

Casos de uso /

Facturación y ERP

Registra al cliente con su RUC, y factura con los datos de SUNAT

Quien factura escribe el RUC y tu sistema completa el resto desde el padrón oficial: la razón social, el estado, la condición y el ubigeo. Sin tipear nombres, y sabiendo de cuándo es cada dato.

El problema

  • La razón social se tipea a mano, y el comprobante sale con un nombre que no es el de SUNAT.
  • Se factura a un RUC dado de baja o no habido, y el problema aparece después, en la contabilidad del cliente.
  • La API que usas hoy no dice de dónde sale el dato ni de qué día es.

Con NexoID

  • Un GET con el RUC devuelve la ficha del padrón de SUNAT, que se recarga cada madrugada.
  • Cada respuesta trae su fuente y su fecha en meta: lo que se facturó se puede auditar.
  • Lotes de 100 RUC por petición, con Idempotency-Key, para sanear la cartera de clientes de una vez.

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/ruc/20999999906 \
  -H "Authorization: Bearer nxid_test_sandboxpublicodenexoidpruebas001"
Con el SDK de JavaScript
import { NexoId, estaActivo } from '@nexo-lat/id';

const nexoid = new NexoId({ token: process.env.NEXOID_TOKEN! });
const cliente = await nexoid.ruc(ruc);    // { datos, meta } | null

if (cliente && estaActivo(cliente.datos)) {
  factura.razonSocial = cliente.datos.nombre;
}

La bolsa que encaja

Bolsa Crecimiento

S/ 149por 1,000,000 consultas

Un ERP con varios usuarios facturando consulta a diario: un millón de consultas al año, y la vigilancia de los 500 RUC a los que más facturas.

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 de RUC del Perú gratis?
Sí: las primeras 1,000 consultas de cada mes son gratis, con datos reales y sin tarjeta. Pide tu acceso por WhatsApp. Para pruebas sin pedir nada, el sandbox tiene un token público con empresas de prueba.
¿De dónde sale el dato?
Del padrón reducido de contribuyentes de SUNAT, que se descarga y se publica cada madrugada, y de su padrón de datos abiertos para el ubigeo y la actividad económica. La respuesta lo dice en meta.origen y meta.fecha_dato.
¿Trae la dirección fiscal?
Solo cuando SUNAT la publica en su padrón, que es alrededor del 13 % de los contribuyentes. Cuando no, llega en null: nunca inventada. El departamento, la provincia y el distrito sí llegan en más del 80 %.
¿Emite el comprobante?
No. NexoID te da los datos del adquirente para que tu sistema de facturación los use; la emisión del comprobante la sigue haciendo tu sistema.
¿Y si el cliente es una persona con RUC 10?
La ficha de una persona lleva su nombre, que es un dato personal: se sirve solo bajo contrato, con la finalidad declarada y el anexo de tratamiento firmado. Para empresas (RUC 20) no hace falta nada de eso.