ForHosting KIT · Documenti e PDF

Generi una fattura con totali e imposta calcolati

Trasformi i dati essenziali di fatturazione in un documento coerente senza replicare le regole di calcolo in ogni applicazione.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

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. 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. Non effettua conversioni né deduce la valuta: tutti i prezzi devono usare una sola valuta scelta dal chiamante. 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

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. Le richieste API costano $0.002; il browser usa la stessa logica pura e restituisce gli stessi risultati.

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.

Quanto costa una richiesta?

Ogni richiesta API costa $0.002.

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.

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.

POSThttps://api.kit.forhosting.com/doc/invoice-generate

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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}'
{
  "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": "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_mb25
max_pages200
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →