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

## introdução

este manual descreve o processo de integração de produtos entre o sistema teceo e o TOTVS, 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 estoques.

para identificar o integrador e realizar as configurações iniciais, consulte o **manual de acesso ao integrador**: [acessar o integrador TOTVS.](/integracoes/totvs/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 TOTVS, definindo as direções e as principais configurações para garantir que a integração funcione de forma completa e automática.

**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 TOTVS**: uma vez que os dados do produto estejam integrados, eles só podem ser alterados pelo ERP (TOTVS). dessa forma, a teceo mantém a integridade das informações sem necessidade de alterações manuais.
* **webservice TOTVS**: para sincronizar a descrição e características dos produtos na teceo, o webservice do TOTVS deve estar habilitado e preenchido com as informações desejadas. se o webservice não estiver disponível no TOTVS, é necessário liberá-lo no módulo de configurações do sistema.
* **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.

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/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-01.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=eee9f8c0b5f39aab07a080325b2785c8" alt="seção integração de produtos do integrador TOTVS Moda com todos os campos e a opção de sincronização automática de produtos" width="2108" height="844" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-01.png" />
</Frame>

### campos para configuração

**- código do Tipo de Categoria:** define a árvore de categorias na teceo, correspondendo ao código de categoria configurado no TOTVS.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-02.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=24978ca6200f2cbbe587ae51ba239691" alt="campo código do tipo de categoria do módulo de integração de produtos" width="736" height="143" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-02.png" />
</Frame>

**- coleções**: seleciona as classificações que representam as coleções na teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-03.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=22d520432a2fdbafc6aa08bc35b1ea03" alt="campo coleções do módulo de integração de produtos" width="736" height="143" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-03.png" />
</Frame>

**- preços sugeridos sell-out:** Define os preços sugeridos de venda na teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-04.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=bf560561bf2a4655f578fcf35e88a558" alt="campo preços sugeridos sell-out do módulo de integração de produtos" width="736" height="116" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-04.png" />
</Frame>

<Note>
  aqui deve ser alinhado com a marca se utilizam table price ou price code list.
</Note>

**- Classificações de Produto**: Adiciona classificações extras que a marca deseja importar para a teceo.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-05.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=70d39cf2a22c0a862ab1fe2022ba1551" alt="campo classificações de produto do módulo de integração de produtos" width="736" height="152" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-05.png" />
</Frame>

**- Códigos dos Tipos e Classificações**: Funciona como filtro para a importação de produtos, garantindo que apenas os produtos específicos (ex. apenas para lojas físicas, e não e-commerce) sejam sincronizados.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-06.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=2ded4c370ed90ce5ef29f1842dade520" alt="campo códigos dos tipos e classificações no erp do módulo de integração de produtos" width="736" height="152" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-06.png" />
</Frame>

**- Alíquota de IPI pela NCM**: Configurada diretamente no banco de dados, essa informação define a alíquota e o NCM do produto.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-07.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=f3ca1964fe0b01cca009ed649d3a3c46" alt="campo alíquota de ipi pela ncm do módulo de integração de produtos" width="736" height="120" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-07.png" />
</Frame>

**- Preço de Sell-In**: Para a configuração completa, é obrigatório configurar uma tabela sell-in, mesmo que os preços estejam zerados.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-08.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=73620241590498d8ef09f9ba20906bcb" alt="botão tabelas de preços de sell-in do módulo de integração de produtos" width="328" height="72" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-08.png" />
</Frame>

### flags para configuração

**- sincronização automática de produtos:** ativa a importação de produtos de forma automática.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-09.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=6352d7500a4c7233824308ffc11fea8c" alt="opção integração automática de produtos ativada no módulo de integração de produtos" width="400" height="72" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-09.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 TOTVS 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 15 minutos, garantindo uma sincronização contínua e segura dos dados.
</Note>

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

#### teste de alteração de nome

no TOTVS, realize as seguintes alterações em um produto:

* modifique o nome.

**procedimento de validação:** acesse a teceo e confirme se o nome foi atualizado corretamente.
**objetivo do teste:** garantir que as alterações de nome no TOTVS sejam refletidas com precisão na teceo.

#### teste de alteração de variações (cor e tamanho)

no TOTVS, 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 TOTVS, 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 TOTVS são refletidas com exatidão na teceo.

#### teste de alteração de preço do sku e código de barras

no TOTVS, 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 TOTVS 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, identifique no canto superior direito a opção **importações.**

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-10.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=5739dd52e953249c71e4a2016f3e3d8c" alt="tela do integrador TOTVS Moda com a opção importações destacada no canto superior direito" width="2100" height="1240" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-10.png" />
</Frame>

b) será mostrado, em tela, uma lista das últimas importações realizadas, juntamente com a data e hora da importação, o componente (clientes, produto etc), o modo (automático ou manual) e status (concluído, concluído parcialmente, processando ou erro).

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-11.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=d37b3c41c4f9bd033e64fe9c90bbd9c0" alt="modal de histórico de importações com data, componente, modo e status de cada importação" width="2112" height="1240" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-11.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 mostrará o motivo da falta de integração.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-12.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=562df644d1bd498c4e4a8b36602ce960" alt="modal de histórico de importações com o status erro destacado em uma linha de importação" width="2112" height="1240" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-12.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-13.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=285ce9e9521f822b93806d52b5fbd678" alt="tela de itens da importação com um produto em status erro e o motivo da falha exibido" width="2112" height="1008" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-13.png" />
</Frame>

### sucesso de 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/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-14.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=b4f2cf52e9521bc0f7b549cead871bce" alt="modal de histórico de importações com o status concluído destacado em uma linha de importação" width="2112" height="1240" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-14.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-15.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=098b370ed547ca8332f5b12eb08f24fb" alt="tela de itens da importação com um produto em status concluído e a quantidade de skus importados" width="2112" height="1000" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-15.png" />
</Frame>

### sincronização manual

caso precise sincronizar um produto de imediato, pode utilizar a **sincronização manual**. para isso, acesse o integrador, e selecione a opção “forçar sincronização” e selecione o componente de produtos. após isso, digite o código do produto e depois clique em “sincronizar produto”, ou apenas clique em “sincronizar todos os produtos” para que todos que atendam aos critérios impostos no integrador sejam importados. 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 o tamanho da fila.

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-16.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=8e631bc5a6da71fd6bf68b451834bb4f" alt="tela do integrador TOTVS Moda com a opção forçar integração destacada no canto superior direito" width="2100" height="1240" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-16.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/teceo/rvLplf6I8uIKyQw1/images/integracoes/totvs/integracao-de-produto-homologacao/img-17.png?fit=max&auto=format&n=rvLplf6I8uIKyQw1&q=85&s=98ea09c4c70b9b24fc98c77eca4a1e23" alt="modal forçar integração com o campo código do produto e o botão integrar todos os produtos" width="2112" height="1240" data-path="images/integracoes/totvs/integracao-de-produto-homologacao/img-17.png" />
</Frame>

## considerações finais

este manual visa guiar a integração dos produtos entre TOTVS 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.