On this page
Connect WineDirect Fulfillment with Corksy
Access the Integration Page:
Log in to the Corksy admin portal.
Navigate to Integration & Apps under settings.
Activate the WineDirect Fulfillment service:
Locate WineDirect Fulfillment from the list of integrations.
Click the Activate button next to WineDirect Fulfillment.
Enter Credentials:
A popup will appear prompting you to provide the required credentials for WineDirect Fulfillment.
Save the Configuration:
After filling in the required fields, click Save to complete the integration.
Feature Overview
The WineDirect Fulfillment integration allows Corksy orders and products to seamlessly sync, and fulfillment status updates are synced back from WineDirect Fulfillment to Corksy.
1. Integration
Required Credentials
Username
Password
Account Number
Supplier ID
2. Orders Sync & Fulfillment
All order types — Admin orders, Club orders, POS orders, and E-commerce orders — sync to WineDirect.
Fulfillment can be completed in WineDirect, and updates are reflected back into Corksy.
Pickup orders do not sync to WineDirect.
Order Type Mapping
Club Orders → Sent to WineDirect as “CLUB” (Club Order)
POS Orders → Sent to WineDirect as “VC” (Visitor Center)
All Other Orders → Sent to WineDirect as “STND” (Daily Order)
3. Product Sync
Newly created products will sync into WineDirect when sync order
⚠️ These cannot be fulfilled immediately because no inventory exists for them in WineDirect.
If a product already synced in WineDirect and that was updated in Corksy, the update is applied in WineDirect when a new order is placed.
WineDirect Product Type Mapping
GSET → Bundle
FOOD → Food
WINE (Wine/ Sparkling) → Wine
ACC (Accessory) → Others
WineDirect Product Parameters
Varietal: Mandatory in WineDirect but not in Corksy.
If no varietal is provided in Corksy, a default value “VARIETAL” will be sent.
If the product has a color variant, that will be sent instead.
Appellation: If no appellation is set in Corksy, the product name will be sent.
Alcohol Type: Not defined in Corksy. Default value sent to WineDirect = “STILL.”
4. Order Cancellation, Editing & Delivery Method Changes
Order Cancellation
If an order is cancelled in Corksy, the cancellation syncs to WineDirect.
The order status changes to “Cancelled” in WineDirect.
Delivery Method Changes
Ship → Pickup: Order will be cancelled in WineDirect.
Pickup → Ship: Order will sync to WineDirect.
Order Editing
If an order is edited (items added/removed), the changes are reflected in WineDirect.
5. Fulfillment Sync
Corksy checks WineDirect every 2 hours for order fulfillment updates.
Full fulfillment updates are applied in Corksy.
Partial fulfillment is not currently handled (requires clarification from WineDirect).
6. Carrier Rates
Carrier Rates Sync (Only the Following Carriers Supported)
FedEx First Overnight®
FedEx Express Saver®
FedEx Ground®
FedEx 2Day®
UPS Ground
UPS Second Day Air
UPS Overnight (provided by WineDirect, unable to test)
UPS One-Day (provided by WineDirect, unable to test)
GSO (provided by WineDirect, unable to test)
Carrier Rate Selection & Fallback (New Development)
Corksy Selection: Users can select any carrier rate at order creation.
WineDirect Restriction: If the selected carrier/rate is not supported by WineDirect, the order will not sync by default.
Default Carrier Fallback (Setting): Introduce a store-level setting: “Default WineDirect Carrier Service.”
When enabled and configured, if an unsupported carrier/rate is selected, Corksy will override the outbound payload and send the configured default carrier service to WineDirect.
If the default is not configured, the order will not sync and an error will be surfaced in Corksy (activity log/alerts).
Audit note: Corksy should log the override (original carrier → default carrier) for traceability.
7. Inventory Management in WineDirect
Inventory levels are maintained in WineDirect manually. Corksy does not push on‑hand quantities to WineDirect.
WineDirect’s API currently supports inventory transfers between locations only (not setting absolute on‑hand quantities).
Admin Setting Suggestion: Provide a default WineDirect warehouse selection in Corksy admin settings, so transfers and future automation can reference the correct warehouse consistently.
8. Known Limitations
Partial fulfillment from WineDirect is not supported.
Only the above carriers are supported — any other carriers will not sync.
Newly created products without inventory cannot be fulfilled until inventory is assigned in WineDirect.
Pickup orders do not sync.