HALOWERKHandelswerk
landed cost
Computes what an import actually costs at the destination. The customs value is assembled from goods, freight and insurance on the chosen basis (CIF or FOB), duty is applied to it, and import VAT is applied to the duty-inclusive value, which is the ordering most calculations get wrong. Duty rates come from the live tariff: the UK Trade Tariff for GB and the USITC HTS for the US, with the commodity description returned so a wrong classification is visible.
POST https://handel.halowerk.com/v1/landed-costEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| hs_code | string | Ja | Commodity code. UK wants 10 digits, US 8 to 10. |
| destination_country | string | Ja | ISO country code of the destination. |
| origin_country | string | Nein | ISO country code of origin, for context. |
| goods_value | number | Ja | Goods value in the given currency. |
| freight_cost | number | Nein | Freight to the border. |
| insurance_cost | number | Nein | Insurance. |
| currency | string | Nein | Currency of all amounts. No conversion is done. |
| valuation_basis | string | Nein | CIF includes freight and insurance in the customs value, FOB does not. |
Vollständiges Eingabeschema anzeigen
{
"type": "object",
"required": [
"hs_code",
"destination_country",
"goods_value"
],
"additionalProperties": false,
"properties": {
"hs_code": {
"type": "string",
"minLength": 4,
"maxLength": 14,
"description": "Commodity code. UK wants 10 digits, US 8 to 10."
},
"destination_country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO country code of the destination."
},
"origin_country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "ISO country code of origin, for context."
},
"goods_value": {
"type": "number",
"minimum": 0,
"description": "Goods value in the given currency."
},
"freight_cost": {
"type": "number",
"minimum": 0,
"default": 0,
"description": "Freight to the border."
},
"insurance_cost": {
"type": "number",
"minimum": 0,
"default": 0,
"description": "Insurance."
},
"currency": {
"type": "string",
"minLength": 3,
"maxLength": 3,
"default": "EUR",
"description": "Currency of all amounts. No conversion is done."
},
"valuation_basis": {
"type": "string",
"enum": [
"CIF",
"FOB"
],
"default": "CIF",
"description": "CIF includes freight and insurance in the customs value, FOB does not."
}
}
}Veröffentlichtes Eingabebeispiel
{
"hs_code": "610910",
"destination_country": "DE",
"origin_country": "US",
"goods_value": 100,
"freight_cost": 10,
"currency": "EUR"
}Ergebnis & Dokumentation
Veröffentlichtes Ergebnisschema anzeigen
{
"$ref": "https://handel.halowerk.com/v1/landed-cost/schema#/outputSchema"
}Veröffentlichtes Ergebnisbeispiel öffnen
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Handelswerk0,005 USDC
allergen check
POSThttps://handel.halowerk.com/v1/allergen-checkReturns what a product declares about allergens: the allergen tags, the trace warnings, the ingredients text in its original language, and the completeness of the record. The distinction it holds to throughout is between not declared and no
- Handelswerk0,006 USDC
container load
POSThttps://handel.halowerk.com/v1/container-loadLoads a package list into one loading space and returns the plan, not an estimate. The floor starts as one free surface; packages are sorted by footprint, then height, then weight, then identifier, and each one is placed on the lowest, then
- Handelswerk0,004 USDC
delivery note json
POSThttps://handel.halowerk.com/v1/delivery-note-jsonAdds structured delivery-note extraction alongside the existing invoice extractor and purchase-order matcher; does not duplicate invoice-extract or filing-to-json. Strict namespace-aware XML parsing, no model or foreign API. Only supplied s