Skip to content
API Reference
/
Inventory
/
Create transfer order

Wineshipping API (3.1.3)

The Wineshipping API is a programmatic communications interface designed to enable Wineshipping’s customer and partner applications to natively transmit and manage shipping orders, inventory, package tracking, and other key business and operational functions.

Try out the API methods in in our postman collection.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL

https://wineshipping.com

API Support

api@wineshipping.com

License

Proprietary

Languages
Servers
Test

https://api-test.wineshipping.com/v3/

Production

https://api.wineshipping.com/v3/

Fulfillment

API Methods for order processing and fulfillment.

Operations

Inventory

API Methods for inventory management.

Operations

Create purchase order

Request

This operation is used to create an inbound inventory request. Successful execution of this operation will generate a new purchase order in Wineshipping system. The inbound request can be a pickup from customer address or a drop-off at a Wineshipping warehouse location. A transaction reference identifier is returned in this operation. Store this identifier in your application and systems as applicable. This reference ID is available in the event a problem occurs with the associated request.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
OrderInfoobject(PurchaseOrderInfo)required
OrderInfo.​CustomerReferenceNostring<= 1000 charactersrequired
OrderInfo.​TransportMethodstringrequired
OrderInfo.​RequestedDatestringrequired
OrderInfo.​ReceiveToLocationstring(InventoryWarehouse)required

See warehouse locations for possible values.

Enum"APC01""APC02""COB01""COB02""ETC01""MMC01""PRB02""PRB04""SJU01""TWL01"
OrderInfo.​InventoryStatusCodestring(InventoryStatus)required

See inventory codes for possible values.

Array of up to 5 items is allowed, and if omitted, all items will be included in the results.

Enum"GOOD-NO-BD""GOOD-NO-TX""GOOD-ST-BD""GOOD-ST-EX""GOOD-ST-IM""GOOD-ST-TX""RTGD-NO-TX""CDMG-NO-TX""DMGD-NO-TX"
OrderInfo.​ReferenceNostring<= 100 characters

optional, pickup reference number

OrderInfo.​FirstNamestring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​LastNamestring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Companystring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Addressstring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Address2string<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Citystring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Statestring= 2 characters

Required, if TransportMethod = PICKUP

Example: "CA"
OrderInfo.​ZipCodestring[ 5 .. 10 ] characters

Required, if TransportMethod = PICKUP

OrderInfo.​PhoneNumberstring[ 10 .. 25 ] characters
Example: "7079339063"
OrderInfo.​EmailAddressstring<= 255 characters
OrderInfo.​SpecialInstructionstring
ItemsInfoArray of objects(PurchaseOrderItemInfo)required
ItemsInfo[].​ItemNostring<= 50 charactersrequired
Example: "ITEMTEST"
ItemsInfo[].​ItemDescriptionstring<= 100 characters
Example: "2019 Cab Napa Valley"
ItemsInfo[].​ItemQuantityinteger(int32)required
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/InventoryMovement/CreatePurchaseOrder \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "OrderInfo": {
      "CustomerReferenceNo": "14932418",
      "TransportMethod": "DROPOFF",
      "RequestedDate": "08/30/2025",
      "ReceiveToLocation": "APC01",
      "InventoryStatusCode": "GOOD-NO-TX",
      "ReferenceNo": "RN-14932419-D",
      "FirstName": "John",
      "LastName": "Smith",
      "Company": "KV",
      "Address": "50 Technology Ct",
      "Address2": "",
      "City": "Napa",
      "State": "CA",
      "ZipCode": "94558",
      "PhoneNumber": "707-933-9063",
      "EmailAddress": "someone@wineshipping.com",
      "SpecialInstruction": ""
    },
    "ItemsInfo": [
      {
        "ItemNo": "DROPOFF_ITEM-1",
        "ItemDescription": "Item Description - 30",
        "ItemQuantity": 2500
      },
      {
        "ItemNo": "DROPOFF_ITEM-2",
        "ItemDescription": "Item Description - 31",
        "ItemQuantity": 3600
      },
      {
        "ItemNo": "DROPOFF_ITEM-3",
        "ItemDescription": "Item Description - 32",
        "ItemQuantity": 4200
      }
    ]
  }'

Responses

Returns a transaction reference identifier of the created purchase order.

Update purchase order

Request

Update an existing inventory receipt request

Security
Authentication
Bodyapplication/json
PurchaseOrderNumberstring
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
OrderInfoobject(PurchaseOrderInfo)required
OrderInfo.​CustomerReferenceNostring<= 1000 characters
OrderInfo.​TransportMethodstring
OrderInfo.​RequestedDatestring
OrderInfo.​ReceiveToLocationstring(InventoryWarehouse)

