--- title: Commerce7 API Integration on Truto slug: commerce7 category: E-Commerce canonical: "https://truto.one/integrations/detail/commerce7/" --- # Commerce7 API Integration on Truto **Category:** E-Commerce **Status:** Generally available ## Unified APIs ### Unified E-Commerce API - **Customers** — The customer represent a customer in E-Commerce. - **Orders** — The order represent an order in E-Commerce. - **Products** — The product represent a product in E-Commerce. ## How it works 1. **Link your customer's Commerce7 account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Commerce7.** The Proxy API is a 1-to-1 mapping of the Commerce7 API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync DTC wine sales into inventory and production software** — If you build production or inventory management software for beverage producers, integrating with Commerce7 lets you automatically deplete finished goods inventory every time a sale happens — whether it's from the web store, POS, or a wine club shipment. This eliminates hours of manual spreadsheet reconciliation for your winery customers. - **Power personalized marketing campaigns from wine club and customer data** — Marketing automation platforms can pull rich customer attributes like club membership tier, birthdate, lifetime value, and custom tags from Commerce7 to drive hyper-targeted email and SMS campaigns. Offering this as a native integration means your users get segmentation that actually reflects the wine industry's unique buyer lifecycle. - **Automate alcohol-compliant order fulfillment and tracking** — Fulfillment and 3PL platforms need exact order details — including delivery method, compliance status, and product volume — to legally ship alcohol across state lines. Integrating with Commerce7 lets your software ingest orders, validate compliance, and push tracking numbers back to update order status automatically. - **Build cross-channel loyalty programs for tasting room and online purchases** — Loyalty and customer experience platforms can aggregate order history across Commerce7's POS and e-commerce channels to calculate reward points and tier status. Writing tags like 'VIP' back to customer profiles means tasting room staff see loyalty status in real time on the POS, closing the loop between digital engagement and in-person experiences. - **Streamline accounting by syncing multi-channel sales data to ERPs** — Accounting and ERP platforms serving the beverage industry can pull daily sales from Commerce7's web, POS, and subscription channels to auto-generate journal entries and reconcile revenue. This native integration removes the need for your users to manually export CSVs or re-key transaction data. ## What you can build - **Real-time order ingestion pipeline** — Automatically pull new Commerce7 orders — including channel (Web, POS, Club), delivery method, and compliance status — into your application as they're created, using Commerce7's webhook support or polling. - **Bidirectional customer tag sync** — Read customer tags, club membership status, and LTV from Commerce7 and write enriched tags (like marketing segments or loyalty tiers) back to customer profiles so they surface on the POS in tasting rooms. - **SKU-level inventory sync from external warehouses** — Push real-time stock levels from a Warehouse Management System into Commerce7's product inventory to prevent overselling highly allocated or rare wines. - **Automated fulfillment status and tracking number writeback** — After your fulfillment logic processes a shipment, push the carrier tracking number back to the Commerce7 order to trigger automatic shipping notification emails to the buyer. - **Wine club membership change listener** — Detect when a customer joins, upgrades, or cancels a club membership by syncing customer data and club status, then trigger downstream workflows like onboarding sequences or churn alerts. - **Vintage product rollover automation** — Use product and variant data to help wineries transition SKUs between vintages (e.g., 2022 Pinot Noir to 2023 Pinot Noir) while preserving pricing, volume, and inventory relationships in your platform. ## FAQs ### How does authentication work with Commerce7? Commerce7 uses Basic Authentication (app ID and secret per tenant). Truto manages credential storage and auth handling so your application never touches raw credentials directly. ### What are Commerce7's API rate limits? Commerce7 enforces a rate limit of 100 requests per minute per tenant. Truto handles pagination and request management, but you should design bulk sync workflows (like large order pulls) to stay within this limit. ### Does Commerce7 support webhooks for real-time data? Yes. Commerce7 offers webhooks for key events including Customers, Orders, Fulfillment, and Reservations. These can be used alongside Truto's polling capabilities to keep your data fresh without constant API calls. ### What Unified API resources does Truto map to Commerce7? Truto's Unified E-Commerce API covers Customers, Orders, and Products. These map to Commerce7's core objects including customer profiles (with club status, tags, birthdate, LTV), orders (with channel, compliance, and delivery data), and products (with SKU, price in cents, volume, and inventory levels). Specific tools are built on request to match your integration needs. ### Can I write data back to Commerce7, or is it read-only? Commerce7's API is fully read-write with over 900 endpoints. Common write operations include updating customer tags, pushing tracking numbers to orders, and syncing inventory levels. Truto can support bidirectional sync — specific write operations are scoped during integration setup. ### How does Commerce7 handle product pricing and alcohol-specific fields? Prices are stored in cents (integer format) to avoid floating-point issues. Products also carry alcohol-specific attributes like Volume (e.g., 750ml, 1.5L Magnum) and variant-level data, which are critical for compliance calculations and shipping logistics.