Importante!
O cadastro de Produtos será realizado no sistema TOTVS Protheus, e será integrado com o sistema TOTVS OMNI através de comunicação de Mensagem Única (ITEM).
Caso queira verificar os campos que compõem a mensagem de Item, acesse https://api.totvs.com.br/legado Clique no Link: Mensagem Padronizada, depois em Lista de serviços e busque a mensagem Item.
Produto | Fluxo | Tipo da Mensagem | Versão MSU | Formato |
---|---|---|---|---|
TOTVS Protheus | Envia | Sincrona | 4.011 | JSON |
TOTVS OMNI | Recebe | Sincrona | 4.011 | JSON |
Dica!
Antes de realizar a integração de um 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 (Item) 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 ITEM
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:
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 |
MATA010 | Item | Produto | Sim | Não | Síncrono | Todas | LjxjCsCoPr() | PAD.APP | 4.011 | 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():
LjxjCsCoPr(): Esta função verifica se o produto cadastrado atende as seguintes condições:
Produto vinculado à uma Categoria de Produtos
Produto com complemento de produtos cadastrado e o campo E-commerce(B5_ECFLAG) = 1 - Ativo.
Atendendo estes requisitos a mensagem de Item será gerada e enviada ao TOTVS OMNI.
Cadastro e integração do Produto
- No Faturamento (SIGAFAT) acesse Atualizações / Cadastros / Produtos (MATA010).
- Inclua/Altere o produto com as informações necessárias, como mostra o vídeo abaixo:
Duvida
O que um produto precisa ter para ser integrado com o TOTVS OMNI corretamente?
Já tenho diversos produtos cadastrados que atende os dados informados acima e quero integra-los, o que eu faço?
Neste caso deve ser realizado a execução da Carga inicial.
Mensagem gerada e enviada para o TOTVS OMNI
Visualizar o dado gerado
Após realizar o cadastro de Produto e suas demais informações necessárias para integra-lo é possível visualizar a mensagem gerada e enviada para o TOTVS OMNI, para isso siga o passo a passo abaixo:
- Acesse o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:
- Em seguida posicione o cursos na mensagem gerada e clique no ícone da Lupa e em seguida, Visualizar mensagem original, como mostra o vídeo abaixo:
Demais informações
Fluxo da integração de Produto
Após realizar o cadastro do Produto no TOTVS Protheus será gerado a mensagem ITEM no EAI do configurador, essa mensagem é disparada ao TOTVS OMNI através da ROTA cadastrada e vinculado ao Adapter ITEM.
Quando recepcionado e processada a mensagem ITEM pelo TOTVS OMNI, o mesmo retorna uma mensagem para o Protheus informando sucesso ou falha na integração.
Em caso de sucesso, é gravado no Protheus na tabela XXF um DE/PARA de Produto, com o código do Produto atribuído no TOTVS OMNI relacionando com o código do Produto 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.
Legendas de status da mensagem
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
Vamos lá!
Após integrar um Produto, vamos para o próximo passo, Integrando Saldo de Estoque.