{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Order Management Quickstart Guide","siteUrl":"https://developer.wineshipping.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"order-management-quickstart-guide","__idx":0},"children":["Order Management Quickstart Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks you through creating your first sales order using the Wineshipping API. We recommend following this four-step workflow: discover inventory, test the payload, integrate with your software, then monitor the shipment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"workflow-overview","__idx":1},"children":["Workflow Overview"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"graph LR\n A[\"Step 1: Discover Inventory
GetSellable API\"] --> B[\"Step 2: Test Payload
Console/Postman\"]\n B --> C[\"Step 3: Integrate
Your Software\"]\n C --> D[\"Monitor Shipment
GetDetails/Webhooks\"]\n","diagramHtml":"

Step 1: Discover Inventory
GetSellable API

Step 2: Test Payload
Console/Postman

Step 3: Integrate
Your Software

Monitor Shipment
GetDetails/Webhooks

","diagramHtmlDark":"

Step 1: Discover Inventory
GetSellable API

Step 2: Test Payload
Console/Postman

Step 3: Integrate
Your Software

Monitor Shipment
GetDetails/Webhooks

"},"children":["graph LR\n A[\"Step 1: Discover Inventory
GetSellable API\"] --> B[\"Step 2: Test Payload
Console/Postman\"]\n B --> C[\"Step 3: Integrate
Your Software\"]\n C --> D[\"Monitor Shipment
GetDetails/Webhooks\"]\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-discover-available-inventory-with-getsellable","__idx":2},"children":["Step 1: Discover Available Inventory with GetSellable"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before creating an order, use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/getsellable"},"children":["GetSellable"]}," endpoint to find available items and quantities."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getsellable-request-example","__idx":3},"children":["GetSellable Request Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Authentication\": {\n \"UserKey\": \"YOUR_USER_KEY\",\n \"Password\": \"YOUR_PASSWORD\",\n \"CustomerNo\": \"YOUR_CUSTOMER_NUMBER\"\n },\n \"Warehouses\": [\"APC01\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getsellable-response-example","__idx":4},"children":["GetSellable Response Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"TotalRecordCount\": 145,\n \"SalesChannel\": \"DTC\",\n \"Items\": [\n {\n \"ItemNo\": \"1466-SE\",\n \"ItemDescription\": \"2016 CAB SAUV RESERVE NAPA VALLEY\",\n \"ItemUnit\": \"bottle\",\n \"SellableQuantity\": 1250\n },\n {\n \"ItemNo\": \"A37B693E\",\n \"ItemDescription\": \"Pinot Noir 2020\",\n \"ItemUnit\": \"bottle\",\n \"SellableQuantity\": 450\n },\n {\n \"ItemNo\": \"5C7D8E9F\",\n \"ItemDescription\": \"Chardonnay 2019 - Case\",\n \"ItemUnit\": \"case\",\n \"SellableQuantity\": 12\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Takeaways:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Note the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ItemNo"]}," for each product you want to include in your order"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SellableQuantity"]}," is sufficient for your order"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pay attention to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ItemUnit"]}," (bottle, case, etc.) to match your order quantities"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-test-your-payload-in-consolepostman","__idx":5},"children":["Step 2: Test Your Payload in Console/Postman"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before integrating with your application, test your order payload using Redocly Console, Postman, or curl."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"quick-start-payload-minimal-example","__idx":6},"children":["Quick Start Payload (Minimal Example)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this as your starting point:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Authentication\": {\n \"UserKey\": \"YOUR_USER_KEY\",\n \"Password\": \"YOUR_PASSWORD\",\n \"CustomerNo\": \"YOUR_CUSTOMER_NUMBER\"\n },\n \"OrderInfo\": {\n \"OrderNo\": \"MYORDER-001\",\n \"OrderDate\": \"2026-01-15T10:30:00Z\",\n \"OrderType\": \"RETAIL\"\n },\n \"RecipientContactInfo\": {\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"Address\": \"123 Main St\",\n \"City\": \"Napa\",\n \"State\": \"CA\",\n \"ZipCode\": \"94558\",\n \"Country\": \"US\",\n \"PhoneNumber\": \"7071234567\",\n \"EmailAddress\": \"customer@example.com\"\n },\n \"ShipmentInfo\": {\n \"ShippingCarrier\": \"FEX\",\n \"ShippingCarrierService\": \"GRND\",\n \"RequestedShipmentDate\": \"01/20/2026\",\n \"WineshippingWarehouseLocation\": \"APC01\"\n },\n \"ItemsInfo\": [\n {\n \"ItemNo\": \"1466-SE\",\n \"ItemDescription\": \"2016 CAB SAUV RESERVE NAPA VALLEY\",\n \"ItemQuantity\": 6\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testing-in-redocly-console","__idx":7},"children":["Testing in Redocly Console"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi"},"children":["API Reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fulfillment > Create Sales Order"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try It Out"]}," button"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the \"Quick Start\" example or paste your payload"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Replace authentication credentials with your test credentials"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Execute"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testing-in-postman","__idx":8},"children":["Testing in Postman"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open your Postman workspace"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a new POST request to: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api-test.wineshipping.com/v3/api/SalesOrder/CreateSalesOrder"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content-Type"]}," header to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste the payload in the request body"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Send"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testing-with-curl","__idx":9},"children":["Testing with cURL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api-test.wineshipping.com/v3/api/SalesOrder/CreateSalesOrder \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"Authentication\": {\n \"UserKey\": \"YOUR_USER_KEY\",\n \"Password\": \"YOUR_PASSWORD\",\n \"CustomerNo\": \"YOUR_CUSTOMER_NUMBER\"\n },\n \"OrderInfo\": {\n \"OrderNo\": \"MYORDER-001\",\n \"OrderDate\": \"2026-01-15T10:30:00Z\",\n \"OrderType\": \"DTC\"\n },\n \"RecipientContactInfo\": {\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"Address\": \"123 Main St\",\n \"City\": \"Napa\",\n \"State\": \"CA\",\n \"ZipCode\": \"94558\",\n \"Country\": \"US\",\n \"PhoneNumber\": \"7071234567\",\n \"EmailAddress\": \"customer@example.com\"\n },\n \"ShipmentInfo\": {\n \"ShippingCarrier\": \"FEX\",\n \"ShippingCarrierService\": \"GRND\",\n \"RequestedShipmentDate\": \"01/20/2026\",\n \"WineshippingWarehouseLocation\": \"APC01\"\n },\n \"ItemsInfo\": [\n {\n \"ItemNo\": \"1466-SE\",\n \"ItemDescription\": \"2016 CAB SAUV RESERVE NAPA VALLEY\",\n \"ItemQuantity\": 6\n }\n ]\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"success-response","__idx":10},"children":["Success Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP 201"]}," with a transaction reference ID:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"D94BC05C-A1C3-4CBB-8DA1-E59C73AD2CAE\"\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Store this ID!"]}," Use it to track the order and troubleshoot any issues."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"common-test-errors--fixes","__idx":11},"children":["Common Test Errors & Fixes"]},{"$$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":"Error"},"children":["Error"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid credentials"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UserKey"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Password"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CustomerNo"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing/invalid required fields"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check all required fields are populated and formatted correctly"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429 Too Many Requests"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit exceeded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait before retrying; use webhooks instead of polling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GetDetails"]}," for tracking updates"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ItemNo"]}," unavailable or address invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GetSellable"]}," to verify items; validate address format"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-integrate-with-your-software","__idx":12},"children":["Step 3: Integrate with Your Software"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once your payload is verified in the console, integrate the request into your application using your preferred HTTP client library."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"python-example","__idx":13},"children":["Python Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import requests\nimport json\nfrom datetime import datetime\n\ndef create_sales_order(item_no, quantity):\n url = \"https://api-test.wineshipping.com/v3/api/SalesOrder/CreateSalesOrder\"\n \n payload = {\n \"Authentication\": {\n \"UserKey\": \"YOUR_USER_KEY\",\n \"Password\": \"YOUR_PASSWORD\",\n \"CustomerNo\": \"YOUR_CUSTOMER_NUMBER\"\n },\n \"OrderInfo\": {\n \"OrderNo\": f\"ORDER-{datetime.now().timestamp()}\",\n \"OrderDate\": datetime.utcnow().isoformat() + \"Z\",\n \"OrderType\": \"DTC\",\n \"WineshippingWarehouseLocation\": \"APC01\"\n },\n \"RecipientContactInfo\": {\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"Address\": \"123 Main St\",\n \"City\": \"Napa\",\n \"State\": \"CA\",\n \"ZipCode\": \"94558\",\n \"Country\": \"US\",\n \"PhoneNumber\": \"7071234567\",\n \"EmailAddress\": \"customer@example.com\"\n },\n \"ShipmentInfo\": {\n \"ShippingCarrier\": \"FEX\",\n \"ShippingCarrierService\": \"GRND\",\n \"RequestedShipmentDate\": \"01/20/2026\"\n },\n \"ItemsInfo\": [\n {\n \"ItemNo\": item_no,\n \"ItemQuantity\": quantity\n }\n ]\n }\n \n headers = {\"Content-Type\": \"application/json\"}\n response = requests.post(url, json=payload, headers=headers)\n \n if response.status_code == 201:\n transaction_id = response.json()\n print(f\"Order created successfully. Transaction ID: {transaction_id}\")\n return transaction_id\n else:\n print(f\"Error: {response.status_code} - {response.text}\")\n return None\n\n# Usage\ncreate_sales_order(\"1466-SE\", 6)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"javascripttypescript-example","__idx":14},"children":["JavaScript/TypeScript Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"async function createSalesOrder(itemNo: string, quantity: number): Promise {\n const url = \"https://api-test.wineshipping.com/v3/api/SalesOrder/CreateSalesOrder\";\n \n const payload = {\n Authentication: {\n UserKey: \"YOUR_USER_KEY\",\n Password: \"YOUR_PASSWORD\",\n CustomerNo: \"YOUR_CUSTOMER_NUMBER\"\n },\n OrderInfo: {\n OrderNo: `ORDER-${Date.now()}`,\n OrderDate: new Date().toISOString(),\n OrderType: \"DTC\",\n WineshippingWarehouseLocation: \"APC01\"\n },\n RecipientContactInfo: {\n FirstName: \"John\",\n LastName: \"Doe\",\n Address: \"123 Main St\",\n City: \"Napa\",\n State: \"CA\",\n ZipCode: \"94558\",\n Country: \"US\",\n PhoneNumber: \"7071234567\",\n EmailAddress: \"customer@example.com\"\n },\n ShipmentInfo: {\n ShippingCarrier: \"FEX\",\n ShippingCarrierService: \"GRND\",\n RequestedShipmentDate: \"01/20/2026\"\n },\n ItemsInfo: [\n {\n ItemNo: itemNo,\n ItemQuantity: quantity\n }\n ]\n };\n \n try {\n const response = await fetch(url, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(payload)\n });\n \n if (response.status === 201) {\n const transactionId = await response.json();\n console.log(`Order created successfully. Transaction ID: ${transactionId}`);\n return transactionId;\n } else {\n console.error(`Error: ${response.status} - ${response.statusText}`);\n return null;\n }\n } catch (error) {\n console.error(\"Request failed:\", error);\n return null;\n }\n}\n\n// Usage\ncreateSalesOrder(\"1466-SE\", 6);\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cnet-example","__idx":15},"children":["C#/.NET Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"using System;\nusing System.Net.Http;\nusing System.Text;\nusing System.Text.Json;\nusing System.Threading.Tasks;\n\npublic class WineshippingOrderService\n{\n private readonly HttpClient _httpClient;\n private const string ApiUrl = \"https://api-test.wineshipping.com/v3/api/SalesOrder/CreateSalesOrder\";\n \n public WineshippingOrderService(HttpClient httpClient)\n {\n _httpClient = httpClient;\n }\n \n public async Task CreateSalesOrderAsync(string itemNo, int quantity)\n {\n var payload = new\n {\n Authentication = new\n {\n UserKey = \"YOUR_USER_KEY\",\n Password = \"YOUR_PASSWORD\",\n CustomerNo = \"YOUR_CUSTOMER_NUMBER\"\n },\n OrderInfo = new\n {\n OrderNo = $\"ORDER-{DateTime.UtcNow.Ticks}\",\n OrderDate = DateTime.UtcNow.ToString(\"o\"),\n OrderType = \"DTC\",\n WineshippingWarehouseLocation = \"APC01\"\n },\n RecipientContactInfo = new\n {\n FirstName = \"John\",\n LastName = \"Doe\",\n Address = \"123 Main St\",\n City = \"Napa\",\n State = \"CA\",\n ZipCode = \"94558\",\n Country = \"US\",\n PhoneNumber = \"7071234567\",\n EmailAddress = \"customer@example.com\"\n },\n ShipmentInfo = new\n {\n ShippingCarrier = \"FEX\",\n ShippingCarrierService = \"GRND\",\n RequestedShipmentDate = \"01/20/2026\"\n },\n ItemsInfo = new[]\n {\n new\n {\n ItemNo = itemNo,\n ItemQuantity = quantity\n }\n }\n };\n \n var json = JsonSerializer.Serialize(payload);\n var content = new StringContent(json, Encoding.UTF8, \"application/json\");\n \n var response = await _httpClient.PostAsync(ApiUrl, content);\n \n if (response.StatusCode == System.Net.HttpStatusCode.Created)\n {\n var responseContent = await response.Content.ReadAsStringAsync();\n var transactionId = JsonSerializer.Deserialize(responseContent);\n Console.WriteLine($\"Order created successfully. Transaction ID: {transactionId}\");\n return transactionId;\n }\n else\n {\n var errorContent = await response.Content.ReadAsStringAsync();\n Console.WriteLine($\"Error: {response.StatusCode} - {errorContent}\");\n return null;\n }\n }\n}\n\npublic static class Program\n{\n public static async Task Main()\n {\n using var httpClient = new HttpClient();\n var service = new WineshippingOrderService(httpClient);\n await service.CreateSalesOrderAsync(\"1466-SE\", 6);\n }\n}\n","lang":"csharp"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-monitor-your-shipment","__idx":16},"children":["Step 4: Monitor Your Shipment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After creating an order, track its status using webhooks (recommended) or the GetDetails API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"webhook-events-recommended","__idx":17},"children":["Webhook Events (Recommended)"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the best experience and to avoid rate limiting, use event-driven tracking via webhooks instead of polling."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/eventdriventracking"},"children":["Set up webhooks"]}," to receive real-time updates on:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order fulfillment status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Package tracking events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Carrier updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Delivery estimates"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getdetails-api-for-ad-hoc-queries","__idx":18},"children":["GetDetails API (For Ad-Hoc Queries)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api-test.wineshipping.com/v3/api/Tracking/GetDetails \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"AuthenticationDetails\": {\n \"UserKey\": \"YOUR_USER_KEY\",\n \"Password\": \"YOUR_PASSWORD\",\n \"CustomerNo\": \"YOUR_CUSTOMER_NUMBER\"\n },\n \"OrderNo\": \"MYORDER-001\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":19},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore more examples"]},": Check out the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/createsalesorder"},"children":["full CreateSalesOrder examples"]}," for advanced scenarios (international orders, multiple items, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set up webhooks"]},": Configure ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/eventdriventracking"},"children":["Event-Driven Tracking"]}," for real-time updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Handle errors"]},": Review common error codes in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/codes-descriptions"},"children":["Codes & Descriptions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage orders"]},": Learn how to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/updatesalesorder"},"children":["update"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/fulfillment/cancelsalesorder"},"children":["cancel"]}," orders"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inventory management"]},": Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi/inventory/getinventorystatus"},"children":["GetInventoryStatus"]}," for detailed inventory information"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":20},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For issues or questions:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email"]},": ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:api@wineshipping.com"},"children":["api@wineshipping.com"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Reference"]},": ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v3.1/openapi"},"children":["Full specification"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Infrastructure"]},": Learn about ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/infrastructure"},"children":["environments and rate limits"]}]}]}]},"headings":[{"value":"Order Management Quickstart Guide","id":"order-management-quickstart-guide","depth":2},{"value":"Workflow Overview","id":"workflow-overview","depth":3},{"value":"Step 1: Discover Available Inventory with GetSellable","id":"step-1-discover-available-inventory-with-getsellable","depth":2},{"value":"GetSellable Request Example","id":"getsellable-request-example","depth":3},{"value":"GetSellable Response Example","id":"getsellable-response-example","depth":3},{"value":"Step 2: Test Your Payload in Console/Postman","id":"step-2-test-your-payload-in-consolepostman","depth":2},{"value":"Quick Start Payload (Minimal Example)","id":"quick-start-payload-minimal-example","depth":3},{"value":"Testing in Redocly Console","id":"testing-in-redocly-console","depth":3},{"value":"Testing in Postman","id":"testing-in-postman","depth":3},{"value":"Testing with cURL","id":"testing-with-curl","depth":3},{"value":"Success Response","id":"success-response","depth":3},{"value":"Common Test Errors & Fixes","id":"common-test-errors--fixes","depth":3},{"value":"Step 3: Integrate with Your Software","id":"step-3-integrate-with-your-software","depth":2},{"value":"Python Example","id":"python-example","depth":3},{"value":"JavaScript/TypeScript Example","id":"javascripttypescript-example","depth":3},{"value":"C#/.NET Example","id":"cnet-example","depth":3},{"value":"Step 4: Monitor Your Shipment","id":"step-4-monitor-your-shipment","depth":2},{"value":"Webhook Events (Recommended)","id":"webhook-events-recommended","depth":3},{"value":"GetDetails API (For Ad-Hoc Queries)","id":"getdetails-api-for-ad-hoc-queries","depth":3},{"value":"Next Steps","id":"next-steps","depth":2},{"value":"Support","id":"support","depth":2}],"frontmatter":{"title":"CreateSalesOrder Quickstart","description":"Step-by-step guide to creating sales orders using the Wineshipping API","seo":{"title":"Order Management Quickstart Guide"}},"lastModified":"2026-11-06T01:36:10.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/createsalesorderquickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}