Pular para o conteúdo principal

Como atualizar os dados de um cliente

É possível alterar o dados de um cliente, tanto via api, quanto via plataforma e o objetivo dessa documentação é mostrar como fazer isso.

info

Alguns dados sensíveis na documentação estarão mascarados por questões de segurança.

Via Plataforma

Para alterar os dados de um cliente via plataforma você precisa

1. Acessar a aba de Clientes

1 Select Customers Tab

2. Selecionar o cliente que deseja alterar

2 Select Customer

3. Clicar em qual campo você desejar alterar

3 Edit And Save Ao editar o campo não esqueça de clicar em salvar em cada campo.

Via API

Para alterar os dados de um cliente via API, você utiliza o endpoint /api/v1/customer/{correlationID} da API utilizando o método PATCH.

Para editar o cliente você precisa chamar a API informando o correlationID do cliente em que deseja alterar na URL, e no corpo da requisição você pode informar os campos name, email, phone, address and taxID.

info

O campo taxID é um campo que não pode ser editado do usuário, caso já possua valor. Ou seja, se o cliente já possuir um taxID cadastrado, não será possível alterá-lo. Caso precise editar o taxID de um usuário de qualquer maneira, o ideal é criar um novo cliente com o novo taxID.

Exemplo

No body da requisição, você precisa informar somente os campos que deseja alterar, caso não informe um campo, ele não será alterado.

Exemplo com taxID

{
"name": "Eduardo",
"taxID: "360.***.***-72"
}

Exemplo com email

{
"name": "Dan",
"email": "dan@gmail.com"
}

Exemplo com telefone

{
"name": "Dan",
"phone": "+554899..."
}

Exemplo com endereço

{
"address": {
"zipcode": "137...",
"street": "R...",
"number": "15",
"neighborhood": "Centro",
"city": "S...",
"state": "SP",
"complement": "Casa"
}
}

Após efetuar a requisição, se tudo ocorreu bem, o status code da requisição será 2xx e no body da resposta, retornaremos o cliente criado.

Retornarmeros a seguinte resposta de exemplo:

{
"customer": {
"name": "NOME DO CLIENTE",
"taxID": { "taxID": "360...", "type": "BR:CPF" },
"correlationID": "d1d46bbd-b010-4beb-b59e-cecf824efb43",
"address": {
"zipcode": "137...",
"street": "R...",
"number": "15",
"neighborhood": "Centro",
"city": "S...",
"state": "SP",
"complement": "Casa"
}
}
}

Consulte a documentação da API para mais informações sobre os campos e a resposta da requisição aqui: API