Suppliers - Impact Data

Upload supplier impact data by identifier

Changed on

Overview

Upsert customer impact fields for one supplier and one year on the resolved edge.

Null or omitted fields keep the value already stored for that year. year defaults to the current calendar year. additionalInformation is stored as a comment in the supplier's change history and is not returned in the response. The response is the same shape as GET for the written interval, including computed fields.

Required Permission

update_supplier_data. When perspectiveId is set, Perspective read is also required.

post/public/v2/suppliers/impact-data

Request

Query parameters

perspectiveIdinteger

Perspective used for computed impact fields. Defaults to the caller's active perspective. Requires Perspective read when set.

Request body

Example request

{
  "identifier": {
    "supplierId": "SAP-12345",
    "customerId": "CRM-67890",
    "ownId": "OWN-SITE-01",
    "prewaveId": 102006215,
    "source": "SAP"
  },
  "impactData": {
    "year": 2026,
    "atSupplierLocation": "SameBuilding",
    "atSupplierDeviation": "OnTarget",
    "atSupplierLastConfirmedDate": "2023-11-23T00:00:00Z"
  }
}

Response

Updated impact data

Example response

{
  "identifier": {
    "supplierId": "SAP-12345",
    "customerId": "CRM-67890",
    "ownId": "OWN-SITE-01",
    "prewaveId": 102006215,
    "source": "SAP"
  },
  "impactData": {
    "atSupplierLocation": "SameBuilding",
    "atSupplierDeviation": "OnTarget",
    "atSupplierLastConfirmedDate": "2023-11-23T00:00:00Z",
    "validFrom": "2026-01-01T00:00:00Z",
    "validTo": "2026-12-31T23:59:59Z"
  }
}

Changes