Skip to content
ShopgateShopgateShopgate Documentation

Create sales orders

POST
/merchants/{merchantCode}/orders
curl --request POST \
  --url https://order.shopgate.io/v1/merchants/example/orders \
  --header 'Content-Type: application/json' \
  --data '{ "orders": [ { "externalCode": "000000274", "shopCode": "shop_12345", "type": "standard", "customerId": "55c98b8e-1100-497c-8df6-4b4f0353ab2a", "externalCustomerNumber": "C1756793", "localeCode": "de-de", "currencyCode": "EUR", "status": "new", "taxExempt": false, "expedited": false, "notes": "Please wrap each item individually.", "specialInstructions": "House behind the dumpster", "data": "example", "addressSequences": [ { "type": "pickup", "customerContactId": "0b475af4-7ed9-4065-b4bb-7d76c537d820", "firstName": "Max", "middleName": "René", "lastName": "Muster", "company": "Shopgate GmbH", "address1": "Schloßstr. 10", "address2": "Haus B", "address3": "erste Etage", "address4": null, "city": "Butzbach", "region": "HE", "postalCode": "\"35510\"", "country": "DE", "additionalFields": { "dhlPostBoxNumber": "example", "dhlPostNumber": "example" }, "phone": "+49 12345 6789 001", "fax": "+49 12345 6789 002", "mobile": "+49 12345 6789 003", "emailAddress": "max.muster@shopgate.com", "orderSegment": { "selectedShippingMethod": { "code": "standardShipping", "serviceLevel": { "code": "standard", "cost": 4.99, "carrier": { "code": "DHL" } } } } } ], "primaryBillToAddressSequenceIndex": 1, "primaryShipToAddressSequenceIndex": 1, "coupons": [ { "code": "SUMMER2020", "name": "Coupon for Summer 2020", "limits": { "overall": 500, "maxPerCustomer": 1 }, "status": "active", "couponSet": null, "promotion": { "code": "promo", "name": "Promo with Coupon" } } ], "appliedPromotions": [ { "code": "2020summerPromotion", "name": "Summer Promotion for 2020", "model": "simpleDiscount", "description": "This promotion is for our summer coupons", "promotionalText": "This coupons gives you 10% off to celebrate the summer 2020", "status": "active", "startDate": "2020-07-01T00:00:000", "endDate": "2020-07-01T00:00:000", "target": "order", "type": "coupon", "discount": { "type": "percentage", "amount": 10 }, "conditions": { "$and": [ { "subTotal": { "gte": 100 } }, { "$or": [ { "fulfillmentMethod": { "$in": [ "directShip", "BOPIS", "ROPIS" ] } }, { "customer.segment.code": { "$in": [ "employees", "contractors" ] } } ] } ] }, "impact": { "conditions": { "lineItem.product.categoryCode": { "$in": [ "shirts" ] }, "lineItem.quantity": 1 }, "automaticallyAddedToCart": false }, "coupon": { "code": "summer2020", "name": "Coupon 10off for the summer 2020", "limits": { "overall": 10, "maxPerCustomer": null } }, "couponSet": null, "limitConditions": { "maxOverallUsageCount": 100, "maxCustomerUsageCount": 1, "maxUsagePerOrder": 1, "cantBeCombinedWithPromotionCode": { "$in": [ "bogo1" ] } } } ], "lineItems": [ { "code": "386", "parentLineItemCode": "286", "quantity": 1, "fulfillmentMethod": "directShip", "fulfillmentLocationCode": "DERetail001", "shipToAddressSequenceIndex": 1, "product": { "code": "24-MB02", "name": "Fusion Backpack", "image": "https://myawesomeshop.com/images/img1.jpg", "price": 59.99, "salePrice": 39.99, "currencyCode": "EUR", "identifiers": { "mfgPartNum": "100-440-0.750-3434-A", "upc": "\"72527273070\"", "ean": "\"401234567890\"", "isbn": "978-3-16-148410-0", "sku": "UGG-BB-PUR-06", "distiPartNum": "\"235454356363\"" }, "options": [ { "code": "color", "name": "Color", "value": { "code": "red", "name": "Red" } } ] }, "currencyCode": "EUR", "shippingAmount": 1, "taxAmount": 0, "tax2Amount": 0, "taxExempt": true, "unitPromoAmount": 0, "unitDiscountAmount": 0, "discountAmount": 0, "promoAmount": 0, "overrideAmount": 1, "extendedPrice": 72, "price": 79.98, "substitutionAllowed": true, "fulfillmentSlot": { "id": "5_2019-09-03", "date": "2019-09-03", "weekday": "fri", "from": "08:00", "to": "08:59", "status": "active", "orderCount": 10 }, "appliedPromotions": [ { "code": "2020summerPromotion", "name": "Summer Promotion for 2020", "model": "simpleDiscount", "description": "This promotion is for our summer coupons", "promotionalText": "This coupons gives you 10% off to celebrate the summer 2020", "status": "active", "startDate": "2020-07-01T00:00:000", "endDate": "2020-07-01T00:00:000", "target": "order", "type": "coupon", "discount": { "type": "percentage", "amount": 10 }, "conditions": { "$and": [ { "subTotal": { "gte": 100 } }, { "$or": [ { "fulfillmentMethod": { "$in": [ "directShip", "BOPIS", "ROPIS" ] } }, { "customer.segment.code": { "$in": [ "employees", "contractors" ] } } ] } ] }, "impact": { "conditions": { "lineItem.product.categoryCode": { "$in": [ "shirts" ] }, "lineItem.quantity": 1 }, "automaticallyAddedToCart": false }, "coupon": { "code": "summer2020", "name": "Coupon 10off for the summer 2020", "limits": { "overall": 10, "maxPerCustomer": null } }, "couponSet": null, "limitConditions": { "maxOverallUsageCount": 100, "maxCustomerUsageCount": 1, "maxUsagePerOrder": 1, "cantBeCombinedWithPromotionCode": { "$in": [ "bogo1" ] } } } ] } ], "subTotal": 65.98, "discountAmount": 0, "promoAmount": 0, "shippingSubTotal": 3.99, "shippingDiscountAmount": 0, "shippingPromoAmount": -2, "shippingTotal": 1.99, "taxAmount": 0, "tax2Amount": 0, "taxSummary": [ { "code": "default_19", "name": "19%", "amount": 1.5 } ], "total": 64.97, "submitDate": "2019-09-02T09:02:57.733Z", "fulfillDate": "2019-09-03T15:02:32.733Z", "completeDate": "2019-09-03T15:02:57.733Z", "sourceIp": "85.45.62.2", "userAgent": "Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0", "domain": "www.mydomain.com", "platform": "engage", "os": "ios", "imported": false, "campaignAttribution": { "campaignCode": "CMP-1", "channel": "push", "distributionIndex": 0 } } ] }'

