ForHosting KIT · Strumenti per sviluppatori

Calcolatore dei costi di gestione dell’ordine

Il calcolatore combina un importo fisso con una percentuale del subtotale dell’ordine, mostrando sia l’addebito completo sia il totale al checkout.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

È utile quando imballaggio, amministrazione, lavorazioni speciali o attività di evasione non possono essere coperti da un solo metodo. Inserisca il subtotale e uno o entrambi i componenti per ottenere un riepilogo trasparente, con valori monetari arrotondati a due decimali prima dell’impiego in un negozio, preventivo, fattura o flusso di pagamento.

Imposti il subtotale e i due componenti

Parta dal subtotale precedente alle spese di gestione. Deve corrispondere all’importo di beni o servizi sul quale la Sua politica applica la percentuale; non includa la tariffa stessa, altrimenti il calcolo diventerebbe composto. Inserisca quindi la quota fissa, destinabile a imballaggio, documentazione, prelievo in magazzino o altri costi uguali per ogni ordine idoneo. Infine indichi la percentuale come tale, non come frazione decimale: usi 4.5 per quattro e mezzo per cento, non 0.045. Ogni componente può essere zero, così sono supportate anche politiche solo fisse o solo percentuali. Tutti i valori devono essere non negativi e la percentuale non può superare 100. La separazione rende più semplice spiegare l’addebito, verificare la configurazione della piattaforma ed evitare che la quota fissa entri per errore nella base percentuale.

Comprenda calcolo e arrotondamento

Lo strumento moltiplica dapprima il subtotale per la tariffa percentuale divisa per 100. L’importo ottenuto viene arrotondato a due decimali, secondo la precisione in centesimi normalmente usata al checkout. Successivamente aggiunge la quota fissa e arrotonda l’addebito complessivo. Il totale dell’ordine è dato dal subtotale originale più tale addebito. La risposta include subtotale normalizzato, tariffa fissa, percentuale, quota percentuale, spesa di gestione totale e totale finale. Questo dettaglio consente a un’integrazione di mostrare una sola voce conservando i dati per test e riconciliazione. Non vengono aggiunti imposte, spedizione, sconti, mance, commissioni di pagamento o conversioni valutarie. Applichi questi elementi separatamente, secondo la sequenza del Suo sistema e i requisiti normativi pertinenti.

Usi il risultato in modo sicuro nel checkout

Impieghi il calcolatore come passaggio deterministico dopo avere stabilito il subtotale idoneo e prima di presentare il riepilogo conclusivo. Un negozio può richiamarlo quando cambia il carrello, il reparto operativo può provare un nuovo piano tariffario e l’amministrazione può confrontare l’importo previsto con gli ordini completati. In assenza di rete, stato salvato, casualità o data corrente, gli stessi input producono sempre lo stesso risultato. Conservi i valori inseriti con il riepilogo se dovrà spiegare un addebito storico. Prima del lancio verifichi l’ordine con cui la piattaforma applica sconti, spedizione, imposte e tariffe, poiché questa funzione usa soltanto il subtotale fornito. Renda visibile l’addebito prima della conferma del pagamento. L’API costa $0.002 per richiesta; nel browser lo stesso calcolo puro avviene senza inviare valori a terzi.

Casi d'uso

Configurare il checkout del negozio

Calcoli l’addebito esatto per riprodurre una politica con quota fissa e percentuale.

Provare un piano tariffario

Confronti le spese su subtotali rappresentativi prima di pubblicare una nuova politica.

Riconciliare gli ordini completati

Ricalcoli la spesa attesa dai dati registrati e la confronti con quella dell’ordine.

Domande frequenti

Quale subtotale devo inserire?

Inserisca la base prevista dalla Sua politica prima di questa spesa. L’inclusione di sconti, spedizione o imposte dipende dal checkout.

Posso calcolare soltanto una tariffa fissa?

Sì. Imposti percentage_fee su zero oppure lo ometta; l’addebito coinciderà con la quota fissa.

Come vengono gestite le frazioni di centesimo?

La quota percentuale viene arrotondata a due decimali prima di aggiungere quella fissa. Anche addebito e totale sono arrotondati.

Sono incluse imposte o spedizione?

No. Viene calcolata solo la gestione sul subtotale fornito; gli altri adeguamenti devono essere separati.

Quanto costa l’API?

L’API costa $0.002 per richiesta. La versione browser esegue localmente lo stesso calcolo 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/handling-fee

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/handling-fee \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subtotal":125.5}'

const res = await fetch("https://api.kit.forhosting.com/ecom/handling-fee", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "subtotal": 125.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/handling-fee",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "subtotal": 125.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/handling-fee", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"subtotal":125.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"subtotal":125.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/handling-fee", 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

{
  "subtotal": 125.5
}

Esempio di risposta

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