Histórico da Página

O Mensagem de Reserva de Itemserá 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.

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

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:

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 resercareserva, 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:

.

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

Image Modified Aguardando execução

Image Modified Executando

Image Modified Finalizada

Image Modified Falhou

Image Modified Bloqueado

Image Modified Não entregue

Image Modified Recusada

Image Modified Entregue