Create sales orders

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
merchantCode
required
string

Unique merchant code which represents the unique “merchant account”.

Request Body

Section titled “Request Body”
Media typeapplication/json
object
orders
required
Array<object>
>= 1 items <= 100 items
object
externalCode

External order id

string
>= 1 characters
Example
000000274
shopCode

Code of the source shop.

string
Example
shop_12345
type
string
default: standard
Allowed values: standard
customerId
required

Customer identifier

string
Example
55c98b8e-1100-497c-8df6-4b4f0353ab2a
externalCustomerNumber

A customer number / reference to an external system.

string
Example
C1756793
localeCode
required

5-character locale code - normalized to lowercase with dash separator. e.g. ‘en-us’.

string
/^[a-z]{2}[-_][a-zA-Z]{2}$/
Example
de-de
currencyCode
required
string
>= 3 characters <= 3 characters
Example
EUR
status
string
Allowed values: new open rejected canceled ready fulfilled completed inProgress
taxExempt
boolean
expedited

Indicates if the order needs to be threated expediently

boolean
Example
false
notes

Customer notes where the shopper can provide special instructions. The notes are shown in the In-Store App & Admin.

string | null
<= 1000 characters
Example
Please wrap each item individually.
specialInstructions

Special instructions of the order. It can contain special shipping or fulfillment instructions

