Skip to main content
Release: CX-Neptune (Preview)

Conformity Assessment Criteria

This document lists the conformity assessment criteria for CX-0164 Blocking Notifications v1.0.0.

Overview

Conformity assessment is performed via self-assessment. All criteria marked as MUST are mandatory for certification.

Conformity Criteria Table

CaC-IDRequirementLevelTest MethodReference
CaC-1Block Notification data model (v1.0.0) MUST be implemented conformantlyMUSTSelf-assessment§3.1
CaC-2Create operation (/create) MUST be implementedMUSTSelf-assessment§4.1.2
CaC-3Update operation (/update) with partsToAdd / partsToUpdate and updateable master-data fields MUST be implementedMUSTSelf-assessment§4.1.2
CaC-4Remove operation (/remove, cancels parts or the whole notification) MUST be implementedMUSTSelf-assessment§4.1.2
CaC-5Feedback operation (/feedback) MUST be implementedMUSTSelf-assessment§4.1.2
CaC-6Single Connector assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. (BlockNotificationAPI) per CX-0151 MUST be registeredMUSTSelf-assessment§4.1.3
CaC-7MessageHeaderAspect v3.0.0 MUST be used in header of all requestsMUSTSelf-assessment§3.1.2
CaC-8Context format Blocking-BlockNotificationAPI-<Operation>:1.0.0 MUST be usedMUSTSelf-assessment§3.1.4
CaC-9Usage Policies MUST be defined per CX-0152MUSTSelf-assessment§2.1.3
CaC-10Data exchange MUST occur only via CX-0018 compliant ConnectorMUSTSelf-assessment§2.1.3
CaC-11All operations MUST use HTTPHTTP HTTP is an application-layer protocol for transmitting hypermedia documents (such as HTML). It was designed for communication between web browsers and web servers, but can also be used for other purposes. POST method onlyMUSTSelf-assessment§4.1.2
CaC-12messageId MUST be unique (UUIDv4) and MUST NOT be reusedMUSTSelf-assessment§2.1.3

Detailed Requirements

CaC-1: Data Model Implementation

The implementation MUST conform to the schemas defined in the OpenAPI specification block-notification-api-v1.0.0.yaml. This includes:

  • BlockNotificationCreate
  • BlockNotificationUpdate
  • BlockNotificationRemove
  • BlockNotificationFeedback

CaC-2 to CaC-5: API Operations

All four APIAPI An API is a way for two or more computer programs to communicate with each other. operations MUST be implemented:

OperationEndpointRequired
Create/createYes
Update/updateYes
Remove/removeYes
Feedback/feedbackYes

CaC-6: Single Connector Asset

Per CX-0151 §4.1.4, exactly one assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. MUST be defined in the connector for the Block Notification APIAPI An API is a way for two or more computer programs to communicate with each other.. The assetAsset On the Data Provider side, an Asset describes the data set which will be shared or can be consumed by a Data Consumer. MUST have:

{
"@id": "BlockNotificationAPI",
"properties": {
"dct:type": { "@id": "https://w3id.org/catenax/taxonomy#BlockNotificationAPI" },
"cx-common:version": "1.0"
}
}

CaC-7: MessageHeaderAspect

All requests MUST include a header object compliant with MessageHeaderAspect v3.0.0 containing:

  • messageId (unique UUID)
  • context (operation-specific)
  • sentDateTime (ISO 8601)
  • senderBpn (BPNLBPNL The unique identifier of a legal entity of a partner within Catena-X (e.g., a company).)
  • receiverBpn (BPNLBPNL The unique identifier of a legal entity of a partner within Catena-X (e.g., a company).)
  • version ("3.0.0")

CaC-8: Context Format

The context field MUST follow the pattern Blocking-BlockNotificationAPI-<Operation>:1.0.0 where <Operation> is one of:

  • Create
  • Update
  • Remove
  • Feedback

CaC-9 & CaC-10: Policy and Connectivity

  • Usage policies MUST be defined according to CX-0152
  • All data exchange MUST occur via a CX-0018 compliant connector

CaC-11: HTTP Method

All APIAPI An API is a way for two or more computer programs to communicate with each other. endpoints MUST accept HTTPHTTP HTTP is an application-layer protocol for transmitting hypermedia documents (such as HTML). It was designed for communication between web browsers and web servers, but can also be used for other purposes. POST requests only. Other HTTPHTTP HTTP is an application-layer protocol for transmitting hypermedia documents (such as HTML). It was designed for communication between web browsers and web servers, but can also be used for other purposes. methods (GET, PUT, PATCH, DELETE) are not supported.

CaC-12: Message ID Uniqueness

The messageId field in the header MUST:

  • Be a valid UUIDv4 (with or without urn:uuid: prefix)
  • Be unique per message
  • Never be reused across different notifications

Copyright © 2026 Catena-X Automotive Network e.V. All rights reserved. For more information, please visit here.