Contatos do fornecedor
As pessoas de contato de um fornecedor. Correspondem à aba Contatos, na tela Fornecedores.
Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| GET | /administrative/vendors/{customer_vendor_uuid}/contacts | Lista os contatos do fornecedor |
| POST | /administrative/vendors/{customer_vendor_uuid}/contacts | Cadastra um contato |
| GET | /administrative/vendors/{customer_vendor_uuid}/contacts/{id} | Consulta um contato |
| PUT | /administrative/vendors/{customer_vendor_uuid}/contacts/{id} | Altera um contato |
| DELETE | /administrative/vendors/{customer_vendor_uuid}/contacts/{id} | Apaga um contato |
O {customer_vendor_uuid} é o uuid do fornecedor. O {id} é o id numérico do contato.
Endpoints de contatos
GET /administrative/vendors/{customer_vendor_uuid}/contacts
Lista os contatos do fornecedor.
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/vendors/{customer_vendor_uuid}/contacts
Cadastra um contato no fornecedor.
Corpo
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| name | Sim | Texto | Nome da pessoa de contato |
| 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/vendors/{customer_vendor_uuid}/contacts/{id} e DELETE /administrative/vendors/{customer_vendor_uuid}/contacts/{id}
Consultar e apagar um contato. A exclusão é lógica.
Resposta: 200.
PUT /administrative/vendors/{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.