Wine POS API
Wine POS (WinePOS) is a point-of-sale and back-office system built for wine and liquor retailers, handling inventory by sizes, singles, packs, and cases across single and multi-location stores, plus payments, compliance, age verification, vendor invoicing, and eCommerce sync. An unofficial API lets you programmatically pull inventory, sales transactions, customers, orders, and vendor invoices—and push updates like price changes, inventory adjustments, and purchase orders back into Wine POS without manual data entry or FTP file handling.
What is Wine POS?
Wine POS (WinePOS) is a point-of-sale and back-office system built specifically for wine and liquor retailers, describing itself as a trusted, scalable POS for wine and liquor stores for over 40 years. Stores use Wine POS to manage inventory across sizes, singles, packs, and cases, ring sales with built-in age verification, process payments in a solution compliant across all 50 states, automate vendor invoices into purchase orders, and synchronize inventory and customer orders with their eCommerce storefronts across single and multi-location businesses.
Core product areas include:
- Point of Sale and register operations with built-in age verification, gift cards, and self checkout
- Inventory management across sizes, singles, packs, and cases with multi-location data synchronization
- WinePOS Payments processing, compliant across all 50 states
- V-Connect Remote Access and V-Droid Mobile (line busting, receiving/scanning, price changes, shelf labels, transfers)
- VisionLink eCommerce Integration plus Docupiler vendor invoice automation
- Comprehensive back-office and register reporting, time clock, and data vault
Common data entities:
- Items, SKUs, Sizes, Singles, Packs, Cases, Shelf Labels
- Inventory Levels, Adjustments, Transfers, Breakage/Tasting tracking
- Sales Transactions, Tenders, Gift Cards, Age Verification records
- Customers, Customer Orders, Loyalty
- Vendors, Vendor Pricing, Vendor Invoices, Purchase Orders
- Locations, Registers, Time Clock entries
The Wine POS Integration Challenge
Wine and liquor retailers run their entire operation on Wine POS, but the store's own inventory, sales, and customer data is hard to get out programmatically:
- Partner-gated API: Integrations flow through Wine POS programs like VisionLink and named partners (CityHive, BottleCapp, WooCommerce), so direct API access typically requires a partnership rather than self-serve developer keys
- File-based extracts: Inventory and item data are often exchanged via daily FTP file uploads and developer data extracts rather than real-time endpoints, introducing latency and parsing overhead
- On-premise and remote-access architecture: Back-office functions run through desktop and V-Connect remote access, so headless automation must work against authenticated sessions rather than a clean cloud API
- Mobile-only operations: Receiving, price changes, transfers, and shelf-label updates happen in V-Droid Mobile, where some workflows and data live outside any documented endpoint
- Multi-location reconciliation: Sizes, singles, packs, and cases must stay consistent across locations, and generic integrations break on the unit-of-measure and pack/case math unique to beverage retail
- Compliance and age verification: Sales carry age-verification and state-specific compliance data that must be preserved exactly when synced to downstream systems
How Supergood Creates Wine POS APIs
Supergood reverse-engineers Wine POS's authenticated back-office and remote-access flows, its eCommerce data extracts, and its FTP-based exchanges to deliver a resilient, real-time API layer for your store—without waiting on a partner program or hand-parsing nightly files.
- Handles username/password and MFA securely in a managed session
- Maintains session continuity across V-Connect remote access with automated refresh and change detection
- Normalizes inventory across sizes, singles, packs, and cases so you integrate once and rely on consistent item and stock objects
- Preserves age-verification, gift card, and state compliance fields across single and multi-location stores
Use Wine POS with AI agents: Wine POS MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your locations, modules, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Wine POS adapter tailored to your store configuration and data.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Wine POS evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Wine POS store using username/password, or MFA, and obtain a session token for downstream calls.
Inventory
/inventoryList items and stock levels across sizes, singles, packs, and cases, with filters for location, category, and vendor.
Inventory
/adjust_inventoryPost inventory adjustments, transfers, and price changes—including breakage and tasting tracking—across single or multi-location stores.
Sales
/salesRetrieve sales transactions, tenders, gift card activity, and age-verification records with date and register filters.
Customers
/customersPull customer records, customer orders, and loyalty details for sync to eCommerce and CRM systems.
Purchasing
/create_purchase_orderCreate purchase orders from vendor invoices and push vendor pricing updates back into Wine POS.
Use Cases
Sync inventory across locations and eCommerce
- Pull live item, stock, and pricing data across sizes, singles, packs, and cases into a central warehouse - Push price changes and inventory adjustments back to every register without desktop access - Keep CityHive, BottleCapp, WooCommerce, or a custom storefront in sync without nightly FTP files
Stream sales and compliance data to analytics
- Stream sales transactions, tenders, and gift card activity to BI and accounting tools - Preserve age-verification and state-specific compliance fields on every sale - Reconcile register and back-office totals across single and multi-location stores
Automate vendor invoicing and purchasing
- Turn vendor invoices into purchase orders and post them back into Wine POS - Sync vendor pricing and update item costs across locations - Match received deliveries against POs and flag discrepancies automatically
Unify customer and loyalty records
- Sync customers and customer orders between Wine POS and your CRM or marketing stack - Surface purchase history and loyalty status to downstream personalization tools - Reconcile online and in-store orders into a single customer view
Technical Specifications
Authentication
Username/password and MFA handled in a managed, encrypted session
Connectivity
Authenticated back-office and V-Connect remote-access flows, plus eCommerce data extracts and FTP exchanges where exposed
Response format
Normalized JSON across Items, Inventory, Sales, Customers, and Purchasing objects
Rate limits
Adaptive throttling tuned to your store to avoid back-office and register-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time reads for inventory and sales with optional scheduled batch syncs replacing nightly FTP extracts
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for sales, inventory adjustments, price changes, and customer order events
Latency
Sub-second reads on cached items and stock; multi-second writes when posting adjustments and purchase orders
Throughput
Horizontally scaled workers sized to multi-location register and inventory volume
Reliability
Retry, backoff, and idempotency keys for inventory adjustments, transfers, and purchase orders
Adaptation
Continuous monitoring of Wine POS releases, mobile app changes, and store-specific configuration drift
Frequently asked questions
Yes. Supergood normalizes items and stock across sizes, singles, packs, and cases for single and multi-location businesses, so inventory, sales, and customer data reconcile cleanly across every location.
No. Supergood works against your existing Wine POS access and authenticated sessions, so you do not need to wait on VisionLink or a named integration partner to get programmatic access to your own data.
Yes. Instead of parsing daily FTP files, Supergood exposes near real-time inventory and item reads, with optional scheduled syncs if you still want batch delivery to a downstream system.
Yes. Age-verification records and state-specific compliance fields are carried through on sales objects exactly as captured at the register, so downstream systems stay audit-ready.
Yes. The API supports writes for price changes, inventory adjustments, transfers, and purchase orders, so you can automate back-office workflows that otherwise require V-Connect or V-Droid Mobile.