Ligação ao SAGE

O zrsPOS emite cada documento no seu próprio SAGE, através da SmartAPI do SAGE. Esta página liga os dois e lê a sua empresa do SAGE, para nunca ter de a escrever.

Precisa de duas coisas do seu parceiro SAGE. Se ainda não as tem, envie-lhe a página para o seu parceiro SAGE.

Endereço do SAGE

O endereço público fixo com https da sua SmartAPI, com o porto, por exemplo https://sage.asuaempresa.pt:5581. O zrsPOS envia cada documento para este endereço. Um endereço que começa por http:// funciona, mas a página avisa que não é seguro: a chave e os documentos atravessam a internet sem cifra. Peça https ao seu parceiro SAGE. O aviso nunca o impede de emitir.

Chave de acesso

A chave (x-api-key) que o seu parceiro SAGE cria na SmartAPI para o zrsPOS. Pertence a uma empresa do SAGE, por isso não há empresa a escolher. O zrsPOS guarda-a cifrada e nunca a volta a mostrar: depois de guardada, a página diz Há uma chave guardada e oferece Substituir a chave. Um endereço novo precisa de novo da chave.

Guardar testa primeiro

Indique o endereço e a chave e carregue em Guardar. Nada é guardado até o SAGE responder: Guardar testa primeiro o que escreveu (A chegar ao SAGE · A ler a sua empresa · A ler as funções do SAGE). Se o SAGE não responder, a página diz a causa no campo a que diz respeito, e nada muda.

Testar ligação testa o que está guardado e nunca guarda. Volta a ler a sua empresa e as funções licenciadas, e atualiza também o que as verificações da configuração leram do SAGE. Um plano só de leitura pode testar na mesma.

Se um teste falhar, a causa fica na página depois de recarregar, com uma saída: Mostrar como quando não é possível chegar ao SAGE (Pôr o SAGE na internet), Substituir a chave quando a chave é recusada, ou a página para o seu parceiro SAGE. As causas estão no fim desta página.

A sua empresa no SAGE

Depois de um bom teste, a página mostra a empresa como o SAGE a tem: nome, NIF, morada, código postal, localidade, país, região de IVA, telefone, e-mail e capital social. Estão só para leitura, de propósito. O SAGE é o emissor certificado, por isso estes dados vêm do SAGE e imprimem-se em todos os documentos. Se algum estiver errado, altere-o no SAGE e teste depois a ligação. Os contactos e o logótipo dos seus documentos estão em Design dos documentos.

A página lista também cada mudança de empresa do SAGE: quando, por quem, de que empresa para qual.

Funções do SAGE

O SAGE só expõe as funções que a sua licença inclui. O zrsPOS lê-as em cada bom teste e mostra-as em palavras simples: documentos de venda, notas de crédito, artigos, clientes, meios de pagamento, caixas, vendedores, armazéns, séries, impostos e zonas, empresa e licença. Cada uma está A funcionar ou Precisa de atenção; os caminhos exatos estão em Detalhes para o suporte. Uma função em falta é nomeada, para a poder pedir ao seu parceiro SAGE (licença em falta). Uma licença inativa di-lo: o SAGE não aceita nada até ser renovada. A última leitura fica guardada, por isso a página nunca fica vazia.

Listas lidas do SAGE

Para sugerir as suas definições, o zrsPOS lê 17 listas do SAGE: séries, tipos de documento, armazéns, condições de pagamento, meios de pagamento SAGE, vendedores e outras. Cada lista está Lida ou Não foi possível ler, com o que isso afeta. Ler as listas de novo lê-as todas e mostra o progresso. É o único sítio para voltar a ler o SAGE; as outras páginas ligam para aqui quando uma lista não foi lida.

Para o seu parceiro SAGE

Um texto, pronto a enviar, personalizado com a sua loja, a sua empresa e o NIF: o que o seu parceiro SAGE prepara. Copie-o, envie-o por e-mail ou imprima-o.

Pôr o SAGE na internet

O zrsPOS corre na nuvem, por isso a SmartAPI tem de responder num endereço público fixo com https e um certificado válido. O seu parceiro SAGE prepara-o; os passos estão em Pôr o SAGE na internet. Cada problema «não é possível chegar ao SAGE» abre-a com Mostrar como.

O que significa «A funcionar»

A ligação ao SAGE está A funcionar quando as três coisas se verificam:

o SAGE respondeu nas últimas 24 horas;
a sua empresa e o NIF foram lidos;
todas as funções de que o zrsPOS precisa estão licenciadas.

Se o SAGE deixar de responder durante mais de um dia, volta a Precisa de atenção e di-lo. As regras de cada parte da configuração estão em O que significa «A funcionar».

Mudar de empresa SAGE

Se o endereço ou a chave levarem a outra empresa (outro NIF), o zrsPOS pergunta sempre primeiro, com o nome das duas empresas. Testar a ligação nunca muda de empresa: diz que o SAGE é de outra empresa e oferece Mudar de empresa. Confirmar põe a emissão em pausa antes de guardar seja o que for, esquece os artigos e as listas lidas da empresa anterior e pede para verificar de novo Lojas, Artigos SAGE e Pagamentos, cada um confirmado na sua página. Os documentos já emitidos ficam com a empresa que os emitiu. Se a mudança não terminar, a emissão fica em pausa e a nova ligação não é guardada: tente de novo, ou escreva para support@zrspos.com.

Desligar o SAGE

Na Zona de risco. O zrsPOS deixa de emitir até voltar a ligar o SAGE, e a chave guardada é apagada. As vendas continuam e esperam pelo documento; os documentos emitidos ficam no SAGE.

Se o teste falhar

Cada causa tem o seu título na página, e a sua página aqui:

O SAGE não respondeu a tempo (tempo esgotado): pode estar desligado, lento ou ainda não estar na internet.
Nada responde neste endereço (recusada): o serviço de ligação do SAGE pode estar parado.
Este endereço não existe (endereço desconhecido): confirme-o com o seu parceiro SAGE.
A ligação segura do SAGE está avariada (certificado): o certificado expirou ou é de outro endereço.
O SAGE recusou esta chave (chave recusada): está errada ou expirou; o seu parceiro SAGE dá-lhe uma nova.
Algo respondeu aqui, mas não o SAGE (não é a SmartAPI): confirme o endereço.
Este endereço envia o zrsPOS para outro lado (redirecionamento): guarde o endereço direto.
Este endereço só funciona dentro da sua loja (rede local): o zrsPOS precisa de um endereço público.
O SAGE recusou o pedido (pedido recusado): a página mostra o motivo do SAGE.

Não precisa de autorizar nenhum endereço do zrsPOS na firewall: não há nenhum.

Problemas nesta página

Cada um tem uma página que diz o que vê, o que aconteceu e o que fazer.