# 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 sale (POS) 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)
    Semi-colon delimited list of tags to apply to the order

  - `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.ItemsInfo.ExternalLineNumber` (string)
    Coming soon: Associate the item with a specific line in the customer's order. This is useful for echoing back data for reconciliation within your systems.
    Example: "100001"

  - `SalesOrdersInfo.ItemsInfo.Group` (string)
    Coming soon: Associate the items with a group for future visualization in ACP, reporting purposes, business rules such as waiving, and shipping rules.
    Example: "gift-set-1"

  - `SalesOrdersInfo.ItemsInfo.ParentItemNo` (string)
    Coming soon: Define the relationship between the ItemNo and any parent items in the customer's order. This is useful for defining gift sets or associations with boxes, or other hierarchy relationships between items on the order.
    Example: "69-SE"

  - `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)


## Response 400 fields

## Response 401 fields

## Response 413 fields

## Response 429 fields

## Response 500 fields