openapi: 3.2.0 info: title: BSM (TEST2) HTTP BSM Sync API description: Thank you for using our HTTP API documentation. version: '1.0' servers: - url: https://rz3.aeb.de/test2bsm/rest security: - SWAGGER_AUTH_KEY: [] - BASIC_AUTH: [] tags: - name: BSM Sync description: API for synchronizing data asynchronous from an engine to a client system paths: /BSMSyncBFBean/acknowledgeEvents: post: tags: - BSM Sync summary: acknowledgeEvents description: Acknowledge events operationId: acknowledgeEvents requestBody: content: application/json: schema: $ref: '#/components/schemas/BSMAcknowledgeEventsRequestDTO' application/xml: schema: $ref: '#/components/schemas/BSMAcknowledgeEventsRequestDTO' responses: default: description: default response content: application/json: schema: $ref: '#/components/schemas/AcknowledgeEventsResponseDTO' application/xml: schema: $ref: '#/components/schemas/AcknowledgeEventsResponseDTO' security: - BASIC_AUTH: [] /BSMSyncBFBean/getNotAcknowledgedEvents: post: tags: - BSM Sync summary: getNotAcknowledgedEvents description: Poll any not acknowledged events for the client system operationId: getNotAcknowledgedEvents requestBody: content: application/json: schema: $ref: '#/components/schemas/BSMSyncEventsRequestDTO' application/xml: schema: $ref: '#/components/schemas/BSMSyncEventsRequestDTO' responses: default: description: default response content: application/json: schema: $ref: '#/components/schemas/SyncEventsResponseDTO' application/xml: schema: $ref: '#/components/schemas/SyncEventsResponseDTO' security: - BASIC_AUTH: [] /BSMSyncBFBean/getPartnerSystemSubscriptions: post: tags: - BSM Sync summary: getPartnerSystemSubscriptions description: Fetch a list of registered partner system subscriptions operationId: getPartnerSystemSubscriptions requestBody: content: application/json: schema: $ref: '#/components/schemas/BSMGetPartnerSystemSubscriptionsRequestDTO' application/xml: schema: $ref: '#/components/schemas/BSMGetPartnerSystemSubscriptionsRequestDTO' responses: default: description: default response content: application/json: schema: $ref: '#/components/schemas/GetPartnerSystemSubscriptionsResponseDTO' application/xml: schema: $ref: '#/components/schemas/GetPartnerSystemSubscriptionsResponseDTO' security: - BASIC_AUTH: [] /BSMSyncBFBean/subscribePartnerSystem: post: tags: - BSM Sync summary: subscribePartnerSystem description: Subscribe a partner system to receive events for the specified business object type operationId: subscribePartnerSystem requestBody: content: application/json: schema: $ref: '#/components/schemas/BSMSubscribePartnerSystemRequestDTO' application/xml: schema: $ref: '#/components/schemas/BSMSubscribePartnerSystemRequestDTO' responses: default: description: default response content: application/json: schema: $ref: '#/components/schemas/SubscribePartnerSystemResponseDTO' application/xml: schema: $ref: '#/components/schemas/SubscribePartnerSystemResponseDTO' security: - BASIC_AUTH: [] /BSMSyncBFBean/synchronizeEvents: post: tags: - BSM Sync summary: synchronizeEvents description: Poll the next events for the client system operationId: synchronizeEvents requestBody: content: application/json: schema: $ref: '#/components/schemas/BSMSyncEventsRequestDTO' application/xml: schema: $ref: '#/components/schemas/BSMSyncEventsRequestDTO' responses: default: description: default response content: application/json: schema: $ref: '#/components/schemas/SyncEventsResponseDTO' application/xml: schema: $ref: '#/components/schemas/SyncEventsResponseDTO' security: - BASIC_AUTH: [] /BSMSyncBFBean/unsubscribePartnerSystem: post: tags: - BSM Sync summary: unsubscribePartnerSystem description: Unsubscribe a partner system from receiving events for the specified business object type operationId: unsubscribePartnerSystem requestBody: content: application/json: schema: $ref: '#/components/schemas/BSMUnsubscribePartnerSystemRequestDTO' application/xml: schema: $ref: '#/components/schemas/BSMUnsubscribePartnerSystemRequestDTO' responses: default: description: default response content: application/json: schema: $ref: '#/components/schemas/UnsubscribePartnerSystemResponseDTO' application/xml: schema: $ref: '#/components/schemas/UnsubscribePartnerSystemResponseDTO' security: - BASIC_AUTH: [] components: schemas: AcknowledgeEventsResponseDTO: type: object properties: hasErrors: type: boolean description:
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' description: Response DTO for acknowledging events. BSMGetPartnerSystemSubscriptionsRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectType: maxLength: 20 type: string description: Optional. Filter for code which identifies the subscribed business object type. partnerServer: type: string description: The partner server to which the call is redirected. description: Request parameter to fetch all or filtered partner system subscriptions to sync events. BSMSubscribePartnerSystemRequestDTO: required: - businessObjectType type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectType: maxLength: 20 type: string description: Code which identifies the subscribed business object type. description: maxLength: 250 type: string description: Optional description of the subscription. partnerServer: type: string description: The partner server to which the call is redirected. description: Request parameter to subscribe a partner system to sync events. DateAndZoneDTO: type: object properties: dateInTimezone: type: string description: 'String representation of the date/time stamp in the format yyyy-MM-dd HH:mm:ss
Length: 19
' timezone: type: string description: 'Time zone of the time stamp.
Examples of valid time zones: "GMT+01:00" or "GMT-02:00".
Maximum length: 50
' description: Date and timezone. GetPartnerSystemSubscriptionsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' syncPartnerSystems: type: array description: All or filtered registered partner system subscriptions. items: $ref: '#/components/schemas/SyncPartnerSystemDTO' description: Response parameter with fetched partner system subscriptions to sync events. SyncPartnerSystemDTO: required: - businessObjectType - clientSystemId type: object properties: clientSystemId: maxLength: 20 type: string description: Id of the sending client system (e.g. Installation ID of the sending host or ERP system). businessObjectType: maxLength: 20 type: string description: Code which identifies the subscribed business object type. description: maxLength: 250 type: string description: Description of the subscription (optional). description: Identification and other data of a single partner system subscription. SyncEventDTO: type: object properties: businessObjectType: maxLength: 20 type: string description: Code which identifies the business object type the event belongs to. businessObjectQualifier: maxLength: 35 type: string description: Optional qualifier which can be used to specify the object in a more detailed way. businessObjectId: maxLength: 36 type: string description: Unique ID of the business object.This ID is usually needed for subsequent calls, e.g. getBusinessObject(...)
eventType: maxLength: 20 type: string description: Type of the event (e.g. CREATE, UPDATE or DELETE).Depending on the business object type and its configuration, additional event types are possible.
eventDate: $ref: '#/components/schemas/DateAndZoneDTO' syncId: maxLength: 20 type: number description: Monotonously increasing event identifier. parameter: $ref: '#/components/schemas/GenericDataRecordDTO' description: DTO to hold data of one synchronized event. GenericDataFieldDTO: type: object properties: name: type: string description:Name of this field, i.e. the role the field plays in the enclosing record.
When the same name is repeated in the context of the same parent record, it is assumed that the parent defines this element as a repeatable (array) element.
value: type: string description:Value of the field.
The format follows the conventions of xml schema encoding, see http://www.w3.org/TR/xmlschema-2/.
Data type of the field.
This is not strictly necessary since the receiving entity should be able to infer the structure with its own meta data; it may be used however for sanity checks.
The format follows the conventions of xml schema encoding, see http://www.w3.org/TR/xmlschema-2/.
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' syncPartnerSystem: $ref: '#/components/schemas/SyncPartnerSystemDTO' description: Response parameter of a partner system unsubscription from sync events. SubscribePartnerSystemResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' syncPartnerSystem: $ref: '#/components/schemas/SyncPartnerSystemDTO' description: Response parameter of a partner system subscription to sync events. NamedGenericDataRecordDTO: type: object properties: name: type: string description: The name of this record, i.e. the role the record plays in the enclosing record.2-letter ISO code of the language.
length=2
example: en text: type: string description: The translated text. example: Some free-form text description: A translated text in one of the specified languages. BSMAcknowledgeEventsRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' syncId: type: string description: Synchronization ID for acknowledge.Pass this field with the value returned in syncId with the last call to SyncBFBean/getNotAcknowledgedEvents.
length=20
businessObjectType: type: string description: Should be the same value, which was passed with businessObjectType with the last call to SyncBFBean/getNotAcknowledgedEvents. length=20 partnerServer: type: string description: The partner server to which the call is redirected. description: Request DTO for acknowledging events. SyncEventsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' syncId: type: string description: Synchronization ID for delta-transmission.Use this syncId in subsequent calls to SyncBFBean/synchronizeEvents to enable delta-transmission of changes.
However, this syncId may be null if no events are found and the field events is an empty array. In this case use the last NOT NULL syncId returned in this field for subsequent calls to SyncBFBean/synchronizeEvents.
length=20
isComplete: type: boolean description: True, if the synchronization is complete and currently no further events are available. False if not.Because a maximum of 100 events are returned with one call of SyncBFBean/synchronizeEvents, the result may be incomplete.
totalCount: type: integer description: The total number of events that are available, regardless of the fetched block size. Filled only if returnTotalCount was set in request. events: type: array description: The resulting events, matching the requested parameters.A maximum number of 100 events are transmitted per call.
To get ALL events make repeated calls of SyncBFBean/synchronizeEvents, always passing the last returned syncId in the next call with syncId.
items: $ref: '#/components/schemas/SyncEventDTO' description: Response DTO for synchronizing events. GenericDataRecordDTO: type: object properties: fields: type: array description: The fields of the record. items: $ref: '#/components/schemas/GenericDataFieldDTO' subrecords: type: array description: Subrecords of the record. example: - name: child record: fields: [] subrecords: [] items: $ref: '#/components/schemas/NamedGenericDataRecordDTO' description: A generic record of data.Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' syncId: type: string description: Synchronization ID for delta-transmission. In calls to SyncBFBean/synchronizeEvents:
Pass this field with the value returned in syncId with the last call to SyncBFBean/synchronizeEvents.
For initializing of delta-transmissions pass simply null.
In calls to SyncBFBean/getNotAcknowledgedEvents this field is not used.
length=20
businessObjectType: type: string description: Optional parameter to resctrict the events to be polled to that business object type. May be null to get all subscribed events of all business object types.Start the initializing of delta transmission with with this age. Older events will not be synchronized.
format: int32 blockSize: type: integer description: For defining the block size. Can be null. If empty the default block size of 100 is used. format: int32 returnTotalCount: type: boolean description: If set, the total number of available events is returned in the response.Note that requiring the total number of events may lead to substantial performance penalties in the service.
partnerServer: type: string description: The partner server to which the call is redirected. description: Request DTO for synchronizing events. BSMUnsubscribePartnerSystemRequestDTO: required: - businessObjectType type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectType: maxLength: 20 type: string description: Code which identifies the subscribed business object type. partnerServer: type: string description: The partner server to which the call is redirected. description: Request parameter to unsubscribe a partner system from sync events. ResponseMessageDTO: type: object properties: messageType: type: string description: 'Message type
If not stated otherwise, the possible types are:
Maximum length: 50
' example: WARNING messageIdentCode: type: string description: 'Optional identification code for further classification of the message type.
Maximum length: 50
' example: '5627' messageTexts: type: array description:Detailed message texts in the requested languages.
items: $ref: '#/components/schemas/TextInLanguageDTO' indentationLevel: type: integer description:The indentation level of the message.
'0' indicates a top level message.
format: int32 example: 0 description: Result messages like errors or warnings. securitySchemes: SWAGGER_AUTH_KEY: type: apiKey name: X-XNSG_WEB_TOKEN in: header BASIC_AUTH: type: http scheme: basic x-proxy-enabled: false