Transactions

Transactions endpoint allow users to create, modify and delete transactions and their components.

Transactions

Check the User Guide: Transaction Management to learn more.

Transactions can be of four different activityTypes:

1. 'IMPORT'

2. 'EXPORT'

3. 'TRADE'

4. 'DOMESTIC'

and are tied to a countryOfActivity, the country in which the activity takes place. For imports, this is the country of entry into the EU. For exports, the country of exit from the EU. For Domestic Production and Trade, EU country where goods are sourced, manufactured or produced or made available on the market.

Transaction Components

A transaction can have multiple components. Transaction components are batches or shipments of one or more goods. They have an hs code as well as information about the amount and unit that is being shipped or traded. A transaction can have two types of components:

1. DDS Reference Components contain products that have already been submitted to the EU Information System before and therefore already have a DDS reference and verification Number.

2. Internal Supplier Components contain products that have not yet been submitted to the EU Information System yet. For these components, the platform uses the TradeAware supplierId to identify the relevant plots of the supplier and their subsuppliers. These identified plots will then be integrated into the request submitted to the EU Information System.

Transaction Status

When a transaction is created, its initial status is set to DRAFT. While in the DRAFT state, the transaction and its components can be freely modified or deleted.

Once the transaction is submitted via the PUT /transactions/:id/submit endpoint, its status changes to TO_SUBMIT, and further modifications are no longer allowed.

The status then progresses asynchronously and can be retrieved using GET /transactions/:id. The transaction follows these possible status updates:

1. DRAFT → Initial state where modifications are allowed.

2. TO_SUBMIT → Transaction is pending submission to TRACES.

3. SUBMITTED → The transaction has been successfully submitted to TRACES but is still awaiting validation.

   • DDS reference and verification number are not assigned immediately in this state.

   • The validation process can take anywhere from a few minutes to several hours, depending on TRACES' response times

4. WITHDRAWN → The transaction was withdrawn before completion and is no longer active.

⚠️ Important Notes:

• Transactions in DRAFT, TO_SUBMIT, or WITHDRAWN statuses do not return a DDS reference or verification number.

Permissions

Your business must be entitled to access this endpoint. If you run into Error 403, please contact your Customer Success Manager.