Histórico da Página
...
| Produto: |
| ||||
|---|---|---|---|---|---|
| Linha de Produto: | |||||
| Segmento: |
| ||||
| Módulo: | Pesagem e Análise de Matéria Prima | ||||
| Função: | Controle Trafego Entrada - CTE | ||||
| País: | Brasil | ||||
| Ticket: | 20087651 | ||||
| Requisito/Story/Issue (informe o requisito relacionado) : | FSWAGRO-4932 |
02. SITUAÇÃO/REQUISITO
Criar integração com a Guardian para captura de peso, onde o SPA_OFF Server irá disponibilizar um endpoint para receber o peso e enviar para o SPA_Desktop.
Também será necessário enviar para o sistema da Guardian comandos para acionar cancela e enviar mensagem para o displayNecessário criar um pré-cadastrado no sistema do Guardian para permitir a pesagem.
03. SOLUÇÃO
Foi criado o endpoint no endereço /CCTRest/rest/integracao/Guardian/pesagemSaida
É esperado o envio de um json no formato:
{
"pontoAcesso": "P3_BAL01",
"referenciaIntegracao": "20250702172820481",
"tagCaminhao": "51389E00E20020473501009722702C104BCA",
"tagCarreta1": "621000EE00E20020473501009722702C104BCA",
"ticketCarreta1": "",
"tagCarreta2": "6211EE00E20020473501009722702C104BCA",
"ticketCarreta2": "",
"tagCarreta3": "",
"ticketCarreta3": "",
"tagCarreta4": "",
"ticketCarreta4": "",
"tagCarreta5": "",
"ticketCarreta5": "",
"tagCarreta6": "",
"ticketCarreta6": "",
"peso": 110000.00
}
criada uma integração, onde, no momento que é enviada a carga no client do SPA_OFF, é enviada uma requisição para a API do Guardian (no endpoint "cadastraTicketGuardian")
ex de xml enviado no corpo da requisição:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header/>
<soap:Body>
<CadastraTicketGuardian xmlns="http://toledobrasil.com.br/WS_Guardian">
<DadosTicket>
<PlacaCarreta>SED4A85</PlacaCarreta>
<PlacaVeiculo>SED4A85</PlacaVeiculo>
<TagAssociado>104940</TagAssociado>
<Fluxo>F1_CANA</Fluxo>
<ReferenciaIntegracao>104940210220244</ReferenciaIntegracao>
<CamposAdicionais>
<CampoAdicionalTicket>
<Numero>1000</Numero>
<Valor>176001</Valor>
</CampoAdicionalTicket>
<CampoAdicionalTicket>
<Numero>1001</Numero>
<Valor>104940210220244</Valor>
</CampoAdicionalTicket>
<CampoAdicionalTicket>
<Numero>1002</Numero>
<Valor>176000</Valor>
</CampoAdicionalTicket>
<CampoAdicionalTicket>
<Numero>1003</Numero>
<Valor>104940210220243</Valor>
</CampoAdicionalTicket>
</CamposAdicionais>
</DadosTicket>
</CadastraTicketGuardian>
</soap:Body>
</soap:Envelope>
headers:
Content-Type - text/xml; charset=utf-8
SOAPAction - http://toledobrasil.com.br/WS_Guardian/CadastraTicketGuardian
Após enviada essa requisição, no sistema do Guardian será criado um pre-cadastro e consequentemente um TicketGuardian. (Esse ticket da "permissão" para o caminhão passar pelas etapas seguintes de pesagem entrada, PCTS e pesagem saída, sem um ticket vinculado ao veiculo, ele não poderá realizar essas ações)
Existe a possibilidade de não precisar ser criado um pr-eCadastro, onde será criado automaticamente um ticketGuardian pelo sistema do Gaurdian, no momento que o caminhão passar pela leitura da tag (antena). Porém, para isso, será necessário que os equipamentos (caminhão e carretas) estejam previamente cadastrados no sistema do Guardian.
Através do parâmetro: RCMP_CAR - FG_CRIA_TICKET_GUARDIAN_CTE, é possivel "ativar ou desativar" essa integração (normalmente esse parâmetro será desativado quando o cliente utilizar Bate-volta, pois o caminhão que entrou com a carga e criou o ticketGuardian, não será o mesmo que vai passar na balanca de entrada, desta forma, quando o caminhao tiver sua tag lida, não vai achar nenhum ticketGuardian aberto para ele)onde:
pontoAcesso é o codigo identificador da balança (valor que será utilizado no cadastro de ponto de controle do PIMS SPA, no campo DE_INTEGRACAO para identificar o ponto de controle que as informações serão enviadas)
referenciaIntegracao codigo interno do sistema do Guardian
tagCaminhao é a tag do caminhao
tagCarreta1(...2,3,4,4 e 6) é a tag da carreta
ticketCarreta1(...2,3,4,5 e 6) é o ticketRastreio da carreta (enviado vazio pois inicialmente foi desenhado de uma forma, mas foi alterado no decorrer do projeto)
peso é o peso total da composição (soma de caminhão e carretas)
Quando o Server recebe essa requisição, ele busca na tabela EQUIPTOS o código do equipamento correspondente a tag recebida.
Através do código do equipamento, é recuperado o código do ticket de rastreio de cada carga da composição na APT_CARGAS (composição recuperada através do código do caminhão e da DT_ENTRADA da tabela APT_CARGAS. Todas as cargas com a mesma DT_ENTRADA do caminhão, com FG_STATUS = "A", formam uma composição)
O Server envia essa informação ao Client que por sua vez cria uma carga no campo de "cargas pendentes":
Ao clicar nessa carga, vemos que serão apresentadas as informações dos códigos dos equipamentos, do ticket de rastreio e do peso:
Quando a carga for submetida, será enviado um comando para a API do Guardian, pedindo para acionar a cancela e enviar uma mensagem no display ("SIGA PATIO").
04. DEMAIS INFORMAÇÕES
Parâmetros envolvidos:
RCMP_CAR - FG_INTEGR_GUARDIAN (Parâmetro para ativar a integração)
RCMP_CAR - URL_SERVICE_GUARDIAN (Parâmetro para configurar a URL do serviço do Guardian ex: "http://127.0.0.1/WS_GUARDIAN")
RCMP_CAR - FG_CRIA_TICKET_GUARDIAN_CTE (parâmetro para ativar ou desativar a integração que cria o pré-cadastro no sistema do Guardian)
Card documentos Informacao Use esse box para destacar informações relevantes e/ou de destaque. Titulo IMPORTANTE!
...

