> ## 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 pedidos - 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 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.](/integracoes/linx/acesso-ao-integrador) ## 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. seção integração de pedido do integrador com os campos de configuração, o bloco de mapeamento de status e os campos e flags de importação de pedidos * **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. campo coleção vigente do módulo de integração de pedido **- natureza de saída:** indica a natureza de saída padrão na sincronização de pedidos\*\*. (campo obrigatório)\*\* campo natureza de saída preenchido com o código 100.01 **- tipo de frete**: indica o tipo de frete padrão na sincronização de pedido. campo obrigatório. **(campo obrigatório)** campo tipo de frete preenchido com o código 01 **- data de entrega do pedido:** indica qual o mínimo de dias para a entrega do pedido após a sincronização na linx. campo data de entrega do pedido preenchido com o valor 0 **- 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)** campo data de entrega limite do pedido preenchido com o valor 180 **- 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 campo identificador da marca no pedido externo vazio, com a descrição de seu funcionamento **- nome da marca no pedido:** indica qual o nome da marca no pedido. campo nome da marca no pedido vazio, com a descrição de seu funcionamento **- 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)** campo status de integração padrão do pedido na linx vazio, com a descrição de seu funcionamento **- filial de pré-venda:** indica a filial de pré-venda padrão na sincronização de pedidos. **(campo obrigatório)** campo filial de pré-venda vazio, com a descrição de seu funcionamento **- filial de pronta entrega:** indica a filial de pronta entrega padrão na sincronização de pedido. **(campo obrigatório)** campo filial de pronta entrega vazio, com a descrição de seu funcionamento **- tipo de venda de pré-venda:** indica o tipo de venda de pré-venda padrão na sincronização de pedidos. **(campo obrigatório)** campo tipo de venda de pré-venda preenchido com multimarca **- tipo de venda de pronta entrega:** indica a filial de pronta entrega padrão na sincronização de pedido. **(campo obrigatório)** campo tipo de venda de pronta entrega preenchido com multimarca **- acionar integração:** qual status de pedido vai acionar integração linx. **(campo obrigatório)** campo acionar integração preenchido com o status aprovado é 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. campo condições de transporte do pedido preenchido com nenhum 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. #### mapeamento de status **- status de aprovado na linx:** indica a letra correspondente ao status de aprovado na linx. campo status de aprovado na linx preenchido com a letra A **- status de cancelado na linx:** indica a letra correspondente ao status de cancelado na linx. campo status de cancelado na linx preenchido com as letras R, X **- status de reprovado na linx:** indica a letra correspondente ao status de reprovado na linx. campo status de reprovado na linx vazio, com a descrição de seu funcionamento **- status de em aprovação na linx:** indica a letra correspondente ao status de em aprovação na linx. campo status de em aprovação na linx preenchido com a letra N **- status de enviado na linx:** indica a letra correspondente ao status de enviado na linx. campo status de enviado na linx vazio, com a descrição de seu funcionamento #### 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. campo histórico de tipos de vendas de pré-venda do módulo de sincronização de pedidos **- lista de filiais:** indica a lista de filiais a serem consideradas na importação de pedidos. campo lista de filiais do módulo de sincronizaçã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. campo histórico de tipos de vendas de pronta entrega do módulo de sincronização de pedidos **- lista de coleções:** indica a lista de coleções a serem consideradas na importação de pedidos. campo lista de coleções do módulo de sincronização de pedidos todos os campos são obrigatórios para preenchimento, pois são essenciais para a importação e o funcionamento correto dos 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. campo de ativação da importação automática de pedidos desativado **- sincronização reversa de pedidos**: ativa a sincronização reversa, possibilitando que alterações no Linx sejam refletidas na teceo. campo de ativação da sincronização reversa de pedidos ativado 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 campo de ativação da integração automática de pedidos com erro desativado a reversa só funciona quando os tipos de venda de pré-venda é diferente de pronta-entrega. ## 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). **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 #### 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. 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. ### 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. 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:** #### 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. **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. #### 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. menu lateral da teceo com a opção pedidos destacada, sobrepondo a tela inicial com a listagem meus últimos pedidos ### identificação do histórico de sincronização no menu lateral, clique em **pedidos.** modal histórico de integração do pedido com o registro de tentativas de sincronização e o botão forçar sincronização em destaque identifique o pedido que deseja verificar e clique sobre o ícone de mais configurações e depois em “verificar integração”. listagem de pedidos com a coluna status de integração e o ícone de mais opções destacado na primeira linha menu de opções do pedido aberto com a opção verificar integração destacada 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. cadastro do pedido com o status integrado destacado no topo ### 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. modal histórico de integração do pedido com uma tentativa de sincronização em erro, destacando a mensagem internal server error ### 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”. modal histórico de integração do pedido com o status sucesso em verde indicando pedido integrado ### 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. modal histórico de integração do pedido com o botão forçar sincronização destacado ## 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.