Histórico da Página
| Informações | ||
|---|---|---|
| ||
O cadastro de Saldo de |
...
estoque será atualizado no |
...
sistema TOTVS Protheus, e será integrado com o sistema |
...
TOTVS OMNI através de comunicação de Mensagem Única. Caso queira verificar os campos que compõem a mensagem de Saldo de estoque, acesse |
...
https://api.totvs.com.br/legado Clique no Link: Mensagem Padronizada |
...
, depois em Lista de Serviços |
...
e busque a mensagem Stocklevel. |
Pré-requisitos:
- Configuração do adapter Stocklevel. Para detalhes, acesse o link: Cadastro de Adapters / Cadastro De/Para Empresas.
Importante
- Configuração do Envio ativo para produtos com estoque alterado desde o último envio, acesse o link: SCHEDESTMG
- Cadastro de Produto - ITEM - (integrado)
- Cadastro De/Para Armazém
- Cadastro De/Para Filial
- Configuração Mozart
O envio da mensagem STOCKLEVEL, é realizado a cada movimentação de saldo de produto:
- Inclusão para validação do saldo em estoque, e envio da mensagem única Stocklevel.
- Documento de Entrada.
- Inclusão Alteração e Exclusão de saldo Inicial do Produto
- Inclusão Alteração e Exclusão de Transferências Simples
- Movimentação Interna de Produtos
- Inclusão Alteração Exclusão e Cópia de Pedido de Venda
- Liberação de Regras (Faturamento de Pedido)
- Prep Doc. de Saída (Faturamento de Pedido)
- Carga Inicial de Produtos - Envio de Saldo de Todos os Produtos que atendam as condições definidas no Adapter da mensagem: Cadastro de Adapters / Cadastro De/Para Empresas.
1. Inclusão de Saldo Inicial - Produto Simples ( Entrada de Saldo em Estoque ):
O cadastro de Saldo inicial, atualiza o saldo inicial do produto no Protheus, e integra via mensagem única a quantidade ao sistema CIASHOP.
Pré condição: Produto já cadastrado em ambas as bases:
Incluir pela Rotina de Saldo inicial do Protheus, Saldo para o Produto já integrado.
Clique em Confirmar para salvar e integrar o Saldo, com o sistema da Ciashop.
...
Importante: o registro será enviado toda vez que confirmar alguma ação: Inclusão, Alteração ou Exclusão.
Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"
...
- 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
Através dessa documentação vamos te ajudar a integrar o Saldo em estoque de produto entre TOTVS Protheus e TOTVS OMNI.
|
| Produto | Fluxo | Tipo da Mensagem | Versão MSU | Formato |
|---|---|---|---|---|
| TOTVS Protheus | Envia | Sincrona | 3.004 | JSON |
| TOTVS OMNI | Recebe | Sincrona | 3.004 | JSON |
| Dica | ||
|---|---|---|
| ||
Antes de realizar a integração de um saldo em estoque, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).
O Adapter é uma rotina responsável pela mensagem (StockLevel) 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. Também vamos precisar realizar o cadastro da rotina SCHEDESTMG, como um agendamento no schedule do TOTVS Protheus, abaixo o exemplo.
|
Cadastro do adapter StockLevel
No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
Clique em incluir e cadastre a rotina responsável pela mensagem StockLevel, 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 saldo em estoque do produto em questão será enviado ou não. |
Cadastro do agendamento do SCHEDESTMG
- No Configurador ( SIGACFG) acesse Schedule / Agent.
- Essa tela lista todos os agentes cadastrados e as tarefas atribuídas a cada um. Aqui é possível inicializar ou parar os agentes (todos ou de cada vez) através da seguinte barra de opções:
- Para criar um novo agente, clique na opção “Cadastro”
Conector de Widget width 600 url https://www.youtube.com/watch?v=wO6_4UKhIHw height 400
| Informações | ||
|---|---|---|
| ||
Importante: Para mais informações do cadastro do agendamento da rotina SCHEDESTMG.
|
Cadastro e integração do Saldo em estoque
- No Estoque/Custos (SIGAEST) acesse Atualizações / Saldos / Inicial (MATA220).
- Inclua o saldo inicial para o produto com as informações necessárias, como mostra o vídeo abaixo:
| Conector de Widget | ||||||
|---|---|---|---|---|---|---|
|
| Dica | ||
|---|---|---|
| ||
O que o saldo inicial precisa ter para ser integrado com o TOTVS OMNI corretamente?
O saldo em estoque será integrado somente na inclusão do Saldo Inicial?
Já tenho diversos saldos de estoque 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 a inclusão do saldo inicial 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 | |||||
|---|---|---|---|---|---|
| |||||
|
Demais informações
| Dica | ||
|---|---|---|
| ||
Após realizar a inclusão do Saldo inicial ou movimentação do estoque no TOTVS Protheus será gerado a mensagem StockLevel 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 StockLevel pelo TOTVS OMNI, o mesmo retorna uma mensagem para o Protheus informando sucesso ou falha na integração, que também pode ser visualizada no monitor do EAI. |
| Informações | ||
|---|---|---|
| ||
A mensagem pode ter diversos tipos de status e cada um deles esta vinculado a uma legenda sendo elas:
|
Próximo passo
| Dica | ||
|---|---|---|
| ||
Após integrar o saldo em estoque de um produto, vamos para o próximo passo, Integrando Preços |
OBS: link do DashBoard é fornecido pela CiaShop.
No sistema CIASHOP - Manager do Lojista, entrar em:
Categoria e Produtos / Catalogo de Produtos:
Entrar na Aba Preço/Estoque, selecionar o Produto que foi integrado o Saldo em Estoque, e clicar na edição do produto (lápis)
É demonstrado as quantidades integradas de todos os armazéns do Produto.
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 STOCKLEVEL
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original:
Código da Função: STOCKLEVEL
Descrição da Mensagem: TotvsMessage STOCKLEVEL Response Message
Tipo da Trasação: Recebimento
Tipo da Mensagem: Response Message
UUID da Mensagem Original: de234fb7-f95c-5bce-a921-0b0c4a272681
2 - Faturamento de Pedido - ( Saída de Saldo em Estoque )
Pré condição: Produto já integrado:
Incluir Pedido de Vendas.
...
Realizar a liberação de Crédito e Estoque:
Atualizações/Pedidos/Liberação de Crédito e Estoque
Liberar Todos
Resultado esperado:
...
Importante: o registro será enviado toda vez que confirmar alguma ação: Inclusão, Alteração ou Exclusão.
Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"
Faturamento do Pedido de Venda Sem Bloqueio de Regras:
Atualizações/Pedidos/Pedidos de Venda
Selecionar o Pedido de Vendas Sem Bloqueios a Faturar
Clicar e Outras Ações
Realizar a Prep de Doc de Saída - Clicando em AVANÇAR
Selecionar o número e série de NF a ser gerada, Clicar em OK
Verificação da integração via Mensagem Única
Conferir os envios de mensagens no caminho abaixo :
Pelo configurador, em Schedule:
Acessar SIGACFG / Configurador / Ambiente / Schedule / Schedule, selecionar EAI na coluna esquerda.
Na coluna direita em Transações, selecionar uma mensagem (legenda cor Cinza - Finalizada) no browse e após clicar na lupa e selecionar “ Visualizar Mensagem Original”, onde será aberto o arquivo XML com os dados da tag.
Importante: o registro será enviado toda vez que confirmar alguma ação: Inclusão, Alteração ou Exclusão.
Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"
A mensagem será atualizada com as TAGs alteradas:
...
- Aguarandoprocessamento: 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.
No sistema CIASHOP - Manager do Lojista, entrar em:
Categoria e Produtos / Catalogo de Produtos:
Entrar na Aba Preço/Estoque, selecionar o Produto que foi integrado o Saldo em Estoque, e clicar na edição do produto (lápis)
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 STOCKLEVEL
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original:
Código da Função: STOCKLEVEL
Descrição da Mensagem: TotvsMessage STOCKLEVEL Response Message
Tipo da Trasação: Recebimento
Tipo da Mensagem: Response Message
UUID da Mensagem Original: 0daa55f5-49b4-4dd4-8dbb-403e1b2a2755
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas