O Rastreio do Pedido de Vendas é enviado do sistema TOTVS Protheus, e será integrado com o sistema TOTVS OMNI através de comunicação de Mensagem Única.

Caso queira verificar os campos que compõem a mensagem de Rastreio do Pedido basta acessar: https://api.totvs.com.br/legado  Clique no Link: Mensagem Padronizada, depois em  Lista de Serviços e busque a mensagem DOCUMENTTRACEABILITYORDER.

ProdutoFluxoTipo da MensagemVersão MSUFormato
TOTVS ProtheusEnviaSíncrona1.000JSON
TOTVS OMNIRecebeSíncrona1.000JSON

Antes de realizar a integração de uma reserva de produto, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).

  • Mas afinal o que é um Adapter?

Adapter é uma rotina responsável pela mensagem (DOCUMENTTRACEABILITYORDER) e seu cadastro é necessário para definir algumas informações importantes, como por exemplo, o tipo da mensagem JSON ou XML, se será possível enviar e receber a mensagem ou somente uma dessas opções.

  • Importante: Como pré-requisito para o cadastro do Adapter é imprescindível ter o Cadastro de Rota.

Cadastro do adapter DOCUMENTTRACEABILITYORDER

  1. No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
  2. Clique em incluir e cadastre a rotina responsável pela mensagem Item, como mostra o vídeo abaixo:


ADCIONAR VIDEO 

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

VersãoAliasRotaFormato
MATA410BDocumenttraceabilityorderRastreio de PedidoSimNãoSíncronoTodas


PAD.APP1.000

SUA_ROTA

JSON


Importante: O campo Condição de envio pode ser preenchido com uma função ou expressão logica, para determinar se o Produto em questão será enviado ou não, no caso do adapter de tabela de preço.


Integrando Rastreio de Pedido




Como funciona a integração de Rastreio de Pedido entre o TOTVS Protheus e TOTVS OMNI?

Após a integração de um pedido do tipo entrega, qualquer atualização que o mesmo tiver no Protheus, será gerado e enviado à mensagem DocumentTraceAbilityOrder, ao TOTVS OMNI, com o status do pedido no Protheus.


Quais são os status de rastreio de pedido que o Protheus envia ao TOTVS OMNI?




 Pedido de Vendas Status Liberado no ERP

  1. No Faturamento (SIGAFAT) acesse Atualizações / Faturamento / Documento de Saída (MATA460A).
    Selecione um pedido de venda liberado (legenda cor verde).
    (informação) Importante: Configurar o parâmetro MV_LJIFPLI = Ex: FI|CC|R$ para recebimento de pedido de venda liberado Ciashop e/ou Market Place.
    OBS: Neste momento não haverá envio de mensagem de rastreio para a gravação do Status no E-commerce.

          

Demais Status do Pedido de Venda:


No Faturamento (SIGAFAT) acesse Atualizações / Pedidos / Liberação de Crédito/Estoque (MATA456)
Selecione o pedido de venda para o desbloqueio de crédito/estoque.
(informação) Importante: Parametrizar no exemplo do parâmetro MV_LJIFPLI = Vazio para gerar pedido bloqueado.
OBS: Neste passo haverá desbloqueio e liberação do pedido de venda.


No Faturamento (SIGAFAT) acesse Atualizações / Faturamento / Documento de Saída (MATA460A).
Selecione o pedido de venda e gere o Documento de Saída.
(informação) Importante: Pedido deve estar liberado para a emissão da Nota Fiscal de Saída.
OBS: Neste momento será gerado mensagem Docummenttraceabilityorder com o status Faturado, que será enviada ao E-Commerce.


No Faturamento (SIGAFAT) acesse Atualizações / NF-e e NFS-e / NF-e Sefaz
Selecione o Documento de Saída e realize a Transmissão da Nota Fiscal à  Sefaz.
(informação) Importante: O Documento de Saída deverá estar gerado.
OBS: Neste momento será gerado mensagem Docummenttraceabilityorder com o status Empacotado, que será enviada ao E-Commerce.


No modulo Controle de Lojas (SIGALOJA) acesse Atualizações / Gerencia Doc. Eletrônico / Grava/Envia Rastreio de Ped.
Informe os campos de acordo com o pedido em que deseja realizar o envio e clique em OK, selecione o pedido em que deseja enviar e clique em Rastreio, informe o código de rastreio para o pedido 

e informe o status 30 - Enviado, selecione a opção "Enviar status (enviado) de pedido para Ciashop" e em seguida clique em OK.

(informação) Importante: Neste momento será gerado mensagem Docummenttraceabilityorder com o status Enviado, que será enviada ao E-Commerce.


No modulo Controle de Lojas (SIGALOJA) acesse Atualizações / Gerencia Doc. Eletrônico / Grava/Envia Rastreio de Ped.
Informe os campos de acordo com o pedido em que deseja realizar o envio e clique em OK, selecione o pedido em que deseja enviar e clique em Rastreio, informe o código de rastreio para o pedido 

e informe o status 31 - Entregue, selecione a opção "Enviar status (enviado) de pedido para Ciashop" e em seguida clique em OK.

(informação) Importante: Neste momento será gerado a mensagem Docummenttraceabilityorder com o status Entregue, que será enviada ao E-Commerce.


No modulo Controle de Lojas (SIGALOJA) acesse Atualizações / Atendimento / Rotina de Troca
Informe os dados da venda conforme sua necessidade e em seguida finalize o processo de devolução.
(informação) Importante: Qualquer item devolvido ira gerar uma mensagem de Rastreio de Pedido com o status Devolvido e o pedido no e-Commerce ficara como devolvido integralmente.

Isto porque o e-Commerce não trata devolução parcial de mercadoria. Não existe integração de NCC com o e-Commerce, sendo assim ao efetuar uma devolução o e-Commerce não será avisado sobre credito do cliente.
OBS: Neste momento haverá envio de mensagem de rastreio para a gravação do status Devolvido no E-commerce.




     Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"

       Acessar o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:


         

Mensagem única do DOCUMENTTRACEABILITYORDER

Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original.

Código da Função: DOCUMENTTRACEABILITYORDER

UUID: 2aa748d7-a056-1553-05bc-83b7c1baa3db

Descrição da Mensagem: Rastreabilidade do Pedido

Tipo da Transação: Envio

Tipo da Mensagem: Business Message

Url Enviada: http://eaistaging.ciashop.com.br/protheus/tirateima

Evento: UPSERT



Json:        



  OBS: link do DashBoard é fornecido pela CiaShop.



Mensagem Unica no Mozart:


Visualizando o resultado da mensagem no Manager do E-Commerce


Obs: Realize o login infonando seu usuário e senha.

  1. No Manager clique em Minhas Vendas/Gerenciar Pedidos

   2. Selecione o Pedido do Protheus, e verifique as informações do Status do Pedido.


Visualizando o Rastreio (Status) do Pedido de Vendas atualizado no Site do E-commerce

Obs: Com base no Pedido de Venda integrado no e-commerce o Status consta em "Pagto Aprovado".




Protheus – Recebimento da Response Message (Mensagens assíncronas)

Recebimento de respostas