Histórico da Página

...

Visão Geral
Configurações
Exemplo de utilização
Principais Campos e Parâmetros
Demais Informações
Tabelas utilizadas

...

Expandir

title	Ambiente Protheus - Requisitos

1) Release Protheus a partir da 12.1.23102210

2) Aplicação das atualizações CTB, com data superior a 29/05/2024 e conforme release do ambiente.

Expandir

title	Comunicação Smartlink

Configurar a comunicação com SmartLink, inserindo as credenciais do cliente (clientId e clientSecret) na rotina FwSgdpParm (documentação detalhada: - Comunicação SmartLink )

Aviso

title	IMPORTANTE

Inserir a configuração somente no ambiente que estiver em produção. Bases de testes que estejam configuradas com o Smartlink utilizando as mesmas credenciais, 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

title	Ambiente Protheus - REST

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

Inserir também a chamada do serviço REST na seção ON START:

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.

Documentação completa das configurações REST/Server

03. EXEMPLO DE UTILIZAÇÃO

Abaixo temos o modelo de mensagem enviada ao Smartlink, que ficará disponível para o consumo através do Job schedulado no ERP.

...

Bloco de código

language	java
title	Exemplo de resposta com erro
collapse	true

{
    "specversion": "1.0",
    "time": "2022-10-18T11:04:03-03:00",
    "type": "PrtBalanResp",
	"tenantId": "d87804f9-xxxx-xxxx-9393-fe9ef0d13c10", /// tenant do cliente   
 	"id": "CODIGO IDENTIFICADOR DA MENSAGEM",
    "data": {
		"error":"Host not found."
    } 
}

...

Aviso

title	Parâmetros da propriedade "data" deveram ser enviados conforme a documentação API balancete modelo1.

API balancete modelo1

...

	O conteúdo do atributo data:{ } presente na requisição do Balancete, permite que mais parâmetros sejam enviados, para determinar filtros e regras a serem aplicadas na geração do Balancete. Esses parâmetros devem ser enviados conforme detalhados na

...

documentação API balancete modelo1.

...

API balancete modelo1