1. Objetivo do manual
Este manual descreve o procedimento de instalação, configuração inicial e validação do serviço StoresAce para Sage 50c. O objetivo é permitir que um técnico execute a instalação de forma consistente, evitando os erros mais comuns observados durante o processo.
Nota: Os nomes das empresas, tokens e caminhos podem variar de cliente para cliente. Deve confirmar sempre os dados antes de iniciar a configuração.
2. Pré-requisitos
- Acesso ao Windows com permissões de Administrador.
- Sage 50c instalado e funcional na máquina.
- Instalador do StoresAce Service disponível no ambiente de trabalho ou numa pasta local.
- Token e empresa/empresa fiscal a associar ao conector StoresAce.
- Acesso aos Serviços do Windows para parar e iniciar serviços.
Atenção: Antes de iniciar a configuração, confirme que não existem sincronizações críticas em execução. Se o serviço já existir, deve ser parado temporariamente durante a configuração.
3. Instalação passo a passo
3.1 Executar o instalador StoresAce
Execute o instalador do serviço StoresAce com permissões de administrador. No ecrã do instalador, confirme a pasta de destino. No vídeo, a pasta utilizada é:
C:\ProgramData\Sage\StoresAce
Clique em Install para extrair os ficheiros a preparar a estrutura de instalação.
3.2 Abrir os Serviços do Windows e parar o serviço
Abra a consola Services do Windows e procure o serviço Sage 50c XSBC Sync Service. Caso esteja em execução, pare o serviço antes de prosseguir.
- Abrir o menu Iniciar e pesquisar por Services/Serviços.
- Localizar Sage 50c XSBC Sync Service.
- Clicar com o botão direito e escolher Stop/Parar, ou usar a opção Stop na consola.
3.3 Abrir a linha de comandos como Administrador
Abra o Command Prompt/CMD como Administrador. Este passo é obrigatório, porque a configuração e arranque do serviço exigem permissões elevadas.
cmd.exe # Executar como Administrador
Entre na pasta base da instalação:
cd C:\ProgramData\Sage\StoresAce
3.4 Confirmar a estrutura de pastas criada
Depois da extração, a pasta C:\ProgramData\Sage\StoresAce deve conter, pelo menos, a pasta Service e os ficheiros batch de apoio à instalação.
Entre na pasta Service, onde se encontram os executáveis, DLLs e ficheiros de configuração do serviço.
cd C:\ProgramData\Sage\StoresAce\Service
3.5 Executar a ferramenta de configuração do serviço
Na linha de comandos, já dentro da pasta Service, execute o comando seguinte:
Sage50c.XSBC.Sync.Service.exe -c
Este comando abre o conector StoresAce e permite executar a inicialização/submissão da configuração.
Atenção: O comando deve ser executado dentro da pasta Service. Se for executado na pasta base C:\ProgramData\Sage\StoresAce, o Windows pode devolver a mensagem de erro “is not recognized as an internal or external command”.
3.6 Configurar o StoresAce Connector
No StoresAce Connector, confirme o token apresentado e a empresa disponível na lista. No vídeo, a empresa aparece associada ao identificador fiscal CRT.510522130.
- Confirmar o token no campo Token.
- Clicar em Refresh Companies, se for necessário atualizar a lista de empresas.
- Selecionar a empresa correta.
- Clicar em Init & Submit para gerar e submeter o pacote de inicialização.
3.7 Iniciar novamente o serviço
Depois da inicialização terminar sem erros, volte à consola Services do Windows e inicie novamente o serviço Sage 50c XSBC Sync Service.
- Abrir Services/Serviços.
- Selecionar Sage 50c XSBC Sync Service.
- Clicar com o botão direito e escolher Start/Iniciar.
- Confirmar que o estado passa para Running/Em execução.
4. Validação final
No final da instalação, confirme os seguintes pontos:
Validação O que confirmar
Serviço instalado O serviço Sage 50c XSBC Sync Service aparece na consola Services.
Serviço em execução O estado do serviço está Running/Em execução.
Conector inicializado A ação Init & Submit terminou sem mensagens de erro.
Ficheiros de configuração A pasta Service contém os ficheiros .config e os executáveis do serviço.
Logs sem erros críticos Os logs do serviço ou do conector não apresentam falhas de autenticação, empresa inválida ou erro de comunicação.
5. Erros comuns e troubleshooting
Sintoma Causa provável Correção recomendada
“is not recognized as an internal or external command” O comando foi executado fora da pasta Service. Executar primeiro: cd C:\ProgramData\Sage\StoresAce\Service
O serviço não inicia Serviço mal instalado, permissões insuficientes ou configuração incompleta. Confirmar permissões de administrador, validar ficheiros .config e rever logs.
Empresa não aparece no conector Lista de empresas não atualizada ou Sage 50c sem empresa acessível. Clicar em Refresh Companies e confirmar acesso à empresa no Sage 50c.
Init & Submit falha Token inválido, falha de comunicação ou dados da empresa inconsistentes. Validar token, ligação à Internet/API e logs gerados.
Serviço já estava em execução durante a configuração O serviço não foi parado antes da alteração. Parar o serviço, repetir a configuração e iniciar novamente.
Boas práticas: Se a instalação for feita num cliente, registe a versão instalada, token utilizado, empresa configurada e data/hora da intervenção.
6. Resumo rápido dos comandos
cd C:\ProgramData\Sage\StoresAce
cd Service
Sage50c.XSBC.Sync.Service.exe -c
Após executar os comandos, use o StoresAce Connector para fazer Init & Submit e inicie o serviço nos Serviços do Windows.