Criar cliente

Cria um novo cliente na plataforma Magento Adobe Commerce.

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	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

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).

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.

{
   "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