Get an EGIS shopping cart with positions and totals per distributor (tenant:egis-cart:write)
GET /api/trade/v1/itsp/egis/carts/detail
Module: Trade · operationId: getEgisCart · Tag: ITSP · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name |
query | string | yes | Cart name without the (global) prefix. |
Responses
- 200 Cart (
application/json) - 400 Invalid name, unknown cart or EGIS not set up. (
application/json) - 401 No valid session or bearer token (no body).
- 403 Missing permission, no active tenant in the token, or a missing CSRF token on a cookie write. (
application/json) - 502 A dependent service (DMS, masterdata, a distributor) failed or is unreachable. (
application/json) - 503 The configuration store is not available. (
application/json)
Fields of the 200 answer:
label(string): Name without the(global)prefix.name(string): Name in EGIS.additionalCharges(number): Freight, minimum-order and small-quantity charges of all distributors.distributors(array of object): Totals per distributor for an online order.distributorId(string): EGIS id of the distributor.distributorName(string): Name of the distributor.freightAbsorptionLimit(number): Order value from which no freight is charged.freightCharge(number): Freight charge.minimumOrderValue(number): Minimum order value of the distributor.positions(integer): Number of positions of the distributor.productTotal(number): Total of the articles of the distributor.smallQuantitiesMarkup(number): Small-quantity markup of the distributor.total(number): Total of the distributor including its charges.
items(array of object): Positions of the cart.availableQuantity(integer): Quantity available at the distributor.comment(string): Comment on the position.currency(string): Currency (ISO 4217).description(string): Description of the article.distributorId(string): EGIS id of the distributor.distributorName(string): Name of the distributor.ean(string): EAN (GTIN) of the article.eol(boolean): The article is end of life.manufacturerName(string): Name of the manufacturer.mpn(string): Manufacturer part number.pcsNumber(string): EGIS PCS article number.purchasePrice(number): Net purchase price.quantity(integer): Quantity in the cart.supplierArticleNumber(string): The distributor's article number.
positions(integer): Number of positions in the cart.total(number): Total of the cart including the charges.
Example 200 answer:
{
"additionalCharges": 8.5,
"distributors": [
{
"distributorId": "70044",
"distributorName": "Nordlicht IT-Distribution GmbH",
"freightAbsorptionLimit": 1500,
"freightCharge": 8.5,
"minimumOrderValue": 50,
"positions": 2,
"productTotal": 1264,
"smallQuantitiesMarkup": 0,
"total": 1272.5
}
],
"items": [
{
"availableQuantity": 140,
"comment": "Mindestbestand Lager",
"currency": "EUR",
"description": "Headset USB Stereo mit Geräuschunterdrückung",
"distributorId": "70044",
"distributorName": "Nordlicht IT-Distribution GmbH",
"ean": "4061234500076",
"eol": false,
"manufacturerName": "Nordlicht",
"mpn": "HS-USB-ANC",
"pcsNumber": "PCS400942",
"purchasePrice": 79,
"quantity": 16,
"supplierArticleNumber": "NL-HS-USB-ANC"
}
],
"label": "Einkauf",
"name": "(global) Einkauf",
"positions": 2,
"total": 1272.5
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/itsp/egis/carts/detail?name=Einkauf' \
-H "Authorization: Bearer $ACCESS_TOKEN"