Submit a Transaction

Submit a transaction to the EU information system.

Submitting a transaction to the EU information system involves multiple steps. First, when you submit a transaction using the PUT /transaction/{id}/submit endpoint, the status is set to TO_SUBMIT. Within approximately five minutes, our asynchronous processing system picks up the job and submits the transaction to the EU information system TRACES. Once the submission is successful, the status updates to SUBMITTED.

The current status of a transaction can be checked at any time by polling the: GET /transaction/{id} endpoint.

Currently, all transactions are submitted to the TRACES Acceptance environment, which is a test environment and not legally binding.

Submit a transaction to be sent to traces.

put

Update the status property of a transaction to TO_SUBMIT.

Authorizations

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.tradeaware.live-eo.com/transactions/{id}/submit' \
  --header 'Authorization: Bearer JWT'

202

400

401

403

404

409

422

202

{
  "id": "02c36247-1aad-41ba-aa49-f114ca4c263f",
  "status": "DRAFT",
  "customId": "DEC-24-238620",
  "activityType": "EXPORT",
  "countryOfActivity": "IT",
  "isGeoLocationConfidential": "false",
  "components": [
    {
      "id": "02c36247-1aad-41ba-aa49-f114ca4c263f",
      "hsn": "18010000",
      "commodity": "oil palm",
      "quantity": 123.45,
      "unit": "KGM",
      "description": "text",
      "namePairs": [
        {
          "commonName": "soybean",
          "scientificName": "Glycine max"
        }
      ],
      "transactionId": "02c36247-1aad-41ba-aa49-f114ca4c263f",
      "dateOfProduction": "2021-01-01T00:00:00.000Z",
      "endDateOfProduction": "2021-01-01T00:00:00.000Z",
      "createdAt": "2023-07-26T15:03:48Z",
      "updatedAt": "2023-07-28T09:13:37Z",
      "supplierBusiness": "[Circular Reference]"
    }
  ],
  "customData": {
    "key1": "someValue",
    "key2": true,
    "key3": 1234
  },
  "dds": {
    "id": "02c36247-1aad-41ba-aa49-f114ca4c263f",
    "submitted": false,
    "submittedAt": "2023-07-26T15:03:48Z",
    "tracesDdsReferenceNumber": "25DEPPQEM17212",
    "tracesDdsVerificationNumber": "KZ4BVOCZ",
    "errors": [
      "Error message"
    ],
    "createdAt": "2023-07-26T15:03:48Z",
    "updatedAt": "2023-07-26T15:03:48Z"
  },
  "createdAt": "2023-07-26T15:03:48Z",
  "updatedAt": "2023-07-28T09:13:37Z"
}