Direcciones del cliente

Esta guía te explica cómo enviar las direcciones del cliente dentro del objeto customer.

1. Dónde van en el JSON

BillingAddress y ShippingAddress hacen parte de customer.

{
  "customer": {
    "companyName": "Mi empresa S.A",
    "personType": "2",
    "regimeType": "49",
    "firstName": "Nombres del cliente",
    "lastName": "Apellidos del cliente",
    "identification": "1234567890",
    "digitCheck": "2",
    "identificationTypeCode": "13",
    "email": "clienteemail@gmail.com",
    "phone": "1234567890",
    "responsibleFor": "ZZ",
    "responsibilities": "R-99-PN",
    "economicActivities": "7020;5140",
    "BillingAddress": {
      "address": "Dirección del cliente",
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001",
      "postalCode": "11001",
      "neighborhood": "Las Mercedes",
      "phone": "489-833-4218",
      "contactName": "Alexandra Champlin"
    },
    "ShippingAddress": {
      "address": "Dirección de entrega del cliente",
      "countryName": "Colombia",
      "countryCode": "CO",
      "regionName": "Bogotá",
      "regionCode": "11",
      "cityName": "Bogotá",
      "cityCode": "11001",
      "postalCode": "11001",
      "neighborhood": "Las Mercedes",
      "phone": "854-336-5164",
      "contactName": "Megan Jones MD"
    }
  }
}

2. Qué significa cada objeto

BillingAddress: dirección de facturación del cliente.

ShippingAddress: dirección de entrega del cliente.

3. Campos soportados en cada dirección

Ambos objetos usan la misma estructura:

Campo	Descripción
`address`	Dirección principal.
`countryName`	Nombre del país.
`countryCode`	Código ISO del país, por ejemplo `CO`.
`regionName`	Nombre del departamento o región.
`regionCode`	Código DIAN del departamento o región.
`cityName`	Nombre de la ciudad o municipio.
`cityCode`	Código DIAN de la ciudad o municipio.
`postalCode`	Código postal.
`neighborhood`	Barrio o sector.
`phone`	Teléfono de contacto para esa dirección.
`contactName`	Nombre del contacto en esa dirección.

4. Reglas prácticas de validación

Envía siempre countryName y countryCode coherentes entre sí.

regionName debe corresponder con regionCode.

cityName debe corresponder con cityCode.

Los dos primeros dígitos de cityCode deben coincidir con regionCode.

Si facturación y entrega son distintas, debes enviar ambos objetos completos.

5. Errores comunes

Enviar BillingAddress o ShippingAddress fuera de customer.

Mezclar códigos y nombres de otra región o ciudad.

Enviar cityCode que no pertenece al regionCode.

Enviar solo el nombre, por ejemplo cityName, sin su código, por ejemplo cityCode.

1. Dónde van en el JSON#

2. Qué significa cada objeto#

3. Campos soportados en cada dirección#

4. Reglas prácticas de validación#

5. Errores comunes#

1. Dónde van en el JSON

2. Qué significa cada objeto

3. Campos soportados en cada dirección

4. Reglas prácticas de validación

5. Errores comunes