Skip to main content

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

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

​
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.
campo código do tipo de categoria do módulo de integração de produtos
- coleções: seleciona as classificações que representam as coleções na teceo.
campo coleções do módulo de integração de produtos
- preços sugeridos sell-out: Define os preços sugeridos de venda na teceo.
campo preços sugeridos sell-out do módulo de integração de produtos
aqui deve ser alinhado com a marca se utilizam table price ou price code list.
- Classificações de Produto: Adiciona classificações extras que a marca deseja importar para a teceo.
campo classificações de produto do módulo de integração de produtos
- 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.
campo códigos dos tipos e classificações no erp do módulo de integração de produtos
- Alíquota de IPI pela NCM: Configurada diretamente no banco de dados, essa informação define a alíquota e o NCM do produto.
campo alíquota de ipi pela ncm do módulo de integração de produtos
- Preço de Sell-In: Para a configuração completa, é obrigatório configurar uma tabela sell-in, mesmo que os preços estejam zerados.
botão tabelas de preços de sell-in do módulo de integração de produtos

​
flags para configuração

- sincronização automática de produtos: ativa a importação de produtos de forma automática.
opção integração automática de produtos ativada no módulo de integração de produtos

​
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.
a validação para atualização dos produtos ocorre a cada 15 minutos, garantindo uma sincronização contínua e segura dos dados.
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.
para esta validação, o ideal é que seja feito uma bateria de testes, cadastrando, no mínimo, 3 produtos para cada teste individualmente.

​
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.
tela do integrador TOTVS Moda com a opção importações destacada no canto superior direito
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).
modal de histórico de importações com data, componente, modo e status de cada importação

​
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.
modal de histórico de importações com o status erro destacado em uma linha de importação
tela de itens da importação com um produto em status erro e o motivo da falha exibido

​
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”.
modal de histórico de importações com o status concluído destacado em uma linha de importação
tela de itens da importação com um produto em status concluído e a quantidade de skus importados

​
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.
tela do integrador TOTVS Moda com a opção forçar integração destacada no canto superior direito
modal forçar integração com o campo código do produto e o botão integrar todos os produtos

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