Pp Fedex

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/fedex/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

FedEx — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the fedex-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install fedex --cli-only

2. Verify: fedex-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/commerce/fedex/cmd/fedex-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use fedex-pp-cli when you run a small-to-medium shipping operation and want to programmatically interact with the FedEx REST API. Right fit for: e-commerce stores creating labels from order CSVs, customer-service teams generating return labels, ops teams tracking in-flight shipments, and SMB owners who want a local ledger of every shipment and rate quote for accounting. The local SQLite archive makes it the right tool for analytical queries over historical shipments. Choose this CLI over multi-carrier SaaS (ShipStation, Shippo) when you only need FedEx, want to own your data, and prefer terminal/agent automation over web UIs.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Save money, save time

• rate shop — Quote rates across every applicable service type in parallel and rank by cost, transit days, or cost-per-day.

  When picking the cheapest viable service for a shipment, this collapses 6+ API calls into one ranked answer. The headline cost-saving command for SMB shippers.

  fedex rate shop --from 90210 --to 10001 --weight 5lb --json --select rates.serviceType,rates.totalNetCharge,rates.transitTime

• ship bulk — Create labels for a CSV of orders with adaptive rate limiting, per-row PASS/FAIL accounting, and resume-from-last-success.

  The 'I ship 30 packages a day' workflow. Replaces clicking through FedEx Ship Manager one label at a time.

  fedex ship bulk --csv orders.csv --service GROUND --output labels/ --resume

• return create — Generate a Ground Call Tag (return label) against an existing tracking number with one command, optionally emailing it to the recipient.

  E-commerce customer-service workflow. Issuing a return label is the most common post-sale interaction.

  fedex return create --tracking 794633071234 --reason damaged --email customer@example.com

• address validate — SHA-256-keyed local cache prevents re-billing the FedEx Address Validation API for repeat lookups.

  Direct cost savings — the only feature with a quantifiable per-call $ impact.

  fedex address validate --street '1600 Amphitheatre Pkwy' --city 'Mountain View' --state CA --zip 94043 --country US --cache

• ship etd — Single-command Electronic Trade Documents shipping: uploads commercial invoice, captures docId, and stitches it into the shipment create call.

  International shipments require ETD; this collapses an error-prone multi-step into one atomic action.

  fedex ship etd --invoice invoice.pdf --orig CN --dest US --recipient-name 'Acme' --weight 2kg --service FEDEX_INTERNATIONAL_PRIORITY

Local state that compounds

• address save — Save frequently-used recipients to a local address book; reference them by name in ship commands.

  Ergonomic parity with paid SaaS competitors. Eliminates retyping addresses for repeat customers.

  fedex address save acme --street '500 Main St' --city Denver --state CO --zip 80202 --country US

• track diff — Show only the tracking events that have appeared since the last poll for each tracking number in the local store.

  Replaces tracking-poll dedupe glue agents would otherwise write.

  fedex track diff --since 1h --json

• track watch — Continuously poll a set of tracking numbers and emit new events to stdout, a webhook, or a file as they arrive. Polling alternative to FedEx push notifications.

  Most SMBs don't have provisioned push webhooks. Polling daemon is the universal alternative.

  fedex track watch --tracking 794633071234 --interval 10m --webhook https://example.com/hook

• archive — SQLite FTS5 search across every shipment in the local archive — recipient name, address, reference, tracking number, service.

  'Did we ship to ACME last week?' — a question SMBs ask constantly.

  fedex archive 'warehouse 47' --service GROUND --json

• spend report — Sum of net charges per service type, lane, or account from the local rate-quote and shipment ledger.

  'How much did I spend on FedEx last month?' — the question every SMB owner asks.

  fedex spend report --since 30d --by service --json

• export — Dump shipments + charges + tracking events as CSV or JSON for QuickBooks/Xero reconciliation.

  Closes the loop on accounting reconciliation without manual data entry.

  fedex export --format csv --since 30d --output fedex-april.csv

