Wholesale Engine Developer API: Buyer Sync & Invoice-Paid Webhooks

Wholesale doesn’t end when the invoice is paid—finance still needs the ledger in your accounting system.

Most legacy B2B apps treat integration as an enterprise upcharge. Wholesale Engine ships Developer API v1 as a core capability: bearer-token access and programmable webhooks without a separate “enterprise tier.”

Ops hub: wholesale operations without app-stacking.

What ships today (v1)

| Capability | Endpoint / event | Use case | |------------|------------------|----------| | Buyer & credit sync | `GET /api/v1/wholesale/buyers` | Pull approved buyers, credit limits, MOA, Net terms flags into CRM or ERP | | Webhook registration | `POST /api/v1/wholesale/webhooks` | Subscribe your HTTPS endpoint to ledger events | | Invoice settled | Outbound `wholesale_invoice_paid` | Push paid invoice payload to Xero, QuickBooks, NetSuite middleware, or a custom ledger | | Token management | Admin → Settings → Developer API | Issue/revoke scoped tokens per shop (`we_live_…`) |

Authentication: `Authorization: Bearer <API_TOKEN>`. Webhook deliveries include HMAC signatures for verification.

Example buyer sync response shape:

```json { "status": "success", "data": [ { "buyer_id": "b2b_849204719", "company_name": "Precision Audio", "net_terms": { "enabled": true, "credit_limit": 5000.0, "outstanding_balance": 1250.0 } } ] } ```

Connects to your books (API first)

The platform bet is open webhooks, not a single country’s accounting brand as a headline feature.

Optional regional connectors (for example an opt-in Fatture in Cloud path for Italian merchants who want an issued FIC document on full payment) stay available—default off, not required for everyone else.

Wholesale Engine Developer API settings with bearer token issuance for ERP integrations
Developer API v1: issue bearer tokens in Admin and register webhooks for invoice-paid events.
--- ## Roadmap (documented, not yet live) - `PUT /api/v1/wholesale/price-lists/{product_id}` — programmatic case-pack and wholesale price updates - Rate limiting and Partner Dashboard webhook UI (register via API/curl today) - Email PO ingest (inbound attachment webhook) **Developers:** full JSON contracts in `API_V1_REST_SPEC.md` in the app repo. --- ## FAQ **Do I need Pro for the API?** Developer API v1 is part of the app’s integration surface—manage tokens under Admin → Settings → Developer API on your install. **Can I use this with QuickBooks or Xero?** Yes—subscribe to `wholesale_invoice_paid` and map the payload in middleware or your iPaaS. --- ## Next steps - Related: [Collections Manager](https://competetracker.com/blog/shopify-collections-manager-net-terms) - Hub: [Wholesale ops without app-stacking](https://competetracker.com/blog/b2b-wholesale-shopify-without-plus) - **[Install Wholesale Engine →](https://apps.shopify.com/wholesale-engine)** ---

Install Wholesale Engine on Shopify