integração de pedidos - homologação

​

introdução

este manual descreve o processo de integração de pedidos 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 pedidos.

​

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 pedidos

nesta seção, vamos configurar a sincronização de pedidos entre a teceo e o TOTVS, escolhendo a direção da integração conforme o fluxo de dados necessário: exportação (teceo para TOTVS), importação (TOTVS para teceo), ou ambas.

• exportação (ida): permite que os pedidos gerados e aprovados na teceo sejam automaticamente enviados ao TOTVS. esta configuração é ideal para centralizar a criação e gestão de pedidos na teceo, refletindo automaticamente no TOTVS para continuidade do processamento.
• importação (volta): permite que os pedidos gerados e atualizados no TOTVS sejam sincronizados automaticamente com a teceo. essa opção é útil para marcas que gerenciam pedidos no TOTVS 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.

​

campos para configuração

- prefixo do pedido: define o prefixo da marca no código do pedido, facilitando a identificação dos pedidos no TOTVS do cliente. exemplo:

• prefixo = lbh
• pedido externo = tlbh-22

- branch code: código da empresa no ambiente TOTVS responsável pelos pedidos. - status do pedido integrado: define o status que o pedido assumirá no TOTVS ao ser integrado. - tipo de integração da reversa: define o tipo de integração reversa para atualização dos dados do pedido, que pode ser:

• • apenas status do pedido: atualiza apenas o status do pedido.
  • completa sem faturamento: atualiza todas as informações, exceto dados de faturamento.
  • completa: (*) atualiza todas as informações do pedido, como alterações de status, faturamento parcial ou total, reservas, inclusões e exclusões de itens e ajustes de quantidade.

(*) a integração reversa completa está disponível conforme o plano contratado pela marca. - operation codes: código de operação da marca para padronização e identificação da operação no TOTVS. - acionar integração: indica o status necessário do pedido para acionar a integração e ser enviado ao TOTVS (pode ser definido como “aprovado” ou “em aprovação”).

​

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: - habilitar classificações do pedido: ativa a classificação dos pedidos, permitindo segmentações específicas. - habilitar transportadora e tipo do frete: habilita a integração dos dados de transportadora e tipo de frete associados ao pedido. - habilitar tipo de cobrança do pedido: ativa a integração dos tipos de cobrança definidos no pedido. - habilitar integração de lote: permite a integração em lote dos pedidos. - habilitar operações do pedido: permite configurar e habilitar operações específicas dos pedidos para integração. - integração reversa de pedidos: ativa a sincronização reversa, possibilitando que alterações no TOTVS sejam refletidas na teceo. - 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 - habilitar integração de pedidos: ativa e possibilita a exportação de pedidos da teceo para o TOTVS - habilitar múltiplas filiais no pedido: possibilita com que seja escolhido e definido a filial do pedido na finalização do mesmo, de acordo com as filiais definidas no integrador.

​

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 TOTVS. 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 TOTVS 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;
    • status do pedido sincronizado (definido no integrador da teceo);
    • código de operação (operation code) e filial (branch code);
    • 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 TOTVS, 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 TOTVS, 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 TOTVS, evitando a duplicidade de estoque ou inconsistências de disponibilidade.

​

testes e validações específicas para descontos

​

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

​

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 TOTVS, 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.

​

testes e validações específicas para produtos com IPI

​

teste de produto com IPI

cadastre um pedido na teceo com produtos que incluem IPI, sem aplicação de descontos. procedimento de validação: valide no TOTVS se o valor do pedido inclui o ipi somado ao valor total do produto, e que nenhum desconto é aplicado a esses produtos. objetivo do teste: assegurar que a exportação de produtos com ipi ocorre conforme esperado, sem aplicação indevida de descontos.

​

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

-> validação de usabilidade do cliente no ambiente TOTVS: antes de configurar a reversa, o time da teceo e a marca alinham os processos operacionais executados no TOTVS após a exportação do pedido e que podem influenciar no funcionamento correto da reversa de pedidos, como:

• branch code: a marca realiza mudanças de código de filial (branch code) para diferentes operações, o que pode impactar a rastreabilidade de pedidos, impossibilitando a reversa.
• subpedidos de faturamento: caso o cliente crie subpedidos para faturar um único pedido, pode ocorrer perda de rastreabilidade e dados divergentes, impossibilitando a reversa.

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 (TOTVS), 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 TOTVS. objetivo do teste: confirmar que o status do pedido no TOTVS é sincronizado corretamente na teceo.

​

teste de edição de itens

no TOTVS, 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 TOTVS sejam importadas corretamente para a teceo.

​

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

​

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