Facturador PRO 8 (y forks compatibles)

Chequea es compatible con Facturador PRO 8 y la mayoría de sistemas de facturación electrónica del mercado peruano. Configurar la integración toma 2 minutos y no requiere modificar el código de tu facturador.

Compatible con:

• Facturador PRO 8 (FacturaloPeru)
• Nubefact
• Multifacturalo
• Facturalo.Pro
• Forks y distribuciones derivadas

Qué obtienes

Una vez configurado, tu facturador usa Chequea para:

Funcionalidad	Cómo se usa en tu facturador
Consulta RUC SUNAT	Autocompletado al dar de alta clientes/proveedores
Tipo de cambio diario	Tasa BCRP que tu facturador usa al emitir comprobantes en USD
Validación masiva de CPE	Módulo “Validador masivo de comprobantes” (panel admin)

Cómo configurarlo

1. Crea tu API key en Chequea

   Entra a app.chequea.pe → API Keys → Crear.

   Selecciona estos scopes según lo que vayas a usar:

   • ruc:read — consulta de RUC (siempre necesario)
   • tipo-cambio:read — tipo de cambio (siempre necesario)
   • cpe:validate — validación masiva de CPE (sólo si la usas)

   Copia el token (ak_live_…) en cuanto se genere. No se vuelve a mostrar después.

2. Pega los datos en tu facturador

   En el panel admin del facturador, ve a Configuraciones → APIRuc (en Facturador PRO 8 está en <tu-dominio>/configurations).

   Llena los dos campos:

   Campo	Valor
   URL del servicio	https://api.chequea.pe
   Token	el ak_live_… que copiaste

   Guarda. No necesitas reiniciar nada.

3. Pruébalo

   Crea un nuevo cliente desde el formulario del facturador y escribe un RUC válido. Debe autocompletar razón social, dirección y ubigeo.

   Para tipo de cambio: el facturador lo consulta automáticamente al emitir un comprobante en USD, o desde el módulo “Tipo de cambio” si está disponible en tu plan.

Despliegues en Docker

Si tu facturador corre en Docker, usa siempre la URL pública https://api.chequea.pe. No uses localhost ni IPs internas — el contenedor no resuelve esas direcciones del host.

Troubleshooting

El RUC no se autocompleta — el formulario queda vacío

Causa común: el token está mal pegado o la URL apunta al sitio público (https://chequea.pe) en lugar del servicio (https://api.chequea.pe). Verifica las dos cosas en Configuraciones → APIRuc.

El facturador muestra 500 “Trying to access array offset on value of type null”

Tu facturador no recibió una respuesta JSON válida. Causas frecuentes:

1. URL incorrecta. Debe ser https://api.chequea.pe (con api. adelante).
2. Token con scopes incompletos. Entra a app.chequea.pe → API Keys y verifica que el token tenga ruc:read activo.
3. Proxy corporativo bloqueando HTTPS desde tu servidor.

Tipo de cambio devuelve 1.00 / 1.00

Tu facturador hace fallback a 1/1 cuando la fecha consultada no tiene tipo de cambio publicado por BCRP (fines de semana y feriados). Verifica que estás consultando un día hábil.

Necesito consulta DNI

La consulta de DNI requiere fuente RENIEC que no es dato abierto. Si tu negocio la necesita, escríbenos a comercial — podemos habilitarla para tu cuenta integrando con tu proveedor contratado.

Para partners y revendedores

Si vendes Facturador PRO 8 a tus clientes y quieres ofrecer el servicio de consulta RUC + tipo de cambio bajo tu marca (con tu propio precio, cuota y soporte), tienes dos caminos:

1. API key central: contratas un plan empresarial con cuota suficiente y embebes una sola API key en el .env de cada instalación que despliegas. Cobras el servicio dentro del precio del facturador.
2. API key por cliente: cada cliente saca su propia API key en Chequea. Tú sólo cobras la instalación y el soporte del facturador.

Habla con comercial si necesitas pricing especial para reventa.