Beta técnica: Guia verificado com a beta publicada do ImaCash 4.4.3.1528. O conector exige validação controlada da instalação antes de gerir numerário; esta versão não é apresentada como a última estável.
Este conector destina-se exclusivamente ao Lightspeed Retail X-Series, anteriormente Vend. Não é compatível com o Lightspeed Restaurant K-Series nem com o Ikentoo.
Pré-requisitos
- Confirme com o fornecedor a edição Retail X-Series, o acesso API e o prefixo ou URL privado da loja. Não utilize um endereço de Restaurant K-Series nem o nome comercial da loja.
- Uma Private App aprovada pelo administrador da loja, com sales:read, users:read e payment_types:read. A Lightspeed indica disponibilidade de Private Apps nos planos Plus; confirme a sua conta. Os tokens pessoais são uma opção antiga para contas que ainda os aceitem.
- Saída HTTPS pela porta 443 para *.retail.lightspeed.app. Não é necessário abrir portas de entrada nem aceder a uma base de dados local.
- Um tipo de pagamento em numerário ativo. O ImaCash importa apenas vendas que já estejam fechadas no Lightspeed.
Configuração no ImaCash
- Abra Configuração > Integração > POS e selecione Lightspeed Retail X-Series. Retail descreve o setor; não é necessário outro seletor com esse nome. A sua conta ImaCash deve permitir consultar e alterar a configuração.
- Em URL da API, introduza o prefixo ou URL HTTPS da loja terminado em retail.lightspeed.app. Um URL antigo vendhq.com é adaptado ao domínio atual. Não introduza um caminho de base de dados nem o URL de outro produto.
- Em Chave de API, introduza o token privado da aplicação aprovada. Não é a palavra-passe do ImaCash nem um identificador de caixa. Não o publique nem envie capturas com o valor; confirme a validade com o responsável da loja.
- Ao validar uma configuração nova ou alterada, o ImaCash consulta tipos de pagamento e utilizadores pela API; deve reconhecer pelo menos um tipo de numerário. Guardar sem alterações pode reutilizar a validação anterior. Um sucesso não prova leituras completas, filtros ou numerário real. A gravação geral tem várias fases: sair ou cancelar depois não anula o que já foi guardado; reabra e confirme. A permissão e a leitura de vendas são verificadas na primeira sincronização, não ao carregar utilizadores. Utilize o reinício apenas quando o resumo de configuração o oferecer.
Funcionamento e âmbito
- As vendas em numerário entram pelo respetivo montante em numerário; as vendas pagas apenas com cartão são ignoradas.
- Num pagamento misto é importada apenas a parte paga em numerário. Os montantes negativos em numerário são tratados como reembolsos.
- A beta é apenas de leitura: não confirma cobranças nem altera vendas no Lightspeed.
- A leitura paginada abrange, no máximo, as últimas duas horas, com sobreposição de dois minutos e pelo menos quinze segundos entre pedidos. Uma falha ou lote incompleto não avança a sincronização. Se a Lightspeed limitar os pedidos, respeite o intervalo indicado. Uma interrupção longa pode deixar vendas fora da janela e exige revisão.
Âmbito de lojas e utilizadores
Os filtros de utilizador afetam a vista local do ImaCash; não limitam o acesso da Private App nem são enviados à API. É carregado o catálogo de vendedores, mas não listas de lojas ou caixas. As referências da venda não comprovam isolamento entre lojas. Confirme o âmbito da conta e de cada posto na validação supervisionada.
Confirmações e resultados incertos
Confirmar no ImaCash não grava um pagamento, fecho ou anulação na Lightspeed. Uma venda fechada já contém pagamentos registados no POS. A sua apresentação no ImaCash não prova entrega de numerário nem autoriza cobrar novamente. Confirme referências, estado e numerário real antes de repetir, resincronizar ou reiniciar.
O que este conector não inclui
Não sincroniza artigos, stock, turnos nem pesquisa de talões por EAN. Não importa vendas apenas com cartão nem um total bancário independente. O token é fornecido em privado; não existe um assistente de renovação OAuth automática. O guia iKentoo corresponde a Restaurant K-Series e mantém-se separado. Só de leitura refere-se à API da Lightspeed: o circuito normal do ImaCash pode acionar uma máquina de numerário.
Teste obrigatório antes da produção
Antes do uso comercial, combine com o fornecedor um ensaio supervisionado de numerário, cartão, pagamento misto, devolução e recuperação da ligação. Confirme referências e resultados reais nos dois sistemas. O guia, o código e uma ligação bem-sucedida não comprovam essa validação.