string | null
Example
House behind the dumpster
data
object | null
addressSequences
required
Array<object>
object
type
required
string
Allowed values: pickup shipping billing
customerContactId
string | null
Example
0b475af4-7ed9-4065-b4bb-7d76c537d820
firstName
required
string
Example
Max
middleName
string | null
Example
René
lastName
required
string
Example
Muster
company
string | null
Example
Shopgate GmbH
address1

This field is required if used as shipping address for direct ship

string | null
Example
Schloßstr. 10
address2
string | null
Example
Haus B
address3
string | null
Example
erste Etage
address4
string | null
Example
null
city

This field is required if used as shipping address for direct ship

string | null
Example
Butzbach
region
string | null
Example
HE
postalCode

This field is required if used as shipping address for direct ship

string | null
Example
"35510"
country

ISO 3166 ALPHA-2 / ISO 3166-2 Country Code. This field is required if used as shipping address for direct ship

string | null
<= 2 characters
Example
DE
additionalFields
object
dhlPostBoxNumber

Number of a postbox

string | null
>= 1 characters <= 5 characters
dhlPostNumber

Number of a post

string | null
>= 1 characters <= 10 characters
phone

Validated according to country code

string | null
Example
+49 12345 6789 001
fax

Validated according to country code

string | null
Example
+49 12345 6789 002
mobile

Validated according to country code

string | null
Example
+49 12345 6789 003
emailAddress
required
string format: email
Example
max.muster@shopgate.com
orderSegment
object
selectedShippingMethod
object
code
required
string
Example
standardShipping
serviceLevel
required
object
code
required
string
Example
standard
cost
number format: float
Example
4.99
carrier
required
object
code
required
string
Example
DHL
primaryBillToAddressSequenceIndex
required

Position in the AddressSequences-Array, mandatory for all fulfillment methods that include billing like directShip and BOPIS

number
primaryShipToAddressSequenceIndex

Position in the AddressSequences-Array, mandatory for all fulfillment methods that include shipping like directShip

number
coupons

Coupon of the order. If the order is in the status new only the code needs to be passed For all other status the whole object should to be filled out with to have all information of the coupons persist for transparency purposes.

Array<object>
object
code
required

Code of the coupon

string
name

Name of the coupon

string
limits
object
overall

Limit for the overall usage of this coupon

number | null
Example
10
maxPerCustomer

Indicates how often this coupon can be used per customer

number | null
Example
1
status
string
Allowed values: active redeemed inactive
couponSet
object
code
string
Example
2020summerCoupons
name
string
Example
All Summer Coupons for 2020
promotion
object
code
string
Example
2020summerPromotion
name

Name of the Coupon

string
Example
Coupons 10off
Example
{
  "code": "SUMMER2020",
  "name": "Coupon for Summer 2020",
  "limits": {
    "overall": 500,
    "maxPerCustomer": 1
  },
  "status": "active",
  "couponSet": null,
  "promotion": {
    "code": "promo",
    "name": "Promo with Coupon"
  }
}
appliedPromotions

Applied promotions of the order. If the order is in the status new this parameter will be ignored. The system will automatically calc the promotions for the order

Array<object>
object
code
required
string
Example
2020summerPromotion
name
required
string
Example
Summer Promotion for 2020
model
string
default: simpleDiscount
Allowed values: simpleDiscount BOGO
description
string | null
Example
This promotion is for our summer coupons
promotionalText

Promotional text that will be displayed to the customer

