Si desarrollas un sistema de facturación, un ERP o cualquier aplicación que maneje datos de empresas dominicanas, integrar la verificación de RNC directamente en tu software te ahorra tiempo y evita errores. En esta guía técnica te mostramos cómo hacerlo con la API de Directorio RNC.

¿Para qué sirve la API?

La API te permite consultar programáticamente los datos de un RNC o cédula: nombre/razón social, estado (activo/inactivo), actividad económica y más. Ideal para:

• Validar el RNC de un cliente al momento de registrarlo.
• Autocompletar datos en formularios de facturación.
• Verificar proveedores de forma masiva.
• Cumplir con la debida diligencia fiscal automáticamente.

Cómo funciona

La API es de tipo REST y devuelve respuestas en formato JSON, por lo que puedes consumirla desde cualquier lenguaje (JavaScript, Python, PHP, C#, etc.).

Ejemplo de solicitud (JavaScript)

const res = await fetch(
  'https://directoriornc.com/api/rnc?q=101010101'
);
const data = await res.json();
console.log(data);

Ejemplo de solicitud (Python)

import requests

resp = requests.get(
    'https://directoriornc.com/api/rnc',
    params={'q': '101010101'}
)
print(resp.json())

Ejemplo de respuesta

{
  "rnc": "101010101",
  "nombre": "EMPRESA EJEMPLO SRL",
  "estado": "ACTIVO",
  "actividad": "COMERCIO AL POR MAYOR"
}

Buenas prácticas de integración

• Cachea los resultados: Los datos de un RNC no cambian a menudo; guarda las respuestas para no consultar lo mismo repetidamente.
• Maneja los errores: Controla los casos donde el RNC no existe o el servicio no responde.
• Valida el formato antes de consultar: Un RNC tiene 9 dígitos y una cédula 11; valida en el cliente antes de llamar a la API.
• Respeta los límites de uso: Evita ráfagas masivas de peticiones; distribuye las consultas.

Casos de uso reales

• Software de facturación: Al escribir el RNC del cliente, autocompleta el nombre y valida que esté activo antes de emitir un B01.
• Onboarding de clientes: Verifica automáticamente la empresa durante el registro.
• Sistemas contables: Valida proveedores antes de registrar facturas de compra.

¿Listo para integrar? Consulta la documentación completa con todos los endpoints, parámetros y ejemplos en nuestra página de documentación de la API.