Create harvest orders

Article • 4/9/2025 • 7 min read

A harvest order is a predefined plan for harvesting resources such as timber or crops, ensuring sustainability and environmental protection. This plan provides you with predictable resource availability, economic stability, and compliance with legal regulations, fostering long-term sustainability and responsible resource management.

Once the harvest order is set to active, you can manually change its status regardless of the agricultural location’s status.

With this feature, you can generate a harvest order based on the status of the associated agricultural location. The statuses of both the agricultural location and the harvest order are detailed in the table below.

Status of the agricultural location	Harvest Order	Status of the harvest order
No Use	Cannot be created	---
Inactive	Created	Inactive
Active	Created	Active, Inactive

The following procedure describes how to create a new harvest order.

Select the Search icon , enter Harvest Orders, and then choose the related link.
The Harvest Orders list page opens.
On the action bar, select New.
The Harvest Order card page opens.

On the General FastTab, enter the required information:

Field	Description
No.	Enter a value from the lookup table. It indicates the number of the involved entries or records according to the specified number series.
Agricultural Location No.	Enter the relevant number of agricultural locations linked to the harvest order.
Description	Specifies the description of the agricultural location linked to the harvest order.
Address	Specifies the address of the agricultural location linked to the harvest order.
Post Code	Specifies the postcode of the agricultural location linked to the harvest order.
City	Specifies the city of the agricultural location linked to the harvest order.
No. of Blanket Purchase Orders	Specifies the number of blanket purchase orders linked to the harvest order.
Status	Specifies the status of the harvest order. It is automatically filled with Active by default, and then it inherits the status of the assigned agricultural location.
Grower No.	Specifies the grower number to which the harvest order is linked.
Grower Name	Specifies the name of the grower to which the harvest order is linked.
Vendor No. (Pay-To)	Specifies the vendor number linked with the agricultural location.
Vendor Name	Specifies the name of the vendor to which the harvest order is linked.
Farm Measurement Unit	Specifies the unit used to measure the farm which is linked to the harvest order.
Farm Size	Specifies the size of the farm linked to the harvest order.

On the Cultivation FastTab, all the fields except Season No. and Calculation based on UoM are automatically populated based on the defined Agricultural Location No. field value.

Field	Description
Season No.	Specifies the season number.
Season Start Date	Specifies the starting date of the season.
Season End Date	Specifies the ending date of the season.
Calculation based on UOM	Specifies the base unit of measure based on which calculation is done. When an item is selected, the field is non-editable else it can be entered manually.
Cultivation	Specifies the type of crops grown in the agricultural location linked to the harvest order.
Type of Cultivation	Specifies the type of cultivation technique adopted in the agricultural location linked to the harvest order.
Product Based (Commodity Item)	Specifies the commodity item assigned to the agricultural location linked to the harvest order.
Product Based (Item Category)	Specifies the item category assigned to the agricultural location linked to the harvest order.
Product Based (Item)	Specifies the items assigned to the agricultural location linked to the harvest order.

On the Lines FastTab, you can view the details in the following fields.

