Saltar para o conteúdo
Logótipo Fattura24

Faturação

Integração Fattura24

Documentos criados no Fattura24 a partir das vendas em Itália, através da API com chave da conta, prontos para o SDI.

Visão geral

Fattura24

O Fattura24 é um software de faturação online italiano, popular entre microempresas e profissionais que querem uma ferramenta simples para fatture elettroniche, ordini e preventivi. Tal como os outros programas italianos, entrega as faturas eletrónicas ao Sistema di Interscambio.

A API do Fattura24 funciona com uma chave gerada na conta, em Configurazione, App Servizi Esterni. Com ela, a Tejobit cria documentos completos (cliente, linhas, IVA, pagamento) através do pedido SaveDocument e guarda o número e o identificador devolvidos.

É uma API mais direta do que a de outros concorrentes, sem webhooks: a ligação é desenhada para enviar dados para o Fattura24 e confirmar o resultado, não para reagir a alterações feitas lá dentro.

Casos de uso

Para que serve

  • Guias turísticos em Roma ou Florença que vendem visitas pelo FareHarbor e precisam de uma fattura por reserva.
  • Vendas pagas por PayPal num site simples, com fatura emitida no Fattura24 assim que o pagamento é confirmado.
  • Ordini criados no Fattura24 a partir de pedidos B2B feitos por formulário, para depois serem convertidos em fatura.
  • Arquivo dos PDF das faturas emitidas numa pasta partilhada com o commercialista.
IN

O que a ligação escuta

  • Reserva paga na plataforma de reservas.
  • Notificação de pagamento do PayPal ou do Stripe.
  • Encomenda concluída na loja online.
  • Submissão de formulário para pedidos ou orçamentos.
OUT

O que a ligação faz

  • Cria a fattura, fattura elettronica, ordine ou preventivo com SaveDocument.
  • Inclui o cliente no próprio documento, com partita IVA ou codice fiscale e dados de entrega SDI.
  • Associa o pagamento e o método usado.
  • Guarda o número e o ID do documento junto da venda de origem.
  • Descarrega o PDF do documento quando é preciso enviá-lo ou arquivá-lo.

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

  • Plano Fattura24 que inclua acesso à API; o plugin oficial para WooCommerce, por exemplo, pede o plano Business.
  • Chave de API ativada em Configurazione, App Servizi Esterni.
  • Sezionali (séries) e taxas de IVA configuradas.
  • Correspondência entre os produtos vendidos e as rubricas do Fattura24.

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

  • Não existem webhooks; alterações feitas à mão no Fattura24 não voltam automaticamente para a origem.
  • A API baseia-se em pedidos com XML e oferece menos operações do que uma API REST moderna.
  • Erros de validação do SDI são tratados dentro do Fattura24 e podem exigir correção manual.

Perguntas frequentes

Antes de começar

Que plano do Fattura24 é preciso?

Um plano com acesso à API. A Tejobit confirma isso antes de começar, porque nem todos os planos incluem a chave de serviços externos.

Posso emitir notas de crédito pela integração?

Sim, desde que se defina a regra: por exemplo, um reembolso total gera uma nota di credito associada à fatura original.

Qual a diferença para o Fatture in Cloud?

São produtos diferentes. O Fattura24 tem uma API mais simples, por chave, sem webhooks; o Fatture in Cloud usa OAuth e notifica alterações. A escolha depende do software que a empresa já usa em Itália.

Ativar a integração Fattura24?

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