manual de integração de produtos 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 produtos
3.1. campos de configuração
3.2. flags para configuração
4. testes em homologação
4.1. homologação de integração de produtos
4.1.1. teste de alteração de observação e nome
4.1.2. teste de alteração de variações (cor e tamanho)
4.1.3. teste de alteração de categoria e coleção
4.1.4. teste de alteração de preço e código de barras
4.1.5.teste de alteração de classificações (triggers)
5. validação de integração
5.1. identificação do histórico de importações
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 de produtos entre o sistema teceo e o Linx, detalhando as etapas necessárias para configurar, testar e validar a importação e exportação de dados de produtos.
2. acessando a área de integração:
no integrador, acesse o módulo de sincronização de produtos. 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 produtos:
nesta seção, vamos configurar a sincronização de produtos entre a teceo e o Linx, definindo as principais configurações para garantir que a integração funcione de forma completa e automática.
critérios para importação de produtos do Linx para a teceo
para que os produtos sejam importados corretamente do Linx para a teceo, é necessário que as seguintes condições estejam atendidas no ERP:
- o campo "envia_loja_atacado" deve estar como sim;
- o campo "inativo" do produto deve estar como não;
- o produto deve possuir vínculo com as tabelas de preço que estão configuradas no integrador da teceo;
- o produto-barra precisa estar devidamente gerado no Linx;
- o status do produto deve estar definido como liberado (código 3 no Linx);
- a griffe do produto (se utilizada) deve estar mapeada corretamente na teceo.
caso qualquer uma dessas condições não esteja atendida, o produto não será importado para a teceo.
principais características da integração de produtos:
-
sincronização completa: todos os dados do produto são importados e sincronizados, incluindo descrição, características, tamanhos e cores.
-
controle pelo Linx: uma vez que os dados do produto estejam integrados, eles só podem ser alterados pelo ERP (Linx). dessa forma, a teceo mantém a integridade das informações sem necessidade de alterações manuais.
-
restrição para tamanhos e cores: após a sincronização de um produto, dados como tamanhos e cores não poderão ser alterados.
-
integração por triggers: a integração de produtos entre a teceo e o Linx acontece por meio de triggers, que são responsáveis por iniciar o processo de importação e atualização dos produtos.
-
as triggers devem ser personalizadas para atender às necessidades específicas de cada marca.
-
abaixo estão os principais campos que devem ser configurados para garantir que a integração funcione corretamente:
3.1 campos para configuração:
- tabelas de preço: indica as tabelas de preço que serão atualizadas durante a importação de produtos.
observação: caso não esteja ativa, não importará o produto.
- tabela de preço sell-out padrão: indica qual será a tabela de preço sell-out padrão nos skus dos produtos dentro da teceo. você pode inserir qualquer código de tabela de preço que esteja ativa. campo obrigatório.
- griffe: a griffe é utilizada para filtrar os produtos que serão importados dentro da teceo.
- classificações: define quais classificações dos produtos que serão importadas dentro da teceo.
observação: para o funcionamento correto das classificações, assim que forem definidas, uma view deverá ser criada e aplicada no ambiente do cliente.
- cores fabricante: um produto é definido como ATIVO para pré-venda na teceo observando o campo COR-FABRICANTE presente em PRODUTO-COR na tabela da Linx.
- tipo de código de barras: a importação dos skus dos produtos será feita de acordo com o tipo de código de barras escolhido. Exemplo: Se o tipo de código de barras for "GTIM", o sku usará o código de barras do tipo "GTIM". Só é possível cadastrar um código de barras por sku.
3.2 flags para configuração:
- sincronização automática de produtos: atualiza todos os produtos importados que sofreram alguma modificação desde a última importação realizada com sucesso, ou então, adiciona novos produtos que foram adicionados após a última importação realizada com sucesso.
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 corretamente entre os dois sistemas, validando todos os fluxos de integração.
4.1 homologação de integração de produtos:
nesta seção, detalhamos os passos e validações para configurar e homologar a importação de produtos do Linx para a teceo, garantindo a atualização automática das informações de produtos.
observação: a validação para atualização dos produtos ocorre a cada 10 minutos, garantindo uma sincronização contínua e segura dos dados.
testes e validações gerais:
▪️ 4.1.1 teste de alteração de observação e nome
no Linx, realize as seguintes alterações em um produto:
- altere o nome;
- modifique a observação.
procedimento de validação: acesse a teceo e confirme se a observação e o nome foram atualizados corretamente.
objetivo do teste: garantir que as alterações de observação e nome no Linx sejam refletidas com precisão na teceo.
▪️4.1.2 teste de alteração de variações (cor e tamanho)
no Linx, realize as seguintes alterações em um produto:
- adicione uma cor;
- inative um tamanho.
procedimento de validação: verifique na teceo se as alterações nas variações do produto foram sincronizadas corretamente.
objetivo do teste: validar que a importação de variações de produtos é realizada sem falhas.
▪️ 4.1.3 teste de alteração de categoria e coleção
no Linx, altere os seguintes atributos de um produto:
- categoria;
- coleção.
procedimento de validação: acesse a teceo e verifique se a categoria e a coleção do produto foram atualizadas corretamente.
objetivo do teste: assegurar que as mudanças de categoria e coleção no Linx são refletidas com exatidão na teceo.
▪️ 4.1.4 teste de alteração de preço e código de barras
no Linx, altere os seguintes atributos de um produto:
- código de barras;
- preço de sell-in e sell-out.
procedimento de validação: acesse a teceo e verifique se as alterações foram atualizadas corretamente.
objetivo do teste: assegurar que as mudanças no Linx são refletidas com exatidão na teceo.
▪️ 4.1.5 teste de alteração de classificações (triggers)
no Linx, altere as classificações mapeadas que serão tragas dos produtos.
procedimento de validação: acesse a teceo, e aguarde que o ciclo de atualização ocorra. após isso, valide se as alterações foram atualizadas corretamente.
objetivo do teste: assegurar que as alterações das classificações no Linx são refletidas com exatidão na teceo.
importante: para esta validação, o ideal é que seja feito uma bateria de testes, cadastrando, no mínimo, 3 produtos para cada teste individualmente.
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 importações:
a) no integrador da teceo, clique em importações.
b) será mostrado, em tela, uma lista das últimas importações realizadas, juntamente com a data e hora da importação, o tipo (clientes, produto etc) e status (concluído, concluído parcialmente, processando ou erro).
5.2 validação de erros de sincronização:
com o histórico de integração acessado, em caso de erros de sincronização, o ícone ficará em vermelho, e ao clicar sobre o código, mostrará o motivo da falta de integração. 
5.3 sucesso na integração:
no mesmo local, quando a integração for bem-sucedida, o ícone ficará em verde, e mostrará a mensagem de “concluído”. 
5.4 sincronização manual:
caso precise sincronizar um produto ou uma coleção de imediato, pode utilizar a sincronização manual. para isso, acesso o módulo de produtos, do integrador, e selecione as coleções/produtos a serem sincronizados. após isso, clique em “sincronizar”, onde o processo será enviado a uma fila de processamento que pode variar o tempo de importação de acordo com o número de itens enviados ou tamanho da fila.
6. considerações finais:
este manual visa guiar a integração dos produtos entre Linx e teceo, abrangendo desde a configuração inicial até os testes específicos de importação.
abaixo estão algumas orientações finais para garantir o sucesso da integração:
-
revisão e ajustes: após os testes de homologação, é recomendável revisar as configurações e realizar ajustes conforme necessário, alinhando todos os detalhes com o time da teceo.
-
monitoramento em produção: após a ativação da integração, sugerimos um acompanhamento inicial para garantir que os produtos sejam sincronizados corretamente no ambiente real.
-
suporte contínuo: a equipe da teceo está disponível para auxiliar em dúvidas ou ajustes futuros que a marca possa precisar, garantindo a continuidade do processo.