Submit CO

Initiating the DTO (or essCert ) Process

Every CO certificate gets submitted to the Chamber using Submit CO Application endpoint.

HTTP

https://api.tradecert2.net/api/v1/cert/CO

Request

Security standards are pretty much the same as for the other endpoints where an Authentication Token is passed under the Authorization header. Here is a sample cURL for the Submit CO endpoint.

cURL

curl --location --request POST 'https://api.tradecert2.net/api/v1/cert/CO' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJraWQiOiJDeHBweFAycjhtSm5xRnVicjVQQm5QU2RoWmFtK1JpakJkcU9CNTlGVVwvdz0iLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJhYzA1ZTk2MS1hZWI2LTQ5NTMtOTVjNy02NjMwOGFmNTQ2ODAiLCJldmVudF9pZCI6Ijg5YzY2ZmNmLThlN2MtNDE1YS04Y2VlLWIyMGI1YWJmNjRmNSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE2Mzg1Mjk2MjEsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC5ldS13ZXN0LTEuYW1hem9uYXdzLmNvbVwvZXUtd2VzdC0xXzVkUWhLMWxqSCIsImV4cCI6MTYzODUzMzIyMSwiaWF0IjoxNjM4NTI5NjIxLCJqdGkiOiIyMzJkYjllYS00ODllLTRlOTQtYWE0Yi1mNWE2Y2YxNTBjOTUiLCJjbGllbnRfaWQiOiIxdWxmdnUycDhhZnN2Z2VwcGdrOXNiMDExcCIsInVzZXJuYW1lIjoiam9obmF1c2NsaWVudCJ9.kc-Gij7PzkHBXqdZIJZTvPgXzIvB882RKkgcJOIrOSrX8Kep00Ig9ZgfvLp0tkweUGR9EipYtAS1YkjrESRWxBUKXZ3HMNOccUyYepoHJ8Or0CF_aY2IZOd4yYRpwAavVt8WybFz4VzCOEltoVC8ig07fhuTLxgB_NEZJZ64eAXDg0rUHIK9Ww8TgdqDpfuw7kamjRxrrBaFLt6DQliintBmZbN6Lw-VhEN0C1tbyGAYtm2O4LORag7fPFMjSP-DtXPS3JsvvhbPurTBGIunjLAiRnICPWGKGBOba5zC91U-1ZkMKB2BHxEY4CukRQJc7DyVRj1CcWbbYpa2Jy6heA' \
--data-raw '{
"Options": {
"Service": "DIY",
"ReturnOrigBy": "Comment",
"Comments": "This is a comment",
"ClientReferenceNumber": "Client ref",
"PurchaseOrderNumber": "Po Number"
},
"cocert": {
"ConsignorRef": "Cons Ref",
"Consignor_1": {
"name": "Con Name",
"city": "Con City",
"CountryISOCode": "IE",
"name2": "Con Name2",
"address1": "Con addr1",
"address2": "Con addr2",
"address3": "Con addr3",
"state": "Con state",
"zip": "Con zip"
},
"Consignee_2": {
"name": "Cons2 name",
"city": "Cons2 city",
"CountryISOCode": "GB",
"name2": "Cons2 name2",
"address1": "Cons2 addr1",
"address2": "Cons2 addr2",
"address3": "Cons2 addr3",
"state": "Cons2 state",
"zip": "Cons2 zip"
},
"CountryOfOrigin_3": "IE",
"Quantity_7": "Quanity 7",
"DestinationCountry": "Germany",
"Originals": "1",
"Copies": "0",
"TransportDetails_4": "Trans details",
"Remarks_5": "Remarks 5",
"DescriptionOfGoods_6": "Des of goods"
},
"Attachment": [
{
"name": "not an invoice",
"attType": "Bill of Lading",
"pdf": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago8PC9MZW5ndGggMjE5L0ZpbHRlci9GbGF0ZURlY29kZT4+c3RyZWFtCnicjU+xbsIwFNzfVxwTMEDsUEdlbAUMbFW9oQ4osWmq4BST5HtZs/Qb+mwJqFCRkPVs+d29u3sCEhMJATVXfOd7OtCrplkGpebQBS01vVGKdegGnsCZrfeUrCSkgLY0GuuvwL1SohjDfPwuCmYZMqUwSQW8IftXMfrNLpJPQVJEjGdHL23eOoOidq43cENzbND4uu36Ad6HZYWubo/4rrY/DbbWls54bjXesE/+aTzXNOQT2P2TcfPBbxF3vEFuAqbqXsCFgZCJ7Ts/TRg7IX2+/qx/yPsXFCNd3gplbmRzdHJlYW0KZW5kb2JqCjEgMCBvYmoKPDwvR3JvdXA8PC9UeXBlL0dyb3VwL0NTL0RldmljZVJHQi9TL1RyYW5zcGFyZW5jeT4+L1BhcmVudCA0IDAgUi9Db250ZW50cyAzIDAgUi9UeXBlL1BhZ2UvUmVzb3VyY2VzPDwvUHJvY1NldCBbL1BERiAvVGV4dCAvSW1hZ2VCIC9JbWFnZUMgL0ltYWdlSV0vQ29sb3JTcGFjZTw8L0NTL0RldmljZVJHQj4+L0ZvbnQ8PC9GMSAyIDAgUj4+Pj4vTWVkaWFCb3hbMCAwIDU5NSA4NDJdL1JvdGF0ZSA5MD4+CmVuZG9iago1IDAgb2JqClsxIDAgUi9YWVogMCA2MDUgMF0KZW5kb2JqCjIgMCBvYmoKPDwvQmFzZUZvbnQvSGVsdmV0aWNhL1R5cGUvRm9udC9FbmNvZGluZy9XaW5BbnNpRW5jb2RpbmcvU3VidHlwZS9UeXBlMT4+CmVuZG9iago0IDAgb2JqCjw8L0lUWFQoMi4xLjcpL1R5cGUvUGFnZXMvQ291bnQgMS9LaWRzWzEgMCBSXT4+CmVuZG9iago2IDAgb2JqCjw8L05hbWVzWyhKUl9QQUdFX0FOQ0hPUl8wXzEpIDUgMCBSXT4+CmVuZG9iago3IDAgb2JqCjw8L0Rlc3RzIDYgMCBSPj4KZW5kb2JqCjggMCBvYmoKPDwvTmFtZXMgNyAwIFIvVHlwZS9DYXRhbG9nL1ZpZXdlclByZWZlcmVuY2VzPDwvUHJpbnRTY2FsaW5nL0FwcERlZmF1bHQ+Pi9QYWdlcyA0IDAgUj4+CmVuZG9iago5IDAgb2JqCjw8L0NyZWF0b3IoSmFzcGVyUmVwb3J0cyBcKGNpX3N0YXRlbWVudFwpKS9Qcm9kdWNlcihpVGV4dCAyLjEuNyBieSAxVDNYVCkvTW9kRGF0ZShEOjIwMTQwMzMxMjMxMTU4KzAxJzAwJykvQ3JlYXRpb25EYXRlKEQ6MjAxNDAzMzEyMzExNTgrMDEnMDAnKT4+CmVuZG9iagp4cmVmCjAgMTAKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMzAxIDAwMDAwIG4gCjAwMDAwMDA1ODAgMDAwMDAgbiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwNjY4IDAwMDAwIG4gCjAwMDAwMDA1NDUgMDAwMDAgbiAKMDAwMDAwMDczMSAwMDAwMCBuIAowMDAwMDAwNzg1IDAwMDAwIG4gCjAwMDAwMDA4MTcgMDAwMDAgbiAKMDAwMDAwMDkyMCAwMDAwMCBuIAp0cmFpbGVyCjw8L1Jvb3QgOCAwIFIvSUQgWzwzMmJmYmVkYjczYzE1OWYxZmViNmJhMDc4YTRhNDUwZT48MjdlZDdhZDIyNTUwOWIzNTgzZDQxNDExNzZlYzU3NTM+XS9JbmZvIDkgMCBSL1NpemUgMTA+PgpzdGFydHhyZWYKMTA4MgolJUVPRgo="
}
],
"InvoiceDetails": {
"invoiceNumber": "12345",
"invCurrency": "EUR",
"invAmount": "500.34"
}
}'

📘

Request Body

Object detailing of request body along with descriptions and datatype is provided within Submit CO Application

Response

A successful submission with proper Request Body provides a 200 response as below.

JSON

{
    "responseCode": 0,
    "message": "Success",
    "applicationId": "2151923"
}

🚧

Error Responses

Standard error responses like 4xx or 5xx are identified through the response header with a message returned in the body having additional details from the essCert API.

e.g. A 403 Forbidden will have the below response body.

{
"Message": "Access Denied"
}

Quote & Submit

The Submit COendpoints also support consumers in getting the quote values based on the provided serviceTag value. The quotation value is calculated per the invoice details and certificate value sent in the request. The response is retrieved according to the serviceTag enum-based parameter provided.

Draft: Draft means an Application created but not submitted to the chamber.

DIY: DIY indicates that the application submitted to the chamber is a DIY. This will result in a retrieved diyCost value in the response

FS: FS means the Application is submitted to the chamber as Full Service. This will result in a retrieved fsCost value in the response

Based on the above, the response parameters are filled as below.

JSON

{
  "response_code": 200,
  "message": "Success",
  "applicationId": "1",
  "diyCost": "92.40",
  "fsCost": "102.95",
  "shippingHandlingCost": "0"
}