Field	Description
Type	Specifies the type of the item associated to the harvest order.
Item Category	Specifies the category that the item belongs to.
Commodity Item No.	Specifies the number of the commodity item associated to the harvest order.
Item No.	Specifies the number of the item asssociated to the harvest order.
Product	Specifies the value of global lot attribute 1 associated to the item.
Variety	Specifies the value of global lot attribute 2 associated to the item.
Size	Specifies the value of global lot attribute 3 associated to the item.
Color	Specifies the value of global lot attribute 4 associated to the item.
Class	Specifies the value of global lot attribute 5 associated to the item.
Label	Specifies the value of global lot attribute 6 associated to the item.
Plot No.	Specifies the plot number linked to the harvest order.
Location Code	Specifies the location code linked to the harvest order line from which the purchase order, blank purchase order or commodity receipt is created. This field is mandatory to create a harvest order document. You can change the code if documents such as purchase orders, blanket purchase orders, and commodity receipts already exist for the selected line.
Unit of Measure	Specifies the expected quantity of the total harvest. You cannot change this value once a document is created from this line.
Expected Qty. to Harvest	Specifies the quantity used in the creation of purchase order, blanket purchase order and commodity receipt.
Qty. to Harvest	Specifies the quantity used in the creation of purchase order, blanket purchase order and commodity receipt.
Qty. on Purch. Order	Specifies the total quantity of unposted purchase orders. It does not include the received quantity in lots.
Qty. on Commodity Receipt	Specifies the total quantity of unposted commodity receipts. It does not include the received quantity in lots.
Qty. on Blanket Purch. Order	Specifies the total quantity of unposted blanket purchase orders. It does not include the received quantity in lots.
Open Qty. in Purchase Contract	Specifies the total quantity of unposted purchase contracts. It does not include the quantity received in lots. This field is visible only when the Aptean Contract Management extension is integrated with the Aptean Commodity Harvest Planning extension.
Harvested Qty.	Specifies the received harvest quantity.
Remaining Qty. to Harvest	Specifies the remaining quantity of the total harvest. It is internally calculated based on the expected quantity to harvest, harvested quantity, and open quantity to harvest values.
Exp. Qty in m²: Integer	Specifies the expected harvest area in square metres (m²). For example, you can harvest 500 m² of cucumbers.
Exp. Yield in Purchase UoM: Integer	Specifies the expected harvest amount based on the purchase unit of measure.
Exp. Yield in Base UoM per m²: Integer	Specifies the expected harvest amount based on the base unit of measure.
Flowers/Plants per m²	Specifies the number of flowers or plants per unit of measure, such as per square metre (m²).

On the action bar, select Register to register the harvest order.
The harvest order is registered.

You cannot select a season with the Closed field set to Yes.
You cannot delete a harvest order when it is linked with posted documents.

You can create commodity receipts, purchase orders, blanket purchase orders, week forecasts and day forecasts directly from a harvest order from the header level or the line level.

For header level, on the action bar, execute the following actions as required.

Action	Description
Create Commodity Receipts	Create commodity receipts for all harvest order lines with the Type field set to Commodity Item. The system creates one commodity receipt per commodity item.
Create Purchase Order	Create a purchase order for all the harvest order lines. For more information, see Create purchase or blanket purchase orders from harvest orders.
Create Blanket Purchase Order	Create a blanket purchase order all the harvest order lines. For more information, see Create purchase or blanket purchase orders from harvest orders.
Create Purchase Contract	Create a purchase contract all the harvest order lines. For more information, see Create purchase contracts from harvest orders. This action is available only when the Aptean Contract Management extension is installed.
Create Week Forecast	Create a week forecast for all the harvest order lines. For more information, see Create week or day forecasts from harvest orders.
Create Day Forecast	Create a day forecast for all the harvest order lines. For more information, see Create week or day forecasts from harvest orders.
Register	Register the harvest order.

For line level, on the Lines FastTab, select the required lines, and then execute the following actions as required.

Action	Description
Create Commodity Receipt	Create a commodity receipt for the selected harvest order lines with the Type field value set to Commodity Item. The system creates one commodity receipt per commodity item.
Create Purchase Order	Create a purchase order for the harvest order lines. For more information, see Create purchase or blanket purchase orders from harvest orders.
Create Blanket Purchase Order	Create a blanket purchase order for the harvest order lines. For more information, see Create purchase or blanket purchase orders from harvest orders.
Create Purchase Contract	Create a purchase contract for the harvest order lines. For more information, see Create purchase contracts from harvest orders. This action is available only when the Aptean Contract Management extension is installed.
Create Week Forecast	Create a week forecast for the harvest order lines. For more information, see Create week or day forecasts from harvest orders.
Create Day Forecast	Create a day forecast for the harvest order lines. For more information, see Create week or day forecasts from harvest orders.