Búsqueda por nombre

Busca contribuyentes DGII por razón social, nombre comercial o actividad económica.

cURL — búsqueda por nombre

curl -s "https://api.erply.pro/v1/dgii/document:search?q=DGII&field=name&limit=5" \
  -H "x-api-key: $ERPLYPRO_API_KEY" | jq .

Respuesta esperada (200 OK)

{
  "items": [
    {
      "rnc": "130862346",
      "name": "DIRECCIÓN GENERAL DE IMPUESTOS INTERNOS",
      "trade_name": "DGII",
      "economic_activity": "ADMINISTRACIÓN PÚBLICA EN GENERAL",
      "status": "ACTIVO"
    }
  ],
  "count": 1
}

Campos de búsqueda

field	Descripción	Ejemplo
name	Razón social (normalizada)	q=ERPLY
trade_name	Nombre comercial	q=DGII
economic_activity	Actividad económica DGII	q=ADMINISTRACION
document	Prefijo de RNC/Cédula	q=13086

JavaScript fetch

const params = new URLSearchParams({
  q: "ERPLY",
  field: "name",
  limit: "10",
});
const resp = await fetch(
  `https://api.erply.pro/v1/dgii/document:search?${params}`,
  { headers: { "x-api-key": process.env.ERPLYPRO_API_KEY } }
);
const { items, count } = await resp.json();
console.log(`Encontrados: ${count}`);

Python requests

import os, requests

resp = requests.get(
    "https://api.erply.pro/v1/dgii/document:search",
    params={"q": "ERPLY", "field": "name", "limit": 10},
    headers={"x-api-key": os.environ["ERPLYPRO_API_KEY"]},
    timeout=5,
)
data = resp.json()
for item in data["items"]:
    print(f"{item['rnc']} — {item['name']}")

Parámetros de consulta

Param	Requerido	Tipo	Descripción
q	Sí	string	Texto a buscar (mínimo 3 caracteres)
field	Sí	enum	Campo de búsqueda: name, trade_name, economic_activity, document
limit	No	integer	Máximo de resultados (default 25, máximo 100)
type	No	enum	Filtro: rnc o cedula

Siguiente paso

→ Enviar tu primera factura