Outros

Petrotec — configuração

Com o provider Petrotec – TPA ficam disponíveis as opções seguintes:

Indique o IP do terminal e o IP do PC. Em ambos a porta de comunicação é 45000.

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.