> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# integração de produtos - homologação

manual de integração de produtos entre o sistema teceo e Linx.

## 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.

## 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.](/integracoes/linx/acesso-ao-integrador)

## 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:

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-01.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=e1d1bd6e789363210d11e1ddcad048c4" alt="seção integração de produtos do integrador com os campos tabelas de preço, griffe, classificações, cores fabricante e tipo de código de barras, e a flag de integração automática" width="1636" height="848" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-01.png" />
</Frame>

### campos para configuração

**- tabelas de preço:** indica as tabelas de preço que serão atualizadas durante a importação de produtos.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-02.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=b58e149355375d7cc6bfefcdb6989fcb" alt="campo tabelas de preço com a observação de que as tabelas padrão já são consideradas na importação" width="816" height="140" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-02.png" />
</Frame>

<Note>
  caso não esteja ativa, não importará o produto.
</Note>

**- 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.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-03.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=49563c8d2c49964da026338a680bb32e" alt="campo tabela de preço sell-out padrão preenchido com o código 01" width="816" height="152" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-03.png" />
</Frame>

**- griffe:** a griffe é utilizada para filtrar os produtos que serão importados dentro da teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-04.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=f5d1f0e9bf64cffa6781c8f3fd59d649" alt="campo griffe com a descrição de que filtra os produtos importados dentro da teceo" width="816" height="140" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-04.png" />
</Frame>

**- classificações**: define quais classificações dos produtos que serão importadas dentro da teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-05.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=f3bd621671d6583c1472cf8ab8092999" alt="campo classificações com a descrição de que define quais classificações dos produtos são importadas" width="816" height="120" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-05.png" />
</Frame>

<Note>
  para o funcionamento correto das classificações, assim que forem definidas, uma view deverá ser criada e aplicada no ambiente do cliente.
</Note>

**- 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.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-06.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=148814843863cca6428edbb88fa55af3" alt="campo cores fabricante com a descrição do critério de produto ativo para pré-venda" width="816" height="140" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-06.png" />
</Frame>

**- 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.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-07.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=ebc0b8a91a68ef512a3b43d458728e10" alt="campo tipo de código de barras configurado como produto + cor + tamanho" width="816" height="188" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-07.png" />
</Frame>

### 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.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-08.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=336c21bbeb70fba342babf4d64467c5a" alt="campo de ativação da integração automática de produtos com a descrição do funcionamento" width="828" height="164" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-08.png" />
</Frame>

## 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.

### 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.

<Note>
  a validação para atualização dos produtos ocorre a cada 10 minutos, garantindo uma sincronização contínua e segura dos dados.
</Note>

**testes e validações gerais:**

#### 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.

#### 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.

#### 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.

#### 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.

#### 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.

<Warning>
  para esta validação, o ideal é que seja feito uma bateria de testes, cadastrando, no mínimo, 3 produtos para cada teste individualmente.
</Warning>

## 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.

### 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).

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-09.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=35bf9a5a0268d55ff6b2652b144bb468" alt="aba importações do integrador lynx server com a lista de histórico de importações de produtos e seus status" width="2100" height="1240" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-09.png" />
</Frame>

### 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.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-10.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=219c3d4230776967495dc4874e49212d" alt="aba importações com o ícone de erro em vermelho destacado na primeira linha da lista" width="1600" height="943" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-10.png" />
</Frame>

### 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”.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-11.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=67324779f8b107a46cc83fe1bdbe5eeb" alt="aba importações com o ícone de sucesso em verde destacado indicando importação concluída" width="1600" height="943" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-11.png" />
</Frame>

### 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.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-produtos-homologacao/img-12.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=765532b1a45dcafdd60758e116cb30c0" alt="seção de sincronização manual com os campos de seleção de coleções e produtos e os botões integrar destacados" width="2100" height="1240" data-path="images/integracoes/linx/integracao-de-produtos-homologacao/img-12.png" />
</Frame>

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.