Antes de começar

O que ter pronto fora do zrsPOS, numa lista com página própria: não guarda nenhuma definição, e pode voltar a lê-la a qualquer momento. Cada ponto diz Por fazer, Feito ou Precisa de atenção, e abre a página onde é verificado.

O zrsPOS verifica os pontos que pode (o SAGE a responder, a chave, as séries, os códigos de barras). Os dois que só podem ser confirmados por si (que o seu parceiro SAGE tem a página dele, que o seu contabilista sabe) marcam-se com Marcar “…” como feito; isso funciona também com o plano só de leitura.

A página do seu parceiro SAGE

A maior parte desta lista é trabalho de quem trata do seu SAGE: publicar a SmartAPI, emitir a chave, criar séries. A app tem uma página pronta para ele, com exatamente o que fazer e um e-mail que pode enviar com um clique. O mesmo texto está no resumo para o parceiro. Marque-a como feita quando a enviar.

O SAGE na internet

O seu SAGE corre na sua própria rede; o zrsPOS corre na nuvem. A SmartAPI do SAGE tem de estar publicada num endereço https público e fixo, por exemplo https://sage.asuaempresa.pt:5581. Normalmente é o seu parceiro SAGE ou o fornecedor de rede que o faz: veja Publicar a SmartAPI. Não há nenhum endereço a autorizar na sua firewall: a SmartAPI só tem de responder na internet, protegida pela chave e pelo https. Um endereço http simples funciona, mas fica assinalado: não é cifrado.

Uma chave de acesso para o zrsPOS

A chave (x-api-key) vem do seu parceiro SAGE. Escreve-a na página Ligação ao SAGE, que a testa antes de a guardar.

Séries comunicadas à AT

Cada loja que vende precisa da sua própria série no SAGE, comunicada à AT (Autoridade Tributária) para os documentos de venda e para as notas de crédito. A API não cria nem comunica séries, por isso isto faz-se no SAGE, uma vez por loja, por si ou pelo seu parceiro: veja Registar uma série na AT. As páginas das Lojas leem o código AT de volta e dizem se falta algum.

Os mesmos códigos de barras no SAGE

O zrsPOS encontra o artigo SAGE de cada linha da venda pelo código de barras da variante do Shopify. É da sua responsabilidade ter os mesmos produtos, com os mesmos códigos de barras, no Shopify e no SAGE: o zrsPOS não cria nem altera os seus produtos. A verificação dos códigos de barras mostra quantos coincidem, lista os que não, e exporta a lista. Uma venda com um código de barras em falta fica à espera em Documentos até ser corrigido; nada se perde.

O seu contabilista sabe

A partir do dia em que entra em produção, o zrsPOS emite as suas vendas do POS como documentos certificados no seu SAGE. Diga-o ao seu contabilista, para que os espere lá. Marque como feito quando ele souber.

Quando todos os pontos estiverem feitos, siga para a Ligação ao SAGE.