Histórico da Página

...

Informações

title	Importante!

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.

Produto	Fluxo	Tipo da Mensagem	Versão MSU	Formato
TOTVS Protheus	Envia	AssíncronaSíncrona	1.000001	JSONCiaShop
TOTVS OMNI	RecebimentoRecebe	AssíncronaSíncrona	1.000001	JSON

...

Dica

title	Dica!

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?

O 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

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

Conector de Widget

width	600
url	https://www.youtube.com/watch?v=VQ3-TlOJ7uU
height	400

Informações

title	Auxilio no preenchimento dos campos

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

Versão

Alias

Rota

Formato

MATA410B

Documenttraceabilityorder

Rastreio de Pedido

Sim

Não

Síncrono

Todas

PAD.APP

1.001

SUA_ROTA

JSON

Importante: No campo Condição de envio pode ser preenchido com a seguinte função IIF( !Empty(SC5->C5_STATUS) ,.T.,.F.), visando gerar e enviar somente os status de pedido gerado via integração.

Integrando Rastreio de Pedido

Dica

title	Dica!

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?

Os status de rastreio de pedido são os seguintes:

Expandir

title	Liberado

Esse status ocorre quando o pedido é integrado ao Protheus e processado pela rotina do GravaBatch, com isso ao gerar o pedido de venda verifica se o parâmetro MV_LJIFPLI esta configurado com a forma de pagamento da venda efetuada para gerar a libertação automática.

Importante: Configurar o parâmetro MV_LJIFPLI = Ex: FI|CC|R$ para recebimento de pedido de venda liberado.
OBS: Neste momento ocorre a geração e o envio de mensagem de rastreio com o status Pedido Liberado ao TOTVS OMNI, que por sua vez atualiza o pedido em sua camada para "Em preparação". Abaixo o exemplo da mensagem de rastreio com o status Liberado.

Expandir

title	Rastreio com o status Liberado

Expandir

title	Faturado

Esse status ocorre quando é gerado no TOTVS Protheus o documento de saída(NF-e) do pedido integrado.

...

Configuração do adapter Documenttraceabilityorder. Para detalhes, acesse o link: Cadastro de Adapters / Cadastro De/Para Empresas.

O rastreio de pedido funciona em Pedidos de Vendas Ciashop e de origem Market Place.

Pedido de Vendas Status Liberado no ERP

No Faturamento (SIGAFAT) acesse Atualizações / Faturamento / Documento de Saída (MATA460A).
Selecione um pedido de venda liberado (legenda cor verde).
Importante: Configurar o parâmetro MV_LJIFPLI = Branco 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.

Image Removed

Demais Status do Pedido de Venda:

Pedido de Vendas Status Bloqueado no ERP

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.
Importante: Parametrizar no exemplo do parâmetro MV_LJIFPLI = exemplo: CC;FI 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.

...

Importante: Pedido deve estar liberado para a emissão da Nota Fiscal de Saída.
OBS:

...

Neste momento

...

é gerada e enviada a mensagem Docummenttraceabilityorder com o status Faturado

...

ao TOTVS OMNI que por sua vez atualiza o pedido em sua camada para "Faturado". Abaixo o exemplo da mensagem de rastreio com o status Faturado.

Expandir

title	Rastreio com o status Faturado

Expandir

title	Empacotado

Esse status ocorre quando é transmitida e autorizado o documento de saída(NF-e) do pedido integrado.

...

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.
Importante: O Documento de Saída deverá estar gerado.
OBS:

...

Neste momento

...

é gerada e enviada a mensagem Docummenttraceabilityorder com o status Empacotado

...

e os dados da NF-e ao TOTVS OMNI que por sua vez atualiza o pedido em sua camada para "Faturado". Abaixo o exemplo da mensagem de rastreio com o status Empacotado.

Expandir

title	Rastreio com o status Empacotado.

Expandir

title	Devolvido

Esse status ocorre quando é realizado a devolução manual do pedido no Protheus.

Pedido de Vendas Status Enviado no ERP e Enviado no 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.

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

Pedido de Vendas Status Entregue no ERP e Entregue no 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.

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.

...

Importante:

...

Qualquer item devolvido ira gerar uma mensagem de Rastreio de Pedido com o status Devolvido

...

.

Não existe integração de NCC com o

...

TOTVS OMNI, sendo assim ao efetuar uma devolução o e-Commerce não será avisado sobre credito do cliente.
OBS:

...

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

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

Image Removed

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

Image Removed

Json:

Image Removed

...

Aguarando processamento: Indica a quantidade de processos específicos, por exemplo (Reserva) estão aguardando na fila para serem executados.
Processando: Significa que após aguardar na fila o arquivo é envidado para ser processado.
Processado: Significa que o arquivo foi processado com sucesso, como por exemplo, enviou uma reserva para o Protheus e o mesmo retorno uma mensagem de sucesso.
Error: Significa que receberá o log de erro da integração especifica, tanto ao tentar enviar quanto AguardoCallback com retorno de erro.
Reprocessar: Indica que a mensagem estava processando e teve algum tipo de erro ou uma possível instabilidade e a mensagem irá reprocessar novamente

Neste momento é gerada e enviada a mensagem Docummenttraceabilityorder com o status Devolvido ao TOTVS OMNI que por sua vez atualiza o pedido em sua camada para "Devolução aceita pelo operador". Abaixo o exemplo da mensagem de rastreio com o status Devolvido.

Expandir

title	Rastreio com o status Devolvido.

Demais informações

Dica

title	Fluxo da integração de Rastreio de Pedido

Após realizar qualquer tipo de movimentação do pedido integrado no TOTVS Protheus será gerado a mensagem DocumentTraceAbilityOrder no EAI do configurador, essa mensagem é disparada ao TOTVS OMNI através da ROTA cadastrada e vinculado ao Adapter DocumentTraceAbilitOrder.

Quando recepcionado e processada a mensagem DocumentTraceAbilitOrder pelo TOTVS OMNI, o mesmo retorna uma mensagem para o Protheus informando sucesso ou falha na integração, que também pode ser visualizada no monitor do EAI.

Informações