# Create transfer order

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.

Endpoint: POST /api/InventoryMovement/CreateTransferOrder
Version: 3.1.3
Security: Authentication

## Request fields (application/json):

  - `Authentication` (object, required)
    Credentials are required for all API operations.

  - `Authentication.UserKey` (string, required)
    Example: "C445598CB576468EA35FBB22C55584EF"

  - `Authentication.Password` (string, required)
    Example: "AF63FDAC1E704DC1AC9460F669ABF107"

  - `Authentication.CustomerNo` (string, required)
    Example: "10703"

  - `TransferInfo` (object, required)

  - `TransferInfo.CustomerReferenceNo` (string, required)
    Pickup or delivery reference number

  - `TransferInfo.RequestedDate` (string, required)

  - `TransferInfo.TransferFromWarehouse` (string, required)
    See [warehouse locations](../../../../docs/codes/warehouselocations) for possible values.
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `TransferInfo.InventoryStatusCode` (string, required)
    See [inventory codes](../../../../docs/codes/inventorycodes) 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-TX", "RTGD-NO-TX", "RDMG-NO-TX", "CDMG-NO-TX", "DMGD-NO-TX", "GOOD-NO-BD", "DMGD-ST-BD", "GOOD-ST-IM"

  - `TransferInfo.TransferToWarehouse` (string, required)
    Must be different from TransferFromWarehouse
    Enum: "APC01", "APC02", "COB01", "COB02", "ETC01", "MMC01", "PRB02", "PRB04", "SJU01", "TWL01", "VCX01", "WOX01"

  - `TransferInfo.TransferToInventoryStatusCode` (string)
    (COMING SOON) will default to TransferFromInventoryStatusCode
    Enum: "GOOD-NO-TX", "RTGD-NO-TX", "RDMG-NO-TX", "CDMG-NO-TX", "DMGD-NO-TX", "GOOD-NO-BD", "DMGD-ST-BD", "GOOD-ST-IM"

  - `TransferInfo.FirstName` (string, required)

  - `TransferInfo.LastName` (string, required)

  - `TransferInfo.PhoneNumber` (string, required)
    Example: "7079339063"

  - `TransferInfo.EmailAddress` (string, required)

  - `TransferInfo.SpecialInstruction` (string)

  - `ItemsInfo` (array, required)

  - `ItemsInfo.ItemNo` (string, required)
    Example: "1466-SE"

  - `ItemsInfo.ItemDescription` (string)
    Example: "2016 CAB SAUV RESERVE NAPA VALLEY"

  - `ItemsInfo.ItemQuantity` (integer)
    Example: 6

  - `ItemsInfo.QuantityUnit` (string)
    Specify whether an item quantity should be denominated in Retail (i.e., bottles) or Wholesale (i.e., cases) when creating an order. If set to Auto, the Order Type determines the default quantity, i.e., bottles for Retail and cases for Wholesale.
    Enum: "RETAIL", "WHOLESALE", "AUTO"

  - `ItemsInfo.InventoryTaxStatus` (string)
    Specify an inventory tax status when creating an order for wholesale, DTT, or DTW. Not relevant to DTC orders.
    Enum: "GOOD-LB-TX", "GOOD-NO-BD", "GOOD-NO-CB", "GOOD-NO-TX", "GOOD-ST-BD", "GOOD-ST-EX", "GOOD-ST-IM", "GOOD-ST-TX"

  - `ItemsInfo.UnitPrice` (number)
    Unit sale price charged to the consumer.


## Response 201 fields

## Response 400 fields

## Response 401 fields

## Response 429 fields

## Response 500 fields