Skip to main content
Endereços vinculados ao customer. Um customer pode ter N endereços, com um marcado como padrão.

​
Campos

CampoTipoDescrição
customerAddressIdUUIDIdentificador único
customerIdUUIDReferência ao customer
labelStringRótulo do endereço (ex.: “Casa”, “Trabalho”)
streetStringLogradouro
numberStringNúmero
complementString?Complemento
neighborhoodStringBairro
cityStringCidade
stateStringEstado
zipCodeStringCEP
countryStringPaís
latFloatLatitude
lngFloatLongitude
isDefaultBooleanIndica se é o endereço padrão. Default: false
createdByUUID?Usuário que criou o registro, quando aplicável
createdAtDateTimeData de criação
updatedByUUID?Usuário que fez a última atualização, quando aplicável
updatedAtDateTimeData da última atualização
deletedByUUID?Usuário que removeu o registro, quando aplicável
deletedAtDateTime?Data de remoção lógica

​
Relacionamentos

​
Regras de Negócio

  • O par customerId + label é único.
  • O primeiro endereço criado pelo cadastro de customer recebe isDefault = true.
  • Um customer pode ter múltiplos endereços, mas apenas um endereço padrão.
  • Endereços removidos devem ser marcados com deletedAt, preservando histórico.

​
Example

{
  "customerAddressId": "0197a7f6-a0c7-73c4-8452-7c1b3f028893",
  "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
  "label": "Casa",
  "street": "Rua das Palmeiras",
  "number": "120",
  "complement": "Apto 42",
  "neighborhood": "Vila Mariana",
  "city": "São Paulo",
  "state": "SP",
  "zipCode": "04102000",
  "country": "BR",
  "lat": -23.5893,
  "lng": -46.6344,
  "isDefault": true,
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T12:00:10.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T12:00:10.000Z",
  "deletedBy": null,
  "deletedAt": null
}