Suporte
Tudo o que precisa para começar e resolver problemas com o LusoInvoice.
Primeiros Passos
1. Instalar a aplicação
Instale o LusoInvoice a partir do Stripe App Marketplace. A aplicação aparecerá na barra lateral do Stripe Dashboard.
2. Ligar ao InvoiceXpress
Abra o painel LusoInvoice na página inicial do Dashboard. Introduza o subdomínio da conta InvoiceXpress e a chave API. Clique em "Validar e Continuar" — as credenciais são verificadas e armazenadas em segurança no Stripe Secret Store.
3. Ativar o webhook
No passo 2 da configuração, clique em "Ativar Integração". Isto cria um webhook que escuta pagamentos concluídos para ativar a sincronização automática.
4. Configurar definições
Vá a Definições para escolher o tipo de documento (Fatura, Fatura-Recibo ou Fatura Simplificada), definir a série InvoiceXpress, retenção na fonte, isenção de IVA, taxa de IVA predefinida e ativar ou desativar a sincronização automática.
Perguntas Frequentes
Como encontro a minha chave API do InvoiceXpress?
Inicie sessão na sua conta InvoiceXpress. Vá a Definições → API e copie a chave API. O subdomínio da conta é a parte antes de .app.invoicexpress.com no URL do InvoiceXpress.
Como sincronizo um pagamento manualmente?
Navegue até Pagamentos no Stripe Dashboard e selecione um pagamento concluído. O painel LusoInvoice à direita mostra os detalhes e itens do pagamento. Clique em "Criar Fatura" para gerar o documento no InvoiceXpress. Um link para a fatura aparece após a sincronização.
Como funciona a sincronização automática?
Quando ativada nas Definições, a sincronização automática escuta o evento webhook payment_intent.succeeded. Sempre que um pagamento é concluído, o LusoInvoice cria automaticamente o documento correspondente no InvoiceXpress. O sistema verifica duplicados para evitar a criação da mesma fatura duas vezes.
Como associo clientes Stripe ao InvoiceXpress?
Vá a Clientes no Stripe Dashboard e selecione um cliente. O LusoInvoice procura automaticamente clientes InvoiceXpress correspondentes por nome e código. Aceite a sugestão ou pesquise manualmente. Depois de associado, as faturas incluirão os dados InvoiceXpress do cliente.
Que tipos de documento são suportados?
O LusoInvoice suporta três tipos de documento português: Fatura, Fatura-Recibo e Fatura Simplificada. Pode escolher o tipo predefinido nas Definições.
Como são tratados os impostos (IVA)?
O LusoInvoice extrai automaticamente informação fiscal do Stripe (incluindo tax rates, Stripe Tax e default tax rates) e mapeia-a para códigos fiscais do InvoiceXpress. Trata corretamente preços com e sem IVA incluído. Também pode definir uma taxa de IVA predefinida ou um código de isenção (M01-M99) nas Definições.
Como desligo o InvoiceXpress?
Vá a Definições e clique em "Desligar InvoiceXpress". Isto remove o webhook, apaga as ligações de clientes e as definições, e devolve a aplicação ao ecrã de configuração inicial. Os registos de sincronização são mantidos como histórico.
Funciona com o modo de teste do Stripe?
Sim. Todas as funcionalidades funcionam no modo de teste do Stripe. Note que o InvoiceXpress não tem modo de teste — os documentos serão criados na sua conta InvoiceXpress real (podem ser anulados depois).
Contacte-nos
Não encontra o que procura? Entre em contacto e ajudamo-lo a configurar.
Enviar email para lusoinvoice@alemdocodigo.pt