Generi una fattura con totali e imposta calcolati
Con un’aliquota dell’8,25 %, un imponibile di 330,5 porta 27,27 di imposta e un totale generale di 357,77: indichi venditore, acquirente e ogni riga con quantità e prezzo unitario, e la fattura somma tutto in un ordine fisso. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Venditore
- Northwind Studio
- Acquirente
- Contoso Retail
- Aliquota fiscale
- 8,25
- Tipo di documento
- invoice
- Subtotale
- 330,5
- Tax
- 27,27
- Totale complessivo
- 357,77
Trasformi i dati essenziali di fatturazione in un documento coerente senza replicare le regole di calcolo in ogni applicazione. Indichi venditore, acquirente, voci, quantità, prezzi unitari e aliquota percentuale. Il generatore calcola totale di riga, imponibile, imposta e totale complessivo, quindi restituisce dati originali e calcolati in un oggetto prevedibile che Lei può archiviare, verificare, visualizzare o inoltrare a un altro flusso di lavoro.
Prepari dati di fatturazione completi
Inizi identificando le due parti della transazione. I campi venditore e acquirente accettano i nomi insieme a indirizzo, registrazione o recapiti che il processo successivo deve conservare. Aggiunga quindi almeno una voce.
Ogni riga richiede una descrizione chiara, una quantità numerica e un prezzo unitario numerico. L’aliquota è espressa in percentuale: inserisca 8.25 per applicare l’8.25 per cento, non 0.0825. Sono ammesse quantità frazionarie per lavori misurati in ore, peso, distanza o altre unità divisibili; anche i prezzi possono avere decimali.
Quantità e prezzi negativi vengono respinti perché in genere indicano una fattura errata o una rettifica che dovrebbe essere rappresentata da una nota di credito dedicata. Usi zero solo quando una voce realmente gratuita deve comparire in fattura. Descrizioni specifiche aiutano a riconciliare il documento con ordini, consegne e contratti.
La richiesta non comprende data o identificativo generato, pertanto chiamate ripetute con dati identici producono sempre lo stesso risultato.
Comprenda come viene calcolato ogni importo
Per ciascuna riga, il generatore moltiplica quantità e prezzo unitario e arrotonda il totale ottenuto a due decimali. Somma poi i totali di riga già arrotondati per ricavare l’imponibile. L’imposta si calcola moltiplicando tale imponibile per l’aliquota percentuale fornita e viene anch’essa arrotondata a due decimali.
Infine, l’imposta arrotondata viene aggiunta all’imponibile per ottenere il totale complessivo. Quest’ordine è esplicito e deterministico, un aspetto importante perché i sistemi contabili possono divergere se arrotondano in un’altra fase. Non effettua conversioni né deduce la valuta: tutti i prezzi devono usare una sola valuta scelta dal chiamante.
Integri il calcolo in modo sicuro
Utilizzi questa capacità nel punto in cui i dati modificabili dell’ordine diventano un record di fattura. Verifichi prima il contesto commerciale: parti, valuta, giurisdizione fiscale ed eventuale necessità di sconti, ritenute, aliquote multiple o rettifiche. Invii quindi le righe normalizzate e conservi l’oggetto restituito come risultato del calcolo.
Poiché l’algoritmo non usa rete, valori casuali, orologio o stato nascosto, la stessa richiesta può essere ripetuta in sicurezza e confrontata durante gli audit. Campi obbligatori mancanti, importi non numerici, elenchi vuoti o eccessivi, aliquote negative e soprattutto quantità o prezzi negativi generano errori. Li risolva prima di assegnare un numero di fattura o inviare dati al cliente.
Il risultato può alimentare un modello HTML, un’importazione contabile, un generatore di allegati o una coda di approvazione, ma tali azioni restano separate. Così l’aritmetica rimane verificabile e la presentazione non altera i totali.
Casi d'uso
Fatturare ordini approvati
Converta righe d’ordine normalizzate in una fattura strutturata con importi e imposte coerenti.
Creare un modulo di fatturazione
Calcoli i totali mentre inserisce parti, voci e aliquota, quindi passi il risultato a un sistema di rendering.
Uniformare le integrazioni contabili
Offra a più applicazioni un unico contratto deterministico prima della registrazione o approvazione.
Domande frequenti
Come devo indicare l’aliquota?
Indichi un numero percentuale. Per esempio, usi 8.25 per applicare un’aliquota dell’8.25 per cento.
Come vengono arrotondati gli importi?
Ogni totale di riga è arrotondato a due decimali; tali righe formano l’imponibile, poi l’imposta viene calcolata e arrotondata.
Posso usare valori negativi per gli accrediti?
No. Qualsiasi quantità o prezzo unitario negativo genera un errore di input. Usi una procedura dedicata alle note di credito.
Il risultato comprende un PDF o un numero di fattura?
No. Restituisce dati strutturati con i totali calcolati. Rendering, numerazione, valuta e consegna sono passaggi separati.
Posso fatturare ore o altre quantità con decimali?
Sì. Le quantità possono essere frazionarie, come ore di lavoro, peso o distanza, e anche i prezzi unitari ammettono decimali; il totale di ogni riga viene poi arrotondato a due decimali.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/doc/invoice-generate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"seller":"Northwind Studio","buyer":"Contoso Retail","line_items":[{"description":"Design consultation","quantity":2,"unit_price":125},{"description":"Style guide","quantity":1,"unit_price":80.5}],"tax_rate":8.25}'const res = await fetch("https://api.kit.forhosting.com/doc/invoice-generate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"seller": "Northwind Studio",
"buyer": "Contoso Retail",
"line_items": [
{
"description": "Design consultation",
"quantity": 2,
"unit_price": 125
},
{
"description": "Style guide",
"quantity": 1,
"unit_price": 80.5
}
],
"tax_rate": 8.25
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/doc/invoice-generate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"seller": "Northwind Studio",
"buyer": "Contoso Retail",
"line_items": [
{
"description": "Design consultation",
"quantity": 2,
"unit_price": 125
},
{
"description": "Style guide",
"quantity": 1,
"unit_price": 80.5
}
],
"tax_rate": 8.25
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/invoice-generate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"seller":"Northwind Studio","buyer":"Contoso Retail","line_items":[{"description":"Design consultation","quantity":2,"unit_price":125},{"description":"Style guide","quantity":1,"unit_price":80.5}],"tax_rate":8.25}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"seller":"Northwind Studio","buyer":"Contoso Retail","line_items":[{"description":"Design consultation","quantity":2,"unit_price":125},{"description":"Style guide","quantity":1,"unit_price":80.5}],"tax_rate":8.25}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/invoice-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"seller": "Northwind Studio",
"buyer": "Contoso Retail",
"line_items": [
{
"description": "Design consultation",
"quantity": 2,
"unit_price": 125
},
{
"description": "Style guide",
"quantity": 1,
"unit_price": 80.5
}
],
"tax_rate": 8.25
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "doc.invoice_generate",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 25 |
max_pages | 200 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Comprenda come viene calcolato ogni importo
L’output conserva descrizioni e quantità inviate, presenta i prezzi unitari come valori monetari e aggiunge line_total a ogni voce. A livello di documento include subtotal, tax_rate, tax e grand_total, oltre a venditore e acquirente. La risposta strutturata è un record di dati e calcoli pronto per un modello, un database, un’approvazione o un’integrazione API, non un PDF o un’immagine.
Integri il calcolo in modo sicuro
Le richieste API costano $0.002; il browser usa la stessa logica pura e restituisce gli stessi risultati.
Domande tecniche
Quanto costa una richiesta?
Ogni richiesta API costa $0.002.