Á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 OMNIEnviaAssíncrona1.000

JSON

Dica

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.

...

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.


 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
width800
linksauto
tbstyletop
lboxtrue
diagramWidth887
revision3

    • (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 reserca, com o código da reserva no TOTVS OMNI relacionando com o código da reserva gerada no Protheus, como mostra o exemplo abaixo:

GIF DE DE-PARA

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, como mostra o exemplo abaixo:

GIF DE FALHA E MENSAGEM DE FALHA


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