PRprewave
Suppliers - Sites Upsert

Upsert suppliers and their desired collections with a delta 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.

In contrast to the full load, the delta load only updates the sites in the payload. Existing sites not part of the payload will not be removed from managed collections.

Required permission: create_sites_upsert_requests

Performance impact: Medium

post/public/v1/sites-upsert/delta

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

  • cedf01f35c95Revision 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

  • d08b2fe6a84fRevision changes
    • info

      endpoint deprecated