string | null
Example
This coupons gives you 10% off to celebrate the summer 2020
status
string
default: active
Allowed values: active inactive
startDate
required
string | null format: date-time
Example
2020-07-01T00:00:000
endDate
string | null format: date-time
Example
2020-07-01T00:00:000
target
string
default: order
Allowed values: order product orderShipping productShipping
type
string
Allowed values: coupon promotion
Example
coupon
discount
required
object
type
required
string
Allowed values: percentage absolute fixedPrice
amount
required
number format: float
Example
10
conditions
object
Example
{
  "$and": [
    {
      "subTotal": {
        "gte": 100
      }
    },
    {
      "$or": [
        {
          "fulfillmentMethod": {
            "$in": [
              "directShip",
              "BOPIS",
              "ROPIS"
            ]
          }
        },
        {
          "customer.segment.code": {
            "$in": [
              "employees",
              "contractors"
            ]
          }
        }
      ]
    }
  ]
}
impact

Describes the impact of the promotion to specific line items. This only applies to BOGO promotions

object
conditions
required

Condition for products which should be impacted by the promotion This only applies to BOGO promotions.
Available condition fields are:

  • lineItem.product.code
  • lineItem.product.categoryCode
  • lineItem.product.price
  • lineItem.product.salePrice
  • lineItem.product.quantity
  • lineItem.product.options.<optionsCode>
  • lineItem.product.properties.<propertyCode>
The condition lineItem.quantity is always required. It needs to be set in the first level or in the $and condition on the first level
object | null
automaticallyAddedToCart

Indicates if the product which the customer would receive is automatically added to the cart. This only applies if the condition has one rule with a single product code

boolean
Example
{
  "conditions": {
    "lineItem.product.categoryCode": {
      "$in": [
        "shirts"
      ]
    },
    "lineItem.quantity": 1
  },
  "automaticallyAddedToCart": false
}
coupon
object
code
required

Unique coupon code. This code can be used by the end customer to activate a promotion in his cart.

string
Example
summer2020
name
required

Name of the Coupon

string
Example
Coupons 10off
limits
object
overall

Limit for the overall usage of this coupon

number | null
Example
10
maxPerCustomer

Indicates how often this coupon can be used per customer

number | null
Example
1
Example
{
  "code": "summer2020",
  "name": "Coupon 10off for the summer 2020",
  "limits": {
    "overall": 10,
    "maxPerCustomer": null
  }
}
couponSet
object
code
required
string
Example
2020summerSaleCoupons
type
required
string
Allowed values: generated custom
count

Only available and must be set for generated couponSet type.

number
<= 50000
Example
20
name
required
string
Example
All summer sale coupons for 2020
description
string
Example
This coupon set contains all coupons for 2020
prefix
string
Example
summer2020-
suffix
string
Example
-covid
Example
null
limitConditions

Set the limits how often the promotion can be used by a customer and with which other promotion it can be combined. For the field cantBeCombinedWithPromotionCode promotion code(s) can be given or a special code anyProductPromotions|anyOrderPromotions that will exclude any product|order promotion when it gets calculated. Available condition fields are:

  • maxOverallUsageCount
  • maxCustomerUsageCount
  • maxUsagePerOrder (only works for target=product)
  • cantBeCombinedWithPromotionCode
object | null
Example
{
  "maxOverallUsageCount": 100,
  "maxCustomerUsageCount": 1,
  "maxUsagePerOrder": 1,
  "cantBeCombinedWithPromotionCode": {
    "$in": [
      "bogo1"
    ]
  }
}
lineItems
required
Array<object>
>= 1 items
object
code
required

Identifier for the line item. Needs to be unique within the sales order.

string
Example
386
parentLineItemCode

Identifier for the parent line item. Needs to be unique within the sales order.

string | null
Example
286
quantity
required
number format: float
Example
1
fulfillmentMethod
required
string
Allowed values: directShip BOPIS ROPIS
Example
ROPIS
fulfillmentLocationCode
required
string | null
Example
DERetail001
shipToAddressSequenceIndex
required

