TradeAware
  • Welcome to TradeAware User Guide
    • Getting Started
  • Using the TradeAware Web App
    • Upload and Analyzing Plots
    • Connect with your supply chain
    • Risk Assessment
    • Transaction Management
    • Document Management
    • Plot Upload and Analysis Trouble Shooting
    • How-to videos
  • Using the TradeAware API
    • API Access and Business Account Registration
    • Authentication
      • Rotate client secret
      • Endpoints enabled for programmatic access
    • Plot Uploading and Analysis Requests
    • Commercial network management
    • Transaction Management
    • API reference
      • Auth
      • Plots
        • Analyses of a specific Plot
        • Batch
      • Analyses
      • Attachments
      • Business invitations
      • Business connections
      • Transactions
        • Create a Transaction
        • Retrieve Transactions
          • Get a transaction by id
          • List all transactions
        • Modify an existing Transaction
          • Update a Transaction
          • Add a Transaction Component
          • Update a Transaction Component
          • Delete a Transaction Component
        • Delete a Transaction
        • Submit a Transaction
        • Retrieve DDS Data
      • Risk Assessments
        • Supplier Risk Assessments
          • Create a Supplier Risk Assessment
          • Update a Supplier Risk Assessment
          • Retrieve Supplier Risk Assessments
            • Get a supplier risk assessment by id
            • Get all supplier risk assessments
          • Retrieve the history
        • Plot Risk Assessments
          • Create a Plot Risk Assessment
          • Update a Plot Risk Assessment
          • Retrieve Plot Risk Assessments
            • Get a plot risk assessment by id
            • Get all plot risk assessments
          • Retrieve the history
      • Survey responses
      • Health
      • Version
      • Specification
  • Additional Resources
    • FAQs
    • Contact Support
    • Terms and Conditions
Powered by GitBook
On this page
  • Transactions
  • Transaction Components
  • Transaction Status
  • Permissions
  1. Using the TradeAware API
  2. API reference

Transactions

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

PreviousBusiness connectionsNextCreate a Transaction

Last updated 2 months ago

Transactions

Check the 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 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.

User Guide: Transaction Management
hs code