Create an abandoned cart

POST https://:account.api-us1.com/api/3/ecomOrders

JSON

{
  "ecomOrder": {
    "externalcheckoutid": "3246315233",
    "source": "1",
    "email": "alice@example.com",
    "orderProducts": [
      {
        "externalid": "PROD12345",
        "name": "Pogo Stick",
        "price": "4900",
        "quantity": "1",
        "category": "Toys",
        "description": "The most advanced Pogo Stick ever created!",
        "productUrl": "https://example.com/products/pogo-stick",
        "imageUrl": "https://example.com/products/pogo-stick.jpg"
      },
      {
        "externalid": "PROD23456",
        "name": "Skateboard",
        "price": "3000",
        "quantity": "1",
        "category": "Toys",
        "description": "Do a kick flip!",
        "productUrl": "https://example.com/products/skateboard",
        "imageUrl": "https://example.com/products/skateboard.jpg"
      }
    ],
    "orderUrl": "https://example.com/orders/3246315233",
    "externalCreatedDate": "2016-09-13T17:41:39-04:00",
    "externalUpdatedDate": "2016-09-14T13:20:17-04:00",
    "abandonedDate": "2016-09-13T17:41:39-04:00",
    "totalPrice": "9111",
    "currency": "USD",
    "connectionid": "1",
    "customerid": "1"
  }
}

201 Created

{
  "ecomOrder": {
        "externalcheckoutid": "3246315233",
        "source": "1",
        "email": "alice@example.com",
        "currency": "USD",
        "connectionid": "1",
        "customerid": "1",
        "orderUrl": "https://example.com/orders/3246315233",
        "externalCreatedDate": "2016-09-13T16:41:39-05:00",
        "externalUpdatedDate": "2016-09-14T12:20:17-05:00",
        "abandonedDate": "2016-09-13T16:41:39-05:00",
        "totalPrice": "9111",
        "totalProducts": 2,
        "createdDate": "2018-08-24T13:52:16-05:00",
        "updatedDate": "2018-08-24T13:52:16-05:00",
        "state": 2,
        "externalid": "",
        "orderProducts": [
            "1",
            "2"
        ],
        "customer": "1",
        "orderDate": "2016-09-13T16:41:39-05:00",
        "tstamp": "2018-08-24T13:52:16-05:00",
        "links": {
            "connection": "http://hosted.localdev/api/3/ecomOrders/1/connection",
            "customer": "http://hosted.localdev/api/3/ecomOrders/1/customer",
            "orderProducts": "http://hosted.localdev/api/3/ecomOrders/1/orderProducts",
            "orderActivities": "http://hosted.localdev/api/3/ecomOrders/1/orderActivities"
        },
        "id": "1",
        "connection": "1"
    },
    "ecomOrderProducts": [
        {
            "orderid": "1",
            "connectionid": "1",
            "externalid": "PROD12345",
            "name": "Pogo Stick",
            "description": "The most advanced Pogo Stick ever created!",
            "price": "4900",
            "quantity": "1",
            "category": "Toys",
            "imageUrl": "https://example.com/products/pogo-stick.jpg",
            "productUrl": "https://example.com/products/pogo-stick",
            "createdDate": "2018-08-24T13:52:16-05:00",
            "updatedDate": "2018-08-24T13:52:16-05:00",
            "tstamp": "2018-08-24T13:52:16-05:00",
            "links": {
                "ecomOrder": "http://hosted.localdev/api/3/ecomOrderProducts/1/ecomOrder"
            },
            "id": "1",
            "ecomOrder": "1"
        },
        {
            "orderid": "1",
            "connectionid": "1",
            "externalid": "PROD23456",
            "name": "Skateboard",
            "description": "Do a kick flip!",
            "price": "3000",
            "quantity": "1",
            "category": "Toys",
            "imageUrl": "https://example.com/products/skateboard.jpg",
            "productUrl": "https://example.com/products/skateboard",
            "createdDate": "2018-08-24T13:52:16-05:00",
            "updatedDate": "2018-08-24T13:52:16-05:00",
            "tstamp": "2018-08-24T13:52:16-05:00",
            "links": {
                "ecomOrder": "http://hosted.localdev/api/3/ecomOrderProducts/2/ecomOrder"
            },
            "id": "2",
            "ecomOrder": "1"
        }
    ]
}

BODY PARAMS

ecomOrder

object

ecomOrder.externalcheckoutid REQUIRED

string The id of the cart in the external service.

ecomOrder.source

int32 The order source code (0 - sync, 1 - realtime webhook).

ecomOrder.email REQUIRED

string The email address of the customer who placed the order.

ecomOrder.orderProducts

object ecomOrder.orderProducts.description

ecomOrder.orderProducts.name REQUIRED

string The name of the product

ecomOrder.orderProducts.price REQUIRED

int32 The price of the product, in cents. (i.e. $456.78 => 45678). Must be greater than or equal to zero.

ecomOrder.orderProducts.quantity REQUIRED

int32 The quantity ordered.

ecomOrder.orderProducts.externalid

string The id of the product in the external service.

ecomOrder.orderProducts.category

string The category of the product.

ecomOrder.orderProducts.description

string The description for the product.

ecomOrder.orderProducts.productUrl

string The URL for the product in the external service.

ecomOrder.orderProducts.imageUrl

string The URL for the image for the product in the external service.

ecomOrder.totalPrice REQUIRED

int32 The total price of the order in cents, including tax and shipping charges. (i.e. $456.78 => 45678). Must be greater than or equal to zero.

ecomOrder.currency REQUIRED

string The currency of the order (3-digit ISO code, e.g., 'USD').

ecomOrder.connectionid REQUIRED

int32 The id of the connection from which this order originated.

ecomOrder.customerid REQUIRED

int32 The id of the customer associated with this order.

ecomOrder.orderNumber

string The order number in the external system (this may differ from the externalid).

ecomOrder.orderUrl

string The URL for the cart where the customer can finish their checkout.

ecomOrder.abandonedDate REQUIRED

date The date the cart was abandoned.

ecomOrder.externalCreatedDate REQUIRED

date The date the abandoned cart was created.

ecomOrder.externalUpdatedDate

string The date the abandoned cart was updated.

ecomOrder.shippingMethod

string The shipping method of the order.

Artikelen in deze sectie

POST https://:account.api-us1.com/api/3/ecomOrders

BODY PARAMS

Opmerkingen