NexoID

Casos de uso /

Ecommerce

Factura a empresas desde tu tienda, sin que escriban la razón social

En el checkout, tu cliente marca «quiero factura» y escribe su RUC. La tienda comprueba que esté bien escrito, tu servidor lo consulta y la razón social aparece sola, tal como la tiene SUNAT.

El problema

  • El cliente escribe la razón social como se acuerda, y la factura sale con otro nombre.
  • Un RUC mal tipeado se descubre al emitir, con el pedido ya pagado.
  • Llamar a una API desde el navegador deja el token a la vista de cualquiera.

Con NexoID

  • El dígito verificador se comprueba en el navegador, al instante y sin llamar a nadie.
  • Tu servidor consulta el RUC y devuelve la razón social, el estado y la condición; el token nunca sale de él.
  • Funciona con cualquier tienda que tenga un servidor propio: hay SDK de PHP y de JavaScript.

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
// En tu servidor, nunca en el navegador.
const nexoid = new NexoId({ token: process.env.NEXOID_TOKEN! });
const empresa = await nexoid.ruc(rucDelCheckout);

return empresa ? { razonSocial: empresa.datos.nombre } : { error: 'RUC no encontrado' };

La bolsa que encaja

Bolsa Inicial

S/ 59por 250,000 consultas

Una consulta por pedido con factura: 250,000 en un año alcanzan para una tienda en crecimiento.

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

¿Puedo consultar el RUC directo desde el navegador?
No conviene: el token quedaría a la vista y cualquiera podría gastar tus consultas. La consulta va en tu servidor, y el navegador solo comprueba el dígito verificador, que no necesita token.
¿Cuánto cuesta consultar RUC por API?
Las primeras 1,000 consultas de cada mes son gratis. Después, bolsas prepago que duran 12 meses, desde S/ 19, con el IGV incluido. Las consultas que no encuentran nada no se cobran.
¿Qué pasa si el RUC no existe?
La API responde 404 con encontrado en false, y no se cobra. Un RUC mal escrito responde 422 antes de buscarlo, y los SDKs lo rechazan sin llamar.
¿Y si quien compra es una persona con RUC 10?
Su ficha 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.