Error API: Ciudad inválida para el departamento

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

Revisa en el catálogo de ciudades y departamentos de Colombia a qué departamento pertenece el municipio del cliente.
Corrige city y department dentro de la dirección del cliente para que correspondan entre sí.
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.