Suppliers - Sites Upsert

Upsert suppliers and their desired collections with a full load.

Changed on

⚠️ DEPRECATED - This endpoint is deprecated and will be removed on 31 May 2027.

Migration: POST /public/v2/suppliers/sites to create sites, GET /public/v2/suppliers/sites/pending to track processing.

Full load means that all sites need to exist in the request payload. Existing sites not part of the payload will be removed from the managed collections in this request.

Required permission: create_sites_upsert_requests

Performance impact: Medium

post/public/v1/sites-upsert/full

Request

Request body

dryRunboolean required

If set to true, the request will be processed without actually writing to the database.This is useful for testing purposes. |Use endpoints {requestId}/dry-runs and dry-run/{id} to get the status and the results of your dry-runs.

Example request

{
  "siteData": [
    {
      "countryCode": "AT",
      "addressLine": "Rothschildplatz 4, 3rd Floor",
      "postalCode": "1020",
      "industries": [
        {
          "industry": "I_AUTOMOTIVE",
          "industryStandard": "MOCK-ISO-42"
        }
      ],
      "website": "https://www.prewave.com",
      "yourReference": {
        "id": "ERP-ID-123",
        "source": "erp"
      },
      "additionalReferences": [
        {
          "id": "ERP-ID-123",
          "source": "erp"
        }
      ],
      "connectionType": "Supplier",
      "spendData": 500000,
      "collectionNames": [
        "product group",
        "responsible supplier manager",
        "responsible team",
        "region",
        "product"
      ],
      "externalReferences": [
        {
          "externalId": "DUNS_123",
          "system": "duns"
        }
      ],
      "impactData": {
        "year": 2024,
        "bi12MlnEuro": 20,
        "grossMttrEMonths": 2,
        "grossMttrIMonths": 4,
        "cocSigned": true
      },
      "safetyStock": {
        "onPremiseStockLevelMonths": 2,
        "atSupplierLocation": "SameBuilding",
        "atSupplierDeviation": "OnTarget",
        "atSupplierStockLevelMonths": 4,
        "atSupplierLastConfirmedDate": "2023-11-23",
        "inLogisticChainDaysOnHand": 40
      }
    }
  ]
}

Response

Request created successfully

requestIdstring uuid required

The ID of a sites upsert request. Use this ID to check the status of the request and to retrieve dry-run ids.

Changes

    • breaking

      added to the // request property allOf list

    • breaking

      added to the // request property allOf list

    • warning

      removed from the // request property allOf list

    • warning

      removed from the // request property allOf list

    • info

      endpoint deprecated