ForHosting KIT · Documenti e PDF

Generi una nota di credito da una fattura

Crei una nota di credito coerente partendo dal riferimento della fattura originale, da una motivazione chiara e dalle righe esatte da stornare.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Il generatore calcola l’imponibile e l’imposta di ogni riga, somma il credito finale e verifica che il risultato non superi il totale della fattura originale. La risposta JSON strutturata è adatta alla revisione, all’archiviazione, ai flussi contabili o alla conversione, tramite il Suo sistema, in un documento stampabile con il marchio aziendale.

Parta dalla fattura di origine e da una motivazione precisa

Una nota di credito utile deve collegarsi senza ambiguità all’operazione che corregge. Inserisca il riferimento della fattura originale esattamente come compare nel Suo sistema di fatturazione o contabilità, quindi indichi il totale della fattura comprensivo di imposte e il codice valuta di tre lettere. La motivazione deve spiegare l’evento commerciale, non limitarsi a ripetere che viene emesso un credito. Tra gli esempi rientrano merci restituite, una riduzione concordata del servizio, scorte danneggiate, una correzione di prezzo o un addebito eccessivo. Una motivazione specifica offre ad approvatori, clienti, contabili e revisori il contesto necessario per comprendere perché ricavi e imposte vengono stornati. Il generatore conserva il testo nel documento strutturato, ma non inventa un numero di nota di credito, una data di emissione, l’identità del cliente, formulazioni legali o uno stato di autorizzazione. Tali campi dipendono dalla Sua organizzazione e giurisdizione e devono essere aggiunti dal sistema che controlla numerazione ed emissione. Separare i fatti originari dagli identificativi generati rende il calcolo deterministico ed evita che il documento appaia ufficialmente emesso prima di completare il normale processo di approvazione.

Descriva ogni riga accreditata e lasci calcolare il totale

Aggiunga una riga per ogni prodotto, servizio, commissione o rettifica da accreditare. Ogni riga richiede una descrizione, una quantità positiva e un prezzo unitario ante imposte non negativo. L’aliquota facoltativa è una percentuale e assume il valore zero quando viene omessa. Per ogni riga, il generatore moltiplica la quantità per il prezzo unitario, arrotonda a due decimali l’imponibile ottenuto, calcola l’imposta su tale imponibile arrotondato e determina il totale della riga. Somma quindi tutti gli imponibili e gli importi fiscali per produrre il credito complessivo. L’arrotondamento per riga è intenzionale: rispecchia il modo in cui molti sistemi di fatturazione mostrano e contabilizzano i documenti dettagliati e garantisce che ogni riga visualizzata sia riconciliabile con il riepilogo. Utilizzi valori positivi, poiché il tipo di documento comunica già che gli importi stornano una parte della fattura; quantità o prezzi negativi creerebbero una doppia negazione poco chiara. Se la fattura originale applicava sconti o arrotondamenti particolari, rappresenti l’importo realmente stornato con una riga di rettifica esplicita, così da riconciliare il totale generato con la fattura di origine.

Convalidi il risultato prima di emettere il documento finale

La risposta completa contiene il tipo di documento, il riferimento della fattura originale, la motivazione, la valuta, le righe numerate e una sezione dei totali. I totali mostrano imponibile accreditato, imposta accreditata, credito complessivo, totale della fattura originale e importo residuo dopo il credito. Il generatore rifiuta la richiesta quando il credito calcolato supera il totale indicato della fattura originale. Questa protezione evita un comune errore di inserimento, ma non sostituisce la verifica di precedenti note di credito associate alla stessa fattura. Poiché lo strumento riceve solo la richiesta corrente e non usa rete né cronologia archiviata, il Suo sistema di fatturazione deve verificare l’importo cumulativo qualora vengano emessi più crediti nel tempo. Prima dell’approvazione, confronti descrizioni, quantità, prezzi, trattamento fiscale, valuta e dati del cliente con la fattura originale. Assegni quindi il numero ufficiale della nota di credito e la data di emissione secondo i Suoi controlli contabili e requisiti locali. La risposta strutturata può alimentare un modello, un flusso contabile, una coda di approvazione o un generatore PDF senza imporre le scelte di presentazione e conformità alla fase aritmetica.

Accreditare merci restituite

Trasformi quantità restituite, prezzi originali e aliquote in una nota di credito dettagliata e pronta per l’approvazione.

Correggere un addebito eccessivo

Documenti una rettifica di prezzo o commissione e calcoli l’importo esatto da stornare.

Preparare dati per la contabilità

Crei totali strutturati e coerenti da archiviare, revisionare o inviare a un generatore di documenti aziendali.

Quanto costa una richiesta?

Ogni richiesta API costa $0.002. La versione nel browser viene eseguita localmente senza una richiesta API a pagamento.

Viene assegnato un numero ufficiale di nota di credito?

No. Lo strumento prepara i dati calcolati, ma lascia numerazione ufficiale e date di emissione al Suo processo di fatturazione controllato.

Come viene calcolata l’imposta?

L’imposta viene calcolata per ogni riga dall’imponibile arrotondato e dall’aliquota; gli importi delle righe vengono poi sommati.

Cosa accade se il credito supera la fattura?

La richiesta non riesce e segnala un input non valido quando il credito calcolato supera il totale indicato della fattura originale.

Rileva crediti precedenti per la stessa fattura?

No. Non dispone di rete o cronologia archiviata; il Suo sistema di fatturazione deve verificare i crediti cumulativi prima dell’emissione.

Posso utilizzare un’aliquota zero?

Sì. Ometta tax_rate o lo imposti su zero per una riga che non deve aggiungere imposte.

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/credit-note-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/credit-note-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"original_invoice_reference":"INV-2026-0042","original_invoice_total":250,"currency":"USD","reason":"Two items were returned unopened.","items":[{"description":"Wireless keyboard","quantity":2,"unit_price":45,"tax_rate":10},{"description":"Shipping adjustment","quantity":1,"unit_price":5}]}'
{
  "original_invoice_reference": "INV-2026-0042",
  "original_invoice_total": 250,
  "currency": "USD",
  "reason": "Two items were returned unopened.",
  "items": [
    {
      "description": "Wireless keyboard",
      "quantity": 2,
      "unit_price": 45,
      "tax_rate": 10
    },
    {
      "description": "Shipping adjustment",
      "quantity": 1,
      "unit_price": 5
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.credit_note_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_items200
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 →