Update specific address
PUT/company/address/:id
Atualiza um endereço existente identificado pelo seu ID. Permite modificar todos os campos exceto o ID.
Fluxo de atualização:
- Validação de permissões (admin/editor)
- Verificação de que o endereço pertence à empresa do usuário
- Se isDefault=true:
- Desmarca o endereço principal atual
- Define este endereço como novo principal
- Atualização de dados na base de dados
Campos atualizáveis:
- name: Novo nome descritivo
- company_name: Razão social no endereço
- phone: Telefone de contato
- addressGoogleMaps: Dados geográficos completos
- isDefault: Flag de endereço principal
Exemplo de solicitação:
PUT /company/address/507f1f77bcf86cd799439011
{
name: Escritório Central Atualizado,
company_name: CargoOffer SL,
phone: +34987654321,
addressGoogleMaps: {
formatted_address: Avenida Principal, 456, 28080 Madrid, Espanha,
geometry: {
location: {
lat: 40.456789,
lng: -3.654321
}
}
},
isDefault: true
}
Exemplo de resposta bem-sucedida:
{
_id: 507f1f77bcf86cd799439011,
name: Escritório Central Atualizado,
company_name: CargoOffer SL,
phone: +34987654321,
street: Avenida Principal, 456,
city: Madrid,
zipcode: 28080,
country: ES,
location: {
type: Point,
coordinates: [-3.654321, 40.456789]
},
isDefault: true,
can_be_deleted: false
}
Casos de erro comuns:
- 400: Dados de entrada inválidos ou incompletos
- 401: Token JWT
Request
Responses
- 200
- 400
- 401
- 403
- 404
Endereço atualizado corretamente
Response Headers
Dados de entrada inválidos
Response Headers
Não autorizado (token JWT inválido ou ausente)
Response Headers
NÃO_PERMITIDO - O endereço não pertence a esta empresa
Response Headers
Endereço não encontrado