Geografía

GET /api/v1/geografia — departamentos, distritos y ciudades de Paraguay para autocompletar direcciones.

Geografía de Paraguay

Tres endpoints públicos jerárquicos para poblar selectores de dirección. Se usan principalmente al configurar el contribuyente (departamentoId, distritoId, ciudadId).

Autenticación

Ninguna. Los tres endpoints son públicos.

GET /api/v1/geografia/departamentos

Lista los 18 departamentos de Paraguay.

Respuesta exitosa

Status: 200 OK

[
  { "departamentoId": 1, "codigo": "01", "nombre": "Concepción" },
  { "departamentoId": 2, "codigo": "02", "nombre": "San Pedro" },
  { "departamentoId": 11, "codigo": "11", "nombre": "Central" },
  { "departamentoId": 0, "codigo": "00", "nombre": "Capital" }
]

Ejemplo

curl https://api.sifende.com.py/api/v1/geografia/departamentos

GET /api/v1/geografia/departamentos/:departamentoId/distritos

Lista los distritos de un departamento.

Path parameters

Parámetro	Tipo	Descripción
`departamentoId`	`integer`	ID del departamento

Respuesta exitosa

Status: 200 OK

[
  { "distritoId": 105, "departamentoId": 11, "codigo": "01", "nombre": "Asunción" },
  { "distritoId": 106, "departamentoId": 11, "codigo": "02", "nombre": "Lambaré" },
  { "distritoId": 107, "departamentoId": 11, "codigo": "03", "nombre": "Fernando de la Mora" }
]

Ejemplo

curl https://api.sifende.com.py/api/v1/geografia/departamentos/11/distritos

GET /api/v1/geografia/distritos/:distritoId/ciudades

Lista las ciudades de un distrito.

Path parameters

Parámetro	Tipo	Descripción
`distritoId`	`integer`	ID del distrito

Respuesta exitosa

Status: 200 OK

[
  { "ciudadId": 2401, "distritoId": 105, "codigo": "01", "nombre": "Asunción" },
  { "ciudadId": 2402, "distritoId": 105, "codigo": "02", "nombre": "Sajonia" }
]

Ejemplo

curl https://api.sifende.com.py/api/v1/geografia/distritos/105/ciudades

Patrón de uso jerárquico

Cargá los departamentos al iniciar el formulario y mostralos en un select.

Cuando el usuario elige uno, llamá a /departamentos/:id/distritos y poblá el segundo select.

Cuando elige distrito, llamá a /distritos/:id/ciudades para el tercer select.

Guardá los tres IDs (departamentoId, distritoId, ciudadId) al crear o actualizar un contribuyente.

Los codigo son los códigos oficiales SIFEN; los id son internos de la API. Al enviar datos a /contribuyentes, usá los IDs internos, no los códigos.

Errores

Status	Tipo	Descripción
404	`departamento-not-found`	Departamento no existe
404	`distrito-not-found`	Distrito no existe

On this page