Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

Error API: Ciudad inválida para el departamento

Guía de Solución de Problemas API DATAICO FACTURA ELECTRÓNICA

Detalle (RESPONSE)

{
  "errors": [
    {
      "path": ["invoice", "customer", "address"],
      "error": "Ciudad 'RETIRO' es inválida para el departamento 'BOLIVAR'."
    }
  ]
}

En el ejemplo, Retiro es un municipio de Antioquia, no de Bolívar.

Motivo

La dirección del cliente trae una ciudad (city) que no pertenece al departamento (department) enviado, según el catálogo de municipios de Colombia que usa la DIAN.

Los dos campos aceptan el nombre o el código:

  • department: nombre del departamento (por ejemplo, ANTIOQUIA) o su código de 2 dígitos (05).
  • city: nombre del municipio (por ejemplo, MEDELLIN) o su código de municipio de 3 dígitos (001).

Usa la misma forma en los dos: ambos por nombre o ambos por código.

Pasos para Solucionar el Error

Opción 1: Corregir la dirección en el JSON

  1. Revisa en la Lista Departamentos del DANE a qué departamento pertenece el municipio del cliente. La descargas en Dataico, en Importación > Terceros > Descarga de Referencias (ver Importar terceros con una plantilla).
  2. Corrige city y department dentro de la dirección del cliente para que correspondan entre sí.
  3. Reenvía la solicitud.

Opción 2: No enviar la dirección del cliente

Si el cliente ya existe en Dataico con una dirección válida, puedes omitir en el JSON los campos de dirección (country_code, department, city y address_line): Dataico usa los datos que ya tiene guardados. Si el cliente no existe o no tiene dirección, esta opción no sirve y debes enviar una dirección correcta.

Recursos Adicionales