ConnectCloud Developers

Map a provider's SKU to an article (tenant:trade:msp:write)

PUT /api/trade/v1/msp/mappings/articles

Module: Trade · operationId: saveMspArticleMapping · Tag: MSP billing · Auth: access token (Authorization: Bearer <accessToken>)

Creates or replaces the mapping of provider and SKU. Drafts become stale.

Request body

application/json (required)

  • articleNumber (string, required): Masterdata article that is sold. (max length 100)
  • provider (string, required): MSP provider (mailstore, sophos, ingram, itc, …). (max length 32)
  • sourceSku (string, required): The provider's SKU. (max length 200)
  • id (string (uuid), read-only): Id of the mapping.
  • matchedBy (string, read-only): Rule of an automatic mapping: the SKU is the article's manufacturer part number, the bare Microsoft SKU (without term) is the article's manufacturer part number (a fallback replaced by the SKU and term's own article once that exists), the article has the Microsoft or Sophos SKU's number, or the article was created for it. (one of manufacturerPartNumber, manufacturerPartNumberBare, articleNumber, created)
  • name (string): Line text; empty: the article's name. (max length 300)
  • source (string, read-only): Every save through the API is manual, also a save of an automatic mapping. (one of manual, auto)
  • unitPrice (number): Net price; empty: the contract's usage position, else the article's price.
  • updatedAt (string (date-time), read-only): When the mapping was last saved.

Example:

{
  "articleNumber": "M365-BP",
  "name": "Microsoft 365 Business Premium",
  "provider": "ingram",
  "sourceSku": "CFQ7TTC0LCHC",
  "unitPrice": 20.6
}

Responses

  • 200 Saved (application/json)
  • 400 Error (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)

Fields of the 200 answer:

  • articleNumber (string, required): Masterdata article that is sold. (max length 100)
  • provider (string, required): MSP provider (mailstore, sophos, ingram, itc, …). (max length 32)
  • sourceSku (string, required): The provider's SKU. (max length 200)
  • id (string (uuid), read-only): Id of the mapping.
  • matchedBy (string, read-only): Rule of an automatic mapping: the SKU is the article's manufacturer part number, the bare Microsoft SKU (without term) is the article's manufacturer part number (a fallback replaced by the SKU and term's own article once that exists), the article has the Microsoft or Sophos SKU's number, or the article was created for it. (one of manufacturerPartNumber, manufacturerPartNumberBare, articleNumber, created)
  • name (string): Line text; empty: the article's name. (max length 300)
  • source (string, read-only): Every save through the API is manual, also a save of an automatic mapping. (one of manual, auto)
  • unitPrice (number): Net price; empty: the contract's usage position, else the article's price.
  • updatedAt (string (date-time), read-only): When the mapping was last saved.

Example 200 answer:

{
  "articleNumber": "CL-3003",
  "id": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e02",
  "name": "E-Mail-Archivierung je Postfach, monatlich",
  "provider": "mailstore",
  "source": "manual",
  "sourceSku": "MB-MAILSTORE",
  "unitPrice": 2.5,
  "updatedAt": "2026-11-19T10:45:00Z"
}

Example request

curl -X PUT 'https://api.mbcom.cloud/api/trade/v1/msp/mappings/articles' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"articleNumber":"M365-BP","name":"Microsoft 365 Business Premium","provider":"ingram","sourceSku":"CFQ7TTC0LCHC","unitPrice":20.6}'

View as Markdown · Interactive reference · OpenAPI