8. WebService / API

← Voltar ao índice

O SCPVendas disponibiliza um WebService para comunicação com a base de dados da aplicação, facilitando a integração com outros sistemas da empresa (ERP, e-commerce, logística, BI).

Objectivo

Permite que aplicações externas troquem informação com o SCPVendas através da Internet — clientes, artigos, documentos, stocks, sincronização, etc. — sem intervenção manual na app móvel.

Utiliza tecnologias standard como HTTP, XML e interfaces RESTful, compatíveis com a maioria das linguagens e plataformas.

O que pode integrar

• ERP (ex.: ARTSOFT)
• Plataformas de reporting e dashboards comerciais
• Sistemas de logística e expedição
• Portais web e e-commerce
• APIs REST e Data Warehouse / Business Intelligence

ContextApi — acções contextuais (app móvel)

Para além do WebService servidor, a app suporta acções contextuais configuráveis no BackOffice (tabelas MobileActions e MobileActionConfig):

• Disponíveis na ficha de cliente, conta corrente, artigo, documento, encomenda e recibo
• Menu (⋮) em cada ecrã com acções definidas na base de dados
• Executar pedidos HTTP, abrir páginas externas, consultar APIs ou mostrar resultados em diálogo

Variáveis de contexto

As acções e consultas dinâmicas suportam variáveis substituídas automaticamente:

• {numDoc} — número do documento
• {codCliente} / {nomeCliente}
• {codArtigo}
• {vendedor} / {emp}
• {serie} / {baseDados}

Novas funcionalidades podem ser activadas só por configuração, sem publicar nova versão da app.

Comandos remotos (FCM)

O administrador pode enviar comandos push via Firebase Cloud Messaging:

• ForceLogout — encerra a sessão no dispositivo
• SyncNow — desencadeia sincronização imediata

Documentação técnica

Para especificação completa dos endpoints, formatos XML/JSON e exemplos de integração, contacte a Scantec ou consulte a documentação fornecida com a licença.