Servicio que obtiene la lista de todos los distritos del Paraguay admitidos por el SIFEN. En cada elemento se recupera el código y la descripción, y el Departamento al cual pertenece el Distrito.
Puede especificar un departamento específico del cual desea obtener los distritos, en la ruta // de la URL, o puede especificar en dicho campo el valor NULL si desea recuperar todos los distritos.
También es posible realizar búsquedas por nombres de distritos parecidos enviando un query parám ?nombre=valor, indicando el valor para el filtro.
Puede utilizar este servicio para mantener actualizado los datos de los distritos en su Sistema.
Endpoint (URL) #
GET https://api.facturasend.com.py/<tenantId>/distritos/<departamentoId>
GET https://api.facturasend.com.py/<tenantId>/distritos/null
Header (Encabezado) #
Requiere el envío del los siguientes atributos en el encabezado
Campo | Valor |
---|---|
Authorization | Bearer api_key_reemplazar_api_key |
Parámetros (BODY) #
No posee
Parámetros (Query Param) #
Campo | Valor |
---|---|
nombre | Distrito para filtrar |
Este parámetro es opcional y sirve para filtrar los distritos utilizando el operador LIKE, ejemplo
GET https://api.facturasend.com.py/<tenantId>/distritos/null?nombre=bahia
Ejemplo de llamadas #
# Obtiene los distritos del departamento y filtrando por el nombre curl \ GET "https://api.facturasend.com.py/<tenantId>/distritos/<departamentoId>?nombre=bahia" \ -H "Authorization: Bearer api_key_<reemplazar_api_key>"
# El ejemplo se muestra utilizando AXIOS import axios from 'axios'; const headers = { `Authorization` : `Bearer api_key_<reemplazar_api_key>` }; axios.post({ url: `https://api.facturasend.com.py/<tenantId>/distritos/<departamentoId>?nombre=bahia`, method: 'GET', {headers} } ).then( respuesta => { console.log(respuesta); });
Respuesta de la Petición #
La respuesta de la petición será la siguiente:
{ "success" : true, "result" : [{ "codigo": 17, "descripcion": "ALTO PARAGUAY" }, { "codigo": 11, "descripcion": "ALTO PARANA" }, { "codigo": 99, "descripcion": "OTROS" }] }
Recomendaciones #
- No aplica
Validaciones #
- No aplica