View Categories

Consultar todos los distritos

1 minutos de lectura

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

CampoValor
AuthorizationBearer api_key_reemplazar_api_key

Parámetros (BODY) #

No posee

Parámetros (Query Param) #

CampoValor
nombreDistrito 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