ForHosting KIT · Strumenti per sviluppatori

Calcolo del peso volumetrico e fatturabile

Il costo di una spedizione non dipende sempre dal valore mostrato dalla bilancia.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Un corriere può addebitare un collo grande e leggero in base allo spazio occupato, usando il peso volumetrico. Questo strumento moltiplica lunghezza, larghezza e altezza, divide il volume per il divisore del corriere e confronta il risultato con il peso reale. Mostra entrambi i valori e indica quale sarà fatturato, offrendo a commercianti, addetti alla logistica e acquirenti una stima chiara prima dell’acquisto dell’etichetta.

Inserisca misure compatibili e il divisore del corriere

Parta dalla lunghezza, dalla larghezza e dall’altezza esterne del collo, includendo rigonfiamenti, maniglie o protezioni che aumentano lo spazio occupato durante il trasporto. Tutte e tre le dimensioni devono essere numeri positivi. Inserisca il peso reale misurato quando il pacco è completamente pronto, non la semplice somma dei pesi di catalogo dei prodotti prima di aggiungere scatola e materiale di riempimento. Indichi infine il divisore pubblicato per il corriere, il servizio, il sistema di unità e le condizioni contrattuali applicabili. La compatibilità è essenziale: un divisore previsto per pollici cubi e libbre non può essere abbinato a centimetri o chilogrammi. Lo strumento non assegna etichette alle unità perché è il divisore a definirne la relazione. Valori mancanti, nulli, negativi, infiniti o non numerici vengono rifiutati, evitando risultati apparentemente plausibili ma inutilizzabili. Regole e divisori possono cambiare in base a servizio, destinazione, contratto e data; verifichi sempre la tariffa corrente prima di usare il risultato in un preventivo.

Comprenda il peso volumetrico e quello fatturabile

Il calcolo determina innanzitutto il volume moltiplicando lunghezza, larghezza e altezza. Divide poi il volume per il divisore indicato e ricava il peso volumetrico. Questo viene confrontato con il peso reale e il valore maggiore diventa il peso fatturabile. Quando i due valori coincidono esattamente, l’output indica il peso reale come criterio, anche se il numero fatturato resta identico. I risultati vengono presentati con sei cifre decimali per rendere stabile l’automazione, mentre il confronto usa il valore completo prima dell’arrotondamento visivo. La capacità non arrotonda automaticamente dimensioni o peso al successivo incremento di addebito. Molti corrieri arrotondano ogni misura prima della moltiplicazione, aumentano il peso finale all’unità successiva, applicano minimi o gestiscono diversamente i colli irregolari. Applichi tali regole prima dell’inserimento oppure adegui in seguito il peso fatturabile. L’output include anche il volume calcolato, utile per controllare la formula e individuare errori nelle misure o nelle unità.

Usi il confronto nelle decisioni di spedizione

Il confronto è particolarmente utile prima che il pacco arrivi al corriere. Lo esegua durante la scelta delle scatole per capire se lo spazio vuoto trasforma un ordine leggero in una spedizione addebitata in base al volume. Confronti imballaggi alternativi mantenendo lo stesso peso reale oppure provi servizi idonei con il divisore pubblicato per ciascuno. Nel checkout o in magazzino, conservi input e risultati insieme alla stima tariffaria, così la decisione potrà essere riprodotta in seguito. L’API costa $0.002 per richiesta ed esegue un calcolo deterministico senza contattare il corriere, quindi si presta sia a controlli in serie sia a singoli colli. Non restituisce una tariffa, non seleziona il servizio, non convalida il contratto e non sostituisce la risposta finale del corriere. Supplementi per fuori misura, zona, movimentazione, carburante o consegna residenziale restano esclusi. Consideri il peso fatturabile come uno degli elementi del calcolo completo. Se cambiano il divisore o l’arrotondamento, aggiorni input e processo invece di riutilizzare vecchi risultati.

Casi d'uso

Scegliere una scatola più piccola

Confronti gli imballaggi prima della preparazione e individui quando lo spazio vuoto porta il peso volumetrico oltre quello reale.

Verificare una stima di spedizione

Riproduca la base di peso di un preventivo usando le misure del collo e il divisore pubblicato per il servizio.

Controllare i dati logistici

Segnali gli ordini in cui il peso fatturabile registrato non coincide con il maggiore tra peso volumetrico calcolato e peso reale.

Domande frequenti

Che cos’è il peso volumetrico?

Converte lo spazio occupato da un collo in un peso, dividendo il volume per un divisore stabilito dal corriere.

Quale peso viene fatturato?

Il maggiore tra peso volumetrico e reale viene restituito come fatturabile. Se coincidono, l’output indica il peso reale come criterio.

Quali unità deve utilizzare?

Usi le unità di dimensione e peso previste dal divisore. Tutti gli input devono appartenere allo stesso sistema compatibile.

Lo strumento arrotonda alla libbra o al chilogrammo intero?

No. Restituisce il risultato matematico con sei decimali. Applichi separatamente le regole pubblicate per misure e incrementi di addebito.

Cosa accade se una dimensione è zero o negativa?

La richiesta termina con un errore di input non valido. Lunghezza, larghezza e altezza devono essere numeri finiti positivi.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. Il calcolo non contatta il corriere e restituisce un risultato deterministico.

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

POSThttps://api.kit.forhosting.com/ecom/shipping-dimensional-weight

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/ecom/shipping-dimensional-weight \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}'

const res = await fetch("https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "length": 20,
    "width": 15,
    "height": 10,
    "divisor": 139,
    "actual_weight": 18
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/shipping-dimensional-weight",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "length": 20,
    "width": 15,
    "height": 10,
    "divisor": 139,
    "actual_weight": 18
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", 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

{
  "length": 20,
  "width": 15,
  "height": 10,
  "divisor": 139,
  "actual_weight": 18
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.shipping_dimensional_weight",
  "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

per richiesta$0.002

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

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.

Leggi la documentazione completa del KIT →