Create order batch

POST 
/v1/batches/orders

Create order batch. Beta

Request

application/json

Body

required

orders

object[]

required

The list of orders to process.

Array [

order_id stringrequired

The source' order id.

order_date stringnullable

The order date. format: YYYY-MM-DD

source string

Default value: API

The order's source.
e.g. API, POS, ERP, Shopify, Woocommerce, etc.

shipping_to

object

required

postal_code stringnullable

Possible values: <= 10 characters

The address postal code (required for shipment purchase)

city stringnullable

Possible values: <= 30 characters

The address city. (required for shipment purchase)

federal_tax_id stringnullable

Possible values: <= 20 characters

The party frederal tax id

state_tax_id stringnullable

Possible values: <= 20 characters

The party state id

person_name stringnullable

Possible values: <= 50 characters

Attention to (required for shipment purchase)

company_name stringnullable

Possible values: <= 50 characters

The company name if the party is a company

country_code stringrequired

Possible values: [AC, AD, AE, AF, AG, AI, AL, AM, AN, AO, AR, AS, AT, AU, AW, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BM, BN, BO, BR, BS, BT, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GT, GU, GW, GY, HK, HN, HR, HT, HU, IC, ID, IE, IL, IN, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KV, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SK, SL, SM, SN, SO, SR, SS, ST, SV, SY, SZ, TC, TD, TG, TH, TJ, TL, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WS, XB, XC, XE, XM, XN, XS, XY, YE, YT, ZA, ZM, ZW, EH, IM, BL, MF, SX]

The address country code

email stringnullable

The party email

phone_number stringnullable

Possible values: <= 20 characters

The party phone number.

state_code stringnullable

Possible values: <= 20 characters

The address state code

residential booleannullable

Indicate if the address is residential or commercial (enterprise)

street_number stringnullable

Possible values: <= 20 characters

The address street number

address_line1 stringnullable

Possible values: <= 50 characters

The address line with street number
(required for shipment purchase)

address_line2 stringnullable

Possible values: <= 50 characters

The address line with suite number

validate_location booleannullable

Indicate if the address should be validated

shipping_from

object

nullable

postal_code stringnullable

Possible values: <= 10 characters

The address postal code (required for shipment purchase)

city stringnullable

Possible values: <= 30 characters

The address city. (required for shipment purchase)

federal_tax_id stringnullable

Possible values: <= 20 characters

The party frederal tax id

state_tax_id stringnullable

Possible values: <= 20 characters

The party state id

person_name stringnullable

Possible values: <= 50 characters

Attention to (required for shipment purchase)

company_name stringnullable

Possible values: <= 50 characters

The company name if the party is a company

country_code stringrequired

Possible values: [AC, AD, AE, AF, AG, AI, AL, AM, AN, AO, AR, AS, AT, AU, AW, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BM, BN, BO, BR, BS, BT, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GT, GU, GW, GY, HK, HN, HR, HT, HU, IC, ID, IE, IL, IN, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KV, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SK, SL, SM, SN, SO, SR, SS, ST, SV, SY, SZ, TC, TD, TG, TH, TJ, TL, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WS, XB, XC, XE, XM, XN, XS, XY, YE, YT, ZA, ZM, ZW, EH, IM, BL, MF, SX]

The address country code

email stringnullable

The party email

phone_number stringnullable

Possible values: <= 20 characters

The party phone number.

state_code stringnullable

Possible values: <= 20 characters

The address state code

residential booleannullable

Indicate if the address is residential or commercial (enterprise)

street_number stringnullable

Possible values: <= 20 characters

The address street number

address_line1 stringnullable

Possible values: <= 50 characters

The address line with street number
(required for shipment purchase)

address_line2 stringnullable

Possible values: <= 50 characters

The address line with suite number

validate_location booleannullable

Indicate if the address should be validated

billing_address

object

nullable

postal_code stringnullable

Possible values: <= 10 characters

The address postal code (required for shipment purchase)

city stringnullable

Possible values: <= 30 characters

The address city. (required for shipment purchase)

federal_tax_id stringnullable

Possible values: <= 20 characters

The party frederal tax id

state_tax_id stringnullable

Possible values: <= 20 characters

The party state id

person_name stringnullable

Possible values: <= 50 characters

Attention to (required for shipment purchase)

company_name stringnullable

Possible values: <= 50 characters

The company name if the party is a company

country_code stringrequired

Possible values: [AC, AD, AE, AF, AG, AI, AL, AM, AN, AO, AR, AS, AT, AU, AW, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BM, BN, BO, BR, BS, BT, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GT, GU, GW, GY, HK, HN, HR, HT, HU, IC, ID, IE, IL, IN, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KV, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SK, SL, SM, SN, SO, SR, SS, ST, SV, SY, SZ, TC, TD, TG, TH, TJ, TL, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WS, XB, XC, XE, XM, XN, XS, XY, YE, YT, ZA, ZM, ZW, EH, IM, BL, MF, SX]

The address country code

email stringnullable

The party email

phone_number stringnullable

Possible values: <= 20 characters

The party phone number.

state_code stringnullable

Possible values: <= 20 characters

The address state code

residential booleannullable

Indicate if the address is residential or commercial (enterprise)

street_number stringnullable

Possible values: <= 20 characters

The address street number

address_line1 stringnullable

Possible values: <= 50 characters

The address line with street number
(required for shipment purchase)

address_line2 stringnullable

Possible values: <= 50 characters

The address line with suite number

validate_location booleannullable

Indicate if the address should be validated

line_items

object[]

required

The order line items.

Array [

weight doublerequired

The commodity's weight

weight_unit stringrequired

Possible values: [KG, LB, OZ, G]

The commodity's weight unit

title stringnullable

Possible values: <= 35 characters

A description of the commodity

description stringnullable

Possible values: <= 100 characters

A description of the commodity

quantity integer

Default value: 1

The commodity's quantity (number or item)

sku stringnullable

Possible values: <= 35 characters

The commodity's sku number

hs_code stringnullable

Possible values: <= 35 characters

The commodity's hs_code number

value_amount doublenullable

The monetary value of the commodity

value_currency stringnullable

Possible values: [EUR, AED, USD, XCD, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, XOF, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, XAF, CHF, NZD, CLP, CNY, COP, CRC, CUC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, FJD, GBP, GEL, GHS, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, XPF, NGN, NIO, NOK, NPR, OMR, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TND, TOP, TRY, TTD, TWD, TZS, UAH, UYU, UZS, VEF, VND, VUV, WST, YER, ZAR, null]

The currency of the commodity value amount

origin_country stringnullable

Possible values: [AC, AD, AE, AF, AG, AI, AL, AM, AN, AO, AR, AS, AT, AU, AW, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BM, BN, BO, BR, BS, BT, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GT, GU, GW, GY, HK, HN, HR, HT, HU, IC, ID, IE, IL, IN, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KV, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SK, SL, SM, SN, SO, SR, SS, ST, SV, SY, SZ, TC, TD, TG, TH, TJ, TL, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WS, XB, XC, XE, XM, XN, XS, XY, YE, YT, ZA, ZM, ZW, EH, IM, BL, MF, SX, null]

The origin or manufacture country

parent_id stringnullable

The id of the related order line item.

metadata

object

nullable

Commodity user references metadata.

{ "part_number": "5218487281", "reference1": "# ref 1", "reference2": "# ref 2", "reference3": "# ref 3", ... }

property name* anynullable

Commodity user references metadata.

    {
        "part_number": "5218487281",
        "reference1": "# ref 1",
        "reference2": "# ref 2",
        "reference3": "# ref 3",
        ...
    }
    </details>
    

]

options

object

nullable

The options available for the order shipments.

{ "currency": "USD", "paid_by": "third_party", "payment_account_number": "123456789", "duty_paid_by": "third_party", "duty_account_number": "123456789", "invoice_number": "123456789", "invoice_date": "2020-01-01", "single_item_per_parcel": true, "carrier_ids": ["canadapost-test"], "preferred_service": "fedex_express_saver", }

property name* anynullable

The options available for the order shipments.

    {
        "currency": "USD",
        "paid_by": "third_party",
        "payment_account_number": "123456789",
        "duty_paid_by": "third_party",
        "duty_account_number": "123456789",
        "invoice_number": "123456789",
        "invoice_date": "2020-01-01",
        "single_item_per_parcel": true,
        "carrier_ids": ["canadapost-test"],
        "preferred_service": "fedex_express_saver",
    }
    </details>
    

metadata

object

User metadata for the order.

property name* any

Default value: [object Object]

User metadata for the order.

]

