Saltar para o conteúdo
Tejobit
Logótipo InvoiceXpress

Faturação

Integração InvoiceXpress

Faturas, recibos e notas de crédito criados no InvoiceXpress a partir de pagamentos, subscrições ou encomendas, na sequência certa.

Pedir esta integração Ver todas as integrações

Visão geral

InvoiceXpress

O InvoiceXpress é um programa de faturação online certificado, popular entre empresas de serviços, agências e negócios com subscrições. A API é REST, em JSON, e cada conta tem um subdomínio próprio. A autenticação faz-se com uma chave de API associada a um utilizador da conta.

Na API, cada documento passa por estados. A ligação cria a fatura e depois muda o estado para finalizado, o momento em que o InvoiceXpress lhe atribui o número na sequência (a série) escolhida. A partir daí pode registar o pagamento, que gera o recibo, e enviar o documento por email ao cliente.

A Tejobit trata as regras que normalmente ficam numa folha de cálculo: que sequência usar por tipo de cliente, quando faturar uma subscrição, como tratar um reembolso. O InvoiceXpress continua a emitir e a comunicar os documentos à AT, de acordo com o modo de comunicação definido na conta.

Casos de uso

Para que serve

  • Empresa de software que fatura cada renovação paga no Stripe com fatura-recibo.
  • Agência de marketing que fatura avenças mensais registadas no CRM.
  • Escola de línguas ou de formação que emite faturas por inscrição e recibos à medida que as prestações são pagas.
  • Loja online B2B que converte encomendas aprovadas em faturas com vencimento a 30 dias.
  • Exportação mensal do SAF-T de faturação e envio automático ao contabilista.
IN

O que a ligação escuta

  • Evento invoice.paid ou checkout.session.completed no Stripe.
  • Negócio marcado como ganho no CRM.
  • Encomenda aprovada na loja online.
  • Data fixa do mês, para avenças e para a exportação do SAF-T.
OUT

O que a ligação faz

  • Procura o cliente por código ou nome e cria-o se não existir.
  • Cria a fatura, fatura-recibo ou fatura simplificada e muda o estado para finalizado.
  • Regista o pagamento da fatura, o que gera o recibo correspondente.
  • Envia o documento por email e devolve o número e o link ao sistema de origem.
  • Pede a exportação do SAF-T do mês e aguarda até o ficheiro estar pronto.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Conta InvoiceXpress com acesso à API, nome da conta e chave de API.
  • Sequências criadas e registadas para os documentos a emitir.
  • Artigos e impostos configurados, ou uma regra para os criar na primeira venda.
  • Modo de comunicação à AT definido na conta (automático ou manual).

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A API aceita até 780 pedidos por minuto por conta; acima disso responde 429 e a ligação repete o pedido mais tarde.
  • A chave de API está ligada a um utilizador: se esse utilizador sair da conta ou a chave for regenerada, a ligação tem de ser atualizada.
  • O InvoiceXpress não envia avisos de eventos à ligação; o que muda dentro do InvoiceXpress é lido por consulta.

Perguntas frequentes

Antes de começar

Uma fatura criada pela API fica logo emitida?

Só depois de passar a finalizado. Até lá é um rascunho sem número. A regra pode ser finalizar logo ou deixar para revisão.

Consigo faturar subscrições do Stripe com IVA português?

Sim. A ligação lê os dados do cliente e do pagamento no Stripe e aplica a taxa de IVA definida para o serviço e o país do cliente, segundo regras acordadas com o contabilista.

A integração substitui o envio do SAF-T?

Não. Pode gerar o ficheiro do mês automaticamente e entregá-lo a quem trata do envio, mas a submissão continua a cargo da empresa ou do contabilista, salvo se a comunicação estiver feita por outra via.

Integrações relacionadas

Ver todas as integrações

Ativar a integração InvoiceXpress?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com