A Square é a primeira caixa ligada à XPRIO. A ligação usa a sua própria conta Square, demora alguns minutos e não passa por nenhum marketplace. Este guia parte do princípio de que já leu o princípio geral. Ligar a minha caixa (POS) à XPRIO
O que precisa de saber
A Square cobra 1 % por encomenda paga fora da Square, à sua conta de programador Square, não à XPRIO. É a tarifa da Square para qualquer encomenda criada por uma aplicação terceira e paga noutro local. A XPRIO não cobra nada.
A Square só mostra uma encomenda depois de paga. Uma encomenda paga online chega, por isso, marcada como paga. Uma encomenda em dinheiro ou com cartão na entrega chega marcada como paga ao ser enviada, com a indicação do meio de pagamento: o senhor cobra ao cliente sem o voltar a registar. A definição «Deixar a caixa cobrar» não existe com a Square.
As suas entregas aparecem como encomendas «expedição» com a morada do cliente, os seus levantamentos como levantamentos com a hora prevista. A Square reserva o seu tipo «entrega» aos parceiros certificados; a informação é a mesma, só o rótulo muda.
Os reembolsos são refletidos. Um reembolso total ou parcial feito na XPRIO é registado na Square exatamente pelo mesmo montante.
Os esgotados vão da Square para a XPRIO, não o contrário: «esgotado» define-se na caixa Square, a API não o permite a partir do exterior.
Existe um ambiente de teste: a Square disponibiliza uma conta sandbox gratuita para experimentar tudo sem tocar na sua caixa real.
Passo 1: criar o seu token de acesso Square
Inicie sessão em developer.squareup.com com a sua conta Square habitual.
Clique em + New application (ou abra uma aplicação existente). O nome é livre, por exemplo «XPRIO».
Na aplicação, abra Credentials. No topo da página, um interruptor alterna entre Sandbox e Production: escolha Production para a sua caixa real.
Copie o Production Access Token (botão Show, depois copie). Não o partilhe com ninguém; a XPRIO cifra-o e nunca mais o mostra.
Para um teste sem consequências, fique em Sandbox: o Sandbox Access Token cola-se na XPRIO com o interruptor Modo de teste ativado, e o painel de teste encontra-se em developer.squareup.com, secção Sandbox test accounts.
Passo 2: ligar na XPRIO
Menu Configuração da Aplicação, Caixa (POS), escolha o estabelecimento, depois Ligar no cartão Square.
Ative Modo de teste (sandbox) se estiver a colar um token sandbox; deixe-o desativado para a sua caixa real.
Cole o token em Token de acesso de produção e clique em Guardar e testar.
Escolha o ponto de venda (location Square) deste estabelecimento, depois Ativar.
A XPRIO cria na Square, uma única vez, o que precisa para marcar as encomendas como pagas, e depois lê o seu catálogo Square: artigos, variações, listas de modificadores, categorias.
Passo 3: os artigos
Siga a caixa Passo seguinte do cartão: importação dos artigos Square para a XPRIO se a sua ementa ainda lá não estiver, envio da sua ementa XPRIO para a Square se o seu catálogo Square estiver vazio, ou correspondência. Com a Square, a associação baseia-se no SKU de cada variação: coloque esse SKU como PLU do seu produto XPRIO e tudo se associa sozinho. Correspondência de artigos entre a XPRIO e a minha caixa
Duas particularidades da Square:
todo o artigo Square tem pelo menos uma variação, mesmo sem tamanho nem sabor: um produto simples XPRIO associa-se a essa variação única, o que é normal;
a Square não tem meal deals: um meal deal XPRIO associa-se a um artigo Square «Menu» à sua escolha, e os seus componentes aparecem como modificadores.
Passo 4: encomenda de teste, depois encomendas reais
Enviar uma encomenda de teste cria na Square uma encomenda chamada «XPRIO» assinalada como teste. Abra a Square (painel ou app Point of Sale): está entre as encomendas, paga, com a sua nota. Se aparecer, as suas encomendas reais seguirão o mesmo caminho.
Na Square, uma encomenda XPRIO traz:
o nome do talão XPRIO-número e o modo (levantamento, entrega, no local);
as linhas com a variação associada, os modificadores associados ou livres, os descontos e as taxas de entrega;
o pagamento, registado como pagamento externo «XPRIO» para uma encomenda paga online, ou dinheiro para uma encomenda em dinheiro;
para um levantamento, a hora prevista e o nome do cliente; para uma entrega, a morada completa.
Perguntas frequentes
O teste de ligação falha. Na maioria das vezes trata-se de um token sandbox colado sem o modo de teste, ou o contrário; ou de um token copiado com um espaço. Regenere-o em Credentials em caso de dúvida.
A encomenda de teste não aparece na Square. Verifique que a app Point of Sale está ligada ao mesmo ponto de venda (location) escolhido na XPRIO, e que a encomenda não está filtrada: a Square coloca-a entre as encomendas em curso, não entre as vendas do dia enquanto não estiver concluída.
Posso manter as minhas vendas ao balcão como antes? Sim. A XPRIO limita-se a acrescentar encomendas e a ler o catálogo. Nada muda para o resto da sua atividade Square.
Como desligo? Botão Desligar no cartão. As ligações de artigos são removidas do lado da XPRIO; nada é eliminado na Square.
Artigos relacionados