manual de integração de estoque 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 pedidos
3.1 campos de configuração
3.1.1 integração de pedido
3.1.2 mapeamento de status
3.2 flags para configuração
4. testes em homologação
4.1 homologação de exportação de pedidos
4.2 homologação de importação de pedidos (reversa)
5. validação de integração
5.1 identificação do histórico de sincronização
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 pedidos 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 pedidos.
2. acessando a área de integração
no integrador, acesse o módulo de sincronização de pedidos.
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 pedidos:
nesta seção, vamos configurar a sincronização de pedidos entre a teceo e o Linx, escolhendo a direção da integração conforme o fluxo de dados necessário: exportação (teceo para Linx), importação (Linx para teceo), ou ambas.
- exportação (ida): permite que os pedidos gerados e aprovados na teceo sejam automaticamente enviados ao Linx. esta configuração é ideal para centralizar a criação e gestão de pedidos na teceo, refletindo automaticamente no Linx para continuidade do processamento.
- importação (volta): permite que os pedidos gerados e atualizados no Linx sejam sincronizados automaticamente com a teceo. essa opção é útil para marcas que gerenciam pedidos no Linx e desejam manter a teceo atualizada para fins de monitoramento e controle.
- ambas as direções: possibilita uma sincronização bidirecional, garantindo que qualquer atualização de status ou detalhes de pedidos em um sistema seja automaticamente refletida no outro. essa configuração demanda atenção especial aos códigos de operação e status dos pedidos para evitar incongruências e retrabalho.
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 selecionada.
observação:
- Integração de pedido: refere-se aos pedidos criados na teceo que serão enviados e registrados no linx.
- mapeamento de status: relaciona os status da teceo com os status da linx.
- sincronização de pedidos: refere-se aos pedidos criados no linx que serão importados para a teceo.
3.1 campos para configuração:
3.1.1 integração de pedido:
- coleção vigente: indica qual coleção será considerada ao integrar os pedidos realizados na teceo com o linx.
- natureza de saída: indica a natureza de saída padrão na sincronização de pedidos. (campo obrigatório)
- tipo de frete: indica o tipo de frete padrão na sincronização de pedido. campo obrigatório. (campo obrigatório)
- data de entrega do pedido: indica qual o mínimo de dias para a entrega do pedido após a sincronização na linx.
- data de entrega limite do pedido: indica qual o limite máximo de dias para a entrega do pedido após a sincronização na linx. (campo obrigatório)
- identificador da marca no pedido externo: indica qual o identificador da marca no código da coluna pedido externo. (campo obrigatório)
-
- observação: o código de prefixo definido no integrador será aplicado no código de pedido externo.
- exemplo:
- prefixo = adh
- pedido externo = tadh-22
- nome da marca no pedido: indica qual o nome da marca no pedido.
- status de sincronização padrão do pedido na linx: indica qual o status de sincronização padrão do pedido na coluna aprovação. (campo obrigatório)
- filial de pré-venda: indica a filial de pré-venda padrão na sincronização de pedidos. (campo obrigatório)
- filial de pronta entrega: indica a filial de pronta entrega padrão na sincronização de pedido. (campo obrigatório)
- tipo de venda de pré-venda: indica o tipo de venda de pré-venda padrão na sincronização de pedidos. (campo obrigatório)
- tipo de venda de pronta entrega: indica a filial de pronta entrega padrão na sincronização de pedido. (campo obrigatório)
- acionar integração: qual status de pedido vai acionar integração linx. (campo obrigatório)
observação: é possível definir o status como “aprovado” ou “em aprovação”.
- condições de transporte do pedido: indica as condições de transporte que serão definidas no pedido.
importante: 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.
3.1.2 mapeamento de status:
- status de aprovado na linx: indica a letra correspondente ao status de aprovado na linx.
- status de cancelado na linx: indica a letra correspondente ao status de cancelado na linx.
- status de reprovado na linx: indica a letra correspondente ao status de reprovado na linx.
- status de em aprovação na linx: indica a letra correspondente ao status de em aprovação na linx.
- status de enviado na linx: indica a letra correspondente ao status de enviado na linx.
3.1.3 sincronização de pedidos:
- histórico de tipos de vendas de pré-venda: indica o histórico de tipo de vendas de pré-venda na importação de pedidos.
- lista de filiais: indica a lista de filiais a serem consideradas na importação de pedidos.
- histórico de tipos de vendas de pronta entrega: indica o histórico de tipo de vendas de pronta entrega na importação de pedidos.
- lista de coleções: indica a lista de coleções a serem consideradas na importação de pedidos.
importante: todos os campos são obrigatórios para preenchimento, pois são essenciais para a importação e o funcionamento correto dos pedidos.
3.2 flags para configuração:
além dos campos de configuração, é necessário ativar algumas flags para habilitar funcionalidades específicas na integração de pedidos:
- importação automática de pedidos: ativa a importação automática de pedidos, possibilitando sincronizar pedidos realizados no Linx.
- sincronização reversa de pedidos: ativa a sincronização reversa, possibilitando que alterações no Linx sejam refletidas na teceo.
observação: a sincronização atualiza os pedidos enviados da teceo para o linx, refletindo alterações feitas no linx diretamente na teceo. os campos mapeados incluem status, itens e faturamento.
- integração automática de pedidos com erro: realiza mais 2 tentativas de reenvio de pedidos (a cada 1 hora), em casos de erros de sincronização
importante: a reversa só funciona quando os tipos de venda de pré-venda é diferente de pronta-entrega.
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 e recebidas corretamente entre os dois sistemas, validando todos os fluxos de integração.
4.1 homologação de exportação de pedidos:
nesta seção, serão realizados testes específicos para validar a integração de pedidos entre a teceo e o Linx. cada teste possui um propósito claro e descreve o resultado esperado para garantir que a exportação de dados de pedidos funcione conforme esperado.
testes e validações gerais:
▪️4.1.1 teste geral de exportação de pedidos
cadastre um pedido na teceo contendo produtos em pronta entrega e pré-venda, com todos os dados adicionais da marca.
procedimento de validação: a marca deve verificar no Linx se todos os dados do pedido exportado estão corretos e completos. os pontos principais a serem checados incluem:
- produtos: cor, tamanho e quantidade;
- prefixo do pedido/código do pedido externo;
- classificação do pedido, transportadora, tipo de cobrança e frete (se houver);
- dados do cliente e do vendedor;
- valor total do pedido e dos produtos;
- método de pagamento e descontos aplicados;
- reserva de estoque (verificar se o estoque de pronta entrega foi reservado conforme solicitado).
objetivo do teste: confirmar que o pedido, incluindo todos os tipos de dados e especificações, é exportado corretamente para o Linx, validando tanto pedidos em pronta entrega quanto de pré-venda em uma única execução
▪️4.1.2 teste de consumo de estoque
crie um pedido na teceo que consuma itens do estoque, especialmente para produtos em pronta entrega.
procedimento de validação: no Linx, confirme que o pedido criado está corretamente consumindo o estoque designado.
objetivo do teste: validar que a reserva de estoque está sendo efetivamente aplicada nos pedidos enviados ao Linx, evitando a duplicidade de estoque ou inconsistências de disponibilidade.
▪️4.1.3 teste de desconto no item do pedido
cadastre um pedido na teceo com desconto aplicado diretamente em itens específicos.
procedimento de validação: verifique no Linx se o desconto no item foi integrado corretamente e se o valor está de acordo com o cálculo de porcentagem no sistema.
objetivo do teste: confirmar que descontos aplicados a itens específicos do pedido são sincronizados corretamente.
▪️4.1.4 teste de desconto por política comercial
crie um pedido na teceo aplicando um desconto estabelecido pela política comercial da marca.
procedimento de validação: valide no Linx a aplicação correta do desconto por política comercial, verificando se a porcentagem de desconto corresponde aos valores pré-cadastrados.
objetivo do teste: garantir que a política comercial aplicada na teceo é refletida no Linx sem erros de cálculo.
▪️4.1.5 teste de cupom de desconto
cadastre um pedido aplicando um cupom de desconto válido.
procedimento de validação: verifique no Linx se o cupom de desconto foi reconhecido e aplicado corretamente.
objetivo do teste: confirmar que cupons de desconto utilizados nos pedidos integram adequadamente com o Linx.
▪️4.1.6 teste geral com todos os tipos de desconto
crie um pedido na teceo com a aplicação simultânea de todos os tipos de desconto que a marca utiliza (no item, política comercial e cupom).
procedimento de validação: no Linx, confirme que todos os descontos foram integrados sem conflitos, respeitando as configurações de cálculo e porcentagens cadastradas no sistema.
objetivo do teste: assegurar que pedidos com múltiplos descontos são exportados corretamente, sem gerar inconsistências de cálculo.
observação: para que a integração funcione corretamente em pedidos com descontos combinados (como cupom e política comercial aplicados ao mesmo tempo), é necessário que o Linx esteja configurado com um "desconto livre" que permita a aceitação de porcentagens de desconto variáveis e não cadastradas previamente.
importante: antes de iniciar os testes, o time da teceo analisa junto a marca a forma de trabalho específica utilizada, identificando quais tipos de desconto são utilizados (como descontos por item, política comercial e cupons). com essa base, os testes de desconto são realizados de forma a garantir que todos os cenários de aplicação sejam cobertos e que a integração ocorra conforme o esperado no Linx.
4.2 homologação de importação de pedidos (reversa):
nesta seção, detalhamos os passos e validações necessários para configurar e homologar a importação de pedidos do Linx para a teceo, garantindo a atualização automática de dados de pedidos de acordo com as necessidades e o plano contratado pelo cliente.
importante: a importação de dados de pedidos do Linx para a teceo permite que informações atualizadas sobre o status, faturamento, e itens de pedidos sejam refletidas na teceo. para definir a configuração mais adequada, às especificações do cliente e o plano contratado devem ser validados antes da ativação da integração.
- validação do plano contratado:
plano one: suporta a reversa completa, permitindo a sincronização de todas as atualizações, como alterações de status, faturamento parcial ou total, inclusões e exclusões de itens e ajustes de quantidade. esse fluxo garante que todas as informações operacionais do pedido sejam espelhadas na teceo.
plano collab: permite a reversa com restrições, oferecendo duas opções:
- reversa completa sem faturamento: permite a sincronização das atualizações, como alterações de status, inclusões e exclusões de itens e ajustes de quantidade, porém sem os dados de faturamento.
- somente status: restringe a reversa a atualizações de status, sem incluir alterações em itens ou faturamento.
- validação de usabilidade do cliente no ambiente Linx:
antes de configurar a reversa, o time da teceo e a marca alinham os processos operacionais executados no Linx após a exportação do pedido e que podem influenciar no funcionamento correto da reversa de pedidos. após validar esses pontos, o time da teceo define junto ao cliente o escopo apropriado para a reversa.
testes e validações gerais:
▪️4.2.1 teste de alteração de status
no ERP (Linx), altere o status de um pedido (por exemplo, de "pendente" para "cancelado").
procedimento de validação: verifique na teceo se o status do pedido foi atualizado conforme o novo status no Linx.
objetivo do teste: confirmar que o status do pedido no Linx é sincronizado corretamente na teceo.
▪️4.2.2 teste de edição de itens
no Linx, realize as seguintes modificações em um pedido:
- exclua um item do pedido.
- aumente a quantidade de um item.
- diminua a quantidade de outro item.
- adicione um novo produto ao pedido.
- altere o preço de um dos itens.
procedimento de validação: verifique na teceo se todas as alterações nos itens do pedido foram refletidas corretamente.
objetivo do teste: garantir que todas as modificações realizadas no Linx sejam importadas corretamente para a teceo.
▪️4.2.3 teste de faturamento do pedido:
no Linx, realize o faturamento de um pedido enviado da teceo.
procedimento de validação: verifique na teceo se o pedido foi faturado corretamente, conforme feito no Linx.
objetivo do teste: garantir que o pedido é faturado.
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 sincronização:
1. no menu lateral, clique em pedidos. 
2. identifique o pedido que deseja verificar e clique sobre o ícone de mais configurações e depois em “verificar integração”.
3. outra forma de acessar o histórico de sincronização seria pelo cadastro do pedido. para identificá-lo, acesse o pedido que deseja e já dentro de seu cadastro, clique sobre o ícone de integração.
5.2 validação de erros de sincronização:
com o histórico de sincronização acessado, em caso de erros de sincronização, o ícone ficará em vermelho, e mostrará o motivo da falta de integração.
5.3 sucesso de integração
no mesmo local, quando a integração for bem-sucedida, o ícone ficará em verde, e mostrará a mensagem de “sucesso”.
5.4 sincronização manual
caso a sincronização de um pedido não tenha ocorrido, você pode sincronizá-lo de forma manual, através da opção “forçar sincronização”, onde a solicitação será enviada a uma fila de processamento.
6. considerações finais:
este manual visa guiar a integração dos pedidos entre Linx e teceo, cobrindo desde a validação inicial até os testes específicos de exportação e 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 pedidos sejam sincronizados corretamente em ambiente real.
- suporte contínuo: a equipe da teceo está disponível para auxiliar em qualquer dúvida ou ajuste futuro que a marca possa precisar, garantindo a continuidade do processo.