{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"v3 vs v4 API","siteUrl":"https://developer.wineshipping.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"v3-vs-v4-api","__idx":0},"children":["v3 vs v4 API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Wineshipping API is currently on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["v3"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v3"]},"), which is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["generally available"]}," for all production workloads. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["v4"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v4"]},") is now available as a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["public preview"]}," — endpoints and behavior may change before general availability."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"quick-comparison","__idx":1},"children":["Quick Comparison"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Feature"},"children":["Feature"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"v3"},"children":["v3"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"v4"},"children":["v4"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL (Production)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.wineshipping.com/v3"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.wineshipping.com/v4"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL (Test)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api-test.wineshipping.com/v3"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api-test.wineshipping.com/v4"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authentication"]}," object in request body"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TBD"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fulfillment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Planned"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inventory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Planned"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tracking"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Planned"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commerce"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TBD"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TBD"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-in-v3","__idx":2},"children":["What is in v3"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["v3 is the current production API and is available at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.wineshipping.com/v3"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every v3 request that requires authorization must include an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authentication"]}," object in the request body containing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UserKey"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Password"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CustomerNo"]},". See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/authentication"},"children":["Authentication guide"]}," for full details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"fulfillment","__idx":4},"children":["Fulfillment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These endpoints manage the full lifecycle of customer sales orders."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/createsalesorder"},"children":["CreateSalesOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submit a new customer or DTC sales/fulfillment order. Supports standard shipping, carrier pick-up-at-location, and international orders."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/updatesalesorder"},"children":["UpdateSalesOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Modify an existing open sales order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/cancelsalesorder"},"children":["CancelSalesOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel an open sales order before it has been fulfilled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/getordersonhold"},"children":["GetOrdersOnHold"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve all orders currently on hold for a customer account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/getreturns"},"children":["GetReturns"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve a list of return sales orders received at a Wineshipping warehouse."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/generatejitlabel"},"children":["GenerateJitLabel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generate a Just-In-Time (JIT) shipping label or packing slip in PDF or PNG format."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/batchsalesorder"},"children":["BatchSalesOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Deprecated)"]}," Create multiple orders in a single request. Use individual ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreateSalesOrder"]}," calls instead."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"inventory","__idx":5},"children":["Inventory"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These endpoints manage inbound inventory (purchase orders), inventory transfers, and real-time inventory data."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/createpurchaseorder"},"children":["CreatePurchaseOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create an inbound inventory receipt request (drop-off at warehouse or customer pickup)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/updatepurchaseorder"},"children":["UpdatePurchaseOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update an existing open purchase order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/cancelpurchaseorder"},"children":["CancelPurchaseOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel an open purchase order. Only allowed before warehouse work has started."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/createtransferorder"},"children":["CreateTransferOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request an inventory transfer between two Wineshipping-managed warehouse locations."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/updatetransferorder"},"children":["UpdateTransferOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update an open transfer order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/canceltransferorder"},"children":["CancelTransferOrder"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel an open transfer order. Only allowed before warehouse work has started."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/getinventorytransactions"},"children":["GetInventoryTransactions"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve inventory transaction history (sales orders, purchase orders, transfers, adjustments, and more)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/getinventorystatus"},"children":["GetInventoryStatus"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve real-time physical inventory details by item, warehouse, and unit of measure."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/getsellable"},"children":["GetSellable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve real-time sellable inventory quantities for use in e-commerce, POS, or wine club platforms."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"tracking","__idx":6},"children":["Tracking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These endpoints provide shipment and package tracking information."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For reliability and scalability, prefer ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/eventdriventracking"},"children":["event-driven tracking via webhooks"]}," over polling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GetDetails"]},"."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/tracking/getdetails"},"children":["GetDetails"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve order tracking status, carrier tracking number, and shipment details for a single order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/tracking/getpackages"},"children":["GetPackages"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve package-level shipping details including tracking numbers and carrier status."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"commerce","__idx":7},"children":["Commerce"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These endpoints support pre-order address and carrier services."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/commerce/addressvalidation"},"children":["AddressValidation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate and correct a U.S. delivery address and classify it as residential or commercial."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/commerce/getcarrierlocations"},"children":["GetCarrierLocations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve available carrier hold/pickup locations near a given address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/commerce/getdeliveryestimates"},"children":["GetDeliveryEstimates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get estimated delivery dates for FedEx and UPS services to a given U.S. address."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"product","__idx":8},"children":["Product"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These endpoints manage SKU definitions and item metadata."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/product/createsku"},"children":["CreateSKU"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Define a new SKU for wine, merchandise, or marketing materials. Supports detailed wine classification and metadata."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/product/updatesku"},"children":["UpdateSKU"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update the metadata for an existing SKU."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/product/retiresku"},"children":["RetireSKU"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mark a SKU as retired to prevent future orders from being placed against it."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-in-v4-coming-soon","__idx":9},"children":["What is in v4 (Coming Soon)"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-in-v4-preview","__idx":10},"children":["What is in v4 (Preview)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["v4 is now available as a public preview at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.wineshipping.com/v4"]},". The server base URL changes from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v3"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v4"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["v4 is a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["preview"]}," and not yet generally available. Endpoints and response shapes may change without notice before GA. Continue using v3 for all production workloads until v4 reaches general availability."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The initial v4 scope targets the three most critical integration areas:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fulfillment"]}," — Sales order creation, management, and fulfillment operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inventory"]}," — Inventory management, purchase orders, and transfer orders."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tracking"]}," — Shipment and package tracking."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Details on Commerce and Product endpoints for v4 are to be determined. Continue using v3 for those capabilities until v4 reaches general availability."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:api@wineshipping.com"},"children":["api@wineshipping.com"]}," for updates on the v4 release timeline."]}]},"headings":[{"value":"v3 vs v4 API","id":"v3-vs-v4-api","depth":2},{"value":"Quick Comparison","id":"quick-comparison","depth":3},{"value":"What is in v3","id":"what-is-in-v3","depth":2},{"value":"Authentication","id":"authentication","depth":3},{"value":"Fulfillment","id":"fulfillment","depth":3},{"value":"Inventory","id":"inventory","depth":3},{"value":"Tracking","id":"tracking","depth":3},{"value":"Commerce","id":"commerce","depth":3},{"value":"Product","id":"product","depth":3},{"value":"What is in v4 (Coming Soon)","id":"what-is-in-v4-coming-soon","depth":2},{"value":"What is in v4 (Preview)","id":"what-is-in-v4-preview","depth":2}],"frontmatter":{"title":"v3 vs v4 API","description":"What is in the v3 API, what is planned for v4, and how they compare.","seo":{"title":"v3 vs v4 API"}},"lastModified":"2026-10-20T13:50:49.560Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v3-to-v4","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}