Manual (SmartAPI)

Introdução

A SmrtAPI é um produto que transforma toda a camada do sage numa WebAPI, conseguem com isso fazer qualquer operação que fazem em sage na SmartAPI.
Exemplos:
Criar/alterar/apagar Documentos
Criar/alterar/apagar Artigos
Criar/alterar/apagar qualquer tabela, documento
Comunicar guias á AT
Imprimir Documentos
Gerar Safts
e muito mais

Manual de instalação

O processo de instalação da extensibilidade é bastante simples. 
Pedimos ao utilizador que siga os passos abaixo indicados para instalar o produto SmartAPI.
Para a utilização a base de dados deve correr numa versão SQL Server 2016 ou superior.

Passo 1 – Instalação

Executar o exe de instalação do produto como administrador.

Irá ser apresentado o quadro de configuração, que irá servir para fazermos a ligação ao Sage

Versao Sage: Devemos selecionar se estamos a usar o 50c faturação ou 50c Loja
Empresa: ID/Nome da empresa (a mesma definida na area de sistema do sage)
Chave de Licença: Chave de licenciamento da aplicação SmartAPI
ID da Máquina: Caso pretendamos que o serviço use um machideID diferente do servidor, devemos indicar qual o machineID definido na conf de postos do Sage. (opcional)
Nome do Serviço: Nome a dar ao serviço (opcional)

Uma vez instalada a SmartAPI com sucesso, podemos verificar que foi criado um serviço no windows de nome SmartAPI.Sage50cLoja

Esse serviço é responsável por colocar em funcionamento toda a SmartAPI, para verificarmos se a API está em fucnionamento depois de garantir que o serviço está a correr sem problemas, na maquina onde foi instalada a smartAPI devemos abrir o seguinte link no browser http://localhost:5581/swagger/ui/index

Irá ser mostrado o swagger da api onde têm ativos todos os endpoints que o licencimaneto pedido tem acesso.

NOTAS
Caso pretendam alterar a API_KEY ou a porta default (5581) da SmartAPI devem editar o seguinte ficheiro
C:\SmartApps\API\Service\SmartAPI.ini

nesse ficheiro encontramos as seguintes settings
X-API-KEYS=pass de acesso á api, caso coloquem varias senhas, devem separar as mesmas por ponto e virgula, ficando algo como A-API-KEYS=DEMO1;DEMO2;DEMO3
APIPort=porta usada pela SmartAPI

De notar que qualquer alteração que façam ao ficheiro em questão, devem reiniciar o serviço SmartAPI, para que as novas configurações sejam carregadas no arranque.