Manual (SmartAPI)

Criado por Etorre · 02/07/2026 Alterado por Etorre · 18/08/2026

Visão geral

Introdução

A SmartAPI expõe a camada do Sage 50 como Web API. Tudo o que faz no Sage pode ser feito via API: criar, alterar e apagar documentos, artigos e outras tabelas; comunicar guias à AT; imprimir documentos; gerar SAF-T; e muito mais.

.NET FrameworkVersão 4.7.2
Base de dadosSQL Server 2016 ou superior
Sage 50Versão 2021 ou superior
Preparação

Instalação

Execute o instalador como administrador.

Instalação da SmartAPI
Instalação da SmartAPI.

O quadro de configuração faz a ligação ao Sage:

Quadro de configuração da SmartAPI
Ligação ao Sage na instalação.
CampoDescrição
Versão Sage50c Faturação ou 50c Loja.
EmpresaID/nome da empresa (o mesmo da área de sistema do Sage).
Chave de licençaChave de licenciamento da SmartAPI.
ID da máquinaOpcional. Machine ID definido na configuração de postos, se o serviço não usar o do servidor.
Nome do serviçoOpcional. Nome a dar ao serviço Windows.

Após a instalação é criado o serviço Windows SmartAPI.Sage50cLoja.

Serviço Windows SmartAPI
Serviço Windows da SmartAPI.

Com o serviço a correr, abra no browser da máquina onde foi instalada:

http://localhost:5581/swagger/ui/index
Swagger da SmartAPI
Swagger com os endpoints incluídos no licenciamento.

Chave e porta

Para alterar a API key ou a porta predefinida (5581), edite C:\SmartApps\API\Service\SmartAPI.ini.

Ficheiro SmartAPI.ini
Ficheiro SmartAPI.ini.
X-API-KEYSPalavra-passe de acesso. Várias chaves separam-se por ponto e vírgula, por exemplo DEMO1;DEMO2;DEMO3.
APIPortPorta da SmartAPI.
Reiniciar o serviço Qualquer alteração ao INI só entra em vigor depois de reiniciar o serviço SmartAPI.