The Wineshipping API is available to clients and technology partners for creating orders, tracking shipments, creating products, managing inventory, and more using Wineshipping’s industry-leading logistics platform.
This is the first focal point for integration. We refer to customer orders as either sales or fulfillment orders. We refer to managing items and inventory as purchase orders or transfer orders.
Create a sales/fulfillment order - Submit customer sales or fulfillment orders with flexible order options to support your unique Direct-to-Consumer (DTC) or wholesale business model. This endpoint also supports carrier pick-up-at-location services.
Processing and publishing orders is a two-step process. Avoid immediately calling the GetDetails endpoint, as it is rate-limited.
- Update an Order
- Cancel an Order
- Get On-Hold orders to manage fulfillment
- Get data on orders returned to a Wineshipping warehouse
For scalability and reliability, we recommend using event-driven tracking via webhooks.
Send an email to api@wineshipping.com to enable webhook-based tracking (see Event Driven Tracking for setup details).
Get tracking numbers and shipment status updates delivered to your systems and customers in real time with event driven tracking via webhooks. Alternatively, use the Track Packages method for ad-hoc, individual order status lookups.
The webhooks and API responses include:
- Order processing status
- Package tracking, carrier status and messaging
- Inventory reservation
- Embedded carrier tracking page link(s)
- Delivery date estimation
Inventory APIs provide access to real-time inventory and product information.
Execute a real-time inventory check or sync with your e-commerce platform, POS, or wine club using Get Sellable Inventory.
Optionally, retrieve detailed, real-time physical inventory information and inventory transactions for reporting or integration with your ERP system.
- By item and item description
- By warehouse location
- By unit of measure
- Inventory status and quantities
- On-Hand, Reserved, Available, Backorder, On-Order
- Damages, Returns status
Create Items - Define new SKUs for wine, merchandise, and marketing materials.
- Define detailed classification and metadata for wine SKUs.
Validate an address - Validate U.S. addresses and classify them as business or residential using carrier data when available.
Get carrier hold locations - Retrieve carrier pickup locations for a given address and carrier.
Get delivery date estimates - Retrieve estimated delivery date for a given address using FedEx and UPS carrier services within the USA.
Note: The information provided by the Wineshipping Delivery Date Estimate API service is for estimating approximate delivery dates based on the corresponding FedEx and/or UPS carrier service information available at the time of inquiry, and is subject to change without notice. Due to these factors, Wineshipping cannot guarantee the accuracy of current or future information generated by the Delivery Date Estimate API service.