Index of the address in the address sequence array where it should be shipped to

integer
product
required
object
code
required

Product code

string
>= 1 characters
Example
24-MB02
name
required

Product name

string
Example
Fusion Backpack
image

Main image url of the product

string | null format: uri
Example
https://myawesomeshop.com/images/img1.jpg
price
required

Main price of the product

number format: float
Example
59.99
salePrice

Sale price of the product

number | null format: float
Example
39.99
currencyCode
required
string
>= 3 characters <= 3 characters
Example
EUR
identifiers
object
mfgPartNum
null | string
<= 255 characters
Example
100-440-0.750-3434-A
upc
null | string
<= 255 characters
Example
"72527273070"
ean
null | string
<= 255 characters
Example
"401234567890"
isbn
null | string
<= 255 characters
Example
978-3-16-148410-0
sku
null | string
<= 255 characters
Example
UGG-BB-PUR-06
distiPartNum
null | string
<= 255 characters
Example
"235454356363"
options
Array<object>
object
code
required
string
Example
color
name
required
string
Example
Color
value
required
object
code
required
string
Example
red
name
required
string
Example
Red
currencyCode
required
string
>= 3 characters <= 3 characters
Example
EUR
shippingAmount
number format: float
taxAmount

Tax amount of the first tax group (e.g. for german taxes this is an absolut number based on either 7% or 19% of the order total; the order total is 10.00 EUR so the taxAmount is 10.00 EUR * 0.19 = 1.9 EUR)

number format: float
0
tax2Amount

Tax amount of the second tax group (can be used for additional taxes like for example US state taxes)

number format: float
0
taxExempt
boolean
unitPromoAmount

Amount of all applied promotions for a single unit (single quantity).

number format: float
0
Example
-4
unitDiscountAmount

Amount of all applied discounts (promotions with coupons) for a single unit (single quantity).

number format: float
0
Example
-3
discountAmount

Total amount of all applied promotions with coupons for the line item. (Formula: lineItem.unitDiscountAmount * lineItem.quantity)

number format: float
0
Example
-6
promoAmount

Total amount of all applied promotions for the line item. (Formula: lineItem.unitPromoAmount * lineItem.quantity)

number format: float
0
Example
-8
overrideAmount
number format: float
extendedPrice
required

The extended Price is the final price of the line item, including all discounts & promotions that apply to this line item, and also already multiplied with the quantity. Formula: (product.price or product.salePrice if not empty) * quantity + promoAmount + discountAmount. Example: A product original price is 60€ (product.price), but it is on sale for 40€ (product.salePrice). Ordered quantity is 2, there is no discount but there is a promotion that applies to this product and gives 10% additional discount (unitPromoAmount = 4€, promoAmount = 8€). The extended price of this line item should be (40€ * 2) + (-8€) = 72€.

number format: float
Example
72
price
required

Price of the line item. Formula: (product.price or product.salePrice if not empty) * quantity

number format: float
Example
79.98
substitutionAllowed

Determines if a substitution is allowed for this line item.

boolean
default: true
fulfillmentSlot
object
id

Id of the fulfillment slot

string
Example
5_2019-09-03
date
string format: date
weekday
string
Allowed values: sun mon tue wed thu fri sat
from

Hour and minute of the day where the time should start

string
Example
08:00
to
string
Example
08:59
status
string
Allowed values: active busy inactive
orderLimit

Limit of orders which can be placed in this slot. This value can only be set for the type fulfillmentSlot

number | null
Example
20
Example
{
  "id": "5_2019-09-03",
  "date": "2019-09-03",
  "weekday": "fri",
  "from": "08:00",
  "to": "08:59",
  "status": "active",
  "orderCount": 10
}
appliedPromotions

