Contextualização
Atualmente a solução dataplace contempla a comunicação do ERP x Equipamento SAT das seguintes maneiras:
1 – Porta serial: Através de porta serial é feito o envio de comandos para o equipamento, efetivando a comunicação. A porta serial pode também ser acessada via Terminal server, ou em casos de uso no cloud, pelo App client do TS plus.
2 – Aplicativo de gerenciamento de fila: Através de um broker do SQL server, o ERP se comunica com o equipamento SAT por intermédio do pSymSAT_queue.exe. O aplicativo que controla a fila de execução se comunica da mesma forma que o item 1, via porta serial.
Problema
1 – Há equipamentos que não se comunicam via porta serial, o que impede utlização via porta compartilhada nos casos de terminal server e App client do TS plus.
2 – Há clientes que querem utilizar o Dataplace ERP na solução cloud, via navegador, mas isso não é possível.
Solução adotada
Dataplace ERP
Nova camada
(Api REST) Criação de um intermediador Dataplace ERP x Equipamento site, com suporte a protocolo http, conforme diagrama, que exemplefica uma venda:
![](https://dataplace.help/wp-content/uploads/2021/11/dataplace-sat-sol-complem-1024x229.png)
1 – O ERP, efetua a venda e com base no equipamento SAT selecionado (quando marcada a opção “SAT Ativo para funcionamento via API” e feitas as devidas configurações) envia para a API, hospedada na nuvem, a informação da venda, com os dados de autenticação e do destinatário, que é o equipamento SAT. Neste contexto, tanto equipamentos configurados com comunicação direta quanto os por fila, funcionarão.
2 – A requisição chega até a API, que identifica o usuário cadastrado (equipamento), verifica se o mesmo está na lista de equipamentos e se sim, envia para o equipamento, via client.
3- A mensagem é recebida pelo client que é um programa executável (Dataplace.Sat.Client.exe) que fica rodando na mesma máquina que está o equipamento SAT.
4 – Após receber a resposta do equipamento, o client encaminha a resposta para a API
5 – A reposta é finalmente entregue ao ERP, que segue o fluxo padrão.
Alterações no sistema
Dp.Library.01.dll: Toda comunicação SAT é feita passando pela dp.library.01, que agora, ao invés de encaminhar para o equipamento, pode enviar para a Nova camada (api).
Configurador Geral(psymCfg01);
No cadastro de equipamentos SAT, foi criado um novo campo: SAT Ativo para funcionamento via API.
Marcando este campo é possível abrir uma nova janela para configurar o funcionamento via API:
![](https://dataplace.help/wp-content/uploads/2021/06/dataplace-confg-geral-cad-sat.png)
![](https://dataplace.help/wp-content/uploads/2021/11/dataplace-confg-geral-cad-sat2.png)
Nesta nova janela, há os seguintes dados que devem ser configurados com auxílio da equipe de suporte:
A – Endereço da API: Endereço onde a API vai ser hospedada;
B – Identificador do dispositivo: o usuário deve gerar um identificador clicando no botão ao lado do campo;
C – Senha: Uma senha forte para autenticação (mínimo 6 caracteres, 1 maiúscula, 1 minúscula e um número)
Cadastrados estes dados, o usuário deve salvar para habilitar o botão processar.
Após salvar, deve contactar o suporte, que irá gerar o hash de instalação.
D – Hash de instalação: Este hash de instalação será gerado por um aplicativo de uso restrito a alguns profissionais de Suporte (a definir ainda). E após inserido, deve processar.
Finalizado o processamento, o equipamento já estará cadastrado na API e pronto para a segunda etapa da configuração.
Dataplace.Sat.Client.exe
![](https://dataplace.help/wp-content/uploads/2021/11/dataplace-confg-geral-sat-client.png)
ste executável deverá ser instalado na máquina onde ficará o equipamento SAT. Ele não depende de instalação do Symphony, portanto, ideal criar uma pasta específica para ele no cliente.
As informações cadastradas no configurador geral, podem ser inseridas campo a campo, neste aplicativo, ou clicando em Copiar na janela de Gerenciar configurações do SAT, no configurador geral, e colando usando (Ctrl + V) no campo Endereço da API.
Após os dados preenchidos, e a Dll devidamente informada, basta clicar em Iniciar para que a comunicação com o equipamento SAT seja estabelecida e a comunicação com a API também.
Com o status Conectado ativo, pode-se usar o ERP normalmente.