Catálogos geográficos

e-Miti expone endpoints de datos de referencia que tu integración puede usar para construir formularios de selección, validar ubicaciones o pre-completar campos antes de emitir un DE.

Para buscar y administrar el catálogo de clientes de tu tenant (alta, edición, baja, consulta del padrón DNIT), ver Receptores.

Catálogo geográfico SET

El catálogo geográfico está organizado en tres niveles jerárquicos: departamento → distrito → localidad. Los códigos que devuelven estos endpoints son los mismos que se usan en los campos codigo_departamento, codigo_distrito y codigo_ciudad de receptor y autofactura.

GET /v1/catalogos/departamentos

Devuelve la lista completa de departamentos (~18 ítems). No requiere filtros.

curl "https://api.emiti.fravelabs.com/v1/catalogos/departamentos" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"

Respuesta 200:

{
  "departamentos": [
    { "codigo": 1,  "nombre": "CAPITAL" },
    { "codigo": 2,  "nombre": "CONCEPCION" },
    { "codigo": 12, "nombre": "CENTRAL" }
  ]
}

GET /v1/catalogos/distritos

Devuelve distritos del departamento indicado. Sin el parámetro departamento devuelve todos.

Param	Tipo	Requerido	Descripción
`departamento`	`integer`	no	Código de departamento para filtrar.

curl "https://api.emiti.fravelabs.com/v1/catalogos/distritos?departamento=1" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"

Respuesta 200:

{
  "distritos": [
    { "codigo": 1, "nombre": "ASUNCION", "codigo_departamento": 1 }
  ]
}

GET /v1/catalogos/localidades

Devuelve localidades del distrito indicado. Sin distrito devuelve la tabla completa (~6 764 ítems, ~200 KB).

Param	Tipo	Requerido	Descripción
`distrito`	`integer`	no	Código de distrito para filtrar.

curl "https://api.emiti.fravelabs.com/v1/catalogos/localidades?distrito=1" \
  -H "Authorization: ApiKey emiti_k_xxxxxxxxxxxxxxxxxxxxxxxx"

Respuesta 200:

{
  "localidades": [
    { "codigo": 1, "nombre": "ASUNCION", "codigo_distrito": 1 }
  ]
}

Cargá los tres niveles de forma progresiva en tus formularios (dpto → distrito → localidad) para evitar payloads grandes. Con TanStack Query o SWR podés cachear cada nivel.

Todos los endpoints de esta página requieren autenticación aunque la información sea pública — son datos compartidos entre tenants (no filtrados por tenant, a diferencia de /v1/receptores).

Introducción

Emisión y consulta

Eventos sobre DE

Receptores y series

Datos de referencia

Catálogos geográficos

Catálogo geográfico SET

GET /v1/catalogos/departamentos

GET /v1/catalogos/distritos

GET /v1/catalogos/localidades

​Catálogo geográfico SET

​GET /v1/catalogos/departamentos

​GET /v1/catalogos/distritos

​GET /v1/catalogos/localidades

Catálogo geográfico SET

GET /v1/catalogos/departamentos

GET /v1/catalogos/distritos

GET /v1/catalogos/localidades