Distritos SV

Librería para consultar la división político-administrativa de El Salvador, permitiendo obtener departamentos, municipios y distritos mediante sus códigos de facturacion electronica.

Instalación

npm install distritos-sv

o

yarn add distritos-sv

Importación

import {
  listaDepartamentos,
  listaMunicipios,
  listDistritos,
  buscarDepartamento,
  buscarMunicipio,
  buscarDistrito,
  formatearDireccion,
} from "distritos-sv";

API

listaDepartamentos()

Obtiene la lista de departamentos.

Retorna

{
  valores: string;
  codigo: string;
}[]

Ejemplo

const departamentos = listaDepartamentos();

console.log(departamentos);

Resultado:

[
  {
    valores: "San Salvador",
    codigo: "06",
  },
];

listaMunicipios(codigoDepartamento)

Obtiene todos los municipios pertenecientes a un departamento.

Parámetros

| Nombre | Tipo | Descripción | | ------------------ | ------ | ------------------------ | | codigoDepartamento | string | Código del departamento. |

Retorna

{
  valores: string;
  codigo: string;
}[]

Ejemplo

const municipios = listaMunicipios("06");

listDistritos(codigoDepartamento, codigoMunicipio)

Obtiene todos los distritos de un municipio.

Parámetros

| Nombre | Tipo | Descripción | | ------------------ | ------ | ------------------------ | | codigoDepartamento | string | Código del departamento. | | codigoMunicipio | string | Código del municipio. |

Retorna

{
  valores: string;
  codigo: string;
}[]

Ejemplo

const distritos = listDistritos("06", "14");

buscarDepartamento(codigoDepartamento)

Busca un departamento por su código.

Parámetros

| Nombre | Tipo | | ------------------ | ------ | | codigoDepartamento | string |

Retorna

{
  codigo: string;
  valores: string;
}

Si no existe devuelve:

{
  codigo: "0",
  valores: "No especificado",
}

Ejemplo

const departamento = buscarDepartamento("06");

buscarMunicipio(codigoDepartamento, codigoMunicipio)

Busca un municipio.

Parámetros

| Nombre | Tipo | | ------------------ | ------ | | codigoDepartamento | string | | codigoMunicipio | string |

Retorna

{
  codigo: string;
  valores: string;
}

Si no existe devuelve:

{
  codigo: "0",
  valores: "No especificado",
}

Ejemplo

const municipio = buscarMunicipio("06", "14");

buscarDistrito(codigoDepartamento, codigoMunicipio, codigoDistrito)

Busca un distrito.

Parámetros

| Nombre | Tipo | | ------------------ | ------ | | codigoDepartamento | string | | codigoMunicipio | string | | codigoDistrito | string |

Retorna

{
  codigo: string;
  valores: string;
}

Si no existe devuelve:

{
  codigo: "0",
  valores: "No especificado",
}

Ejemplo

const distrito = buscarDistrito("06", "14", "01");

formatearDireccion(codigoDepartamento, codigoMunicipio, codigoDistrito)

Convierte los códigos de ubicación en una dirección legible.

Parámetros

| Nombre | Tipo | | ------------------ | ------ | | codigoDepartamento | string | | codigoMunicipio | string | | codigoDistrito | string |

Retorna

string

Ejemplo

const direccion = formatearDireccion("06", "14", "01");

console.log(direccion);

Resultado:

San Salvador, San Salvador Centro, San Salvador

Ejemplo completo

import {
  listaDepartamentos,
  listaMunicipios,
  listDistritos,
  buscarDepartamento,
  buscarMunicipio,
  buscarDistrito,
  formatearDireccion,
} from "distritos-sv";

const departamentos = listaDepartamentos();

const municipios = listaMunicipios("06");

const distritos = listDistritos("06", "14");

const departamento = buscarDepartamento("06");

const municipio = buscarMunicipio("06", "14");

const distrito = buscarDistrito("06", "14", "01");

const direccion = formatearDireccion("06", "14", "01");

Licencia

MIT