Overview

ParcelDuty API Reference

ParcelDuty is a headless freight clearinghouse that bridges warehouse dispatch operations (Mintsoft, Peoplevox, Extensiv, Deposco, Picqer) with carrier billing mainframes (DPD, DHL, UPS, FedEx, Royal Mail) and accounting ERPs (Xero, NetSuite, Sage). All endpoints are stateless, idempotent, and execute in under 50ms SLA.

2. Authentication

Pass an authenticated API key via standard HTTP Bearer authentication:

Authorization: Bearer ***

POST

/v1/billing/reconcile

Reconciles raw carrier EDI 210 / CSV invoices against WMS dispatch exports across rolling 90-day windows. Emits ERP-ready draft re-bill lines with cryptographic laser proof URLs and pre-formatted carrier credit dispute claims.

// Sample cURL Request

curl -X POST https://api.parcelduty.com/v1/billing/reconcile \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "carrier_csv_payload": "...",
    "wms_csv_payload": "...",
    "markup_margin_pct": 12.0
  }'

POST

/v1/billing/accrue

Real-time T+0 pack-bench inspection. Queries the Cross-Tenant Laser Vault to predict volumetric DIM spikes, Non-Conveyable (NCV) fees, and remote area fees before the carton leaves the warehouse dock.

POST

/v1/skus/preflight

Evaluates merchant master SKU catalog syncs before receiving at the dock. Quarantines suspect UN3481 lithium-ion batteries and aerosol hazmat to prevent statutory carrier fines (£1,000–£5,000).

POST

/v1/audit/drop-and-diff

Zero-auth forensic margin auditor for prospective 3PL clients. Takes up to 500 carrier invoice lines and returns complete leakage quantification.

7. Model Context Protocol (@parcelduty/mcp-server)

Install the native MCP server to query freight margin leakage and approve draft re-bills directly inside Claude Desktop, Slack, or Copilot:

npx -y @parcelduty/mcp-server