zrsPOSResolução de problemas
Fez-se uma venda mas não apareceu documento. Veja o subtítulo do mosaico Documentos e Fila e erros. Se a venda está em fila, aguarde ou carregue em Processar tudo. Se diz que a loja não está configurada, termine a configuração em Definições › Lojas e Definições › Artigos SAGE. Se ainda não está em produção, as vendas são ignoradas de propósito. Fila e erros mostra só a loja desta caixa: uma venda feita noutra loja aparece nas caixas dessa loja e em Documentos na administração. Uma venda numa localização marcada Não vende no POS é ignorada sem aviso: o zrsPOS não a fatura e ela não aparece em nenhuma fila.
O talão não imprimiu. Abra o mosaico Documentos → Impressora. Se diz «por configurar», escolha a impressora desta caixa. Nas impressoras pull, a página da impressora na app mostra a hora da última ligação; sem contacto significa que a impressora perdeu corrente ou rede. Nas de envio direto, use Imprimir teste e verifique a regra do router.
A app de impressão diz «Sem ligação ao zrsPOS». O tablet não tem internet, ou a impressora foi apagada na administração (nesse caso a app diz que foi revogada). Verifique primeiro o Wi-Fi; a app volta a tentar sozinha. Veja A app de impressão.
A impressão pára quando o ecrã do tablet se apaga. Abra a zrsPOS Print e carregue em Permitir funcionar em segundo plano (bateria) e permita. Caso contrário o Android pára a app.
A impressora Epson não tem a opção Server Direct Print. Veja se há uma atualização de firmware Epson para esse modelo. Em alternativa, ligue a impressora por USB ao tablet e use a app de impressão, ou mude a impressora para Direto. Veja Impressão e entrega.
«Loja não configurada» numa venda. Faltam a série, os tipos de documento, o armazém ou o PartyID do consumidor final da loja. Abra a loja em Definições › Lojas e complete-os; passa a funcionar quando estiverem certos.
Foi usado o tipo de documento errado numa devolução. A página Documentos e códigos SAGE de cada loja (Definições › Lojas) permite escolher NC ou NRE, no Documento de devolução. Mude; as devoluções seguintes usam a nova escolha.
Uma encomenda foi editada depois de faturada. O zrsPOS lança um alerta em Documentos e na encomenda. Corrija no SAGE (nota de crédito e nova fatura conforme o seu contabilista indicar) e carregue em Tratei disto no SAGE no alerta.
O NIF foi rejeitado. Os NIF portugueses são verificados pelo dígito de controlo. Para números fiscais estrangeiros, ligue NIF estrangeiro no mosaico NIF.
O SAGE está inacessível. Os documentos ficam em fila e repetem automaticamente. Teste a ligação em Definições › Ligação ao SAGE; confirme que o endereço está certo e que o serviço da API do SAGE está a correr.
Quando o SAGE recusa uma venda
Uma venda que o SAGE recusou aparece na página Documentos em Precisa de si, com a causa e Detalhes para o suporte — o documento exato que enviámos e a resposta do SAGE. As causas que o zrsPOS reconhece, e o que fazer:
«A série não foi comunicada à AT para este documento». O SAGE recusa um documento certificado numa série que a AT não conhece para esse tipo de documento — normalmente uma série de notas de crédito nova usada pela primeira vez. No SAGE, comunique a série à AT para esse tipo de documento e depois carregue em Tentar de novo na venda, em Documentos. Entretanto, a Série das devoluções da loja (Definições › Lojas, Documentos e códigos SAGE) pode voltar a A mesma das vendas: a série das vendas já está comunicada.
Guia completo: /manual/pt/problems/series_not_communicated
«As zonas do tipo Intracomunitário… estão reservadas para séries configuradas para IVA Comércio Eletrónico». No SAGE, o cliente está numa zona de vendas online para a UE (OSS, por exemplo «ESP NAO SUJEITO») ou numa zona intracomunitária — normalmente um cliente estrangeiro que comprou primeiro na loja online. Uma venda na caixa é tributada em Portugal, por isso o zrsPOS emite os documentos da loja na zona de IVA da própria loja, seja qual for a zona do cliente. Se ainda vir esta mensagem, confirme que a Zona de IVA da loja (na sua página em Definições › Lojas) é a nacional (por exemplo «Nacional») e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/zone_not_domestic
«O código do imposto 'NS' utilizado no documento não é válido» — numa venda Tax Free. O grupo de IVA isento escolhido nos códigos Tax Free (Tax Free → grupo de isenção) resolve, na sua empresa SAGE, para um código de imposto e motivo de isenção que o SAGE não aceita num documento certificado. O nome do grupo pode parecer certo («Isento Taxfree») e a regra por trás não. Abra o grupo no SAGE (Tabelas → Impostos → Grupos de IVA) e veja que linha da tabela de impostos usa: a combinação comprovada em faturas tax free é o código NS com o motivo M05 (Isento Artigo 14.º do CIVA). Se a sua empresa só tem ISE / M05, use essa. Depois da alteração, o zrsPOS volta a tentar a venda sozinho em minutos; também pode carregar em Tentar estas … vendas de novo. O artigo de caução usa o seu próprio grupo — confirme que aponta para a mesma regra.
Guia completo: /manual/pt/problems/tax_code_invalid
«O cliente tem o crédito cancelado». O SAGE recusa qualquer documento a um cliente cujo tipo de limite de crédito é «cancelado» — um valor por omissão que algumas versões aplicam a clientes criados de fora. Abra o cliente no SAGE e defina um limite de crédito por valor. A venda volta a ser tentada sozinha.
Guia completo: /manual/pt/problems/credit_cancelled
«O tipo de documento não existe no SAGE». O tipo de documento configurado para a loja (FS, FR ou nota de crédito) não existe ou não é válido no SAGE, e o SAGE recusou o documento — não foi criado. Corrija os tipos de documento da loja em Definições › Lojas e carregue em Tentar de novo: a repetição usa o tipo corrigido.
Guia completo: /manual/pt/problems/document_type_invalid
«Série não existe / não válida». A série configurada para a loja não existe no SAGE para este tipo de documento, ou está fechada. Confirme a série da loja (Definições › Lojas) com a tabela Séries do SAGE.
Guia completo: /manual/pt/problems/series_exhausted
«Artigo não existe». Um dos códigos de artigo de Definições › Artigos SAGE (portes, artigo genérico) ou do Tax Free (caução) não existe no SAGE. A página que o tem indica qual falta e propõe criá-lo.
Guia completo: /manual/pt/problems/item_not_found
«Timed out» — o SAGE não respondeu a tempo. O SAGE pode ser lento. O documento pode ter sido emitido à mesma: a repetição procura-o antes de emitir outro, por isso não há risco de duplicado. Se se repetir, o servidor SAGE ou a sua rede estão sobrecarregados.
Guia completo: /manual/pt/problems/timeout
«Unreachable» — o zrsPOS não chega ao SAGE. O serviço SmartAPI está parado, ou o endereço/porta em Definições › Ligação ao SAGE já não estão certos (mudança de router, novo IP público). Teste a ligação aí.
Guia completo: /manual/pt/problems/unreachable
«Pré-visualização» — devolução de uma encomenda online, nota de crédito preparada mas não enviada. O modo de Devoluções online está em pré-visualização: o zrsPOS encontrou a fatura online no SAGE e montou a nota de crédito, mas não a enviou. Abra «Detalhes para o suporte» e confira a fatura de origem (OriginatingON), as linhas, a moeda e o câmbio. Quando o resultado for o esperado em várias devoluções, mude o modo para Automático e carregue em Tentar de novo em cada pedido pendente — só então é emitida.
Guia completo: /manual/pt/problems/online_preview
«Nenhuma fatura das séries online tem esta encomenda» — devolução na loja de uma encomenda online. O zrsPOS procura, nas séries indicadas em Devoluções online, uma fatura (FR/FT) cuja referência contenha o número da encomenda (#1234). Não encontrou nenhuma: ou a série online não está na lista, ou a encomenda foi faturada sem referência (acontece em cerca de 5% das encomendas), ou ainda não foi faturada (só tem NE). Procure a fatura no SAGE pela referência e emita a nota de crédito manualmente; corrija a lista de séries se for esse o caso.
Guia completo: /manual/pt/problems/online_no_match
«Mais do que uma fatura tem esta encomenda» — o zrsPOS não adivinha. Duas ou mais faturas das séries online levam o mesmo número de encomenda na referência (por exemplo, uma encomenda faturada em duas expedições). O zrsPOS nunca escolhe por si. Emita a nota de crédito manualmente no SAGE contra a fatura que faturou o artigo devolvido.
Guia completo: /manual/pt/problems/online_ambiguous
«Moeda diferente» — a fatura online está noutra moeda. A fatura online foi emitida na moeda em que o cliente pagou (Shopify Markets: USD, GBP…) e a devolução não trouxe os preços nessa moeda, ou é um reembolso só de valor. Uma nota de crédito tem de estar na moeda e ao câmbio da fatura original. Emita-a manualmente no SAGE, copiando a moeda e o câmbio da fatura.
Guia completo: /manual/pt/problems/online_currency
«Não foi possível ler a encomenda no Shopify». Para associar a devolução à fatura online o zrsPOS precisa do número da encomenda, que lê ao Shopify. Falhou por falta de acesso (o token da app expirou) ou porque a encomenda não existe. Abra o zrsPOS no admin do Shopify uma vez — isso renova o acesso — e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/online_lookup
«Método de pagamento online sem meio de pagamento SAGE». O reembolso de uma encomenda online foi feito por um método de pagamento (por exemplo PayPal ou cartão online) que não está associado a nenhum meio de pagamento SAGE. Nas encomendas online o zrsPOS nunca usa o meio de pagamento SAGE por omissão, que costuma ser numerário: um reembolso para o cartão não pode aparecer como dinheiro a sair da caixa. Em Definições › Pagamentos, associe esse método de pagamento a um meio de pagamento que não seja numerário. A nota de crédito é emitida na repetição seguinte.
Guia completo: /manual/pt/problems/online_tender
«Pagamento sem meio de pagamento SAGE». A venda ou o reembolso foi pago por um método do Shopify (por exemplo MB Way) que não tem meio de pagamento SAGE associado, e a loja não tem meio de pagamento SAGE por omissão. O zrsPOS nunca deixa o SAGE escolher, porque o SAGE registaria tudo como numerário. Em Pagamentos, associe o método ou escolha o meio de pagamento por omissão. O documento é emitido na repetição seguinte. Com um meio por omissão escolhido, um método sem associação usa-o e aparece um alerta para o associar.
Guia completo: /manual/pt/problems/tender_unmapped
«A fatura online já foi creditada». A fatura da encomenda online já tem notas de crédito no SAGE — emitidas pela loja online ou à mão — e esta devolução passaria o valor faturado. O zrsPOS não credita duas vezes. Confirme com a equipa online o que já foi reembolsado. Se esta nota de crédito ainda for devida, emita-a à mão no SAGE.
Guia completo: /manual/pt/problems/online_already_credited
«O artigo não está na fatura online». A devolução é de um artigo que a fatura online da encomenda não fatura — por exemplo uma pré-venda que ficou só na encomenda (NE) e nunca foi faturada. Não há nada faturado para creditar. Se o artigo nunca foi faturado, arquive o aviso. Se foi faturado noutro documento, emita a nota de crédito à mão contra esse documento.
Guia completo: /manual/pt/problems/online_item_not_invoiced
«Não se sabe se a devolução foi feita na loja». O zrsPOS só emite notas de crédito de encomendas online devolvidas no POS de uma loja — nunca das geridas online, no admin do Shopify ou na loja online. Desta vez o Shopify não disse que app fez a devolução. Se foi feita no POS, carregue em Tentar de novo. Se foi gerida online, arquive o aviso.
Guia completo: /manual/pt/problems/online_origin_unknown
«Loja não configurada». A venda ou a devolução aconteceu numa localização do Shopify que ainda não tem série, tipos de documento e armazém no zrsPOS. Configure essa loja em Definições › Lojas. O documento é emitido na repetição seguinte.
Guia completo: /manual/pt/problems/store_unconfigured
«Venda personalizada sem artigo para a taxa de IVA». Uma venda personalizada do POS (uma linha sem produto) é faturada no artigo SAGE que escolheu para a sua taxa de IVA em Definições › Artigos SAGE, Vendas personalizadas, com o texto da caixa como descrição. A taxa desta venda ainda não tem artigo. Indique-o e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/custom_sale_item
«Artigos sem correspondência no SAGE». Um artigo da venda não existe no SAGE. Normalmente é um produto cujo código de barras não está no SAGE (o zrsPOS associa só pelo código de barras, nunca pelo SKU). Ponha o código de barras do artigo SAGE na variante Shopify, ou crie o artigo no SAGE com esse código de barras, ou venda produtos do catálogo, e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/unmapped_items
«Falta o artigo genérico de reembolso». Um reembolso sem artigos usa o artigo genérico de reembolso. Um reembolso de portes usa o artigo de devolução de portes, senão o de portes, senão o genérico: pelo menos um tem de estar indicado em Definições › Artigos SAGE. Depois carregue em Tentar de novo.
Guia completo: /manual/pt/problems/refund_item_missing
«Não há documento original». O reembolso foi feito numa caixa zrsPOS, mas o zrsPOS não emitiu documento para essa encomenda: uma venda anterior à entrada em produção, ou faturada noutro lado. Aparece uma vez e não é repetido. Emita a nota de crédito à mão no SAGE, contra a fatura original, e carregue em Emiti-a à mão no SAGE. Reembolsos destas encomendas feitos fora das lojas zrsPOS (armazém, loja online) são ignorados e não aparecem.
Guia completo: /manual/pt/problems/no_original_document
«À espera da fatura da venda». A devolução chegou antes de a fatura da venda estar emitida (o SAGE estava lento ou em baixo e a venda ainda está a ser repetida). Não há nada a fazer: a nota de crédito é emitida sozinha logo que a fatura sair. Não a emita à mão.
Guia completo: /manual/pt/problems/awaiting_original
«A troca espera pela nota de crédito da devolução». Uma troca feita na caixa emite dois documentos: a nota de crédito do artigo devolvido e a fatura do artigo novo. A fatura espera pela nota de crédito, que ainda não foi emitida: o Shopify envia o reembolso alguns minutos depois da troca, ou o SAGE estava lento e a nota de crédito está a ser repetida. Não há nada a fazer: a fatura é emitida sozinha logo que a nota de crédito sair. Não a emita à mão. Se a troca não foi feita numa caixa (foi tratada no admin do Shopify, onde a loja online a fatura), carregue em Arquivar a encomenda #….
Guia completo: /manual/pt/problems/awaiting_return_credit
«Não foi possível ler a troca». Para faturar o artigo novo de uma troca, o zrsPOS lê a devolução no Shopify. Essa leitura falhou (o Shopify não respondeu, ou o zrsPOS não tinha acesso nesse momento). O pedido fica guardado e é repetido sozinho; nada se perde. Se persistir, abra a app uma vez no admin do Shopify para renovar o acesso e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/exchange_lookup
«Não foi possível ler a fatura original no SAGE». Para emitir a nota de crédito ao mesmo cliente e pela mesma forma de pagamento da venda, o zrsPOS lê a fatura original no SAGE. O SAGE não respondeu (ou não a encontrou), e o zrsPOS não emite a nota de crédito com um palpite — ao «Consumidor Final», com o meio de pagamento SAGE por omissão. Repete sozinho dentro de minutos. Se persistir, confirme no SAGE que a fatura original existe.
Guia completo: /manual/pt/problems/original_unreadable
«Falta o NIF do emitente». O zrsPOS lê o nome e o NIF da empresa no SAGE e guarda-os quando a ligação é testada (Definições › Ligação ao SAGE). Se o SAGE não responder e não houver dados guardados, o zrsPOS não imprime nem envia o documento — um documento fiscal sem o NIF da empresa não é válido. O talão fica em espera e é tentado de novo sozinho durante alguns minutos. Teste aí a ligação e reimprima a partir do POS.
Guia completo: /manual/pt/problems/issuer_nif_missing
«Crédito em loja sem meio de pagamento SAGE». A venda foi paga, no todo ou em parte, com crédito em loja, e a loja regista esse crédito como vale no SAGE. Para isso o crédito em loja (shopify_store_credit) tem de estar associado em Definições › Pagamentos ao meio de pagamento de vale do SAGE (por exemplo «N.Cred-Reembolso»). O zrsPOS não adivinha: o número desse meio de pagamento muda de empresa para empresa. Faça a associação e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/store_credit_tender
«O vale do crédito em loja é de outro documento». Uma venda foi paga com crédito em loja numa loja cuja série de notas de crédito própria emite outro tipo de nota de crédito do que o que o vale SAGE paga (por exemplo o vale paga «NRE» e a loja emite «NC»). A venda continua a ser emitida, mas o SAGE escolhe o vale pelo tipo do documento resgatado. Dê a essa loja o seu próprio vale em Pagamentos → Crédito em loja.
Guia completo: /manual/pt/problems/voucher_wrong_doc
«Creditaria a fatura para além do total». As notas de crédito do zrsPOS já creditam esta fatura (por exemplo, a troca que a originou) e esta devolução voltaria a creditá-la. Acontece quando a fatura de substituição de uma troca não foi emitida e foi arquivada. Veja a encomenda, emita a correção certa à mão no SAGE e carregue em Arquivar a encomenda #….
Guia completo: /manual/pt/problems/already_credited
«Reembolso só de valor numa venda Tax Free». Um reembolso sem artigos numa venda Tax Free: o zrsPOS não sabe que parte é do artigo isento e que parte é da caução. Emita a nota de crédito à mão no SAGE, anule ou corrija o formulário Tax Free e carregue em Emiti-a à mão no SAGE.
Guia completo: /manual/pt/problems/taxfree_value_refund
«O dinheiro devolvido não é o valor dos artigos devolvidos». Foi devolvido dinheiro a mais para além dos artigos, ou o reembolso foi reduzido no Shopify fora de uma devolução (a partir da encomenda, sem Devolver), por isso o que voltou ao cliente não é o valor dos artigos devolvidos. Um reembolso feito através de uma devolução (uma troca, ou uma devolução com o reembolso reduzido) não é verificado aqui. O zrsPOS não emite a nota de crédito: creditaria, e registaria como pago, o valor dos artigos em vez do que foi devolvido. Veja a encomenda, emita à mão no SAGE a nota de crédito certa e carregue em Emiti-a à mão no SAGE. Tentar de novo não muda o resultado enquanto o reembolso estiver igual.
Guia completo: /manual/pt/problems/refund_discrepancy
«Reembolso sem artigos e sem dinheiro concluído». O Shopify comunicou um reembolso que não indica artigos e que, quando chegou, não tinha dinheiro concluído — normalmente um reembolso por cartão ou PayPal ainda pendente nesse momento. O Shopify não volta a avisar quando fica concluído, por isso o zrsPOS não emite nada. Se o dinheiro foi mesmo devolvido ao cliente, emita à mão no SAGE a nota de crédito contra o documento indicado na mensagem e carregue em Emiti-a à mão no SAGE; se nada foi devolvido, basta arquivar. Tentar de novo não muda o resultado. (O mesmo reembolso numa encomenda que o zrsPOS nunca faturou — uma encomenda online reembolsada a partir do admin do Shopify — não é nosso e é ignorado sem aparecer aqui.)
Guia completo: /manual/pt/problems/nothing_to_credit
«Faltam os códigos SAGE do Tax Free». A venda, ou a sua devolução, é Tax Free e falta um dos códigos SAGE do Tax Free (o artigo de caução, o grupo isento, ou a taxa de IVA da zona da loja). Indique-o e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/taxfree_unconfigured
«Zona de IVA da loja por confirmar». A venda, ou a sua devolução, é Tax Free, o zrsPOS ainda não leu a morada Shopify da loja, e as taxas Tax Free são diferentes por zona. Abra o admin (lê as moradas) e carregue em Tentar de novo; o zrsPOS também volta a tentar sozinho.
Guia completo: /manual/pt/problems/taxfree_zone_unknown
«Venda Tax Free com portes». Uma venda Tax Free não pode ter portes: serviços não são elegíveis. Faça os portes numa venda separada. Esta tem de ser emitida à mão, ou refeita sem portes.
Guia completo: /manual/pt/problems/taxfree_shipping
«Falta o artigo de portes». A venda cobra portes e o artigo de portes não está indicado em Definições › Artigos SAGE. Indique-o e carregue em Tentar de novo.
Guia completo: /manual/pt/problems/shipping_item_missing
«Não paga». A encomenda ainda não estava paga quando chegou. O documento é emitido quando o pagamento for concluído. Se a venda foi cancelada, carregue em Arquivar a encomenda #….
Guia completo: /manual/pt/problems/not_paid
«A encomenda não tem artigos». Por exemplo, só um cartão-oferta, ou uma venda anulada. Não há documento a emitir; carregue em Arquivar a encomenda #….
Guia completo: /manual/pt/problems/no_line_items
«Consulta ao SAGE falhou». O SAGE não respondeu a uma consulta de que o zrsPOS precisa antes de emitir (a fatura online, ou as notas de crédito já emitidas). Repete sozinho. Se persistir, o SAGE está lento ou em baixo.
Guia completo: /manual/pt/problems/sage_lookup_failed
«Interrompido (stale — reaped)». O servidor reiniciou a meio da emissão. A repetição procura primeiro no SAGE o documento que possa já ter saído, por isso não há duplicado. Repete sozinho.
Guia completo: /manual/pt/problems/stale_reaped
«As tentativas automáticas terminaram». O zrsPOS tenta emitir uma venda que falhou duas vezes, logo a seguir à venda, e depois deixa de tentar sozinho (e avisa por e-mail e no POS, com a causa): corrija a causa indicada e carregue em «Tentar de novo» em Documentos (ou no POS). Não emita o documento à mão no SAGE — ficaria em duplicado quando carregasse em «Tentar de novo».
Guia completo: /manual/pt/problems/retry_ended
«As formas de pagamento não somam o total». Os pagamentos da venda não dão o total do documento e o zrsPOS não emite um documento incoerente. Acontece com pagamentos divididos invulgares. Contacte o suporte (support@zrspos.com) com o número da encomenda.
Guia completo: /manual/pt/problems/tender_mismatch
«Não foi possível confirmar se o documento já existe». Numa tentativa anterior o SAGE pode ter emitido o documento sem responder a tempo. Desta vez o zrsPOS não conseguiu confirmar e não reenvia às cegas para não criar um duplicado. Repete sozinho dentro de minutos. Se persistir, o SAGE está lento ou em baixo.
Guia completo: /manual/pt/problems/ghost_lookup
Um erro sem causa provável. O SAGE devolveu uma mensagem que o zrsPOS ainda não reconhece. Abra Detalhes para o suporte, copie o pedido e a resposta e envie-os para support@zrspos.com. Depois de corrigida a causa, carregue em Tentar de novo.
Guia completo: /manual/pt/problems/unknown