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.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.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.
- 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.
campos para configuração
integração de pedido
- coleção vigente: indica qual coleção será considerada ao integrar os pedidos realizados na teceo com o linx.
-
- 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
é possível definir o status como “aprovado” ou “em aprovação”.
mapeamento de status
- status de aprovado na linx: indica a letra correspondente ao status de aprovado na linx.
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.
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.
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.
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.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: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).
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.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.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.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.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.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.
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. - 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.
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.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.
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.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 sincronização
1
pedidos
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.
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.
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”.
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.
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.