Responses

200

application/json

Schema

Schema

id string

A unique identifier

status stringrequired

Possible values: [queued, running, failed, completed, completed_with_errors]

resource_type stringrequired

Possible values: [orders, shipments, trackers, billing]

resources

object[]

required

Array [

id string

A unique identifier

status stringrequired

Possible values: [queued, running, failed, completed, completed_with_errors]

The batch operation resource status

errors

object

nullable

Resource processing errors

property name* anynullable

Resource processing errors

]

created_at date-timerequired
updated_at date-timerequired
test_mode booleanrequired

Example (from schema)

{
  "id": "string",
  "status": "queued",
  "resource_type": "orders",
  "resources": [
    {
      "id": "string",
      "status": "queued",
      "errors": {}
    }
  ],
  "created_at": "2024-07-29T15:51:28.071Z",
  "updated_at": "2024-07-29T15:51:28.071Z",
  "test_mode": true
}

404

application/json

Schema

Schema

errors

object[]

The list of API errors

Array [

message string

The error or warning message

code string

The message code

details

object

any additional details

property name* any

any additional details

]

Example (from schema)

{
  "errors": [
    {
      "message": "string",
      "code": "string",
      "details": {}
    }
  ]
}

500

application/json

Schema

Schema

errors

object[]

The list of API errors

Array [

message string

The error or warning message

code string

The message code

details

object

any additional details

property name* any

any additional details

]

Example (from schema)

{
  "errors": [
    {
      "message": "string",
      "code": "string",
      "details": {}
    }
  ]
}

Loading...