Histórico da Página
Informações | ||
---|---|---|
| ||
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 | AssincronaSincrona | 4.005 API011 | JSONCiaShop |
TOTVS OMNI | Recebe | AssincronaSincrona | 4.005 | JSON |
Pré requisitos:
...
Inclusão de Produto
...
011 | JSON |
Dica | ||
---|---|---|
| ||
Antes de realizar a integração de um Produto, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).
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.
|
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:
Conector de Widget | ||||||
---|---|---|---|---|---|---|
|
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(): 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
- Clique em Confirmar para salvar o complemento de produto, Em seguida no modulo
- No
- Faturamento (SIGAFAT)
- acesse Atualizações / Cenário de Vendas
- Cadastros / Categorias X
- Produtos ( FATA150
- MATA010).
- Inclua/Altere uma categoria de produtos, informando o produto cadastrado, e em seguida clique em confirmar, para integrar o produto com o E-Commerce.
Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"
...
- o produto com as informações necessárias, como mostra o vídeo abaixo:
Conector de Widget | ||||||
---|---|---|---|---|---|---|
|
Informações | |||||
---|---|---|---|---|---|
| |||||
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
Dica | ||
---|---|---|
| ||
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:
Conector de Widget | ||||||
---|---|---|---|---|---|---|
|
Expandir | |||||
---|---|---|---|---|---|
| |||||
|
...
Mensagem única do ITEM
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original.
Código da Função: ITEM
UUID: 51f3a62a-4765-3fcf-1b33-142f2167bb65
Descrição da Mensagem: PRODUTO
Tipo da Transação: Envio
Tipo da Mensagem: Business Message
Url Enviada: http://eaistaging.ciashop.com.br/protheus/tirateima
Evento: UpSert
Json:
- CiaShop - Recebimento
Recebimento da mensagem:
Para identificar o registro da mensagem enviada pelo sistema Protheus,é necessário acessar o DashBoard (Ferramenta de visualização de processamento de mensagens) e em seguida pesquisar pelo UUID da mensagem enviada pelo Protheus na categoria ITEM nos seguintes destinos:
- Aguarando processamento: Indica a quantidade de processos específicos, por exemplo (Reserva) estão aguardando na fila para serem executados.
- Processando: Significa que após aguardar na fila o arquivo é envidado para ser processado.
- Processado: Significa que o arquivo foi processado com sucesso, como por exemplo, enviou uma reserva para o Protheus e o mesmo retorno uma mensagem de sucesso.
- Error: Significa que receberá o log de erro da integração especifica, tanto ao tentar enviar quanto AguardoCallback com retorno de erro.
- Reprocessar: Indica que a mensagem estava processando e teve algum tipo de erro ou uma possível instabilidade e a mensagem irá reprocessar novamente
OBS: link do DashBoard é fornecido pela CiaShop.
...
|
Demais informações
Dica | ||
---|---|---|
| ||
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. |
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 integrar um Produto, vamos para o próximo passo, Integrando Saldo de Estoque. |
Obs: Informe seu usUario e senha de administrador.
- No Manager acesse Categorias e Produtos / Catálogo de Produtos.
Visualizando o Produto no Site do E-commerce
- Acesse o site do E-commerce e Procure na barra lateral esquerda a categoria que foi vinculada ao produto no Protheus.
Protheus – Recebimento da Response Message (Mensagens assíncronas)
Recebimento de respostas
- Sucesso: Indica que a mensagem foi processada com sucesso pela CiaShop e já esta no Manager do E-Commerce.
- Erro: Indica que a mensagem teve erro ao ser processada, e o motivo do erro esta descrito na mensagem de resposta da CiaShop.
Mensagem única do ITEM
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original:
Código da Função: Item
Descrição da Mensagem: TotvsMessage ITEM Response Message
Tipo da Trasação: Recebimento
Tipo da Mensagem: Response Message
UUID da Mensagem Original: 51f3a62a-4765-3fcf-1b33-142f2167bb65
Json:
...