Histórico da Página
...
- Visão Geral
- Configurações
- Exemplo de utilização
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
Esse documento apresenta os passos necessários para ativação e consumo da API Balancete Modelo1 (CTR040S) via Smartlink .
Essa integração prevê a leitura de mensagens enviadas ao SmartLink, através de uma rotina configurada no Schedule do ambiente do cliente. As mensagens serão consumidas pelo ERP, que fará o processamento do Balancete conforme parâmetros solicitados.
A partir dos dados recebidos pelo ERP, haverá a chamada de uma API dentro do próprio ERP, que estará disponível para consumo através das configurações REST citadas abaixo. Após o consumo dessa API, uma mensagem de retorno será enviada ao SmartLink com os dados do Balancete.
Será necessária a atualização do ambiente seguindo a ordem descrita nos tópicos abaixo.Configurar o SMARTLINK de acordo com a documentação: Comunicação SmartLink utilizando as credenciais (client_id e client_secret) .(jogar no tópico 2....)
Configurar no Schedule o Job FWTOTVSLINKJOB ..(jogar no tópico 2....)
Aviso | ||
---|---|---|
| ||
Inserir a configuração somente no ambiente que estiver em produção. Bases de testes que estejam configuradas com o Smartlink interceptarão mensagens da fila da mesma forma que a base de produção, fazendo com que a gravação ou retorno dos dados sejam executados na base de testes. |
...
Expandir | ||
---|---|---|
| ||
1) Release Protheus a partir da 12.1.2210 2) Aplicar a última expedição continua do Protheus, juntamente com o diferencial de dicionário através do UPDDISTR, de acordo com a sua versão da Release. |
Expandir | |||||
---|---|---|---|---|---|
| |||||
Configurar a comunicação com SmartLink, inserindo as credenciais do cliente (clientId e clientSecret) na rotina FwSgdpParm (documentação detalhada: Comunicação SmartLink )
|
Expandir | ||
---|---|---|
| ||
|
Expandir | ||
---|---|---|
| ||
O sistema irá chamar a api com base nos parâmetros configurados no arquivo appserver.ini conforme modelo abaixo: Para o modelo acima a requisição será direcionada para o endereço : http://localhost:9090/api/ctb/balance/model1 Observações:
|
02. EXEMPLO DE UTILIZAÇÃO
...
04. Configuração do ambiente Protheus Rest (jogar no tópico 2....)
O sistema irá chamar a api com base nos parâmetros configurados no appserver.ini conforme modelo abaixo:
...
Observações:
- O sistema irá procurar a tag HTTPREST consultar o parâmetro URIs para encontrar a tag que define o caminho do servidor Rest no caso acima: URL=/rest
- O sistema irá procurar a porta configura na tag HTTPREST para montagem da consulta api.
- Se as tags e parâmetros não existirem ou não estiverem configuradas o retorno para a chamada será de 404 not found pois o sistema não encontrará a api para consulta.
...
Em casos onde o security = 1 a api deverá ser adicionada na lista de exceções conforme modelo abaixo.
05 DEMAIS INFORMAÇÕES
Schedule - Como agendar a execução de rotinas
06.TABELAS UTILIZADAS
- CT1- Plano de Contas
- CQ0- Saldo por Conta no Mês
- CQ1- Saldo por Conta no Dia
- CVN - Plano de Contas Referencial
- CVD - Plano de Contas Referenciais
- CTG - Calendário Contábil
...