Relacionamento de Atributos

Relacionamento de atributos

Você pode personalizar via admin o relacionamento de campos entre a sua aplicação e a nossa API, por padrão os valores esperados são setados na instalação do módulo como:

Moip	Magento	Validação Requerida	Tipo de dados esperado
Nome	firstname + lastname	Obrigatório	String
Email	email	Obrigatório	email
CPF/CNPJ	vat_id	Obrigatório e validado	Int
Telefone	telephone	Obrigatório e validado	Int
CEP	zipcode	Obrigatório e validado	Int
Logradouro	street_1	Obrigatório	string
Número	street_2	Obrigatório	int
Bairro	street_3	Obrigatório	string
Complemento	street_4	Opcional	string

No seu admin você pode alterar esse relacionamento de atributos, para isto vá em Lojas -> Configurações -> Métodos de pagamento -> Moip Base Abra a sessão Configuração Avançada e altere o relacionamento.

Definir atruibuto relacionado

Nesse processo você poderá definir de onde obtem os atributos de cpf, cnpj, nome da empresa, podendo estes serem obtidos do formulário de criação de conta (customer) ou do formulário de checkout (address, tanto shipping como o billing).

Esse processo permite apenas alterar o relacionamento e não a validação que esperamos receber dos atributos.

Dicas úteis

Captura do CPF/CNPJ

Há 2 possibilidades de uso de campos nativos para gravar o CPF/CNPJ do cliente são elas:

• O atributo vat_id relacionado ao checkout.
• O atributo taxvat relacionado ao cadastro de cliente.

CPF/CNJP no checkout

Você pode utilizar o vat_id para receber o campo CPF/CNPJ, nesse caso o atributo é de endereço e torna possível usar o checkout anonimo bem como outras ferramentas para otimizar a experiência do usuário.

Esse é o método mais recomendavel.

CPF/CNPJ no cadastro

O primeiro passo é deixar de permitir o checkout anonimo:

Em seguida torne obrigatório preenchimento do taxvat:

Endereço

Após a instalação do Magento os valores pré-definidos do endereço são de 2 linhas, nossa sugestão é para que altere para 4 linhas, esse processo pode ser feito em:

E termine em nosso módulo a seguinte configuração:

1ª Posição do array de endereço receberá o logradouro

2ª Posição do array de endereço receberá o número

3ª Posição do array de endereço receberá o bairro

4ª Posição do array de endereço receberá o complemento

Note que no magento 2 quando a posição de um array não for preenchida, ao contrario do magento 1, ela não é "preservada" ficando o item subsequente como a posição do item não preenchido, exemplo se colocar o completo como posição 3 e não preencher ao preencher a posição 4 como um bairro o Magento irá gravar no index 3 o valor do campo 4, por isto a recomendação.