Basket Item Details

The basket items are passed in the object node basket/products.

Smart Transaction
{
// ...
"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

id

number

The item ID as integer. It is necessary as handle for further changes.

quantity

number

The amount as integer.

articleNumber

number

Optional. Your internal article number, or storage keeping unit (SKU).

ean

string

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.

desc

string

The article name.

price

number

The gross unit price in the smallest currency unit (e. g. Euro Cent). The currency unit is defined in basket_info.

If you pass a value of 1595 like in the first article, the gross unit price is €15,95.

tax

number

The value-added tax (VAT) rate in percent.

If you pass a value of 19, this means a VAT rate of 19%.

Detailed description of the basket_info:

Attribute

Type

Description

currency

string

Optional. ISO-4217 currency code such as EUR (default), GBP or CHF.

sum

number

The basket total in the smallest currency unit (e. g. Euro Cent).

If you pass a value of 4985 for a basket in EUR, the basket total is €49,85.

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.

missing_sum

number

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 3985 for a basket in EUR, the customer needs to pay the remaining €39.85 by another means of payment.