See warehouse locations for possible values.

Enum"APC01""APC02""COB01""COB02""ETC01""MMC01""PRB02""PRB04""SJU01""TWL01"
OrderInfo.​InventoryStatusCodestring(InventoryStatus)

See inventory codes for possible values.

Array of up to 5 items is allowed, and if omitted, all items will be included in the results.

Enum"GOOD-NO-BD""GOOD-NO-TX""GOOD-ST-BD""GOOD-ST-EX""GOOD-ST-IM""GOOD-ST-TX""RTGD-NO-TX""CDMG-NO-TX""DMGD-NO-TX"
OrderInfo.​ReferenceNostring<= 100 characters

optional, pickup reference number

OrderInfo.​FirstNamestring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​LastNamestring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Companystring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Addressstring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Address2string<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Citystring<= 100 characters

Required, if TransportMethod = PICKUP

OrderInfo.​Statestring= 2 characters

Required, if TransportMethod = PICKUP

Example: "CA"
OrderInfo.​ZipCodestring[ 5 .. 10 ] characters

Required, if TransportMethod = PICKUP

OrderInfo.​PhoneNumberstring[ 10 .. 25 ] characters
Example: "7079339063"
OrderInfo.​EmailAddressstring<= 255 characters
OrderInfo.​SpecialInstructionstring
ItemsInfoArray of objects(PurchaseOrderItemInfo)
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/InventoryMovement/UpdatePurchaseOrder \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "OrderInfo": {
      "CustomerReferenceNo": "14932418",
      "ReferenceNo": "RN-14932419-D",
      "SpecialInstruction": "New instructions"
    }
  }'

Responses

OK

Cancel purchase order

Request

This operation is used to cancel a purchase order request. A transaction reference identifier is required to post using this operation. A transaction reference identifier will be returned upon use of the operation. Store this identifier in your application and systems as applicable. This reference ID is available in the event a problem occurs with the associated request. Successful execution of this method will cancel an open Purchase Order in Wineshipping's system and will return a transaction reference identifier. Note: that Purchase Orders can only be canceled and are considered 'Open' as long as work has not been started.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
CustomerReferenceNostringrequired
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/InventoryMovement/CancelPurchaseOrder \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "CustomerReferenceNo": "string"
  }'

Responses

The purchase order cancellation request has succeeded.

Create transfer order

Request

This operation is used to create a inventory transfer request between two Wineshipping managed inventory locations. Successful execution of this operation will generate a new transfer order in Wineshipping system. A transaction reference identifier is returned in this operation. Store this identifier in your application and systems as applicable. This reference ID is available in the event a problem occurs with the associated request.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
TransferInfoobject(TransferOrderInfo)
ItemsInfoArray of objects(ItemInfo)
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/InventoryMovement/CreateTransferOrder \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "TransferInfo": {
      "CustomerReferenceNo": "00B3164C",
      "RequestedDate": "5/1/2025",
      "TransferFromWarehouse": "APC01",
      "InventoryStatusCode": "GOOD-NO-TX",
      "TransferToWarehouse": "VCX01",
      "FirstName": "John",
      "LastName": "Doe",
      "PhoneNumber": "7079339063",
      "EmailAddress": "john.doe@wineshipping.com",
      "SpecialInstruction": ""
    },
    "ItemsInfo": [
      {
        "ItemNo": "1466-SE",
        "ItemDescription": "2016 CAB SAUV RESERVE NAPA VALLEY",
        "ItemQuantity": 6,
        "UnitPrice": 0
      }
    ]
  }'

Responses

Returns a transaction reference identifier

Update transfer order

Request

Use this operation to update an existing open transfer order. Successful execution of this method will update an open transfer order in Wineshipping system. If for some reason the order cannot be updated standard HTTP Status Code and a reason will be returned.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)

Credentials are required for all API operations.

TransferInfoobject(TransferInfoUpdate)
ItemsInfoArray of objects(TransferItemInfo)
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/InventoryMovement/UpdateTransferOrder \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "TransferInfo": {
      "TransferOrderNumber": "string",
      "CustomerReferenceNo": "string",
      "RequestedDate": "2019-08-24T14:15:22Z",
      "InventoryStatusCode": "string",
      "FirstName": "string",
      "LastName": "string",
      "PhoneNumber": "string",
      "EmailAddress": "string",
      "SpecialInstruction": "string"
    },
    "ItemsInfo": [
      {
        "ItemNo": "string",
        "ItemDescription": "string",
        "ItemQuantity": 0
      }
    ]
  }'

Responses

The transfer order update request has succeeded.