• manifest — Generate a printable PDF/text summary of every shipment created today from the local archive, optionally invoking the Ground EOD close API.

  Closes the warehouse-day workflow loop in one command.

  fedex manifest --date 2026-05-02 --close --output manifest.md

• sql — Direct SQLite SELECT queries against shipments, rate_quotes, tracking_events, address_validations, addresses tables.

  Escape hatch for arbitrary analytics over the local ledger.

  fedex sql "select serviceType, count(*) as n, sum(net_charge) as spend from shipments where created_at > date('now','-30 days') group by serviceType order by spend desc"

Setup smoothness

• doctor — Verifies OAuth auth, sandbox/prod routing, account-number format, label-format compatibility, and surfaces BAG (Bar Code Analysis Group) approval status.

  Avoids the most common 'why won't my labels print' failure mode for first-time users.

  fedex doctor

Command Reference

addresses — Address validation

• fedex-pp-cli addresses — Validate one or more addresses (resolved/standardized form, classification, optional resolved coordinates)

availability — Service availability, special-service options, and transit times

• fedex-pp-cli availability services — Get available services for an origin/destination pair
• fedex-pp-cli availability special_services — Get available special-service options (alcohol, dangerous goods, signature requirements, etc.)
• fedex-pp-cli availability transit_times — Get transit times for an origin/destination pair across services

consolidations — Consolidate multiple shipments into one fulfillment (advanced; for high-volume 3PLs)

• fedex-pp-cli consolidations add_shipment — Add shipments to a consolidation
• fedex-pp-cli consolidations confirm — Confirm a consolidation (locks rates and triggers shipping)
• fedex-pp-cli consolidations confirm_results — Get results of a consolidation confirmation
• fedex-pp-cli consolidations create — Create a consolidation
• fedex-pp-cli consolidations delete — Delete a consolidation
• fedex-pp-cli consolidations delete_shipment — Remove a shipment from a consolidation
• fedex-pp-cli consolidations modify — Modify a consolidation
• fedex-pp-cli consolidations results — Get consolidation results
• fedex-pp-cli consolidations retrieve — Retrieve a consolidation

endofday — Submit and modify Ground end-of-day close (daily manifest)

• fedex-pp-cli endofday close — Submit Ground end-of-day close (manifest packages shipped today)
• fedex-pp-cli endofday modify — Re-submit or modify a previous end-of-day close

freight_pickups — Schedule, check, and cancel freight (LTL) pickups

• fedex-pp-cli freight_pickups availability — Check freight pickup availability
• fedex-pp-cli freight_pickups cancel — Cancel a freight pickup
• fedex-pp-cli freight_pickups create — Schedule a freight (LTL) pickup

freight_shipments — Create freight (LTL) shipments (for industrial shippers)

• fedex-pp-cli freight_shipments — Create a freight (LTL) shipment

globaltrade — Global trade regulatory details (HS codes, restrictions)

• fedex-pp-cli globaltrade — Get regulatory details (HS codes, harmonized system, country restrictions)

locations — Find FedEx Office, dropoff, and pickup locations

• fedex-pp-cli locations — Find FedEx locations near an address or postal code

openship — Build multi-piece shipments progressively before confirming (advanced; not needed for typical SMB workflows)

• fedex-pp-cli openship add_package — Add a package to an open shipment
• fedex-pp-cli openship create — Create an open (uncommitted) multi-piece shipment
• fedex-pp-cli openship delete — Delete an open shipment
• fedex-pp-cli openship delete_package — Delete a package from an open shipment
• fedex-pp-cli openship modify — Modify an open shipment
• fedex-pp-cli openship modify_package — Modify a package in an open shipment
• fedex-pp-cli openship results — Get results of a confirmed open shipment
• fedex-pp-cli openship retrieve — Retrieve an open shipment by index
• fedex-pp-cli openship retrieve_package — Retrieve a specific package from an open shipment

pickups — Schedule, check availability, and cancel Express/Ground pickups

