Como ligar Stripe ao InvoiceXpress em menos tempo
Guia prático para configurar o LusoInvoice, validar credenciais e iniciar a emissão de documentos portugueses a partir do Dashboard do Stripe.
Pré-requisitos antes da integração
Antes de iniciar, confirme que tem acesso administrativo ao Stripe e ao InvoiceXpress. Esta validação inicial evita interrupções durante a configuração inicial.
Também deve confirmar o tipo de documento que vai emitir por defeito e se a série no InvoiceXpress está ativa para emissão.
- Conta Stripe com permissões para instalar aplicações.
- Conta InvoiceXpress com chave API ativa.
- Definições fiscais mínimas (IVA, isenções e retenções) já definidas.
Passo a passo de configuração
Instale o LusoInvoice no Stripe App Marketplace e abra o painel da aplicação no Dashboard. Em seguida, introduza o subdomínio e a chave API do InvoiceXpress.
Depois de validar as credenciais, ative a sincronização automática por webhook e configure as regras de emissão (tipo de documento, série, IVA e comportamento automático).
- Validar credenciais com o botão "Validar e Continuar".
- Ativar a integração por webhook para eventos de pagamento concluído.
- Rever definições para garantir compatibilidade com o seu processo atual.
Checklist de qualidade após a ligação
Faça um teste com um pagamento no modo de teste do Stripe para confirmar a criação correta do documento e a ligação ao cliente.
Acompanhe os registos de sincronização nas primeiras operações para identificar rapidamente divergências de IVA, séries ou associação de cliente.
- Confirmar que não existem documentos duplicados para o mesmo pagamento.
- Validar valores líquidos, IVA e total no documento emitido.
- Garantir que o cliente Stripe está associado ao cliente correto no InvoiceXpress.
FAQ rápida
Posso começar com sincronização manual?
Sim. Pode instalar e usar criação manual de documentos antes de ativar o modo automático via webhook.
Preciso de alterar algo no meu Stripe Checkout?
Na maioria dos casos não. Apenas deve garantir que os dados fiscais e de cliente usados no pagamento estão completos.