manual de integração de clientes entre o sistema teceo e Linx.
encontre no manual:
1. introdução
2. acessando a área de integração
3. configuração da integração de clientes
3.1 campos de configuração
3.2 flags para importação e exportação
4. testes em homologação
4.1 homologação de exportação de clientes
4.1.1 teste de criação simples
4.1.2 teste de exportação com dois representantes
4.1.3 teste de exportação com dois endereços
4.1.4 teste de exportação com cnpj existente
4.1.5 teste de faturamento de pedido
4.2 homologação de importação de clientes
4.2.1 teste de importação de novo cliente
4.2.2 teste de importação de cliente com status “inativo”
4.2.3 teste de importação com endereços duplicados
4.3 homologação de atualização de dados de clientes.
4.3.1 teste de modificação de dados no Linx
5. validação de integração
5.1 identificação do histórico de sincronização
5.2 validação de erros de sincronização
5.3 sucesso de integração
6. considerações finais
1. introdução:
este manual descreve o processo de integração entre o sistema teceo e o Linx, detalhando as etapas necessárias para configurar, testar e validar a importação e exportação de clientes.
2. acessando a área de integração:
no integrador, acesse o módulo de sincronização de clientes.
para identificar o integrador e realizar as configurações iniciais, consulte o manual de acesso ao integrador: acessar o integrador linx.
3. configuração da integração de clientes:
nesta etapa, você configurará a sincronização de clientes entre a teceo e o Linx, escolhendo as direções de integração: exportação (teceo para Linx), importação (Linx para teceo) ou ambas, conforme a necessidade da marca.
- exportação (ida): envia automaticamente os dados dos clientes cadastrados na teceo para o Linx. ideal para iniciar e atualizar cadastros de clientes no Linx, evitando retrabalho.
- importação (volta): permite que os dados de clientes gerenciados no Linx sejam sincronizados com a teceo, mantendo as informações atualizadas na plataforma sem intervenção manual.
- ambas as direções: ativa a sincronização bidirecional entre teceo e Linx, atualizando qualquer mudança no cadastro de clientes em ambos os sistemas.
a seguir, verifique os principais campos e flags que devem ser configurados para garantir que a integração funcione corretamente de acordo com o fluxo de dados escolhido.
3.1 campos para configuração
campos para exportação (teceo para Linx):
- filial: determina a qual filial o cliente exportado estará associado no Linx.
- pontualidade: campo específico do Linx. (campo obrigatório de preenchimento)
- transportadora: específica a transportadora padrão que será atribuída ao cliente no linx durante a exportação.
- indicador fiscal terceiro: campo específico do Linx.
- conta contábil: campo específico do Linx (usado somente na exportação de clientes, para inserir a conta contábil no cadastro do mesmo).
- tipo de bloqueio padrão: indica o tipo de bloqueio que será configurado para o cliente no linx.
- conceito: campo específico do Linx. (campo obrigatório de preenchimento).
- forma de pagamento padrão: configura a forma de pagamento padrão atribuída ao cliente no momento da exportação.
- lista de status cancelado do cliente: mapeia os status que definem um cliente como cancelado para a correta sincronização com o linx.
campos para importação (Linx para teceo):
- tipo do cliente: define a classificação do cliente importado do linx para a teceo.
3.2 flags para importação e exportação:
há também flags que determinam se a importação e exportação de clientes será ativa ou não, tais como:
- importação automática de clientes: ativar para que a importação ocorra de forma automática.
observação: a importação de clientes só ocorrerá para clientes do tipo configurado no campo “tipo do cliente” e que o representante esteja previamente cadastrado na teceo.
- exportar cliente ativo: ativar para exportar de forma automática clientes com o status de “ativo”.
4. testes em homologação:
nesta etapa, o time da teceo, em colaboração com o t.i. e o gerente de projetos da marca (designados no início do contrato), realizarão os testes no ambiente de homologação. esse processo colaborativo visa garantir que as informações estejam sendo enviadas e recebidas corretamente entre os dois sistemas, validando todos os fluxos de integração.
importante: para que a exportação e a importação de clientes entre a teceo e o Linx ocorram automaticamente, alguns requisitos são necessários:
exportação automática (teceo para Linx):
- cadastrar o cliente com todos os dados gerais;
- inserir o endereço (o mesmo deve ser o endereço principal);
- vincular um representante principal (essa vinculação deve ser feita por um administrador);
- definir o status do cliente conforme o configurado no campo "status do cliente para sincronização" dentro do integrador da teceo;
- não possuir um cnpj de um cliente já existente no Linx;
- apenas clientes com cnpj podem ser exportados; clientes com cpf ou internacionais não são exportados.
importação automática (Linx para teceo):
a importação de clientes do Linx para a teceo ocorre a cada 1 hora, respeitando os seguintes critérios:
- o cliente no Linx deve possuir a classificação correta, configurada de acordo com os códigos previamente definidos no integrador da teceo;
- o representante deve estar previamente cadastrado na teceo;
- o cliente deve estar vinculado a um representante no Linx.
4.1 homologação de exportação de clientes:
nesta fase, serão realizados testes específicos para validar a integração de clientes entre a teceo e o Linx. cada teste tem um objetivo claro e descreve o resultado esperado para garantir que a exportação dos dados de clientes funcione corretamente.
testes e validações gerais:
▪️4.1.1 teste de criação simples
crie um cliente com todos os dados cadastrais obrigatórios, incluindo:
- nome;
- cnpj;
- endereço principal;
- representante.
procedimento de validação: a marca deve acessar o Linx e verificar se o cliente foi exportado com todos os dados corretos e completos.
objetivo do teste: validar que todos os dados do cliente são exportados corretamente e sem falhas.
▪️4.1.2 teste de exportação com dois representantes
crie um cliente na teceo e insira dois representantes na área de representantes do cliente.
procedimento de validação: verifique no Linx se ambos os representantes foram exportados corretamente e associados ao cliente.
objetivo do teste: confirmar que é possível exportar múltiplos representantes e que estes são corretamente integrados ao Linx.
▪️4.1.3 teste de exportação com dois endereços
crie um cliente com dois endereços, onde um seja do tipo “comercial” e o outro seja “entrega” ou “cobrança”.
procedimento de validação: verifique no Linx se ambos os endereços foram exportados corretamente, respeitando o tipo de endereço designado.
objetivo do teste: validar a exportação de múltiplos endereços distintos e assegurar que o sistema não aceita endereços duplicados do mesmo tipo (o que deve gerar um erro).
▪️4.1.4 teste de exportação com cnpj existente
tente criar um cliente com um cnpj já cadastrado no Linx.
procedimento de validação: verifique se a exportação falha e o sistema retorna um erro, impedindo a duplicação de clientes com o mesmo cnpj.
objetivo do teste: garantir que o sistema não permite a criação de clientes duplicados, respeitando o controle de unicidade de cnpj.
▪️4.1.5 teste de faturamento de pedido
fature um pedido de um cliente previamente integrado entre a teceo e o Linx.
procedimento de validação: acompanhe no Linx se o pedido foi atualizado e faturado corretamente.
objetivo do teste: validar o processo de faturamento de pedidos para clientes integrados, assegurando que o faturamento é refletido corretamente no Linx.
observações:
- os dados de contato, mídias, tabela de preço e grupo de clientes não são exportados na integração.
- somente representantes dos clientes são exportados; vendedores e guias não são incluídos.
4.2 homologação de importação de clientes:
nesta seção, serão executados testes específicos para verificar a integração de clientes entre a teceo e o Linx. cada teste tem um objetivo definido e descreve o resultado esperado, assegurando que a importação de dados de clientes ocorra conforme o planejado.
testes e validações gerais:
▪️ 4.2.1 teste de importação de novo cliente
importe um novo cliente do Linx para a teceo.
procedimento de validação: após a importação, verifique na teceo se todos os dados do cliente (nome, cnpj, endereço, representante) foram recebidos e exibidos corretamente.
objetivo do teste: confirmar que novos clientes criados no Linx são importados para a teceo com todos os dados corretamente mapeados.
▪️4.2.2 teste de importação de cliente com status “inativo”
importe um cliente do Linx para a teceo com o status “inativo”.
procedimento de validação: verifique se a teceo importa o cliente corretamente, e observe como o status “inativo” é tratado dentro do sistema.
objetivo do teste: avaliar como a teceo lida com clientes importados como inativos, garantindo a consistência do status entre os sistemas.
▪️4.2.3 teste de importação com endereços duplicados
tente importar um cliente do Linx que possui dois endereços do mesmo tipo (por exemplo, dois endereços comerciais).
procedimento de validação: confirme se a importação gera um erro devido à duplicidade de tipos de endereço, impedindo a entrada de dados conflitantes.
objetivo do teste: assegurar que o sistema detecta e rejeita endereços duplicados, mantendo a consistência dos dados de clientes.
observação:
- validar o tipo do cliente integrado, que deve importar de acordo com o tipo configurado no integrador.
4.3 homologação de atualização de dados de clientes:
testes e validações gerais:
▪️4.3.1 teste de modificação de dados no Linx
solicite ao cliente que faça uma modificação em um cliente já existente no Linx, como atualização de nome, endereço ou representante (este último deve estar previamente cadastrado na teceo).
procedimento de validação: após a modificação, verifique na teceo se as alterações feitas no Linx foram corretamente integradas e atualizadas.
objetivo do teste: confirmar que qualquer atualização feita no Linx é sincronizada automaticamente com a teceo, mantendo a consistência dos dados entre os dois sistemas.
observações:
- com a importação ativa, as alterações realizadas no Linx serão refletidas automaticamente na teceo a cada ciclo de importação.
- após a sincronização de um cliente, seus dados ficam bloqueados para edição na teceo, e todas as atualizações devem ser feitas diretamente no Linx.
5. validação de integração
nesta seção, você validará as possíveis mensagens de erro ou de êxito na integração, e a partir delas acompanhar o processo ou corrigi-lo.
5.1 identificação do histórico de sincronização:
1. no menu lateral, clique em clientes.
2. identifique o cliente que deseja verificar e clique sobre o ícone de integração.
3. outra forma de acessar o histórico de sincronização seria pelo cadastro do cliente. para identificá-lo, acesse o cliente que deseja e já dentro de seu cadastro, clique sobre o ícone de integração.
5.2 validação de erros de sincronização:
com o histórico de sincronização acessado, em caso de erros de sincronização, o ícone ficará em vermelho, e mostrará o motivo da falta de integração. 
5.3 sucesso de integração:
no mesmo local, quando a integração for bem-sucedida, o ícone ficará em verde, e mostrará a mensagem de “sucesso”.
5.4 sincronização manual:
caso o cliente tenha tido algum erro de exportação (e que foi corrigido), você pode forçar uma sincronização manual. para isso, no “histórico de sincronização do cliente”, clique sobre a opção “forçar sincronização”, onde o cliente será enviado para uma fila de importações para ser reprocessado. 
6. considerações finais:
este manual foi desenvolvido para orientar a integração dos dados de clientes entre Linx e teceo, abordando desde a validação inicial até os testes específicos de exportação e importação. para garantir o sucesso da integração, considere as seguintes orientações:
- revisão e ajustes: após os testes de homologação, revise as configurações e realize ajustes necessários, alinhando todos os detalhes com o time da teceo para garantir que os dados de clientes estejam corretamente sincronizados.
- monitoramento em produção: após a ativação da integração, recomendamos um acompanhamento inicial para assegurar que os dados de clientes sejam sincronizados corretamente no ambiente de produção.
- suporte contínuo: a equipe da teceo está disponível para auxiliar com qualquer dúvida ou ajuste que a marca possa precisar, assegurando a continuidade e o sucesso da integração dos dados de clientes.