Implementação de geração de logs em arquivo .txt para o processamento de pedidos da integração Junsoft, replicando os principais pontos já registrados no log do banco e melhorando a rastreabilidade do fluxo.
Produto | Linx DMS Web |
|---|---|
Menu | Oficina > Recapagem > Log Comunicação API Junsoft |
Data |
|
Autor | Alison Romeu Lamas da Silva |
Uso Interno | AUTO-89587 |
Área | Automotivo P&D |
Melhorar a rastreabilidade da integração com a JunSoft, permitindo consultar em arquivo .txt o histórico do processamento dos pedidos, inclusive em casos de erro ou interrupção antes da finalização completa do processo.
Este documento se destina a todos dos clientes que utilizam o Linx DMS.
Para que a geração do log em arquivo .txt funcione corretamente, é necessário que a integração JunSoft esteja devidamente parametrizada para a empresa e revenda em execução, incluindo a URL do serviço, código da empresa JunSoft e os parâmetros de movimentação utilizados no processamento dos pedidos. Também é necessário que o endpoint ProcessaPedidosPendentes esteja sendo executado com empresa, revenda e usuário válidos.
- Início do processamento
O endpoint é executado para uma determinada empresa e revenda, iniciando o fluxo de integração com a JunSoft.
Geração do arquivo de log TXT
O sistema monta o caminho do arquivo de log diário em:Documentos\Logs\Pedidos PendentesO arquivo é gerado com o nome do dia, por exemplo:
ProcessaPedidosPendentes_20260512.txt- Busca de pedidos pendentes na JunSoft
O sistema registra no log TXT a chamada de busca dos pedidos pendentes, informando a URL da JunSoft, o endpoint utilizado e os parâmetros da empresa JunSoft. - Retorno da busca de pedidos
Após a resposta da JunSoft, o sistema registra no TXT a quantidade de pedidos recebidos, os pedidos retornados e as empresas JunSoft identificadas no retorno. - Filtro por empresa JunSoft
Os pedidos retornados são filtrados conforme oCodigoEmpresaJunsoftparametrizado para a empresa e revenda em processamento. Caso nenhum pedido pertença à empresa parametrizada, isso também é registrado no log TXT. - Validações antes do processamento
Para cada pedido filtrado, o sistema valida informações necessárias, como cadastro do cliente, movimentações parametrizadas, cadastro dos itens e quantidade em litígio disponível. Se alguma validação impedir o processamento, o motivo é gravado no TXT. - Processamento do pedido
Quando o pedido está válido, o sistema realiza o processamento no Linx DMS, podendo criar pedido, OS, movimentações de peças, serviços, notas fiscais ou cancelamentos, conforme o status e os itens do pedido. - Commit da transação principal
Após processar o pedido com sucesso, o sistema realiza ocommitda transação principal no banco. Esse momento é registrado no TXT para comprovar que o banco foi confirmado antes da confirmação na JunSoft. - Envio da confirmação para a JunSoft
Somente depois docommit, o sistema envia a confirmação do processamento para a JunSoft pelo endpoint de confirmação do pedido. - Retorno da confirmação
O retorno da JunSoft também é gravado no TXT, contendo os dados recebidos após o envio da confirmação. - Atualização do status de envio
Após confirmar o pedido na JunSoft, o sistema atualiza o status de envio no Linx DMS para indicar que o pedido foi confirmado. - Tratamento de erros
Caso ocorra erro em qualquer ponto crítico do processo, como busca de pedidos, processamento, confirmação ou atualização de status, o erro é registrado no TXT com a exceção detalhada. - Finalização do processo
Ao final da execução, o sistema registra no TXT o encerramento do processamento e a quantidade de pedidos filtrados para aquela execução.
======================================================================
Data/Hora : 12/05/2026 17:10:07
Empresa : 1
Revenda : 22
Mensagem : Início da execução do ProcessaPedidosPendentes.
JSON:
{
"Empresa": 1,
"Revenda": 22,
"Usuario": 0
}
======================================================================
Data/Hora : 12/05/2026 17:10:07
Empresa : 1
Revenda : 22
Mensagem : Busca de Pedidos pendentes na JunSoft - URL http://junsoftmobile.sipal.com.br:8081/JunsoftApolloAS/api/
JSON:
{
"Metodo": "GET",
"Url": "http://junsoftmobile.sipal.com.br:8081/JunsoftApolloAS/api/",
"Endpoint": "/pedido",
"CodigoEmpresaJunsoft": "1"
}
======================================================================
Data/Hora : 12/05/2026 17:10:15
Empresa : 1
Revenda : 22
Mensagem : Nenhum pedido foi processado após o filtro por empresa JunSoft. A JunSoft retornou pedidos, porém nenhum pertence ao CodigoEmpresaJunsoft parametrizado para esta empresa/revenda.
JSON:
{
"CodigoEmpresaJunsoftParametro": "1",
"TotalPedidosRecebidosJunsoft": 1,
"IdsEmpresasRecebidas": [
5
],
"PedidosRecebidos": [
{
"Pedido": 6082,
"IdEmpresa": 5,
"Cliente": "GUILHERME PERTILE PINHEIRO",
"CpfCnpj": "029.622.061-23",
"StatusPedido": "N"
}
]
}
======================================================================
Data/Hora : 12/05/2026 17:10:15
Empresa : 1
Revenda : 22
Mensagem : Retorno da busca de Pedidos pendentes na JunSoft - URL http://junsoftmobile.sipal.com.br:8081/JunsoftApolloAS/api/
JSON:
{
"Metodo": "GET",
"Url": "http://junsoftmobile.sipal.com.br:8081/JunsoftApolloAS/api/",
"Endpoint": "/pedido",
"CodigoEmpresaJunsoftParametro": "1",
"TotalRecebido": 1,
"IdsEmpresasRecebidas": [
5
],
"PedidosRecebidos": [
{
"Pedido": 6082,
"IdEmpresa": 5,
"Cliente": "GUILHERME PERTILE PINHEIRO",
"CpfCnpj": "029.622.061-23",
"StatusPedido": "N"
}
],
"TotalFiltradoEmpresa": 0,
"RetornoFiltrado": []
}
======================================================================
Data/Hora : 12/05/2026 17:10:15
Empresa : 1
Revenda : 22
Mensagem : Fim da execução do ProcessaPedidosPendentes.
JSON:
{
"TotalPedidosFiltrados": 0
}
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br.
Seu período de teste Premium terminouSeu período de teste Premium terminou