Painel da integração: mudanças entre as edições
De CIGAM WIKI
Criou página com '<h1>Painel da Integração</h1> <p> O painel disponibiliza métricas, monitoramento e rastreabilidade da integração. </p> <h2>Métricas Iniciais</h2> <ul> <li>Tarefas na fila</li> <li>Vínculos De/Para</li> <li>Pedidos importados</li> <li>Logs processados</li> </ul> <h2>Classificação dos Logs</h2> <ul> <li><strong>Azul:</strong> envio para o MERCOS</li> <li><strong>Verde:</strong> resposta HTTP 200 ou 201</li> <li><strong>Vermelho:</s...' |
Sem resumo de edição |
||
| (3 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 4: | Linha 4: | ||
O painel disponibiliza métricas, monitoramento e rastreabilidade da integração. | O painel disponibiliza métricas, monitoramento e rastreabilidade da integração. | ||
</p> | </p> | ||
[[Arquivo:Mercos_integracaoHome.png]] | |||
<h2>Métricas Iniciais</h2> | <h2>Métricas Iniciais</h2> | ||
[[Arquivo:Mercos_integracaoHomeVinculos.png]] | |||
<p> | |||
Painel que mostra o andamento da integração: | |||
</p> | |||
<ul> | <ul> | ||
<li>Tarefas na fila</li> | <li>Tarefas na fila | ||
<li>Vínculos De/Para</li> | * Indica quantas tarefas estão aguardando na fila , geralmente são tarefas de envio de dados do CIGAM para o MERCOS</li> | ||
<li>Pedidos importados</li> | <li>Vínculos De/Para | ||
<li>Logs processados</li> | * Indica o total de vínculos de/para armazenados e controlados pela integração. | ||
* Vínculos de/para são dados vinculados entre Id mercos e ID CIGAM de cada registro</li> | |||
<li>Pedidos importados | |||
* Total de pedidos importados pela integração, são pedidos que são baixados do MERCOS para dentro do CIGAM</li> | |||
<li>Logs processados | |||
* Cada comunicação efetuada entre os sistemas é armazenada em LOG, isso possibilita rastrear o resultado de cada comunicação efetuada entre os dois sistemas e ver como um determinado dado foi enviado e recebido.</li> | |||
</ul> | </ul> | ||
<h2>Classificação dos Logs</h2> | <h2>Classificação dos Logs</h2> | ||
[[Arquivo:Mercos_integraçãohomeLogs.png]] | |||
<ul> | <ul> | ||
<li><strong>Azul:</strong> envio para o MERCOS</li> | <li><strong>Azul:</strong> envio para o MERCOS</li> | ||
<li><strong>Verde:</strong> resposta HTTP 200 ou 201</li> | <li><strong>Verde:</strong> resposta HTTP 200 ou 201</li> | ||
<li><strong>Vermelho:</strong> erro de comunicação</li> | <li><strong>Vermelho:</strong> erro de comunicação | ||
* Erros de comunicação podem ocorrer por seguintes situações: | |||
** Indisponibilidade temporária da api Mercos, o Código Http armazenado no log ajudará a diagnosticar. | |||
** Envio Incorreto de alguma informação ou falta dela. Exemplo: No Mercos pode estar marcado que o telefone é um campo obrigatório e o cadastro da empresa no CIGAM pode estar vazio. | |||
** Nos casos de erros o diagnostico deve ser feito caso a caso pois as regras de negócio podem variar.</li> | |||
</ul> | </ul> | ||
<h2>Fila de Processos</h2> | <h2>Fila de Processos</h2> | ||
<p> | <p> | ||
Lista os processos aguardando execução. | Lista os processos aguardando execução. | ||
* Quando um evento ocorre no CIGAM uma tarefa é adicionada na fila de envio para o Mercos. | |||
* Exemplos: | |||
** Um novo cliente é Cadastrado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos. | |||
** Um cadastro de cliente é Editado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos. | |||
** Um preço é alterado na tabela, uma ação GEPRECTA é adicionada na fila para envio ao Mercos. | |||
** Um pedido troca de Controle no CIGAM, uma ação STATUSPEDIDO é adicionada na fila para envio ao Mercos. | |||
** Um pedido é faturado no CIGAM, uma ação FATURAPEDIDO é adicionada na fila para envio ao Mercos. | |||
** Um pedido é cancelado no CIGAM, uma ação CANCELAPEDIDO é adicionada na fila para envio ao Mercos. | |||
** A Execução das tarefas da fila é parametrizada conforme o volume de eventos que ocorrem na base do Cliente, por padrão a fila é executada a cada 3 ou 4 minutos podendo baixar a 2 minutos. | |||
</p> | </p> | ||
| Linha 39: | Linha 54: | ||
Apresenta as últimas comunicações realizadas entre MERCOS e CIGAM. | Apresenta as últimas comunicações realizadas entre MERCOS e CIGAM. | ||
</p> | </p> | ||
<p> | |||
A integração serve como um intérprete entre dois sistemas completamente diferentes. A Mercos disponibiliza sua interface de programação de Aplicações (API) para que seja consumida para envio e retorno de informação entre os sistemas. Nesta questão, em vários momentos a integração pergunta e o Mercos responde. Para que possamos rastrear Como um dado foi enviado ao Mercos ou Como um dado veio do Mercos, a integração armazena logs para diagnosticos. | |||
</p> | |||
<p> | <p> | ||
Próxima Página | Próxima Página | ||
</p> | </p> | ||
* [[Menu da Integração]] | * [[Menu da Integração]] | ||
Edição atual tal como às 16h54min de 21 de agosto de 2026
Painel da Integração
O painel disponibiliza métricas, monitoramento e rastreabilidade da integração.
Métricas Iniciais
Painel que mostra o andamento da integração:
- Tarefas na fila
- Indica quantas tarefas estão aguardando na fila , geralmente são tarefas de envio de dados do CIGAM para o MERCOS
- Vínculos De/Para
- Indica o total de vínculos de/para armazenados e controlados pela integração.
- Vínculos de/para são dados vinculados entre Id mercos e ID CIGAM de cada registro
- Pedidos importados
- Total de pedidos importados pela integração, são pedidos que são baixados do MERCOS para dentro do CIGAM
- Logs processados
- Cada comunicação efetuada entre os sistemas é armazenada em LOG, isso possibilita rastrear o resultado de cada comunicação efetuada entre os dois sistemas e ver como um determinado dado foi enviado e recebido.
Classificação dos Logs
- Azul: envio para o MERCOS
- Verde: resposta HTTP 200 ou 201
- Vermelho: erro de comunicação
- Erros de comunicação podem ocorrer por seguintes situações:
- Indisponibilidade temporária da api Mercos, o Código Http armazenado no log ajudará a diagnosticar.
- Envio Incorreto de alguma informação ou falta dela. Exemplo: No Mercos pode estar marcado que o telefone é um campo obrigatório e o cadastro da empresa no CIGAM pode estar vazio.
- Nos casos de erros o diagnostico deve ser feito caso a caso pois as regras de negócio podem variar.
- Erros de comunicação podem ocorrer por seguintes situações:
Fila de Processos
Lista os processos aguardando execução.
- Quando um evento ocorre no CIGAM uma tarefa é adicionada na fila de envio para o Mercos.
- Exemplos:
- Um novo cliente é Cadastrado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos.
- Um cadastro de cliente é Editado no CIGAM, uma ação GEEMPRES é adicionada na fila para envio ao Mercos.
- Um preço é alterado na tabela, uma ação GEPRECTA é adicionada na fila para envio ao Mercos.
- Um pedido troca de Controle no CIGAM, uma ação STATUSPEDIDO é adicionada na fila para envio ao Mercos.
- Um pedido é faturado no CIGAM, uma ação FATURAPEDIDO é adicionada na fila para envio ao Mercos.
- Um pedido é cancelado no CIGAM, uma ação CANCELAPEDIDO é adicionada na fila para envio ao Mercos.
- A Execução das tarefas da fila é parametrizada conforme o volume de eventos que ocorrem na base do Cliente, por padrão a fila é executada a cada 3 ou 4 minutos podendo baixar a 2 minutos.
Últimos Logs
Apresenta as últimas comunicações realizadas entre MERCOS e CIGAM.
A integração serve como um intérprete entre dois sistemas completamente diferentes. A Mercos disponibiliza sua interface de programação de Aplicações (API) para que seja consumida para envio e retorno de informação entre os sistemas. Nesta questão, em vários momentos a integração pergunta e o Mercos responde. Para que possamos rastrear Como um dado foi enviado ao Mercos ou Como um dado veio do Mercos, a integração armazena logs para diagnosticos.
Próxima Página
