## 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:

```json
{
  "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

```bash
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/itsp/egis/carts/detail?name=Einkauf' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
