Custom DesignerCustomDesignerDocumentation

Shipping labels

This is a proof of concept. Custom Designer can estimate carton weight from invoice garments, show shipping cost, and (when EasyPost is connected) buy a printable label.

It does not yet replace pickup & delivery emails, online-store checkout shipping charges, or tracking emails to the customer.

What you need

  1. An EasyPost account. Start with a test API key (EZTK…) so labels are not real postage.
  2. Settings → Integrations → EasyPost: paste the key, fill a structured ship-from address (street, city, state, ZIP), enable, save. Save tests the key by listing shipments (works with test keys). EasyPost’s carrier-account list is production-only and is not used.
  3. A client record with street, city, state, and ZIP (or type the ship-to on the order Shipping tab).

Company address is a single text field, so the EasyPost card stores a structured origin for rating.

Weight → cost

On Orders → Shipping:

  • SanMar lines use pieceWeight (pounds per garment, e.g. 0.28).
  • S&S lines use unitWeight (pounds, e.g. 0.3092). If that is missing, weight is caseWeight / caseQty.
  • New catalog lines also store unitWeightLbs on the invoice item. Older lines are looked up from the vendor catalog when you open Shipping, then saved so the next visit is instant.
  • Fabric copy such as “4.3-ounce” in a product description is not used — that is cloth weight, not the garment.
  • Other garment lines use a 6 oz fallback per piece.
  • Setup, art fees, rush, and similar titles are skipped.
  • A poly mailer or box tare and carton size are chosen from piece count.

Estimate shipping cost always returns USPS-like ballpark rates from that weight (not a carrier quote). Get EasyPost rates calls EasyPost with the carton and addresses and lists live carrier services.

How many boxes / labels

Jobs over 24 pieces or 30 lb (garments + box) split into cartons. Each carton is a separate EasyPost shipment and label. Buy a label per carton (same or mixed services). Adjust a carton’s weight or dimensions if you packed it differently.

Buy a label

Select an EasyPost rate and Buy label. After a successful purchase, a prompt asks whether to add the postage as an invoice line (Shipping · USPS GroundAdvantage, quantity 1, the paid rate). You can also add an existing label from the Purchased labels card at the top of the Shipping tab. Purchases are logged on the order Activity tab (shipping_label_purchased) so you can reprint from Shipping.

Estimated (non-EasyPost) rows cannot be purchased.

Limitations (POC)

  • Carton split is 24 pieces or 30 lb — not a 3D packer, and not vendor case packs.
  • No webhook tracking updates, void/refund, or customs forms.
  • Online store checkout still bills shipping after fulfillment; it does not yet call these rates.
  • Catalog lookup needs SanMar or S&S connected; lines without a style/SKU still use 6 oz.