Update abandoned cart

Find all incomplete orders in the store.

PUT https://app.ecwid.com/api/v3/{storeId}/carts/{cartId}

Request and response example

Request:

PUT /api/v3/1003/carts/6626E60A-A6F9-4CD5-8230-43D5F162E0CD HTTP/1.1
Authorization: Bearer secret_token
Host: app.ecwid.com
Content-Type: application/json
Cache-Control: no-cache

{
  "hidden": true,
  "taxesOnShipping": [
    {
      "name": "Tax X",
      "value": 20,
      "total": 2.86
    }
  ]
}

Response:

{
  "updateCount": 1
}

Required access scopes

Your app must have the following access scopes to make this request: update_orders

Path params

All path params are required.

Param	Type	Description
storeId	number	Ecwid store ID.
cartId	string	Internal cart ID, for example, 0B299518-FB54-491A-A6E0-5B6BA6E20868.

Headers

The Authorization header is required.

Header	Format	Description
Authorization	Bearer secret_ab***cd	Access token of the application.

Request JSON

A JSON object with the following fields:

Field	Type	Description
hidden	boolean	Determines if the order is hidden (removed from the list). Applies to abandoned carts only
taxesOnShipping	array of objects taxesOnShipping	Taxes applied to shipping. null for old orders, [] for orders with taxes applied to subtotal only. Are not recalculated if cart is updated later manually. Is calculated like: (shippingRate + handlingFee)*(taxValue/100)
b2b_b2c	string	Order type: business-to-business (b2b) or business-to-consumer (b2c)
customerRequestedInvoice	boolean	true if customer requested an invoice, false otherwise
customerFiscalCode	string	Fiscale code of a customer
electronicInvoicePecEmail	string	PEC email for invoices
electronicInvoiceSdiCode	string	SDI code for invoices

taxesOnShipping

Field	Type	Description
name	string	Tax name
value	number	Tax value in store settings, applied to destination zone
total	number	Tax total applied to shipping

Response JSON

A JSON object with the following fields:

Field	Type	Description
updateCount	number	The number of updated items that defines if the request was successful. One of: 1 if the item was updated, 0 if the item was not updated.