📥 Guía descargable

Descarga la guía completa de Validación de Identidad en recursos para desarrolladores →

Consulta de RNC/Cédula

Verifica un contribuyente DGII en menos de 50 ms usando su RNC (9 u 11 dígitos) o Cédula.

Tiempo estimado

Menos de 5 minutos si ya tienes tu API key del paso 2.

Requisitos previos

• API key sandbox activa (ver Crear tenant)
• RNC o Cédula a consultar (usaremos 130862346 — el RNC de DGII)

cURL

curl -s https://api.erply.pro/v1/dgii/document/130862346 \
  -H "x-api-key: $ERPLYPRO_API_KEY" | jq .

Respuesta esperada (200 OK)

{
  "rnc": "130862346",
  "name": "DIRECCIÓN GENERAL DE IMPUESTOS INTERNOS",
  "trade_name": "DGII",
  "economic_activity": "ADMINISTRACIÓN PÚBLICA EN GENERAL",
  "status": "ACTIVO",
  "payment_regime": "ORDINARIO"
}

JavaScript fetch

const resp = await fetch(
  "https://api.erply.pro/v1/dgii/document/130862346",
  { headers: { "x-api-key": process.env.ERPLYPRO_API_KEY } }
);
const data = await resp.json();
console.log(data.name); // "DIRECCIÓN GENERAL DE IMPUESTOS INTERNOS"

Python requests

import os, requests

resp = requests.get(
    "https://api.erply.pro/v1/dgii/document/130862346",
    headers={"x-api-key": os.environ["ERPLYPRO_API_KEY"]},
    timeout=5,
)
data = resp.json()
print(data["trade_name"])  # "DGII"

Casos de respuesta

Código	Significado
200	Contribuyente encontrado
400	Formato de documento inválido (no es RNC ni Cédula)
404	No existe en el padrón DGII
429	Rate limit excedido — espera e intenta de nuevo

Siguiente paso

→ Búsqueda por nombre