# Create multiple orders (deprecated)

This operation is used to create new orders in batch. The response will contain order creation status for each order along with individual order transaction number for reference later in the event there is an issue with an order.

Endpoint: POST /api/SalesOrder/BatchSalesOrder
Version: 3.1.3
Security: Authentication

## Request fields (application/json):

  - `Authentication` (object)
    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"

  - `BatchId` (string)
    Example: "BATCHID"

  - `BatchDescription` (string)
    Example: "500 mix group"

  - `SalesOrdersInfo` (array)

  - `SalesOrdersInfo.OrderInfo` (object)
    test

  - `SalesOrdersInfo.OrderInfo.TransmissionId` (string)
    Example: "TransID-083021"

  - `SalesOrdersInfo.OrderInfo.OrderNo` (string, required)
    Usually the order number in your point of sle system.
    Example: "TESTORDER-1"

  - `SalesOrdersInfo.OrderInfo.PONo` (string)

  - `SalesOrdersInfo.OrderInfo.ShipmentKey` (string)

  - `SalesOrdersInfo.OrderInfo.OrderType` (string, required)
    RETAILUsed for daily orders.CLUBUsed for club and subscription orders.DTTUsed for 'Direct-To-Trade' orders that go directly to a retailer.WHOLESALEUsed for orders that go to a distributor.DELIVERY_TO_WINERYUsed for orders that move inventory on behalf of the winery without changing ownership (aka RTW).
    Enum: "CLUB", "RETAIL", "DTT", "JIT", "DELIVERY_TO_WINERY", "WHOLESALE"

  - `SalesOrdersInfo.OrderInfo.OrderSource` (string)
    Example: "Tasting Room"

  - `SalesOrdersInfo.OrderInfo.OrderDate` (string)
    Example: "2025-08-24T14:15:22Z"

  - `SalesOrdersInfo.OrderInfo.GiftCard` (integer)
    Indicates there is a gift message with this order
    Enum: 0, 1

  - `SalesOrdersInfo.OrderInfo.GiftCardMessage` (string)
    Required if GiftCard set to 1
    Example: "gift message text"

  - `SalesOrdersInfo.OrderInfo.Tags` (string)

  - `SalesOrdersInfo.OrderInfo.SpecialInstructions` (string)

  - `SalesOrdersInfo.OrderInfo.ConsumerTaxCollected` (string)
    Total Tax Collected on an Order - useful for compliance

  - `SalesOrdersInfo.OrderInfo.ConsumerShippingPrice` (string)
    Total Shipping cost collected on an Order - useful for compliance

  - `SalesOrdersInfo.BillingContactInfo` (object)

  - `SalesOrdersInfo.BillingContactInfo.FirstName` (string)
    Example: "Jon"

  - `SalesOrdersInfo.BillingContactInfo.LastName` (string)
    Example: "Doe"

  - `SalesOrdersInfo.BillingContactInfo.Company` (string)
    Example: "Wineshipping"

  - `SalesOrdersInfo.BillingContactInfo.Address` (string)
    Example: "50 Technology Ct"

  - `SalesOrdersInfo.BillingContactInfo.Address2` (string)
    Example: "Suite A"

  - `SalesOrdersInfo.BillingContactInfo.City` (string)
    Example: "Napa"

  - `SalesOrdersInfo.BillingContactInfo.State` (string)
    Example: "CA"

  - `SalesOrdersInfo.BillingContactInfo.ZipCode` (string)
    Example: "94558"

  - `SalesOrdersInfo.BillingContactInfo.Country` (string)
    Example: "US"

  - `SalesOrdersInfo.BillingContactInfo.PhoneNumber` (string)
    Example: "7079339063"

  - `SalesOrdersInfo.BillingContactInfo.EmailAddress` (string)
    Example: "someone@wineshipping.com"

  - `SalesOrdersInfo.DeliveryContactInfo` (object)

  - `SalesOrdersInfo.DeliveryContactInfo.HoldAtLocation` (integer)
    Set at 1 for adding Hold At Location specific addresses for the Order (UPS Access Points & FedEx Hold Locations) – it is not necessary to add Delivery Location Info not using Hold at Locations
    Enum: 0, 1

  - `SalesOrdersInfo.DeliveryContactInfo.LocationCode` (string)

  - `SalesOrdersInfo.RecipientContactInfo` (object)

  - `SalesOrdersInfo.ShipmentInfo` (object)

  - `SalesOrdersInfo.ShipmentInfo.ShippingCarrier` (string)
    See [carrier codes](../../../../docs/codes/carriercodes) for possible values.
    Enum: "FEX", "UPS", "BSW", "GSO", "WIL", "FCC", "TMC", "WST", "WILL"

  - `SalesOrdersInfo.ShipmentInfo.ShippingCarrierService` (string)
    See [carrier codes](../../../../docs/codes/carriercodes) for possible values.
    Enum: "ONPR", "GRND", "2DAY", "HOME", "ONST", "CALL", "LPDS", "NONE"

  - `SalesOrdersInfo.ShipmentInfo.RequestedShipmentDate` (string)
    RequestedShipmentDate is optional (MM/DD/YYYY format) and is only meaningful to schedule shipment in the future. By default orders will be processed as soon as possible, in-line with your account preferences (cutoff schedules for each site and carrier service)
    Example: "8/31/2025"

  - `SalesOrdersInfo.ShipmentInfo.Insurance` (integer)
    Enum: 0, 1

  - `SalesOrdersInfo.ShipmentInfo.IcePack` (integer)
    Enum: 0, 1

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

  - `SalesOrdersInfo.ItemsInfo` (array)

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

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

  - `SalesOrdersInfo.ItemsInfo.ItemQuantity` (integer, required)
    Example: 6

  - `SalesOrdersInfo.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.
    Enum: "RETAIL", "WHOLESALE"

  - `SalesOrdersInfo.ItemsInfo.InventoryTaxStatus` (string)
    Only applicable to non-DTC order types such as Wholesale. See [inventory codes](../../../../docs/inventorycodes) for possible values.

  - `SalesOrdersInfo.ItemsInfo.AdditionalFields` (object)
    These are optional parameters for specific business scenarios

  - `SalesOrdersInfo.TransactionReferenceNumber` (string)
    Unique identifier of the order to be used when cancelling or updating an order. The TransactionReferenceValue is returned by the CreateSalesOrder response. If TransactionReferenceNumber is provided OrderNo is ignored.

## Response 200 fields (application/json):

  - `TransactionReferenceNumber` (string)

  - `CreateSalesOrderStatuses` (array)

  - `CreateSalesOrderStatuses.RefTransmissionId` (string)

  - `CreateSalesOrderStatuses.RefOrderNo` (string)

  - `CreateSalesOrderStatuses.IsCreated` (boolean)

  - `CreateSalesOrderStatuses.Messages` (array)