• fedex-pp-cli pickups availability — Check whether pickup is available for a postal code on a date
• fedex-pp-cli pickups cancel — Cancel a previously-scheduled Express/Ground pickup
• fedex-pp-cli pickups create — Schedule an Express or Ground pickup at a specified address

postal — Postal code validation and country servicing

• fedex-pp-cli postal — Validate that FedEx services a postal code in a country

rates — Rate quotes for Express, Ground, Home, Ground Economy, and freight

• fedex-pp-cli rates quote — Quote rates for a shipment (Express/Ground/Home/Ground Economy)
• fedex-pp-cli rates quote_freight — Quote rates for freight (LTL) shipments

shipments — Create, validate, cancel, and retrieve shipments

• fedex-pp-cli shipments cancel — Cancel a shipment by tracking number
• fedex-pp-cli shipments create — Create a shipment and generate label(s)
• fedex-pp-cli shipments results — Retrieve results of an asynchronous shipment job
• fedex-pp-cli shipments tag — Create a Ground Call Tag (return label) for an existing shipment
• fedex-pp-cli shipments tag_cancel — Cancel a Ground Call Tag
• fedex-pp-cli shipments validate — Validate a shipment package without creating a label (catches rejections before billing)

track — Track shipments by tracking number, reference, TCN, or associated shipment; retrieve documents and configure notifications

• fedex-pp-cli track associated — Track shipments associated with a master tracking number (multi-piece)
• fedex-pp-cli track documents — Retrieve tracking documents (signature proof of delivery, etc.)
• fedex-pp-cli track notifications — Configure tracking notifications (email/SMS) for a shipment
• fedex-pp-cli track number — Track up to 30 tracking numbers in one call (returns full event timeline per shipment)
• fedex-pp-cli track reference — Track by reference number (PO/customer ref/RMA)
• fedex-pp-cli track tcn — Track by Transportation Control Number (military/government use)

Hand-written commands

• fedex-pp-cli auth login [--client-id <id>] [--client-secret <secret>] [--env sandbox|prod] — Mint an OAuth2 bearer token via client_credentials and cache it on disk
• fedex-pp-cli auth logout — Clear the cached bearer token
• fedex-pp-cli auth status — Show the cached token's expiry and which env vars were detected
• fedex-pp-cli rate shop --from <zip> --to <zip> --weight <n>[lb|kg] — Quote rates across every applicable service type in parallel and rank by cost or transit
• fedex-pp-cli ship bulk --csv <path> --service <type> [--output <dir>] [--resume] [--concurrency N] — Create labels for a CSV of orders with adaptive rate limiting and resumable on partial failure
• fedex-pp-cli ship etd --invoice <pdf> --orig <country> --dest <country> ... — Single-command Electronic Trade Documents shipping (upload + reference + ship in one call)
• fedex-pp-cli address save <name> --street <s> --city <c> --state <s> --zip <z> --country <c> — Save a recipient to the local address book
• fedex-pp-cli address list — List saved recipients in the local address book
• fedex-pp-cli address delete <name> — Delete a saved recipient from the local address book
• fedex-pp-cli track diff [--since <duration>] [--tracking <num>...] — Show only tracking events that have appeared since the last poll
• fedex-pp-cli track watch --tracking <num> [--interval <duration>] [--webhook <url>] — Long-poll daemon: continuously poll tracking and emit new events
• fedex-pp-cli return create --tracking <orig-tracking> [--reason <reason>] [--email <addr>] — Generate a return label (Ground Call Tag) for an existing shipment
• fedex-pp-cli spend report [--since <duration>] [--by service|account|lane] — Sum net charges per service type from the local shipment ledger
• fedex-pp-cli archive <query> — FTS5 search across shipments in the local archive
• fedex-pp-cli export [--format csv|json] [--since <duration>] [--output <file>] — Export shipment history for accounting reconciliation
• fedex-pp-cli manifest [--date YYYY-MM-DD] [--close] [--output <file>] — Generate end-of-day manifest report from local archive; optionally fire Ground EOD close
• fedex-pp-cli doctor — Verify auth, sandbox/prod routing, account-number format, label-format compatibility, BAG approval status