ConnectCloud Developers

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"

View as Markdown · Interactive reference · OpenAPI