Histórico da Página
Informações | ||
---|---|---|
| ||
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. |
Produto | Fluxo | Tipo da Mensagem | Versão MSU | Formato |
---|
TOTVS Protheus | Recebe |
Síncrona | 1.000 | JSON |
TOTVS OMNI | Envia |
Síncrona | 1.000 | JSON |
Pré-requisitos:
Configuração do adapter ItemReserve. Para detalhes, acesse o link: Cadastro de Adapters / Cadastro De/Para Empresas.
Importante
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!
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 e selecione a opção : Visualizar mensagem original.
Observe a apresentação do jSON, com as informações da Reserva integrada.
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
Status das mensagens no EAI Protheus
Atualmente, existem 7 status disponíveis para uma mensagem na fila do EAI Protheus:
Aguardando 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);
Executando - A mensagem está sendo enviada para o sistema integrado ou a mensagem recebida está sendo processada;
Finalizada - A mensagem foi processada sem erros ou foi enviada sem erros;
Falhou - Houve um erro no envio da mensagem ou no seu recebimento;
Bloqueado - A mensagem foi bloqueada para execução pelo usuário;
Nã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);
Recusada - 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 | ||
---|---|---|
| ||
Antes de realizar a integração de uma reserva de produto, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).
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.
|
Cadastro do adapter ItemReserve
- 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=3mCwQXkI0gE height 400
Informações | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
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 | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
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?
O sistema vai identificar o Lote com a data de validade mais próxima e fará a reserva do produto para esse lote.
|
Abaixo exemplo da mensagem ItemReserve:
Expandir | |||||
---|---|---|---|---|---|
| |||||
|
Demais informações
Dica | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
A mensagem pode ter diversos tipos de status e cada um deles esta vinculado a uma legenda sendo elas: Aguardando execução Executando Finalizada Falhou Bloqueado Não entregue Recusada Entregue |
Próximo passo
Dica | ||
---|---|---|
| ||
Após configurar e entender funcionamento de Reserva de Produto, vamos para o próximo passo, Clientes. |
...