Antes de tudo devemos abrir o Sage como administrador para garantir que os certificados e servidor de ligação fica bem configurado. Existem as seguintes opções assim que escolhemos um terminal do tipo “SIBS – TPA”
Activo: Indicamos se este provider está ou não ativo Nome do Perfil: Nome indicado para este perfil Modalidade de pagamento: Modalidade de pagamento a usar para despoletar este provider. Endereço IP: Endereço IP da maquina local (POS), por defeito devem deixar https://+:10005/
Para uma correta instalação devemos seguir os passos numerados pela sua ordem.
1- Instalar certificado
Caso o instalar certificado dê algum erro de permissão, devem instalar como administrador o ficheiro .bat que aparece nessa mesma janela
2- Testar Ligação
Devem carregar em iniciar Servidor, uma vez o servidor iniciado devem ir ás configurações do SmartPOS do TPA, carregar em ligação WI-Fi, nessa opção devem colocar o IP do POS da seguinte forma wss://192.168.1.10:10005 (devem trocar o IP pelo IP do POS) e carregar em conectar.
3-Emparelhar equipamento
Nessa opção o terminal SmartPOS vai mostrar um código, devem colocar esse código na janela como mostrado na imagem.
4-Pedido de Credenciais de Autenticação
Esta Informação é fornecida e retirada pelo portal da EAT da Sibs
5- Configurar dados do Comerciante Neste opção podemos listar assim como alterar os dados do comerciante, e enviar os mesmos novamente para o terminal
Para além das funções de abrir e fichar TPA (que podem consultar no manual base), para os terminais do tipo SIBS (SmartPOS), existem outras duas.
SDCS.SIBS.NIF Esta função envia para o equipamento um formulário para o cliente colocar o NIF, esse NIF depois fica agarrado á transação.
SDCS.SIBS.INQUIRY Esta função envia para o equipamento um formulário de inquerito, para o cliente avaliar o atendimento, essa classificação é depois enviada para campo extra do documento
Assim que escolhido o tipo de Provider “Petrotec – TPA” ficamos com as seguintes opções disponiveis
A única configuração que temos de meter é o IP do terminal assim como o IP do pc em questão. Em ambos os casos a porta de comunicação é a 45000. Para garantirmos que está tudo OK devemos carregar em testar ligação e aguardar o sucesso da mesma
Instalação ConectorStoreAce
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 e 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.
