An open API service indexing awesome lists of open source software.

https://github.com/soapyred/zapier-freightutils

Zapier integration for FreightUtils — free freight tools API (CBM, LDM, ADR, HS, customs, reference data)
https://github.com/soapyred/zapier-freightutils

customs dangerous-goods freight logistics shipping zapier zapier-integration

Last synced: 14 days ago
JSON representation

Zapier integration for FreightUtils — free freight tools API (CBM, LDM, ADR, HS, customs, reference data)

Awesome Lists containing this project

README

          

# zapier-freightutils

[![GitHub release](https://img.shields.io/github/v/release/SoapyRED/zapier-freightutils)](https://github.com/SoapyRED/zapier-freightutils/releases)
[![License: MIT](https://img.shields.io/github/license/SoapyRED/zapier-freightutils)](https://opensource.org/licenses/MIT)

Zapier integration for [FreightUtils](https://www.freightutils.com) — free freight tools API. **Currently private** (invite-only). Public Zapier marketplace listing is queued for v0.2.0+.

## What's in this release

18 operations — **10 Creates** and **8 Searches** — wrapping the FreightUtils REST API.

**Creates**
- Calculate CBM
- Calculate LDM
- Calculate Chargeable Weight
- Calculate Consignment (single-line totals)
- Calculate Pallet Fitting
- Convert Units
- Check ADR LQ/EQ Eligibility
- Calculate ADR 1.1.3.6 Exemption
- Calculate UK Import Duty
- **Calculate Shipment Summary** — composite covering CBM, chargeable weight, LDM, customs estimate, and DG flags for an entire shipment (multi-item) in one step. Replaces 4–5 chained Zap actions.

**Searches**
- Find ADR Entry
- HS Code Lookup
- Find Incoterm
- Find Airline
- Find UN/LOCODE Location
- Find ULD (Unit Load Device)
- Find Sea-Freight Container
- Find Road-Freight Vehicle

## Install

The app is **private** during v0.1.0 — accept the invite URL below to add it to your Zapier account, then it appears under **Your Apps** in the connector picker.

**Invite URL (all versions):**

**Invite URL (v0.1.0 specific):**

Authenticate with your FreightUtils API key; the test call hits `/api/health` — green tick means auth works end to end.

## Get an API key

Generate a free key (100 req/day) at . Upgrade to Pro (50,000 req/month, £19) via .

Rate limits:

| Tier | Limit |
|------|-------|
| Free | 100 req/day |
| Pro | 50,000 req/month |

## Worked example A — calculate chargeable weight on each new shipment row

**Trigger** — Google Sheets: New Row in `Incoming Shipments` tab (columns: `length_cm`, `width_cm`, `height_cm`, `gross_weight_kg`).

**Action** — FreightUtils: *Calculate Chargeable Weight*. Map:
- Length (cm) → `{{length_cm}}`
- Width (cm) → `{{width_cm}}`
- Height (cm) → `{{height_cm}}`
- Gross Weight (kg) → `{{gross_weight_kg}}`

**Action** — Google Sheets: Update Row. Write `chargeable_weight_kg` and `volumetric_weight_kg` back to the same row.

## Worked example B — HS code → UK duty from an email

**Trigger** — Gmail: New Email matching `subject:"New import query"` with body line `SKU: , Origin: , Value: £`.

**Action** — Zapier AI Action or Formatter: extract `sku_description`, `origin_country`, `customs_value`.

**Action** — FreightUtils: *HS Code Lookup*. Query → `{{sku_description}}`. Returns a list of candidate HS codes.

**Filter** — only continue if the top match has `hs_code` populated.

**Action** — FreightUtils: *Calculate UK Import Duty*. Commodity Code → `{{hs_code}}`, Origin Country → `{{origin_country}}`, Customs Value → `{{customs_value}}`.

**Action** — Slack: Send Message. Template: `HS: {{hs_code}} · Duty: £{{duty_gbp}} · VAT: £{{vat_gbp}} · Total: £{{total_gbp}}`.

## Known Constraints

**Email by Zapier (free plan)** — Zapier's free-plan Email by Zapier action silently overrides the To: field and sends only to the account owner's email address regardless of input. This is a Zapier platform behaviour, not a FreightUtils issue. For arbitrary recipients use Gmail, Outlook, or SendGrid actions instead.

## Roadmap

- ~~**v0.2.0** — public Zapier marketplace listing submission (after dogfooding + feedback)~~ shipped
- ~~**v0.3.0** — `shipmentSummary` composite Create (closes 18/18 MCP-tool parity)~~ shipped
- **v1.0.0** — public Zapier marketplace listing submission; UX-consistency pass renaming legacy single-letter input keys (`l`/`w`/`h`/`gw`/`pl` etc. on `cbm` / `chargeableWeight` / `pallet`) to full-word snake_case (`length` / `width` / `height` / `gross_weight`).
- Later — custom dynamic dropdowns (e.g., live HS chapter picker), triggers on FreightUtils events when those exist.

## Links

- FreightUtils:
- API docs:
- Pricing:
- Status:
- Changelog:
- Repo:
- Issues:
- Sibling n8n package:

## Licence

MIT — see [LICENSE.md](LICENSE.md).

Built by [Marius Cristoiu](https://www.linkedin.com/in/marius-cristoiu-a853812a2/), ADR-certified freight transport planner.