Frequently Asked Questions

Everything you need to know about syncing shipping data to Faire with WholesaleBridge.

Getting Started

What is WholesaleBridge?
WholesaleBridge is a cloud-based shipping data sync tool for wholesale brands. It takes the shipping CSV or XML export from your carrier (FedEx, UPS, USPS, DHL, LTL carriers, etc.) and automatically pushes tracking numbers, carrier info, and shipping costs to Faire and other wholesale platforms — replacing hours of manual data entry with a single upload.
How does WholesaleBridge work?

Three steps:

  1. Export your daily shipping file from your carrier or warehouse system — any CSV, TSV, or XML format works.
  2. Upload it to WholesaleBridge. Our AI-powered column mapper automatically detects your PO numbers, tracking numbers, carriers, and shipping costs — no reformatting required.
  3. Sync. WholesaleBridge validates your data, flags anything that needs attention, and pushes it directly to Faire's API. Orders are marked as shipped, tracking is live, and you get paid faster.
Do I need to install any software?
No. WholesaleBridge is 100% cloud-based and runs entirely in your web browser. No downloads, no desktop software, no ERP integration, no IT department required. Any team member with a browser can be up and running in under 5 minutes.
Do I need to reformat my shipping CSV before uploading?
No. Upload your file exactly as your carrier system generates it. Our AI column mapper learns your format on the first upload and remembers it for every future upload. We support CSV, TSV, pipe-delimited, and XML files with automatic delimiter detection. No reformatting, no templates, no training required.
How do I connect WholesaleBridge to my Faire account?
After signing up, go to Settings and enter your Faire API key. WholesaleBridge encrypts your key with AES-256-GCM vault encryption — it's never stored in plaintext and never exposed in logs. Once connected, you can start uploading shipping files immediately.

Carriers & Platforms

What carriers does WholesaleBridge support?
Over 1,200 carriers including FedEx, UPS, USPS, DHL, Amazon Shipping, OnTrac, and all major LTL freight carriers (XPO Logistics, Old Dominion, Estes, Dayton Freight, ABF Freight, and more). Our carrier detection engine uses fuzzy matching — even if your CSV has abbreviations or typos like "Fed Ex" or "FEDERAL EXPRESS", WholesaleBridge will recognize the carrier automatically.
What wholesale platforms does WholesaleBridge connect to?
WholesaleBridge currently integrates with Faire. Support for Airgoods, JOOR, Tundra, and Bulletin is on our roadmap. We also support reverse sync to Shopify — when you push tracking to Faire, WholesaleBridge can automatically update your Shopify fulfillments too.
Can WholesaleBridge handle LTL freight shipments?
Yes. WholesaleBridge automatically detects LTL (Less Than Truckload) carriers like XPO Logistics, Old Dominion, Estes, Dayton Freight, and more. LTL shipments are flagged for special handling since they typically require palletization and different tracking workflows. Our premium tier includes LTL-specific features like delivery tracking and proof of delivery capture.
Does WholesaleBridge work with Shopify?
Yes. WholesaleBridge supports reverse sync to Shopify. When you push tracking data to Faire, WholesaleBridge can automatically create fulfillments in your Shopify store using the modern FulfillmentOrders API. You can optionally notify customers when their order ships.
What if I ship from multiple warehouses or locations?
WholesaleBridge handles multiple shipping formats seamlessly. Each CSV format gets its own saved template with column mappings and cost rules. If warehouse A exports in one format and warehouse B in another, WholesaleBridge recognizes each format automatically by its header fingerprint and applies the right mapping.

Features

What happens if WholesaleBridge detects an error in my shipping data?

WholesaleBridge uses a smart holding pen system:

  • Hard errors (missing PO number, missing tracking) are flagged and skipped automatically.
  • Soft warnings (tracking format mismatch, possible duplicate) are routed to a review queue where you can approve, edit, or skip each row.

Nothing is submitted to Faire without your approval. Error messages include specific details like "Row 14: tracking 12345 doesn't match FedEx format (expected 12 or 15 digits)" so you know exactly what to fix.

Can I control what shipping cost is reported to Faire?

Yes. WholesaleBridge supports template-level cost rules:

  • Pass-through — report your actual shipping cost (default)
  • Free shipping — set cost to $0
  • Flat rate — fixed dollar amount per shipment
  • Percentage — adjust by a percentage of actual cost
  • Cap — set a maximum ceiling

Cost rules are per template — run a free shipping promo in March and switch back in April. WholesaleBridge also enforces Faire's 50% shipping cap automatically, flagging any shipment where shipping exceeds 50% of the order subtotal.

Can multiple team members use WholesaleBridge?
Yes. WholesaleBridge supports multi-user organizations. Each team member gets their own login with optional multi-factor authentication. All uploads are tracked by user in the audit trail.
How fast does WholesaleBridge process my uploads?
WholesaleBridge processes uploads in two phases. Phase 1 (validation and mapping) happens instantly — you see a preview within seconds. Phase 2 (pushing to Faire) runs in the background with up to 10 concurrent API calls for maximum throughput. A typical 500-row shipping file completes in under 60 seconds.

Security & Privacy

Is my data secure with WholesaleBridge?

Yes. Security is our top priority:

  • API keys encrypted with AES-256-GCM vault encryption (pgsodium)
  • Every action logged in SOC 2-ready audit trails
  • PII automatically sanitized from all logs
  • Multi-factor authentication (TOTP) support
  • HttpOnly secure cookies with CSRF protection
  • Complete organization-level data isolation
  • Faire's 15-day data retention compliance built in
Is WholesaleBridge affiliated with Faire?
No. WholesaleBridge is an independent third-party tool. We are not affiliated with, endorsed by, or partnered with Faire, Inc. We use Faire's official API to push shipping data on behalf of brands who provide their own Faire API credentials.

Pricing

What does WholesaleBridge cost?
WholesaleBridge is currently in pre-launch. Design partners who share shipping data to help train our system get their first year completely free. We will offer simple, transparent monthly pricing when we launch — no per-transaction fees, no hidden costs. Sign up for early access.

Still have questions?

We'd love to hear from you. Get in touch and we'll get back to you within 24 hours.

mark@wholesalebridge.io