> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camo.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Sales Import

> For customers with this module, we support the following bulk import specs:

### Total Addressable Market (TAM) Product Sales

This import is meant to capture estimated per acre value, broken down by product category and year

***Required fields***

* **price\_per\_acre** - Unit value per acre price, in USD (Example: 104.31, *do not* include any formatting such as currency symbol \$, etc.)
* **year** - 4-digit year (Example: 2025)
* **category** - Platform designated product categories, must be one of:
  * crop\_nutrition
  * crop\_nutrition\_nh3
  * crop\_nutrition\_phosphate
  * crop\_nutrition\_potash
  * crop\_nutrition\_uan
  * crop\_nutrition\_urea
  * crop\_protection
  * farm\_services
  * fungicides
  * herbicides
  * insecticides
  * seed
  * seed\_coating

***Optional fields***

* **county\_geoid** - 5-digit county FIPs code, setting price for a specific county
* **state\_geoid** - 2-digit state FIPs code, setting price for a specific state
* **crop\*** - Commodity code, see list of supported commodities in CSV attached to this help article; used if product has variable pricing depending on the crop commodity

If both ***county\_geoid*** and ***state\_geoid*** are provided, first 2 digits of the county geoid must match state geoid. If neither ***county\_geoid*** or ***state\_geoid*** are provided, price will be universal across the entire nation.

\* List of commodities based on USDA NASS reported crop commodities; reach out to [support@camo.ag](mailto:support@camo.ag) to request missing additions.

### Contact Product Purchases

This import is meant to capture aggregated purchase history per Contact, broken down by product category and year.

***Required fields***

* **purchased\_amount** - Total spend, in USD (Example: 52000, *do not* include any formatting such as currency symbol \$, commas, etc.)
* **year** - 4-digit year (Example: 2025)
* **contact\_id** - Unique customer contact identifier, should match customer Contact 'contact\_id' field (e.g. ERP customer ID or number; Salesforce Account ID; etc)

One of the following:

**product\_name** - Name of product, which should match product definitions linked to Contacts (Examples: Zidua; Xitavo; 3210 Brand; Acuron; Amistar; etc.)

OR

**product\_id** - Product ID, which should match product ID definitions linked to Contacts (Examples: 1234xyz; etc.)

***Optional fields***

* **crop** - Commodity code, see list of [supported commodity codes in this CSV](/assets/commodity-codes.csv) attached to this help article; used if product has variable pricing depending on the crop commodity
* **map\_item\_external\_id** - Internal unique identifier linking the purchase to an imported point or boundary feature of interest (e.g. retail or wholesale location); if provided, must map to an previously imported location (see [Creating Custom Map Layers: Location Points](/hc/en-us/articles/33458881640727-Creating-Custom-Map-Layers-Location-Points-Bulk-Upload))