Beta técnica: A integração está implementada e disponível para testes controlados antes de ser utilizada com cobranças reais.
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
- Uma conta Retail X-Series e o prefixo ou URL atual da loja, por exemplo https://minha-loja.retail.lightspeed.app.
- Uma Private App aprovada com as permissões sales:read, users:read e payment_types:read. O token pessoal é aceite apenas para contas antigas compatíveis.
- 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 na categoria Retail.
- Em URL da API, introduza o prefixo da loja ou o URL completo *.retail.lightspeed.app.
- Em Chave da API, cole o token da Private App. Não o envie por correio eletrónico, capturas de ecrã ou registos de suporte.
- Guarde a configuração. O ImaCash valida a loja, o token, os utilizadores e os tipos de pagamento na API real antes de a aceitar.
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 sincronização é incremental, paginada e limitada; perante um limite 429 conserva o cursor e respeita Retry-After.
Teste obrigatório antes da produção
Valide uma venda em numerário, uma venda apenas com cartão, uma venda mista, um reembolso e a recuperação após uma falha de rede ou um 429. Confirme que não aparecem duplicados ao repetir a sincronização.
