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.
Update the status property of a transaction to TO_SUBMIT.
Authorizations
Path parameters
idstringRequired
Responses
202Success
application/json
400Error
401Error
403Error
404Error
409
409 Conflict when a transaction is already SUBMITTED, AVAILABLE, WITHDRAWN or PROCESSING.
422Error
put
PUT /transactions/{id}/submit HTTP/1.1
Host: api.tradeaware.live-eo.com
Authorization: Bearer JWT
Accept: */*
{
"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": {
"id": "02c36247-1aad-41ba-aa49-f114ca4c263f",
"email": "[email protected]",
"name": "Example Inc.",
"username": "John Doe",
"addressStreet": "Salawati 143",
"addressZip": "98451",
"addressPostcode": "12345",
"addressArea": "Brandenburg",
"addressCity": "West Papua",
"addressCountryCode": "ID",
"addressCountry": "Indonesia",
"addressLine1": "Salawati 123",
"addressLine2": "3rd floor",
"createdAt": "2023-07-26T15:03:48Z",
"updatedAt": "2023-07-28T09:13:37Z",
"initialLocale": "id-ID",
"units": "metric",
"plots": [
"[Circular Reference]"
],
"newlyCreated": "true",
"members": [
"[Circular Reference]"
],
"connectionsAsSource": [
"[Circular Reference]"
],
"connectionsAsTarget": [
"[Circular Reference]"
],
"businessInvitations": [
"[Circular Reference]"
],
"contactPerson": "[Circular Reference]",
"machineToMachineClientId": "1234567890asdfghjk",
"eori": "text",
"vat": "text"
}
}
],
"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"
}
Last updated