Generi una distinta di imballaggio senza prezzi
L’ordine ORD-10482, con 2 righe e 3 unità in totale, diventa una distinta numerata con l’indirizzo di consegna e le quantità, senza prezzi, imposte o dati di fatturazione. Indichi numero d’ordine, indirizzo e articoli. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Funziona nel tuo browser: gratis, senza registrazione, i file non escono dal tuo dispositivo.
Crei una distinta di imballaggio da inserire nella spedizione senza trasformarla in una fattura. Indichi il numero d’ordine, un indirizzo di consegna strutturato e uno o più articoli con le rispettive quantità. Il generatore convalida i dati, numera le righe, calcola le unità totali e restituisce sia campi strutturati riutilizzabili sia un documento di testo pronto per la stampa. Prezzi, imposte, condizioni di pagamento e dati di fatturazione vengono esclusi deliberatamente, così il risultato resta dedicato all’evasione, al controllo del destinatario e al contenuto del pacco.
Componga il documento con i dati di spedizione
Una distinta di imballaggio risponde a una domanda pratica del magazzino: che cosa deve contenere questo pacco e dove deve arrivare? Inizi con il numero usato dal Suo negozio, magazzino o sistema di gestione degli ordini. Fornisca poi destinatario e destinazione in campi strutturati, così ogni parte resterà riutilizzabile.
Inserisca ciascun prodotto preparato in una riga separata con nome, quantità intera positiva e SKU facoltativo. Il generatore mantiene l’ordine indicato, assegna numeri di riga visibili, normalizza gli spazi superflui e calcola sia il numero di righe sia le unità totali. Il risultato comprende un oggetto strutturato per le automazioni e una distinta testuale da stampare, salvare o inserire in un altro layout.
Poiché l’algoritmo non inventa dati mancanti, il documento resta riconducibile alle informazioni fornite dal processo di evasione. Una richiesta priva di articoli non produce un documento vuoto, ma restituisce un errore.
Tenga distinta la distinta dalla fattura
Distinta e fattura possono riferirsi allo stesso ordine, ma svolgono funzioni diverse. La fattura richiede o registra un pagamento e normalmente include prezzi unitari, sconti, imposte, totali, indirizzo di fatturazione, istruzioni di pagamento e condizioni legali. Questa capacità non genera nessuno di tali campi.
Identifica chiaramente il documento come distinta di imballaggio e contiene soltanto riferimento dell’ordine, destinazione, identità e quantità degli articoli, conteggi e una rappresentazione stampabile. La separazione è utile per i regali, quando l’ufficio acquisti deve ricevere i documenti finanziari a parte o quando il personale di magazzino non deve conoscere le condizioni commerciali. Impedisce inoltre ai sistemi successivi di interpretare un documento logistico come prova di un importo dovuto.
Per calcoli contabili o richieste di pagamento, utilizzi un flusso dedicato alle fatture. Qui le quantità sono dati operativi per confrontare il contenuto fisico con l’ordine senza mostrare prezzi.
Convalidi, stampi e automatizzi in modo coerente
Usi la risposta strutturata quando un altro sistema deve archiviare la distinta, trasferire le righe in un modello PDF, creare un fascicolo di etichette o confrontare le quantità preparate con le scansioni. Usi il documento testuale quando basta un inserto semplice e leggibile. I componenti obbligatori dell’indirizzo vengono verificati separatamente; azienda, seconda riga, regione, codice postale e SKU facoltativi sono omessi se vuoti, anziché comparire come valori nulli.
Le quantità devono essere interi positivi, evitando righe ambigue con zero o frazioni nelle spedizioni ordinarie. Il generatore è deterministico: lo stesso input produce lo stesso risultato senza rete, data corrente, identificatori casuali, verifiche di magazzino o arricchimento dei prodotti. Non conferma la disponibilità, l’accettazione dell’indirizzo da parte del corriere o l’avvenuta spedizione.
Esegua questi controlli nei sistemi appropriati prima di considerare la distinta un’autorizzazione all’invio.
Casi d'uso
Inserisca una distinta in un pacco e-commerce
Trasformi le righe confermate in un inserto leggibile senza esporre prezzi o dati di pagamento.
Agevoli il controllo in magazzino
Fornisca righe numerate e unità totali da confrontare con i prodotti collocati nel cartone.
Documenti le spedizioni sostitutive
Crei un riepilogo del contenuto per sostituzioni o garanzie quando una fattura non è adatta.
Domande frequenti
La distinta include i prezzi?
No. Prezzi, sconti, imposte, condizioni di pagamento e totali di fattura sono esclusi deliberatamente.
Che cosa accade se l’elenco degli articoli è vuoto?
La richiesta restituisce un errore di input non valido, perché la distinta deve contenere almeno un articolo.
Un articolo può non avere uno SKU?
Sì. Nome e quantità intera positiva sono obbligatori; lo SKU è facoltativo e viene omesso se vuoto.
L’indirizzo viene convalidato presso un corriere?
No. I campi obbligatori vengono controllati e formattati, ma la consegnabilità non viene verificata e nessun corriere viene contattato.
Che differenza c’è tra distinta di imballaggio e fattura?
La distinta indica cosa c’è nel pacco e dove va; la fattura registra un pagamento con prezzi, imposte e condizioni. Questo documento esclude di proposito ogni dato economico, utile quando il pacco è un regalo.
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/packing-slip-generate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"order_number":"ORD-10482","shipping_address":{"name":"Morgan Lee","company":"Northwind Studio","address_line_1":"48 Harbor Street","address_line_2":"Suite 3B","city":"Portland","region":"ME","postal_code":"04101","country":"US"},"items":[{"name":"Canvas Tool Roll","quantity":2,"sku":"CTR-NAVY"},{"name":"Brass Measuring Gauge","quantity":1,"sku":"BMG-01"}]}'const res = await fetch("https://api.kit.forhosting.com/doc/packing-slip-generate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"order_number": "ORD-10482",
"shipping_address": {
"name": "Morgan Lee",
"company": "Northwind Studio",
"address_line_1": "48 Harbor Street",
"address_line_2": "Suite 3B",
"city": "Portland",
"region": "ME",
"postal_code": "04101",
"country": "US"
},
"items": [
{
"name": "Canvas Tool Roll",
"quantity": 2,
"sku": "CTR-NAVY"
},
{
"name": "Brass Measuring Gauge",
"quantity": 1,
"sku": "BMG-01"
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/doc/packing-slip-generate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"order_number": "ORD-10482",
"shipping_address": {
"name": "Morgan Lee",
"company": "Northwind Studio",
"address_line_1": "48 Harbor Street",
"address_line_2": "Suite 3B",
"city": "Portland",
"region": "ME",
"postal_code": "04101",
"country": "US"
},
"items": [
{
"name": "Canvas Tool Roll",
"quantity": 2,
"sku": "CTR-NAVY"
},
{
"name": "Brass Measuring Gauge",
"quantity": 1,
"sku": "BMG-01"
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/packing-slip-generate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"order_number":"ORD-10482","shipping_address":{"name":"Morgan Lee","company":"Northwind Studio","address_line_1":"48 Harbor Street","address_line_2":"Suite 3B","city":"Portland","region":"ME","postal_code":"04101","country":"US"},"items":[{"name":"Canvas Tool Roll","quantity":2,"sku":"CTR-NAVY"},{"name":"Brass Measuring Gauge","quantity":1,"sku":"BMG-01"}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"order_number":"ORD-10482","shipping_address":{"name":"Morgan Lee","company":"Northwind Studio","address_line_1":"48 Harbor Street","address_line_2":"Suite 3B","city":"Portland","region":"ME","postal_code":"04101","country":"US"},"items":[{"name":"Canvas Tool Roll","quantity":2,"sku":"CTR-NAVY"},{"name":"Brass Measuring Gauge","quantity":1,"sku":"BMG-01"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/packing-slip-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
{
"order_number": "ORD-10482",
"shipping_address": {
"name": "Morgan Lee",
"company": "Northwind Studio",
"address_line_1": "48 Harbor Street",
"address_line_2": "Suite 3B",
"city": "Portland",
"region": "ME",
"postal_code": "04101",
"country": "US"
},
"items": [
{
"name": "Canvas Tool Roll",
"quantity": 2,
"sku": "CTR-NAVY"
},
{
"name": "Brass Measuring Gauge",
"quantity": 1,
"sku": "BMG-01"
}
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "doc.packing_slip_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. |
Domande tecniche
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. La versione deterministica nel browser funziona senza inviare i dati di spedizione a un modello remoto.