Applied promotions of the order. If the order is in the status new this parameter will be ignored. The system will automatically calc the promotions for the order

Array<object>
object
code
required
string
Example
2020summerPromotion
name
required
string
Example
Summer Promotion for 2020
model
string
default: simpleDiscount
Allowed values: simpleDiscount BOGO
description
string | null
Example
This promotion is for our summer coupons
promotionalText

Promotional text that will be displayed to the customer

string | null
Example
This coupons gives you 10% off to celebrate the summer 2020
status
string
default: active
Allowed values: active inactive
startDate
required
string | null format: date-time
Example
2020-07-01T00:00:000
endDate
string | null format: date-time
Example
2020-07-01T00:00:000
target
string
default: order
Allowed values: order product orderShipping productShipping
type
string
Allowed values: coupon promotion
Example
coupon
discount
required
object
type
required
string
Allowed values: percentage absolute fixedPrice
amount
required
number format: float
Example
10
conditions
object
Example
{
  "$and": [
    {
      "subTotal": {
        "gte": 100
      }
    },
    {
      "$or": [
        {
          "fulfillmentMethod": {
            "$in": [
              "directShip",
              "BOPIS",
              "ROPIS"
            ]
          }
        },
        {
          "customer.segment.code": {
            "$in": [
              "employees",
              "contractors"
            ]
          }
        }
      ]
    }
  ]
}
impact

Describes the impact of the promotion to specific line items. This only applies to BOGO promotions

object
conditions
required

Condition for products which should be impacted by the promotion This only applies to BOGO promotions.
Available condition fields are:

  • lineItem.product.code
  • lineItem.product.categoryCode
  • lineItem.product.price
  • lineItem.product.salePrice
  • lineItem.product.quantity
  • lineItem.product.options.<optionsCode>
  • lineItem.product.properties.<propertyCode>
The condition lineItem.quantity is always required. It needs to be set in the first level or in the $and condition on the first level
object | null
automaticallyAddedToCart

Indicates if the product which the customer would receive is automatically added to the cart. This only applies if the condition has one rule with a single product code

boolean
Example
{
  "conditions": {
    "lineItem.product.categoryCode": {
      "$in": [
        "shirts"
      ]
    },
    "lineItem.quantity": 1
  },
  "automaticallyAddedToCart": false
}
coupon
object
code
required

Unique coupon code. This code can be used by the end customer to activate a promotion in his cart.

string
Example
summer2020
name
required

Name of the Coupon

string
Example
Coupons 10off
limits
object
overall

Limit for the overall usage of this coupon

number | null
Example
10
maxPerCustomer

Indicates how often this coupon can be used per customer

number | null
Example
1
Example
{
  "code": "summer2020",
  "name": "Coupon 10off for the summer 2020",
  "limits": {
    "overall": 10,
    "maxPerCustomer": null
  }
}
couponSet
object
code
required
string
Example
2020summerSaleCoupons
type
required
string
Allowed values: generated custom
count

Only available and must be set for generated couponSet type.

number
<= 50000
Example
20
name
required
string
Example
All summer sale coupons for 2020
description
string
Example
This coupon set contains all coupons for 2020
prefix
string
Example
summer2020-
suffix
string
Example
-covid
Example
null
limitConditions

Set the limits how often the promotion can be used by a customer and with which other promotion it can be combined. For the field cantBeCombinedWithPromotionCode promotion code(s) can be given or a special code anyProductPromotions|anyOrderPromotions that will exclude any product|order promotion when it gets calculated. Available condition fields are:

  • maxOverallUsageCount
  • maxCustomerUsageCount
  • maxUsagePerOrder (only works for target=product)
  • cantBeCombinedWithPromotionCode
object | null
Example
{
  "maxOverallUsageCount": 100,
  "maxCustomerUsageCount": 1,
  "maxUsagePerOrder": 1,
  "cantBeCombinedWithPromotionCode": {
    "$in": [
      "bogo1"
    ]
  }
}
subTotal
required

