# RNC API: consulta del padrón de contribuyentes

**Próximamente.** Consulta desde tu sistema el padrón de contribuyentes por RNC, cédula o nombre. Cada respuesta dice de qué fecha es el dato. Un servicio de Villar JA Data y Tecnología SRL sobre el listado público de la DGII.

- **Me interesa (WhatsApp):** <https://wa.me/18292040510?text=Hola%2C%20me%20interesa%20la%20RNC%20API%20de%20Villar%20JA.>
- **Correo:** <mailto:ventas@villarja.com?subject=RNC%20API>

## En resumen

- **Estado:** Próximamente.
- **Consulta:** RNC, cédula o nombre.
- **Fuente:** Listado público de la DGII.
- **Para empezar:** Plan gratis y sandbox.

## Ejemplo (sandbox)

```bash
curl https://rnc.villarja.com/v1/taxpayers/900000001 \
  -H "Authorization: Bearer rnc_sbx_…"
```

```json
{
  "rnc": "900000001",
  "legalName": "EMPRESA FICTICIA ACTIVA, SRL",
  "commercialName": "FICTICIA ACTIVA",
  "status": "ACTIVO",
  "category": null,
  "regime": "NORMAL",
  "economicActivity": "SERVICIOS DE PRUEBA",
  "startDate": "2001-05-14",
  "dataAsOf": "2026-01-01",
  "source": "sandbox"
}
```

## Qué devuelve

- **Identidad:** RNC o cédula, razón social y nombre comercial.
- **Situación:** Estado en el padrón (activo, suspendido, dado de baja…), categoría y régimen.
- **Actividad:** Actividad económica registrada y fecha de inicio de operaciones.
- **Frescura:** La fecha del padrón de la que sale el dato y su fuente, en cada respuesta.

## Cómo funciona

1. **Crea tu cuenta y tu clave.** En el portal de autoservicio, con plan gratis para empezar.
2. **Prueba en el sandbox.** Un padrón ficticio fijo para integrar sin gastar consultas.
3. **Consulta en producción.** La misma API con tu clave de producción y el consumo a la vista.

## Lo que debes saber

- **De dónde sale el dato:** Del listado público de contribuyentes que publica la DGII, actualizado cada mes. No es un servicio oficial de la DGII.
- **Personas físicas:** La consulta por número devuelve el contribuyente que corresponda. La búsqueda por nombre solo devuelve personas jurídicas.
- **Planes y cobro:** Planes mensuales o anuales con cupo de consultas, cobrados en dólares por PayPal. Los precios se publican al abrir el servicio.
- **Si te pasas del cupo:** Te avisamos y la velocidad se reduce hasta el siguiente periodo. Tu sistema no se queda sin respuesta de golpe.

## Preguntas frecuentes

- **¿Es un servicio oficial de la DGII?** No. Es un servicio de Villar JA construido sobre el listado público de la DGII. Cada respuesta indica la fecha del padrón usado.
- **¿Qué tan actualizado está?** El padrón se sincroniza cada mes con el listado de la DGII y vigilamos que la sincronización termine bien.
- **¿Puedo buscar personas por nombre?** No. La búsqueda por nombre solo devuelve personas jurídicas. Una cédula concreta se consulta por su número.
- **¿Cuándo estará disponible?** Estamos terminando el portal y el cobro. Escríbenos y te avisamos en cuanto abra, con acceso al sandbox.
- **¿Cuánto cuesta?** Habrá un plan gratis para empezar y planes de pago según el volumen de consultas. Publicaremos los precios al abrir.