Histórico da Página

O Portal do Fornecedor comunica com o ERP através de API, desta forma é necessário garantir que o serviço de API esteja disponível e acessível de forma externa.

Configurando as portas da API

O aplicativo RM.Host é responsável por hospedar e expor os serviços de APIs. Veja mais sobre a configuração da porta webApi.

A tag ApiPort configurada nesta etapa será utilizada durante a instalação do Portal.

Validação de acesso externo das APIs

Para validar se as configurações de portas das APIs foram realizadas corretamente, acesse o browser e digite a URL  http://{IP ou domínio}:{porta}/api/swagger/.

Exemplo: http://10.173.17.242:8051/api/swagger

Importante na validação usar o IP, nome da máquina ou domínio.

Verifique se a página abaixo foi carregada

____________________________________________________________________________________________________________________________________________________________________________________________________

Conectando com o banco de dados

Para que a API saiba em qual banco de dados conectar quando for acionada pelo Portal, devemos configurar a tag DefaulDB. Veja mais em Configurando DefaultDB.

Validação de acesso ao banco de dados através da API

Para validar se a configuração da comunicação com o banco de dados das APIs foi realizada corretamente, acesse a API via browser.

Exemplo: http://10.173.17.242:8051/api/est/v1/Unitofmeasures

Neste exemplo estamos usando o cadastro de Unidade de Medidas, ao acessar será solicitado um usuário do sistema que tenha acesso a este cadastro dentro do sistema.

Você deverá ter um resultado semelhante a este, onde lista os registros do cadastro de unidade de medida.

Para realizar a autenticação com as APIs utilizamos o usuário PORTALDOFORNECEDOR .

Este usuário é criado automaticamente pelo sistema durante o processo de comunicar fornecedor exportando os dados para web na cotação, mas para isso, é necessário antes definir qual código de acesso e perfil serão associados a este usuário.

____________________________________________________________________________________________________________________________________________________________________________________________________

Perfil

Cadastre um novo perfil, ou utilize um já existente que possua as permissões abaixo.

____________________________________________________________________________________________________________________________________________________________________________________________________

Parâmetros da cotação

Informe o perfil e código de acesso que serão utilizado para realizar a autenticação das APIs, nos parametros da cotação na etapa Definições Gerais 6/6

Configuração de Rotas, Paginação e Usuário RM

No diretório "C:\TOTVS\CorporeRM\FrameHTML\Web\App\Cmp\PortalDoFornecedor\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações:

{
	"rmApiServer": "http://192.168.10.12:8052/API/",
	"pageSize": 8,
}

• rmApiServer: Deve conter o endereço da URL de acesso ao RM. É para esta rota que serão direcionadas as requisições do portal, ela é a mesma que foi configurada anteriormente no RM.Host.exe.config ou RM.Host.service.exe.config , ou seja, http://Endereço (Ip ou nome da máquina onde o Host está instalado):APIPort. 
• pageSize: Número de itens da paginação.

Caso esteja utilizando alguma regra no IIS com Rewrite , na tag rmApiServer deve ser informado o caminho do portal conforme publicado no IIS, exemplo:

{
	"rmApiServer": "http://localhost/FrameHTML/Web/App/Cmp/PortalDoFornecedor/API/",
	"pageSize": 8,
}

IMPORTANTE:
Após configurar o arquivo config.json, é necessário limpar o cache do navegador, caso contrário, o arquivo de configuração antigo será mantido por um tempo.
A Tag rmApiServer deve obrigatoriamente terminar com barra "/".