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.
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.
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
- 01
Pedido
O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.
- 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.
- 03
Configuração e testes
A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.
- 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.
Integrações relacionadas
Ver todas as integrações- Faturação
Fatture in Cloud
Documentos emitidos, clientes e pagamentos no Fatture in Cloud criados a partir das vendas, com o envio ao SDI feito pelo próprio software.
Desde 5 € /mês + IVA
Ver integração - Reservas
FareHarbor
Operadores de tours e atividades: cada reserva FareHarbor gera o documento certo no software de faturação, sem exportações manuais.
Desde 30 € /mês + IVA
Ver integração - Pagamentos
PayPal
Liga os webhooks e a API de transações do PayPal à faturação e à loja, para capturas, reembolsos e disputas não ficarem por registar.
Desde 5 € /mês + IVA
Ver integração
Ativar a integração Fattura24?
Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.