Cancel a transfer order

Request

This operation is used to cancel a transfer order request. A transaction reference identifier is required to post using this operation. A transaction reference identifier will be returned upon use of the operation. Store this identifier in your application and systems as applicable. This reference ID is available in the event a problem occurs with the associated request. Successful execution of this method will cancel an Open Purchase Order in Wineshipping's system and will return a transaction reference identifier. Please note that Transfer Orders can only be canceled and are considered "open" as long as work has not been started.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
CustomerReferenceNostringrequired
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/InventoryMovement/CancelTransferOrder \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "CustomerReferenceNo": "string"
  }'

Responses

Returns a transaction reference identifier - note, transfer orders can only be cancelled before work has been started

Get inventory transactions

Request

This method allows a customer to retrieve inventory transactions. Inventory transactions include Sales Orders, Purchase Orders, Transfer In, Transfer Out, Production Lines, Inventory Adjustments and Inventory Status Changes. There are multiple input filters available for use, including filters to retrieve specific types of inventory transactions, to retrieve transactions processed on a particular date, or to retrieve transactions in a specific Wineshipping warehouse.There are also pagination and skip/top query parameters that allow customers to further control the inventory transactions that are returned in the response.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
TransactionDatestring

Required unless TransactionStartDateTime is specified. Format: MM/DD/YYYY

Example: "12/31/2025"
TransactionStartDateTimestring(date-time)

Required unless TransactionDate is specified.

Example: "2025-02-10T08:12:39.483Z (UTC)"
TransactionEndDateTimestring(date-time)

Optional; valid only when TransactionStartDateTime is specified.

Example: "2017-02-10T08:12:39.483Z (UTC)"
TransactionTypestring

Required unless TransactionTypes is specified instead

TransactionTypesArray of strings

Required unless TransactionType is specified instead

Items Enum"Purchase Order""Transfer In""Transfer Out""Production Line""Inventory Adjustment""Inventory Status Change""Sales order""Return Order"
Warehousestring(InventoryWarehouse)

See warehouse locations for possible values.

Enum"APC01""APC02""COB01""COB02""ETC01""MMC01""PRB02""PRB04""SJU01""TWL01"
WarehousesArray of strings(InventoryWarehouse)

(COMING SOON)

Items Enum"APC01""APC02""COB01""COB02""ETC01""MMC01""PRB02""PRB04""SJU01""TWL01"
Example: ["APC01"]
Referencestring

This field contains Inventory Transaction Reference Codes that explain why a transaction occurred

InventoryStatusstring(InventoryStatus)

See inventory codes for possible values.

Array of up to 5 items is allowed, and if omitted, all items will be included in the results.

Enum"GOOD-NO-BD""GOOD-NO-TX""GOOD-ST-BD""GOOD-ST-EX""GOOD-ST-IM""GOOD-ST-TX""RTGD-NO-TX""CDMG-NO-TX""DMGD-NO-TX"
InventoryStatusesArray of strings(InventoryStatus)

(COMING SOON)

Items Enum"GOOD-NO-BD""GOOD-NO-TX""GOOD-ST-BD""GOOD-ST-EX""GOOD-ST-IM""GOOD-ST-TX""RTGD-NO-TX""CDMG-NO-TX""DMGD-NO-TX"
ItemNumbersArray of strings
Skipinteger(int32)
Topinteger(int32)
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/Inventory/GetTransactions \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "TransactionType": "Inventory Adjustment",
    "Warehouse": "APC01",
    "Reference": "",
    "InventoryStatus": "GOOD-NO-TX",
    "ItemNumbers": [
      ""
    ],
    "Skip": 0,
    "Top": 2500
  }'

Responses

OK

Bodyapplication/json
TransactionReferenceNumberstring
TotalRecordCountinteger(int32)
Skipinteger(int32)
Default 0
Topinteger(int32)
MoreRecordsboolean
InventoryTransactionsArray of objects(InventoryTransaction)
Response
application/json
{
  "TransactionReferenceNumber": "79f019f0-1a6e-4777-8c0d-d475ba2aaa3e",
  "TotalRecordCount": 2,
  "Skip": 0,
  "Top": 10000,
  "MoreRecords": false,
  "InventoryTransactions": [
    { … },
    { … }
  ]
}

Get inventory information

Request

This operation provides inventory information with warehouse, status, quantity on hand, quantity reserved on orders, quantity on backorder, quantity available, and quantity on an inbound PO. This operation optionally accepts a warehouse code to return related inventory records for a specific Wineshipping warehouse, if omitted the operation will return inventory records for all warehouses. The operation also accepts an array of items to query inventory records, if omitted returns inventory records for all items in the warehouse specified.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)required

