Pôr o SAGE na internet
O zrsPOS corre na nuvem, por isso a sua SmartAPI tem de responder num endereço https público e fixo. O que tem de estar certo no fim, os passos para quem gere a sua rede, e um SAGE alojado pelo seu parceiro.
O seu Sage 50c corre na sua própria rede; o zrsPOS corre na nuvem. Para emitir documentos, a SmartAPI tem de responder a partir da internet. Quem a prepara é o seu parceiro SAGE. Cada problema de «não é possível chegar ao SAGE» em Definições › Ligação ao SAGE abre esta tarefa guiada com Mostrar como pôr o SAGE na internet.
O que tem de estar certo no fim
- A SmartAPI responde num endereço público fixo: um IP fixo ou um nome DDNS que aponta sempre para a sua ligação.
- O endereço começa por https e o certificado é válido: não autoassinado, não expirado, emitido para esse nome.
- O endereço não redireciona para outro lado: o que grava é o endereço em que o SAGE responde.
- A chave de acesso está emitida e é mantida privada.
Não é precisa nenhuma regra de firewall para o zrsPOS. O zrsPOS não liga a partir de um endereço fixo, por isso não há nenhum a autorizar. O que protege a SmartAPI é a chave e o https.
Passos para quem gere a sua rede
- Descobrir o porto em que a SmartAPI escuta (por exemplo 5581) e confirmar que responde dentro da rede.
- Dar à ligação um endereço público fixo: um IP fixo do seu operador, ou um nome DDNS.
- No router ou na firewall, reencaminhar esse porto para o computador onde corre o Sage.
- Pôr um certificado https válido nesse nome. Um proxy inverso à frente da SmartAPI é uma forma habitual.
- Testar de fora, por exemplo num telemóvel com dados móveis.
- Dar à loja o endereço e a chave de acesso.
No zrsPOS
A página Pôr o SAGE na internet («O zrsPOS chega ao seu SAGE pela internet. O seu parceiro prepara isso.») tem quatro passos: 1. Envie ao seu parceiro SAGE a página dele, 2. Peça-lhe o endereço e a chave de acesso, 3. Indique-os e teste (na Ligação ao SAGE), 4. Verifique de novo aqui.

Verificar de novo faz o teste da ligação. Responde «O SAGE respondeu. Está feito.» ou «Ainda não: … O seu parceiro pode ainda estar a tratar disso.»
Um SAGE alojado pelo seu parceiro
Alguns parceiros SAGE correm a SmartAPI por si, num endereço https deles. Funciona da mesma forma: grave o endereço e o porto deles, e a chave. Nesses servidores, a página onde a SmartAPI descreve as suas funções fica atrás de um redirecionamento para o mesmo endereço; o zrsPOS segue-o até lá, e só até lá. Veja Funções e licença do SAGE.
Casos especiais
- «Ainda não: ainda não há endereço e chave do SAGE guardados.» Indique primeiro os dois na Ligação ao SAGE.
- Um endereço da rede da loja (192.168…, 10.…) é recusado: «Este endereço só funciona dentro da sua loja». O zrsPOS só chega a endereços públicos.
- Um redirecionamento (de http para https, ou para outro nome) é recusado ao guardar: grave o endereço final. Os documentos nunca seguem um redirecionamento.
- http em vez de https funciona, mas a página avisa que não é seguro: a chave e os documentos atravessam a internet sem cifra.
- Um IP público novo (mudança de router ou de operador) estraga um endereço por IP fixo: o SAGE deixa de responder até o endereço ser atualizado. Um nome DDNS evita isso.
- Continua a falhar? Cada causa tem a sua página: veja Quando o teste da ligação falha. Escreva para support@zrspos.com com o endereço (nunca a chave) e o título que a página mostra.
Mais em SAGE
- O SAGE e o seu parceiro SAGE
- Ligar o zrsPOS ao seu SAGE
- Testar a ligação
- Quando o teste da ligação falha
- Funções e licença do SAGE
- A sua empresa e as listas lidas do SAGE
- Mudar de empresa SAGE
- Registar uma série na AT
- Reparar a numeração de uma série
- Artigos SAGE
- Artigos de vendas personalizadas
- Artigos de IVA das ilhas
- Artigos de reembolso e de portes
- Códigos de barras
- Métodos de pagamento
- Meio de pagamento por omissão e o que conta como numerário
- Crédito em loja como vale: um vale para cada loja
- Pagamentos em devoluções e encomendas online