UN Comtrade upgrade plan 2018

All UN Comtrade-related dissemination sites will be gradually upgraded in 2018 to take advantage of new data items and features. A brief list of the planned new features is shown below. A more detailed User Guide on the new features will be available soon in our website

2018 Q1 Q2 Q3 Q4
Legacy Merchandise Trade/Services Statistics UI (ending)
Data API/UI v.1 (ending)
Data API/UI v.2   (starting)


Important milestones:


  • Current data services (data interface, data API and bulk API v.1) will only be available until the end of the year
  • By Quarter 3, it is expected that data API v.2 will be available; users will be able to query data and metadata via the new data interface v.2; and, in addition, bulk data API v.2 will be released.
  • By Quarter 4, legacy merchandise monthly and services interfaces, web services and batch processing options will be discontinued.


Previous System

Upgrades made with new system

Result for Comtrade Users

Three separate processing systems for annual and monthly Merchandise Trade Statistics and Trade in Services

One integrated processing system for all trade data

Improved consistency and timeliness of dissemination of trade data. Monthly Merchandise Trade Statistics will be disseminated the same way as annual Merchandise Trade Statistics data (e.g., will be converted to other classifications and missing quantities will be estimated)

Data items for Merchandise Trade Statistics included trade by commodity and by partner

In addition, new data items now include (when reported):

  • mode of transport
  • customs procedure codes
  • 2nd partner

More information on the nature of trade flows and partner country attribution, allowing for better analysis of bilateral trade asymmetries

Single valuation for Merchandise Trade Statistics imports (at CIF) and exports (at FOB)

In addition, FOB valuation for imports (when reported)

Symmetrical valuation of imports and exports and more information on insurance and freight costs, allowing for better analysis of bilateral trade asymmetries

Trade flows for Merchandise Trade Statistics consisted of Total Exports: Re-exports; Total Imports; and Re-Imports

Expanded breakdown of trade flows for Merchandise Trade Statistics (when reported) including Domestic Exports, Export/Import of goods after/for inward processing; Export/Import of goods for/after outward processing; and Export/Import on intra-firm trade

More information on the nature of trade flows, especially re-exports, re-imports, and goods for processing, and intra-firm trade

Merchandise Trade Statistics quantity units standardised to 12 World Customs Organization (WCO) recommended units

In addition, standardization to more quantity units (43+ units), when reported

Additional measures of quantity

Single weight (net weight in kg) for Merchandise Trade Statistics

In addition, gross weight (net weight plus the weight of the shipping or cargo container), when reported

More information on weight and shipping

Limited quantity estimations for Merchandise Trade Statistics (not all commodities estimated)

Estimation of quantity for all commodities; when applicable. However, some may not be shown for specific commodities

More complete quantity data; especially for aggregated data

Conversion for Merchandise Trade Statistics at 6-digit HS level only

Conversion at any HS level and improved conversion of residuals

More complete converted datasets

Only EBOPS2002 data disseminated for Trade in Services (EBOPS2010 data converted to EBOPS2002)

Trade in Services data also disseminated in EBOPS2010 (when reported in EBOPS2010)

Trade in Services data in both EBOPS2002 and EBOPS2010, when reported



Output Examples

Tab Delimited file:

Find attached an Tab Delimited file with sample data from our new dissemination system:  


JSON response example:


{
   "year": 2017,
   "period": 1,
   "reporterAreaCode": 792,
   "reporterAreaDescription": "Turkey ",
   "reporterAreaISOAlpha3": "TUR",
   "flowCode": "M",
   "flowDescription": "Import",
   "partnerGeoAreaCode": 616,
   "partnerGeoAreaDescription": "Poland ",
   "partnerGeoAreaISOAlpha3": "POL",
   "consignmentGeoAreaCode": 703,
   "consignmentGeoAreaDescription": "Slovakia ",
   "consignmentGeoAreaISOAlpha3": "SVK",
   "primaryPartnerGeoAreaCode": 616,
   "primaryPartnerGeoAreaDescription": "Poland ",
   "primaryPartnerGeoAreaISOAlpha3": "POL",
   "cmdCode": 820411,
   "cmdDescription": "Tools, hand; hand-operated spanners and wrenches (including torque meter wrenches but not including tap wrenches), non-adjustable",
   "cmdAggregateLevel": 6,
   "isLeaf": true,
   "classificationCode": "H5",
   "customCode": "C00",
   "customCodeDescription": "All customs procedure codes",
   "motCode": 3200,
   "motCodeDescription": "Road",
   "qtyUnitCode": 8,
   "qtyUnitCodeDescription": "Weight in kilograms",
   "qty": 1279,
   "isQtyEstimated": false,
   "altQtyUnitCode": 8,
   "altQtyUnitCodeDescription": "Weight in kilograms",
   "altQty": 1279,
   "isAltQtyEstimated": false,
   "netWeight": 1279,
   "isNetWeightEstimated": false,
   "grossWeight": 0,
   "cifValue": 7395,
   "fobValue": null,
   "primaryValue": 7395,
   "primaryValueValuation": "CIF",
   "flag": 0,
   "isLeafLevel": true,
   "isReported": false,
   "isAggregate": true,
   "isOriginalClassification": true
 }

For questions, please contact comtrade@un.org