Credentials are required for all API operations.

Authentication.​UserKeystringrequired
Example: "C445598CB576468EA35FBB22C55584EF"
Authentication.​Passwordstringrequired
Example: "AF63FDAC1E704DC1AC9460F669ABF107"
Authentication.​CustomerNostringrequired
Example: "10703"
Warehousestring(InventoryWarehouse)

See warehouse locations for possible values.

Enum"APC01""APC02""COB01""COB02""ETC01""MMC01""PRB02""PRB04""SJU01""TWL01"
ItemNumbersArray of strings

Up to five items are allowed. If omitted, all items in the specified warehouse are included in the results.

InventoryStatusesArray of strings(InventoryStatus)[ 0 .. 5 ] items

Up to five inventory status codes are allowed. If omitted, all inventory statuses are included in the results. The following are generic status codes. If you have a custom Wineshipping inventory type, please work with IT to get the inventory codes. See inventory codes for possible values.

Items Enum"GOOD-NO-BD""GOOD-NO-TX""GOOD-ST-BD""GOOD-ST-EX""GOOD-ST-IM""GOOD-ST-TX""RTGD-NO-TX""CDMG-NO-TX""DMGD-NO-TX"
IncludeTotalRecordCountboolean

Indicates whether to query the total record count.

Default false
Skipinteger(int32)

Start returning results after skipping the specified number of records. The default is zero. This identifies a subset of the results defined by the input filter. The subset is defined by skipping N results and selecting only the remaining results (starting with N+1), where N is an integer greater than or equal to zero.

Default 0
Topinteger(int32)<= 2500

Limit the number of results to the specified value; the default is 2500. Any value outside the range of 0 to 2500 is set to 2500. Identifies a subset of the results based on the input filter by selecting only the first N results, where N is an integer greater than or equal to zero.

Default 2500
IncludeUnavailableItemsboolean

When true, the response includes items (products) with no physical inventory. By default, only items with non-zero physical inventory are returned.

Default false
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/Inventory/GetStatus \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "Warehouse": "APC01",
    "ItemNumbers": [
      "string"
    ],
    "InventoryStatuses": [
      "GOOD-NO-BD"
    ],
    "IncludeTotalRecordCount": false,
    "Skip": 0,
    "Top": 2500,
    "IncludeUnavailableItems": false
  }'

Responses

OK

Bodyapplication/json
TotalRecordCountinteger(int32)
Skipinteger(int32)
Topinteger(int32)
MoreRecordsboolean
WarehouseInventoryStatusesArray of objects(WarehouseInventoryStatus)
Response
application/json
{
  "TotalRecordCount": 12,
  "Skip": 0,
  "Top": 10,
  "MoreRecords": true,
  "WarehouseInventoryStatuses": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}

Get sellable inventory

Request

This operation provides the total, aggregated inventory available to sell. This operation optionally accepts a list of warehouse codes to return sellable inventory totals for a specific subset of Wineshipping warehouses, otherwise all physical locations with sellable inventory are considered.

This method is specifically designed to efficiently sync available inventory quantities with Commerce, pos or other order management systems for all skus. See the GetInventoryStatus for retrieving more detailed inventory information for an individual sku.

Security
Authentication
Bodyapplication/json
Authenticationobject(Authentication)

Credentials are required for all API operations.

WarehousesArray of strings
OrderTypestring
OrderSourcestring
ItemNumbersArray of strings
Verboseboolean
IncludeUnavailableItemsboolean
IncludeIncomingInventoryboolean
IncludeLibraryInventoryboolean
IncludeStorageInventoryboolean
PageNumberinteger(int32)
PageSizeinteger(int32)
curl -i -X POST \
  https://api-test.wineshipping.com/v3/api/Inventory/GetSellable \
  -H 'Authorization: WineshippingAuth <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Authentication": {
      "UserKey": "C445598CB576468EA35FBB22C55584EF",
      "Password": "AF63FDAC1E704DC1AC9460F669ABF107",
      "CustomerNo": "10703"
    },
    "ItemNumbers": [
      "6F9161ED",
      "A37B693E"
    ]
  }'

Responses

OK

Bodyapplication/json
TotalRecordCountinteger(int32)
SalesChannelstring
ItemsArray of objects(InventoryItem)
Response
application/json
{
  "TotalRecordCount": 0,
  "SalesChannel": "string",
  "Items": [
    { … }
  ]
}

Product

API Methods for item management.

Operations

Tracking

API Methods for tracking and shipments.

Operations

Commerce

API Methods for carriers, expected delivery dates and addresses.

Operations