Contatos do colaborador

As pessoas de contato ligadas ao cadastro do colaborador. A tela Colaboradores não tem aba de contatos; os campos de contato da pessoa ficam no formulário do colaborador.

Use o customer_vendor.uuid do colaborador (o uuid do cadastro da pessoa, não o do colaborador) nos caminhos abaixo.

Endpoints

Método	Caminho	Descrição
GET	/administrative/employees/{customer_vendor_uuid}/contacts	Lista os contatos
POST	/administrative/employees/{customer_vendor_uuid}/contacts	Cadastra um contato
GET	/administrative/employees/{customer_vendor_uuid}/contacts/{id}	Consulta um contato
PUT	/administrative/employees/{customer_vendor_uuid}/contacts/{id}	Altera um contato
DELETE	/administrative/employees/{customer_vendor_uuid}/contacts/{id}	Apaga um contato

O {id} é o id numérico do contato.

Endpoints de contatos

GET /administrative/employees/{customer_vendor_uuid}/contacts

Lista os contatos do cadastro.

Parâmetros de URL

Parâmetro	Descrição
search	Busca pelo nome do contato
select_email	Quando informado, devolve só id, name e email
select_cellphone	Quando informado, devolve só id, name e cellphone
per_page e page	Paginação

Resposta: 200, lista de contatos com id, customer_vendor_id, name, email, phonenumber e cellphone.

POST /administrative/employees/{customer_vendor_uuid}/contacts

Cadastra um contato.

Corpo

Campo	Obrigatório	Tipo	Descrição
name	Sim	Texto	Nome da pessoa de contato
email	Não	Texto	E-mail do contato
cellphone	Não	Texto	Celular do contato
phonenumber	Não	Texto	Telefone do contato

Resposta: 201, com o contato criado.

GET /administrative/employees/{customer_vendor_uuid}/contacts/{id} e DELETE /administrative/employees/{customer_vendor_uuid}/contacts/{id}

Consultar e apagar um contato. A exclusão é lógica.

Resposta: 200.

PUT /administrative/employees/{customer_vendor_uuid}/contacts/{id}

Altera um contato. Envie somente os campos que mudam, com os mesmos campos da criação.

Resposta: 200, com o contato alterado.