zrsPOSManual English

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

  1. A SmartAPI responde num endereço público fixo: um IP fixo ou um nome DDNS que aponta sempre para a sua ligação.
  2. O endereço começa por https e o certificado é válido: não autoassinado, não expirado, emitido para esse nome.
  3. O endereço não redireciona para outro lado: o que grava é o endereço em que o SAGE responde.
  4. 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

  1. Descobrir o porto em que a SmartAPI escuta (por exemplo 5581) e confirmar que responde dentro da rede.
  2. Dar à ligação um endereço público fixo: um IP fixo do seu operador, ou um nome DDNS.
  3. No router ou na firewall, reencaminhar esse porto para o computador onde corre o Sage.
  4. Pôr um certificado https válido nesse nome. Um proxy inverso à frente da SmartAPI é uma forma habitual.
  5. Testar de fora, por exemplo num telemóvel com dados móveis.
  6. 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.

Pôr o SAGE na internet: os quatro passos e Verificar de novo

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