Configurar / Usar isoCRM_vtex
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
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_NAME_ENDERECO
DATA_ENTITY_NAME_CLIENTE
ACCOUNT_NAME_VTEX
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_NAME_ENDERECO - É o nome da pasta dentro da vtex que representa dados de endereço do Cliente, normalmente é AD
DATA_ENTITY_NAME_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
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 300 registro de clientes,( neste momento o sistema apenas esta reunindo os clientes )
Vermelho - Alguns cadastro dentro da VTEX não possui Documento, o motor irá descriminar no arquivo de log estes casos. Esta é a única exigência para inserir um cadastro dentro do Iso
Azul - Se existiir pelo menos um documento no cadastro dentro da VTEX com certeza será inserido dentro da Iso
Ao final desse processamento, os clientes já devem estar cadastrados no Iso.
Onde conferir se a importação funcionou?
Podemos usar o próprio cadastro que funcionou no exemplo anterior.( Azul )
Dentro do iso em Cadastro > filtre por e-mail e informe o e-mail mostrado no log.
