Departamentos

Esta guía te explica cómo usar correctamente los departamentos en el JSON.

1. Qué representan estos campos

regionName: nombre del departamento, por ejemplo Bogotá.

regionCode: código DIAN del departamento, por ejemplo 11.

Regla clave:

regionCode debe coincidir con regionName.

El cityCode que uses debe pertenecer al regionCode informado.

2. Cómo se ve en el JSON

Para documento soporte code: "05", dirección del proveedor:

{
  "supplier": {
    "address": {
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001"
    }
  }
}

Para los demás documentos, dirección del cliente:

{
  "customer": {
    "BillingAddress": {
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001"
    },
    "ShippingAddress": {
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001"
    }
  }
}

3. Errores comunes

Enviar regionName y regionCode que no corresponden.

Usar un cityCode de otro departamento.

Enviar el código de departamento con formato inválido. Debe mantener 2 dígitos.

4. Catálogo de departamentos de Colombia

Códigos y nombres de los departamentos de Colombia.

Nombres	Códigos
Amazonas	91
Antioquia	05
Arauca	81
Atlántico	08
Bogotá	11
Bolívar	13
Boyacá	15
Caldas	17
Caquetá	18
Casanare	85
Cauca	19
Cesar	20
Chocó	27
Córdoba	23
Cundinamarca	25
Guainía	94
Guaviare	95
Huila	41
La Guajira	44
Magdalena	47
Meta	50
Nariño	52
Norte de Santander	54
Putumayo	86
Quindío	63
Risaralda	66
San Andrés y Providencia	88
Santander	68
Sucre	70
Tolima	73
Valle del Cauca	76
Vaupés	97
Vichada	99

1. Qué representan estos campos#

2. Cómo se ve en el JSON#

3. Errores comunes#

4. Catálogo de departamentos de Colombia#

1. Qué representan estos campos

2. Cómo se ve en el JSON

3. Errores comunes

4. Catálogo de departamentos de Colombia