Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleImportante!

O Mensagem de Reserva de Item

...

será realizado no sistema

...

TOTVS Protheus, e será integrado com o TOTVS Protheus através de comunicação de Mensagem Única (ItemReserve).

Caso queira verificar os campos que compõem a mensagem de Categoria, acesse  https://api.totvs.com.br/legado  Clique no Link: Mensagem Padronizada, depois em  Lista de Serviços e busque a mensagem ItemReserve.

ProdutoFluxoTipo da MensagemVersão MSUFormato
CiaShop
TOTVS ProtheusRecebe
Assíncrona
Síncrona1.000JSON
Protheus
TOTVS OMNIEnvia
Assíncrona
Síncrona1.000

JSON

Image Removed

        Pré-requisitos:

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

Importante (informação)

Procedimento para Utilização

Inclusão:

Após a inclusão da Reserva no sistema CiaShop, acesse o Configurador (SIGACFG), Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).

O sistema Protheus apresenta De-Para das integrações com o Sistema CiaShop

Importante!(informação)

Todas as integrações que utilizam mensagem unica como meio de comunicação, será passível de consulta via rotina de monitoramento das mensagens, bem assim como o seu resultado de integração.

1 - No Configurador (SIGACFG) acesse Ambiente / Cadastros / Schedule.
2 - Clique na opção EAI.
3 - Localize o código da função =ITEMRESERVE.      
4 - Clique na lupa Image Removed e selecione a opção : Visualizar mensagem original.

Image Removed
Observe a apresentação do jSON, com as informações da Reserva integrada.

Image Removed

1 - Clique na lupa e selecione a opção : Visualizar mensagem de Resposta. 
2 - Veja a resposta enviado ao CiaShop com o Código gerado no Protheus na tag Destination

Image Removed

Status das mensagens no EAI Protheus

 Atualmente, existem 7 status disponíveis para uma mensagem na fila do EAI Protheus:

Image RemovedAguardando execução - A mensagem está na fila do EAI e ainda não começou a execução (o seu envio ou o seu processamento pelo adapter);

Image RemovedExecutando - A mensagem está sendo enviada para o sistema integrado ou a mensagem recebida está sendo processada;

Image RemovedFinalizada - A mensagem foi processada sem erros ou foi enviada sem erros;

Image RemovedFalhou - Houve um erro no envio da mensagem ou no seu recebimento;

Image RemovedBloqueado - A mensagem foi bloqueada para execução pelo usuário;

Image RemovedNão entregue - A mensagem não foi enviada para o destino (ou ainda, ocorreu um erro por time-out e não foi possível definir se a mensagem foi recebida e processada);

Image RemovedRecusada - A mensagem foi recusada por conter divergências entre a mensagem e o seu XSD.

No Configurador ( SIGALOJA) acesse Atualizações/Gerência de Vendas / Controle de Reservas(Mata430).
Clique em Visualizar.

Observe a Reserva que foi incluída no sistema via mensagem unica.

Dica
titleDica!

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 (ItemReserve) 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 ItemReserve

  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:

Conector de Widget
width600
urlhttps://www.youtube.com/watch?v=3mCwQXkI0gE
height400


Informações
titleAuxilio no preenchimento dos campos

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

VersãoAliasRotaFormato
LOJA704ItemReserveReserva de ProdutoNãoSimSí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 ITEM, estamos utilizando a função LjxjCsCoPr():


 Integrando uma reserva de Produto

Dica
titleDica!

Como funciona a integração de uma reserva entre o TOTVS OMNI e o TOTVS Protheus ?

A reserva de Produtos é enviada ao TOTVS Protheus, informando o a filia, armazém, código e quantidade dos produtos a serem reservados, com isso a mensagem é processada pelo Protheus realiza a reserva dos Produtos informados.


Qual o procedimento quando utilizo Controle de Lote/Sublote/Endereçamento/Serie?

  • Caso na mensagem Padronizada ItemReserve não seja informado as tags referente à Lote, SubLote, Endereçamento e Serie, mencionadas a baixo:
    • "LotNumber" - Lote
    • "SubLotNumber" - SubLote
    • "AddressingItem" - Endereçamento
    • "SeriesItem" - Serie

O sistema vai identificar o Lote com a data de validade mais próxima e fará a reserva do produto para esse lote.
Caso a quantidade do produto seja superior ao do primeiro lote, o sistema identifica se tem outros lotes do mesmo produto, caso tenha será reservado 100 unidades do lote com a validade mais próxima e 2 unidades para o segundo lote com a validade mais próxima. Com isso gerando duas linhas do mesmo produto na tabela SC0, para lotes diferentes, como mostra o exemplo abaixo:

draw.io Diagram
bordertrue
diagramNameReserva
simpleViewerfalse
width
linksauto
tbstyletop
pageId552590004
lboxtrue
diagramWidth886

    • (informação) Importante : Endereçamento e Serie o tratamento é o mesmo.
    • Para reservas integradas via MP - ItemReserve o cancelamento automático de reserva com a validade expirada (C0_VALIDA) está desabilitado.
    • O cancelamento de Reserva só será realizado via Mensagem Padronizada com o evento delete que se encontra dentro do Content no Json EVENT = DELETE
    • O cancelamento de reserva também poderá ser realizado via tela na rotina Controle de Reservas - MATA430. 


Abaixo exemplo da mensagem ItemReserve:

Expandir
titleExemplo da mensagem ItemReserve
Bloco de código
titleJson
Inserir json de ItemReserve


Demais informações

Dica
titleFluxo da integração de Reserva de Produto

Quando recepcionado e processada a mensagem ItemReserve pelo TOTVS Protheus, o mesmo retorna uma mensagem para o TOTVS OMNI informando sucesso ou falha na integração.

Em caso de sucesso, é gravado no Protheus na tabela XXF um DE/PARA de reserva, com o código da reserva no TOTVS OMNI relacionando com o código da reserva gerada no Protheus.

Em caso de falha no monitor do EAI é possível verificar que a legenda da mensagem foi alterada para a cor amarela, indicando falha e conseguimos visualizar o motivo da falha através da do detalhe da mensagem.

Informações
titleLegendas de status da mensagem

A mensagem pode ter diversos tipos de status e cada um deles esta vinculado a uma legenda sendo elas:

Image Added Aguardando execução

Image Added Executando

Image Added Finalizada

Image Added Falhou

Image Added Bloqueado

Image Added Não entregue

Image Added Recusada

Image Added Entregue


Próximo passo

Dica
titleVamos lá!

Após configurar e entender funcionamento de Reserva de Produto, vamos para o próximo passo, Clientes.

...