7. Async Orders

Create an Async Order under a specific Account.

Changed on
post/asyncOrders

Request

  • Base URL
    https://integration-api.tangocard.com/raas/v2
  • URL
    https://integration-api.tangocard.com/raas/v2/asyncOrders
  • Auth
    • HTTP basic
    • or HTTP bearer

Request body

externalRefIDstring required

Required. Idempotent field that can be used for client-side order cross reference and prevent accidental order duplication. Will be returned in order response.

customerIdentifierstring required

specify the customer associated with the order. Must be the customer the accountIdentifier is associated with.

accountIdentifierstring required

specify the account this order will be deducted from

campaignstring

Optional. Campaign that may be used to administratively categorize a specific order. Must be between 0 and 1024 characters in length.

purchaseOrderNumberstring

The Purchase Order Number associated with this order.

notesstring

Optional order notes. Must be between 0 and 1024 characters in length.

Example request

{
  "lineItems": [
    {
      "etid": "E000000"
    }
  ]
}

Response

OK

externalRefIDstring

Required. Idempotent field that can be used for client-side order cross reference and prevent accidental order duplication. Will be returned in order response.

statusstring

This status reflects about cart status or validation status based on the processing

totalLineItemsinteger

Total number of line items submitted in the request

createdAtstring date-time
duplicateLineItemRefIdsobject

If any duplicate duplicateLineItemRefIds exist in the request

Changes

    • breaking

      the /// request property format changed from no format to email

    • breaking

      the / request property format changed from no format to email

    • warning

      the /// request property's maxLength was set to 255

    • warning

      the / request property's maxLength was set to 255

    • info

      added the new optional request property //

    • info

      added the new BULKSHIPMENT enum value to the request property //