Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

About the

...

data

Commodity balances show the balance of staple foods. The purpose of this domain is to show the consumption, import, and export of these staple foods for each country. 

...

Info

The Hub uploads Historical Commodity Balance Sheet data. If users have questions about this domain or run into issues with uploading or exporting data, please submit a helpdesk ticket with a detailed description of the issue and the path taken to arrive at the issue. 

Data

...

upload process

Preparing

...

data for

...

upload

Each file should contain the following columns or their equivalent names at a minimum: 

  1. Country

  2. Item (Indicator)

  3. Crop (Commodity) 

  4. Data Source Document

  5. Values (periods as one column or multiple periods/columns)

Indicators and crop names should be standardized, meaning it is recommended to stick to the names used in the previous periods if possible.

A file may contain other columns; if so, they can still be loaded as long as the required fields above are included. 
Note
Tip

It is best practice to use the same indicator and crop names as used in previous periods if possible.

Currently, the FDW will recognize the following column headers: datasourcedocument , data_source_organization , data_source_document , schedule , data_usage_policy , country , geographic_group , fewsnet_region , start , end , id , created , modified , specialization_type , name , description , metadata , geographic_unit , indicator , is_calculated , _search , _country , datausagepolicy , original_data_source , product , unit , dataseries_ptr.

Note

Important: If you regularly receive a document from a non-FEWS NET source that contains alternate column headings, do not edit the column headings every time. Instead, submit a help desk ticket so the Hub can add the headings as aliases to the system.

If the unit type is not specified, the default unit type will be used:

  • 1000 t for weight units (indicators like Net Supply, Export, Requirements etc.)

  • Percent for indicators Self-Sufficiency and Stock to Use

  • Person for Population indicator

  • 1 kg for Consumption per capita per year

Importing commodity balance sheet data

Commodity balance sheet data must be uploaded twice: under Commodity

...

Balances and Commodity Balance Values.

  1. Go to Dataseries Management > Commodity Balances > Commodity Balances.

  2. Click Import Commodity Balances.

  3. Click Choose File and select your spreadsheet to load the file.

  4. Load Click Submit and the same file from Step 1 into the Commodity Balance Value screen. Select: file will be in draft status. 

  5. Go to Dataseries Management > Data Points > Commodity Balance Value. Utilizing the same file in Step 1, click the Values.

  6. Click Import Commodity Balance Values button and upload the file in the appropriate format. .

  7. Click Choose File and select the same spreadsheet to load the file.

  8. Click Submit and the file will be in draft status. 

Accessing

...

commodity balance sheet data

There are four endpoints that allow retrieving Commodity Balance data:

...