The basket items are passed in the object node basket/products
.
{
// ...
"basket"
: {
"products"
: [
{
"id"
: 0,
"articleNumber"
:
"8050"
,
"ean"
:
"4123456789012"
,
"desc"
:
"ACME ball pen Modern Line 8050"
,
"quantity"
: 2,
"priceOne"
: 1595,
"tax"
: 19
},
{
"id"
: 1,
"articleNumber"
:
"22012"
,
"ean"
:
"4123500055537"
,
"desc"
:
"ACME pen case Modern Line"
,
"quantity"
: 1,
"priceOne"
: 1795,
"tax"
: 19
}
],
// ...
},
"basket_info"
: {
"sum"
: 4985,
"currency"
:
"EUR"
,
// ...
},
...
}
The Smart Transaction is about €49.85. There are two articles in it, having a gross unit price of €15.95 and €17.95.
Monetary amounts are expressed in the smallest currency unit (e. g. Euro Cent).
These fields are mandatory for an ordinary basket item:
- item ID;
- quantity;
- article name;
- gross unit price;
- VAT rate.
Additionally, you can also pass:
- your article number, or storage keeping unit (SKU);
- the official EAN (or GTIN) of this product.
Detailed description of the objects for the basket items (array elements of basket/products
):
Attribute | Type | Description |
---|---|---|
|
| The item ID as integer. It is necessary as handle for further changes. |
|
| The amount as integer. |
|
| Optional. Your internal article number, or storage keeping unit (SKU). |
|
| Optional. The official EAN or GTIN of this product. Note: If your product has no EAN or GTIN, please omit this attribute. It might conflict with real GTINs that need to be evaluated by use. We need to evaluate EANs when you start a loyalty card programme to detect loyalty cards, or articles with special tax handling. We also need to evaluate EANs when you start to sell e-goods, phone charge for example. |
|
| The article name. |
|
| The gross unit price in the smallest currency unit (e. g. Euro Cent). The currency unit is defined in If you pass a value of |
|
| The value-added tax (VAT) rate in percent. If you pass a value of |
Detailed description of the basket_info
:
Attribute | Type | Description |
---|---|---|
|
| Optional ISO 4217 currency code such as |
|
| The basket total in the smallest currency unit (e. g. Euro Cent). If you pass a value of The basket total must be equal to the sum of the gross item totals, including special items for shipping fee or bonus. This is explained in more detail in the respective sections or guides. |
|
| Readonly. The missing sum when using a secucard loyalty card for payment, and perhaps bonus collection. It is only present after the loyalty card is applied, which is explained in more detail in the respective guide. Again, it is expressed in the smaller currency unit. Assuming there is a missing sum of |