Calidad y límites de los datos
Usa estas APIs para consultar directorios, no como certificaciones emitidas por el Gobierno. Las guías de fuentes describen la evidencia que respalda cada servicio.
Localidades
Las localidades combinan identificadores vinculados a una fuente con una jerarquía administrativa interpretada. Un código oficial anterior puede seguir siendo útil aunque una ley posterior cambie el tipo o el área superior de un lugar. No concluyas que la ausencia de una característica en una capa geométrica significa que el lugar fue eliminado legalmente.
Revisa la respuesta activa de /v1/catalog para consultar releaseId, knownThrough, qualityStatus y el hash de la versión publicada. La fecha de publicación, el período que cubren las fuentes y las fechas de vigencia legal tienen significados distintos; una implementación reciente de la API no vuelve actuales los datos de fuentes antiguas.
El informe de vigencia (en inglés) indica su propio corte de evidencia y los conflictos conocidos. La evaluación de fuentes (en inglés) explica quién mantiene cada fuente y sus esquemas de identificadores. Para una localidad específica, usa el endpoint de procedencia en la referencia de localidades.
Contribuyentes
La búsqueda por nombre devuelve solo el identificador fiscal y los nombres registrado y comercial. La consulta exacta devuelve esos datos de identidad, junto con las clasificaciones de registro y checksum y los datos disponibles de la DGII, como el régimen, la categoría y el indicador de facturador electrónico. Los datos ausentes son null; isElectronicInvoicer: null significa desconocido y false significa que la fuente informó que no. El estado de registro, la clasificación del checksum y el indicador de facturador electrónico responden preguntas distintas. Ninguno demuestra cumplimiento tributario actual.
Una publicación antigua no provoca por sí sola una respuesta 503. La última observación conocida sigue disponible cuando una publicación nueva omite al contribuyente. Las fechas de publicación y consulta y la evidencia de origen permanecen internas; no indican cuándo la DGII actualizó por última vez el registro de un contribuyente. La API no dispone actualmente de esa fecha oficial y no devuelve updatedAt. Los datos del perfil ausentes o no disponibles son null; un indicador de facturador electrónico desconocido no equivale a falso. Una falla temporal no debe convertirse en una decisión negativa sobre el registro.
La búsqueda por nombre incluye nombres registrados y comerciales de la publicación actual. La búsqueda por identificador también puede devolver una última observación conocida. Ninguna modalidad consulta el formulario de la DGII. No encontrar coincidencias no indica ausencia de registro; confirma el número elegido con la consulta exacta. Respeta las cabeceras de caché: las respuestas exitosas pueden guardarse hasta 60 segundos.
La certificación MICM es una fuente independiente, disponible solo para servicios autenticados a través de la API del directorio. Sus fechas de publicación, emisión y vencimiento son independientes de las fechas de la DGII. Un certificado vencido puede devolverse con sus fechas; un certificado nulo no demuestra que la empresa carezca de certificación. Consulta los campos y las condiciones de acceso en la guía de contribuyentes.
Precios de combustibles
Los precios de combustibles se califican a partir de las resoluciones semanales publicadas oficialmente por el MICM. Los importes son cadenas decimales en DOP y cada registro indica su unidad, etapa de venta y período inclusivo de vigencia. La cobertura del catálogo y la disponibilidad de un precio vigente son afirmaciones distintas; un producto puede tener historial sin contar con un período actual utilizable. Cuando un período vigente expira, la API responde 503 en vez de presentar un valor antiguo como actual.
El archivo histórico tiene brechas y clasificaciones de fuentes no resueltas. Un rango sin resultados no demuestra que el precio se mantuvo igual, y el servicio no calcula entre unidades como MMBTU y CUBIC_METER. Los modos de entrega y las etapas de venta del gas natural identifican mercados distintos. Lee la guía rápida de precios de combustibles y la referencia de precios de combustibles antes de usar registros para decisiones de precios o cumplimiento.
Uso responsable
Usa únicamente los registros necesarios para tu flujo de trabajo. Evita almacenar o publicar identificadores personales sin necesidad y no interpretes que la disponibilidad de una fuente pública autoriza cualquier uso posterior.
Ambas APIs son de solo lectura. Guarda en caché las respuestas exitosas, evita enumerar registros en volumen y gestiona la indisponibilidad temporal. Este servicio público gratuito inicial no promete un SLA ni una cuota de solicitudes ilimitada.
La primera solicitud puede tardar más mientras la base de datos se reactiva.
Procedencia de la documentación
Las guías detalladas se generan a partir de revisiones fijadas del repositorio del servicio. El Markdown original y sus hashes SHA-256 están publicados en el manifiesto de fuentes de documentación. Los contratos de la API están disponibles como JSON de OpenAPI, con los hashes de los contratos originales en el índice del servicio.
Las fechas de evidencia de cada guía describen su evaluación, no la implementación actual de la API.
Los repositorios del servicio son privados. Este portal ofrece extractos públicos de las guías de fuentes sin requerir acceso al repositorio; los procedimientos de despliegue y los artefactos de revisión no publicados siguen reservados para los mantenedores. El portal no distribuye los PDF originales de las fuentes ni bases de datos de catálogos descargables.