Tipos de consulta
- Consulta por RNC / Cédula
- Consulta por nombre (detalle exacto)
- Consulta por nombres (lista paginada)
Consulta por RNC / Cédula
GET
GET https://rnc.lipuve.com.do/api/consulta?rnc=131996035
POST
POST https://rnc.lipuve.com.do/api/consulta
{ "rnc": "131996035" }
cURL
curl "https://rnc.lipuve.com.do/api/consulta?rnc=131996035"
curl -X POST "https://rnc.lipuve.com.do/api/consulta" -H "Content-Type: application/json" -d '{"rnc": "131996035"}'
Respuesta (éxito)
{
"error": false,
"codigo_http": 200,
"mensaje": "Consulta Exitosa",
"cedula_rnc": "131-99603-5",
"nombre_razon_social": "AGROPECUARIA DELIA & MILO AGRODEMI SRL",
"nombre_comercial": "AGROPECUARIA DELIA & MILO AGRODEMI",
"categoria": "",
"regimen_de_pagos": "NORMAL",
"estado": "ACTIVO",
"actividad_economica": "CRÍA DE ANIMALES Y OBTENCIÓN DE PRODUCTOS DE ORIGEN ANIMAL, N.C.P. ...",
"administracion_local": "ADM LOCAL LA VEGA",
"facturador_electronico": "SI",
"licencias_de_comercializacion_de_vhm": "N/A",
"rnc_consultado": "131996035"
}
Consulta por nombre (detalle exacto)
Busca por nombre, toma el primer resultado y devuelve su detalle completo. Mínimo 4 caracteres.
GET https://rnc.lipuve.com.do/api/consulta/nombre?buscar=lugo%20%26%20de%20oleo
POST https://rnc.lipuve.com.do/api/consulta/nombre
{ "buscar": "lugo & de oleo" }
curl "https://rnc.lipuve.com.do/api/consulta/nombre?buscar=lugo%20%26%20de%20oleo"
La respuesta tiene el mismo formato que la consulta por RNC.
Consulta por nombres (lista paginada)
GET https://rnc.lipuve.com.do/api/consulta/nombres?buscar=lugo&pagina=1
POST https://rnc.lipuve.com.do/api/consulta/nombres
{ "buscar": "lugo", "pagina": 1 }
curl "https://rnc.lipuve.com.do/api/consulta/nombres?buscar=lugo&pagina=2"
Respuesta (éxito)
{
"error": false,
"codigo_http": 200,
"mensaje": "Consulta Exitosa",
"info_paginacion": {
"pagina_actual": 1,
"paginas_totales": 5,
"total_en_esta_pagina": 7
},
"resultados": [
{
"cedula_rnc": "130-00229-2",
"nombre_razon_social": "LUGO & DE OLEO EIRL",
"nombre_comercial": "LUGO & DE OLEO",
"categoria": "",
"regimen_de_pagos": "NORMAL",
"estado": "ACTIVO",
"facturador_electronico": "NO",
"licencias_de_comercializacion_de_vhm": "N/A"
}
]
}
Errores (siempre JSON)
400 – Solicitud incorrecta
{ "error": true, "codigo_http": 400, "mensaje": "Debe especificar el parámetro 'rnc'", "rnc_consultado": null }
404 – No inscrito / no encontrado
{ "error": true, "codigo_http": 404, "mensaje": "el rnc/cedula consultado no se encuentra inscrito como contribuyente.", "rnc_consultado": "1305035590" }
500 – Error interno
{ "error": true, "codigo_http": 500, "mensaje": "Error interno: ...", "rnc_consultado": "131996035" }
502 – La DGII no respondió o respondió algo inesperado (fallo temporal, se puede reintentar)
{ "error": true, "codigo_http": 502, "mensaje": "no se pudo acceder a la pagina dgii: ...", "rnc_consultado": "131996035" }