zrsPOSManual
InícioPreçosAplicaçõesEnglish
Índice

Pôr o SAGE na internet

Uma tarefa guiada para o comerciante ou o seu parceiro SAGE. Cada problema «não é possível chegar ao SAGE» na Ligação ao SAGE abre-a com Mostrar como.

Porque é preciso. O seu Sage 50c corre na sua própria rede; o zrsPOS corre na nuvem. Para o zrsPOS emitir documentos, a SmartAPI tem de responder pela internet.

O que tem de estar certo no fim

  1. A SmartAPI responde num endereço público fixo: um IP estático 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 auto-assinado, não expirado, e emitido para o nome usado.
  3. O endereço não redireciona para outro; o que guarda na Ligação ao SAGE é o final.
  4. A chave de API está emitida e mantida privada.

Não precisa de autorizar nenhum endereço do zrsPOS na firewall. O zrsPOS não chama a partir de um endereço fixo, por isso não há nenhum a autorizar. O que protege a API é a chave e o https.

Passos para quem gere a rede

  1. Descubra o porto em que a SmartAPI escuta (por exemplo 5581) e confirme que funciona a partir de dentro da rede.
  2. Dê à ligação um endereço público fixo: peça ao fornecedor um IP estático, ou configure um nome DDNS.
  3. No router ou na firewall, encaminhe esse porto para o servidor onde o Sage corre.
  4. Ponha um certificado https válido no endereço (um certificado para o nome DDNS ou de domínio usado). Um proxy inverso à frente da SmartAPI é uma maneira comum de o fazer.
  5. Teste a partir de fora da sua rede, por exemplo num telemóvel com dados móveis: o endereço deve responder.
  6. Dê ao comerciante o endereço e a chave de acesso. Na Ligação ao SAGE ele indica os dois e carrega em Guardar: testa-os primeiro.

No zrsPOS

A página Pôr o SAGE na internet tem os mesmos quatro passos: envie ao seu parceiro SAGE a página dele, peça-lhe o endereço e a chave de acesso, indique-os na Ligação ao SAGE e guarde, e carregue depois em Verificar de novo aqui. Verificar de novo é o teste da ligação: diz O SAGE respondeu. Está feito., ou porque ainda não.

Se continuar a falhar

Cada falha tem a sua página; a Ligação ao SAGE mostra a que se aplica:

Continua preso? Escreva para support@zrspos.com com o endereço (nunca a chave) e o título que a página mostra.