The subtotal of the order (Formula: Sum of all lineItem.extendedPrice)

number format: float
Example
65.98
discountAmount

Total amount of all applied promotions with coupons on order level. Without line item level promotions, since these are already included in the order subtotal.

number format: float
0
Example
0
promoAmount

Total amount of all applied promotions on order level. Without line item level promotions, since these are already included in the order subtotal.

number format: float
0
Example
-5
shippingSubTotal

The original shipping costs, without any discounts or promotions

number format: float
Example
3.99
shippingDiscountAmount

Discounts on the shipping costs because of a couppon

number format: float
Example
0
shippingPromoAmount

Discounts on the shipping costs because of an (automatically applied) promotion

number format: float
Example
-2
shippingTotal

The final shipping costs including shippingDiscountAmount & shippingPromoAmount (Formula: shippingSubTotal + shippingDiscountAmount + shippingPromoAmount)

number format: float
Example
1.99
taxAmount

Tax amount of the first tax group (e.g. for german taxes this is an absolut number based on either 7% or 19% of the order total; the order total is 10.00 EUR so the taxAmount is 10.00 EUR * 0.19 = 1.9 EUR)

number format: float
0
tax2Amount

Tax amount of the second tax group (can be used for additional taxes like for example US state taxes)

number format: float
0
taxSummary
Array<object>
object
code
string
Example
default_19
name
string
Example
19%
amount
number
Example
1.5
total
required

The final price of the order that the shopper has to pay, including all promotions, discounts, shipping costs etc.

number format: float
Example
64.97
submitDate
required

Date when the order was submitted by the customer

string | null format: date-time
Example
2019-09-02T09:02:57.733Z
fulfillDate

Date when the order status was changed to fulfilled

string | null format: date-time
Example
2019-09-03T15:02:32.733Z
completeDate

Date when the order status was changed to completed

string | null format: date-time
Example
2019-09-03T15:02:57.733Z
sourceIp

IP address from the client where the order was placed. It can be a IPv4 or IPv6 address

string
Example
85.45.62.2
userAgent

The UserAgent string from headers of the incoming request.

string | null
Example
Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0
domain

The domain from which order came.

string | null
/^(((?!-))(xn--|_{1,1})?[a-z0-9-]{0,61}[a-z0-9]{1,1}\.)*(xn--)?([a-z0-9][a-z0-9\-]{0,60}|[a-z0-9-]{1,30}\.[a-z]{2,})$/
Example
www.mydomain.com
platform

The platform from which the order came.

string
Allowed values: engage desktop mobile checkoutPage inStoreApp other
Example
engage
os

Operation system of the source device

string
Allowed values: ios android other
Example
ios
imported

Indicates if the order has been imported from an external system. Enabling this flag means that there will be no further processes triggered by this order like emitting events, calculating properties like prices, or starting payment transactions.

boolean
Example
false
campaignAttribution

Campaign the order should be attributed to

object
campaignCode
required
string
channel
required
string
distributionIndex
required
number
Example
{
  "campaignCode": "CMP-1",
  "channel": "push",
  "distributionIndex": 0
}

Responses

Section titled “Responses”

201

Section titled “201”
Media typeapplication/json
object
orderNumbers
Array<string>
errors
Array<object>
object
entityIndex
number
entity
string
entityId
string
code
number
message
string
subentityPath
Array<string | null | number>
Examplegenerated
{
  "errors": [
    {
      "entityIndex": 1,
      "entity": "example",
      "entityId": "example",
      "code": 1,
      "message": "example",
      "subentityPath": [
        "example"
      ]
    }
  ]
}

404

Section titled “404”

Order not found

Media typeapplication/json

default

Section titled “default”

Unexpected error

Media typeapplication/json
object
code

Machine readable error code

string
message
required

Human readable error code

string
Example
{
  "code": "internal.database",
  "message": "Internal Database Error"
}