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”| Zone | Countries | Rate |
|---|---|---|
| United States | US | Base $5 + $5/0.5kg |
| Switzerland | CH | $7.50/0.5kg |
| Canada | CA | $5/0.5kg |
| Russia | RU | $9/0.5kg |
| South Africa | ZA | $16/0.5kg |
| Israel | IL | $30/0.5kg |
| South America | AR, BR, CL, CO, CR, DO, EC, SV, HN, JM, LR, MD, NI, PA, UY | $12.50/0.5kg |
| European Union | AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE | $4.50/0.5kg + VAT |
| China | CN | Free (SF Express) |
| HK / TW / Macau / SG | HK, TW, MO, SG | $2.50/0.5kg |
| Default | All others | $5/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 calculated on underdeclared product values:
- Wheels: $10 per item declared value → $2.00 VAT per wheel
- Bushings: $2 per item declared value → $0.40 VAT per bushing
- Rate: 20%
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.