Shipping
Weight-based shipping
Section titled “Weight-based shipping”The default shipping provider calculates rates based on total cart weight and destination country.
Zone rates
Section titled “Zone rates”Example configuration — edit the zone table in the source to match your carriers and markets.
| Zone | Countries | Rate |
|---|---|---|
| Domestic | US | $5.00 flat |
| Europe | AT, BE, FR, DE, IT, NL, ES, … | $10.00/0.5kg |
| Rest of world | All others | $15.00/0.5kg |
| Default fallback | Unmatched destinations | $5.00/0.5kg |
Weight calculation
Section titled “Weight calculation”- Weight rounds up to nearest 0.5kg
- Minimum charge: 0.5kg
- Weight unit stored in kg; lb/oz converted automatically
EU VAT
Section titled “EU VAT”For EU destinations, VAT is applied to items at the configured rate; shipping charges themselves are not taxed. For example, a $10.00 item in a 20% VAT class contributes $2.00 VAT; a $2.00 item contributes $0.40.
Product weight
Section titled “Product weight”Products should include weight data:
{ "weight": 1.1, "weight_unit": "kg"}Products without weight default to 0.5kg.
Flat rate (manual provider)
Section titled “Flat rate (manual provider)”For testing or simple setups, a manual flat-rate provider is available:
| Service | Cost |
|---|---|
| Standard | $10 |
| Express | $25 |
| Free (orders > $100) | $0 |
Enable by setting default_provider = "manual" in config.
Carriers
Section titled “Carriers”Additional carrier integrations (DHL, FedEx, UPS, USPS) can be enabled in config with API credentials. These providers return real-time rates from the carrier APIs.