Integration without Synchronization

In this scenario the host system integration will be tighter and the effort to implement it will be higher. But the synchronization of changes made in the Export Controls web application to a host system still falls out of this scope.

A user (order processor) of a host system creates or updates a business transaction (e.g., an order). The host system then calls, if all mandatory data was entered, a checkTransaction() request with a host- system-generated transactionId using the Export Controls API.

Export Controls performs all configured checks and creates a log entry. If a restriction was detected, a check transaction is generated and stored in Export Controls. A response is sent back to the host system. The host system uses the response results to store the results along with the order. If the response suggested an export restriction, the host system blocks the order. Additionally, the order processor may be informed about the blocked order.

Some time later, the export control officer then uses the Export Controls web application to check the created transaction and perhaps approves or rejects it. There is no automatic feedback to the host system for this action.

Either the order processor manually triggers a re-check of the order, or a batch job can be created that runs, e.g., once a day to re-check all blocked/critical orders. Then the host system again calls checkTransaction() for the same order (using the same transaction Id (API: transactionIdHost)). Depending on whether the Export Control officer approved the transaction, the result of the check might now turn into "not critical".

🚧

Warning

Use the API getTransactionCheckResult only if the host system can ensure, that no data in the transaction has changed in between, as this API does not trigger a new check and thus will not detect changed partners, positions, goods, etc. in the transaction.

The host system has to evaluate the new response result, and remove the previously created blocking of the order in case the result is uncritical. Additionally, the host system might inform the order processor about the update via a popup or other means of notification.

📘

Use the calls of checkTransaction() in moderation, as each call will be billed.

📘

If a business transaction (e.g., an order) is deleted in the host system, no action is required, as deletion of check transactions in the Export Controls web application is not supported and not necessary.