# Criar cliente
{% tabs %}
{% tab title="Parâmetros" %}
| Campo | Tipo | Descrição |
| ------------------------------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição | Campo de texto | Descrição visual do conector na construção do fluxo. |
| [Conta de serviço](#user-content-fn-1)[^1] | Seletor | Permite selecionar uma conta de serviço do tipo Bearer Token, cadastrada no Workspace Floui, para realizar a conexão e autenticação com o ambiente Adobe Commerce Magento. |
| ID do grupo de clientes | Campo de texto | Identificador do grupo de clientes (Customer Groups). O grupo de clientes é usado para segregar clientes do e-commerce para aplicação de regras customizadas. |
| Primeiro nome | Campo de texto | Primeiro nome do cliente. |
| Ùltimo nome | Campo de texto | Ùltimo nome do cliente. |
| E-mail | Campo de texto | E-mail do cliente. |
| Documento legal (Taxvat/CPF/CNPJ) | Campo de texto | Número de documento do cliente. Com ou sem pontuações |
| Data de nascimento | Campo de texto | Data de nascimento do usuário no formato YYYY-MM-DD. |
| Gênero | Seletor |
Permite selecionar o gênero do cliente. Entre:
Masculino.
Feminino.
Não especificado.
|
| Aceite de assinatura newsletter | Seletor | Define se o usuário está ou não sujeito a receber e-mails de newsletter do e-commerce. |
| Aceite de assistência remota | Seletor | Define se o usuário permite ou não o acesso a sua conta por administradores Magento para assistência remota. |
| Definir valor de senha | Campo de texto | Define o valor de senha do usuário. Caso deixe vazio o usuário deverá configurar uma nova senha através da recuperação de senha. |
| Nome do meio (middlename) | Campo de texto | Nome que será adicionado após o prefixo do nome e o primeiro nome do cliente. \[Prefixo] \[Primeiro Nome] \[Meio] \[Ultimo Nome] |
| Atributos customizados | Tabela de parâmetros | Refere-se a atributos específicos e personalizados do cliente, além dos atributos padrão. Configurado no formato de Chave e Valor. \[custom\_attributes] |
| Sufixo (suffix) | Campo de texto | Sufixo que será adicionado após o último nome. Exemplo: \[Prefixo] \[Primeiro Nome] \[Meio] \[Ultimo Nome] \[Sufixo] |
| Prefixo (prefix) | Campo de texto | Prefixo que será adicionado ao antes do primeiro nome. Exemplo: \[Prefixo] \[Primeiro Nome] \[Meio] \[Ultimo Nome] \[Sufixo] |
| ID do endereço de cobrança padrão | Campo de texto | Refere-se ao identificador do endereço de cobrança do usuário. O endereço é uma entidade separada que é atribuída a um cliente. |
| ID do endereço de entrega padrão | Campo de texto | Refere-se ao identificador do endereço de entrega do usuário. O endereço é uma entidade separada que é atribuída a um cliente. |
| Lista com endereços (objeto JS/JSON) | Campo de texto | Permite informar o caminho da lista com os dados de endereços do cliente, localizado dentro do objeto msg. |
| Código de visão de loja | Campo de texto | Código identificador da visão de loja do website em que o usuário será criado. |
| ID do website | Campo de texto | Identificador do website em que o usuário será criado. |
| Output Path | Campo de texto | Refere-se ao caminho do resultado da requisição na saída do conector no contexto de execução do fluxo |
| {% endtab %} | | |
{% tab title="Payload" %}
## Detalhes
O conector Criar Cliente oferece uma interface simples para o cadastro de um cliente no e-commerce por meio da API REST.
O conector utiliza o endpoint **POST** `/rest/V1/customers`. Para saber mais sobre esta ou outras APIs disponibilizadas para Adobe Commerce Magento, acesse o link [REST endpoints (ReDocly)](https://developer.adobe.com/commerce/webapi/rest/quick-reference/).
## Endereços
Para adicionar uma lista de endereços a um cliente é necessário que o JSON com os dados do endereço siga um padrão específico. Segue um exemplo da estrutura para inserir uma lista de endereços durante o cadastro de clientes. No caso abaixo o JSON está no caminho `msg.user_address`, logo, na configuração **Lista com endereços (objeto JS/JSON)** será necessário passar o caminho `msg.user_address.addresses`.
```json
{
"addresses":[
{
"firstname":"João",
"lastname":"Silva",
"street":[
"Rua XV de Novembro, 1234"
],
"city":"Curitiba",
"region":{
"region_code":"PR",
"region":"Paraná",
"region_id":502
},
"country_id":"BR",
"postcode":"80020-310",
"telephone":"41987654321",
"default_shipping":true,
"default_billing":false
}
]
}
```
## Sucesso
Quando a requisição for bem-sucedida, a resposta conterá todos os dados de cadastro do usuário, além do identificador único do seu cadastro no e-commerce.
Sucesso na criação de clientes
## Erros
Por ser uma rota com vários atributos para preenchimento, poderá haver diversos cenários de erro. Nestes casos a API retornará uma mensagem de erro informando insucesso na criação.
Erro ao criar usuário
{% endtab %}
{% endtabs %}
[^1]: A conta de serviço precisa ser adicionada no painel de configuração do Floui antes de ser selecionada dentro do componente.
