> ## 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 estoque - homologação

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

## introdução

este manual descreve o processo de integração de estoques entre a teceo e o Linx, abordando as configurações, testes e validações necessárias para garantir a sincronização correta do estoque.

## acessar tela da integração

no integrador, acesse o módulo de sincronização de estoques.

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 estoques

nesta etapa, configuramos a sincronização de estoques entre a teceo e o Linx, conforme as necessidades da marca.
**importante:** a cada 15 minutos, o sistema realiza a validação automática de alterações em estoque, garantindo que os dados estejam atualizados. caso haja alguma modificação, a atualização é enviada para a fila de sincronização.

aqui também é definido o **tipo de cálculo** que será usado para o **estoque disponível**.
o cálculo padrão é:

* **estoque disponível teceo** = estoque em aberto no linx - pedidos em aberto do tipo "pronta-entrega” desconsiderando os status “R” e “X”.

<Note>
  para o cálculo do estoque, podemos considerar também ou não, os estoques em trânsito.
</Note>

abaixo estão os principais campos que devem ser configurados para assegurar que a integração funcione corretamente, conforme o fluxo de dados e a direção de sincronização:

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-01.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=6eab2444fe106524eb019a338cf9eff4" alt="seção integração de estoque do integrador com os campos filial de estoque, margem de segurança, considerar estoque em trânsito e integração de estoque futuro" width="1632" height="524" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-01.png" />
</Frame>

### campos para configuração

#### sincronização de estoque

**- margem de segurança para estoque**: define um número a ser subtraído do saldo de estoque durante a sincronização, criando uma margem de segurança no sistema teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-02.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=ec0853a5687b7ffc955542840939d576" alt="campo margem de segurança para estoque com a descrição de seu funcionamento" width="408" height="212" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-02.png" />
</Frame>

**- filial de estoque**: a "filial de estoque" é utilizada para filtrar os produtos que terão o estoque importado dentro da teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-03.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=dedf8b365af57845b8f4f20ed3126f9f" alt="campo filial de estoque com a descrição de que filtra os produtos com estoque importado" width="816" height="152" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-03.png" />
</Frame>

<Warning>
  se a marca não tiver os dois tipos de venda configurados (pronta entrega e pré-venda), é necessário criar ambos para que a reversa de pedidos funcione corretamente. além disso, a view de estoque precisa ser ajustada para considerar os dois tipos de venda, garantindo que o estoque unificado os contabilize. caso o tipo de venda seja alterado, a view de consumo de estoque deve ser atualizada para refletir essa mudança.
</Warning>

#### sincronização de estoque futuro

**- janela de entrega padrão:** indica qual será a janela de entrega padrão. a janela deve estar cadastrada previamente na teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-04.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=bbcb16a0b2b301e2d0676f87bf1584fb" alt="campo janela de entrega padrão com a descrição de seu funcionamento" width="816" height="116" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-04.png" />
</Frame>

<Note>
  é necessário criar uma view para habilitar a funcionalidade de estoque futuro.
</Note>

### flags para configuração

**- considerar estoque em trânsito**: ativa a validação de estoque em trânsito, caso exista.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-05.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=78185267de120aa87ac0b74177b0b474" alt="campo de ativação de considerar estoque em trânsito" width="328" height="116" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-05.png" />
</Frame>

**- sincronização de estoque automática**: habilita a sincronização automática de estoques entre os sistemas.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-06.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=16348f047586f73abecaaf23c410c5f2" alt="campo de ativação da integração de estoque automática" width="328" height="116" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-06.png" />
</Frame>

**- integração de estoque futuro:** ativa a integração de estoque futuro.

<Frame>
  <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-07.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=396c52e39309571943e448cf12a5511e" alt="campo de ativação da integração de estoque futuro" width="380" height="116" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-07.png" />
</Frame>

## testes em homologação

para garantir que a integração de estoques funcione corretamente, realize os testes abaixo no ambiente de homologação.

### sincronização inicial

insira um produto no Linx com saldo em estoque.

**procedimento de validação**: acesse a teceo e verifique se o saldo do produto foi importado corretamente, refletindo o valor configurado no Linx.
**objetivo do teste**: validar que o saldo inicial de estoque é sincronizado corretamente.

### teste de alteração de saldo no Linx

atualize o saldo de um produto no Linx, reduzindo e aumentando o valor do estoque.

**procedimento de validação**: confirme na teceo se o saldo atualizado foi refletido de maneira correta.
**objetivo do teste**: assegurar que alterações de saldo no Linx são refletidas na teceo.

### teste de pedido cancelado ou abandonado na teceo

crie um pedido de pronta entrega na teceo e, em seguida, cancele ou abandone o pedido.

**procedimento de validação**: confira no Linx se o saldo do produto foi liberado corretamente após o cancelamento ou abandono do pedido.
**objetivo do teste**: validar que o saldo de estoque é corretamente restaurado em casos de cancelamento ou abandono de pedidos.

## sincronização manual de estoque

caso o estoque de um produto tenha sido editado e seja preciso deste saldo atualizado de imediato, poderá forçar uma sincronização manual, que será enviada para a fila de importações antes do próximo ciclo de atualização. para isso, execute os seguintes passos:

<Steps>
  <Step title="pronta-entrega">
    dentro do cadastro do produto, acesse a aba de **pronta-entrega**.

    <Frame>
      <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-08.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=d75ba1cc20c0d21efd852b48e98de169" alt="aba pronta-entrega do cadastro do produto com a listagem de skus e seus estoques disponíveis" width="2100" height="1240" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-08.png" />
    </Frame>
  </Step>

  <Step>
    selecione os skus dos quais deseja atualizar o estoque.

    <Frame>
      <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-09.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=0b80901a54282fcb7e7dad189f6aeac2" alt="aba pronta-entrega com dois skus selecionados na listagem" width="2100" height="1240" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-09.png" />
    </Frame>
  </Step>

  <Step>
    no canto superior direito, clique sobre o menu de opções (3 pontos) e em seguida em “sincronizar estoques”.

    <Frame>
      <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-10.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=fb05023bb6702ab7087c136c92d52535" alt="menu de opções da aba pronta-entrega com a opção sincronizar estoques destacada" width="2100" height="1240" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-10.png" />
    </Frame>
  </Step>

  <Step>
    com isso, o sku será enviado para a fila de processamento para sincronizar o estoque.

    <Frame>
      <img src="https://mintcdn.com/teceo/-A18IP0b2388oBid/images/integracoes/linx/integracao-de-estoque-homologacao/img-11.png?fit=max&auto=format&n=-A18IP0b2388oBid&q=85&s=151e4f11cf575dea9f2c53ddc583aefd" alt="aba pronta-entrega com a notificação de sincronização em andamento" width="2100" height="1240" data-path="images/integracoes/linx/integracao-de-estoque-homologacao/img-11.png" />
    </Frame>
  </Step>
</Steps>

## considerações finais

a integração de estoques entre teceo e Linx garante maior precisão no controle de saldos, evitando erros operacionais e otimizando os processos da marca.
para garantir o sucesso da integração:

* revise periodicamente as configurações e ajustes no integrador.
* monitore as sincronizações nos primeiros dias após a ativação.
* entre em contato com a equipe de suporte da teceo para solucionar dúvidas ou realizar ajustes adicionais.


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