Embedded Files
Para que serve esse sistema?
Para que serve esse sistema?
Este sistema é projetado para integrar o e-commerce VTEX ao sistema Iso, utilizando o motor isoCRM_vtex. Atualmente, a integração permite a importação de dados de clientes e seus respectivos endereços. No entanto, apenas cadastros que contêm CPF ou CNPJ são importados.
Estamos utilizando a versão 2 da API da VTEX. Antes de realizar qualquer requisição, é necessário que o cliente conceda permissão para os tokens nas rotas GET através do painel de administração que apenas o cliente tem acesso.
Para mais detalhes, consulte a documentação da API da VTEX.
Preparando o terreno
Preparando o terreno
1 - É preciso criar um usuário específico para esse motor dentro do Iso.
2 - Cadastre 5 parametros.
Estes parametros devem ser fornecidos pelo cliente
X-VTEX-API-AppKey
X-VTEX-API-AppToken
DATA_ENTITY_ENDERECO
DATA_ENTITY_CLIENTE
ACCOUNT_NAME_VTEX
VTEX_CLASSIFICACAO
VTEX_ESPECIALIDADE
VTEX_SITUACAO
VTEX_INTEGRACAO_ORIGEM
VTEX_INTEGRACAO_EMAIL
VTEX_INTEGRACAO_CPF
3 - Entedendo cada parametro :
X-VTEX-API-AppKey - É um token que é gerado na área adm do cliente
X-VTEX-API-AppToken - É um token que é gerado na área adm do cliente
DATA_ENTITY_ENDERECO - É o nome da pasta dentro da vtex que representa dados de endereço do Cliente, normalmente é AD
DATA_ENTITY_CLIENTE - É o nome da pasta dentro da vtex que representa dados de clientes, normalmente é CL
ACCOUNT_NAME_VTEX - É o nome da conta do cliente dentro da vtex
VTEX_CLASSIFICACAO - É o nome da Classificação que será cadastrada no cadastro do cliente
VTEX_ESPECIALIDADE - É o nome da Especialidade que será cadastrada no cadastro do cliente
VTEX_SITUACAO - É o nome da situação que será cadastrada no cadastro do cliente
VTEX_INTEGRACAO_ORIGEM - É o nome da origem que será cadastrada no sistema
VTEX_INTEGRACAO_EMAIL -
A = significa que caso o cadastro dentro da vtex não tenha documento, ele será cadastrado como estrangeiro .
I = Caso não tenha documento cadastrado ele não irá cadastrar no sistema
VTEX_INTEGRACAO_CPF
A = Significa que para realizar o cadastro é obrigatório o cliente dentro da vtex ter um documento cadastrado
I = Caso não tenha documento cadastrado, não irá cadastrar no sistema
Como usar?
Como usar?
1 - Entedendo os principais parametros
Ao executar o sistema pela primeira vez, um arquivo chamado isoCRM_vtex_config.json será gerado localmente.
Configure os seguintes itens de acordo com as informações do cliente:
URL
USERNAME
USER_PASSWORD
EMP_CODE
Observe que existem os itens data_inicial, hora_inicial e dias_corridos_para_ler. O funcionamento é o seguinte:
Se data_inicial e hora_inicial estiver configurada como 10/09/2024 as 15:22 e dias_corridos_para_ler estiver definido como 5, o sistema buscará registros na base de dados da VTEX a partir do dia 10/09 até o dia 15/09.
Após o término do período de leitura (ou seja, após o dia 15/09, conforme o exemplo), o sistema realizará automaticamente uma nova análise. Ele calculará a próxima data a partir do dia 15/09, adicionando o número de dias definido em dias_corridos_para_ler (que é 5 neste caso).
Assim, o sistema buscará registros novamente a partir do dia 20/09.
Além disso, o sistema atualizará automaticamente o arquivo isoCRM_vtx_config.json com a nova data_inicial e hora_inicial, baseando-se na data de criação do cliente mais recente encontrada na base de dados da VTEX. Isso garante que o sistema sempre trabalhe com os dados mais atualizados.
time_sleep significa que a cada ciclo re consulta o sistema irá dormir X minutos.
No exemplo da imagem ele irá dormir de 1 em 1 minuto a cada processamento de de 5 dias
2 - Interpretando o log
Durante a execução do sistema, o log exibirá informações como o número de clientes encontrados na base de dados da VTEX. Além disso, qualquer erro ocorrido durante a inserção no Iso será registrado e detalhado.
Verde - Isso significa que o sistema achou ao total de 500 registro de clientes,( neste momento o sistema apenas esta reunindo os clientes )
Vermelho - O Cadastro foi inserido com sucesso!
Azul - É OBRIGATÓRIO o cadastro ter registro de nome dentro da vtex, caso não tenha dentro da vtex NÃO SERA IMPORTADO PARA O SISTEMA
Ao final desse processamento, os clientes já devem estar cadastrados no Iso.
Amarelo - Caso exista nome cadastrado e e-mail dentro da vtex, mas não exista documento, ele será cadastrado como extrangeiro
Caso o cadastro ja exista no sistema, ele não será inserido no sistema.
o motivo de existir 2 registro de log VTEX_INTEGRACAO_CPF e VTEX_INTEGRACAO_EMAIl é pelo motivo de que dentro dos parametros estão definidos como A
Onde conferir se a importação funcionou?
Onde conferir se a importação funcionou?
Podemos usar o próprio cadastro que funcionou no exemplo anterior.( Vermelho )
Dentro do iso em Cadastro > filtre por e-mail e informe o e-mail mostrado no log.
Report abuse