Managing Grower Contracts

This chapter provides an overview of valid start and end dates and discusses how to:

See Also

Managing Cash Flow

Click to jump to parent topicUnderstanding Valid Start and End Dates

As part of managing your grower contracts, you might need to revise start and end dates.

This diagram shows valid start and end dates among contract headers, contract blocks, and contract harvest records:

Valid start and end dates

As illustrated in this diagram, the harvest end date must be greater than the contract block start date. The contract renewable end date must be greater than the harvest start date.

You can attach harvest records with dates after the contract block end date. However, you are not allowed to apply transactions to the contract after the contract block end date. The system prevents you from generating weigh tags after the contract block end date.

Click to jump to parent topicReviewing Contracts

This section provides an overview of the Contract Workbench program and discusses how to review contracts.

Click to jump to top of pageClick to jump to parent topicUnderstanding the Contract Workbench Program

A grower contract consists of a header record, as well as block and harvest records. The Contract Workbench program (P43C00) provides a single entry point for all of the forms and programs that are available for managing grower contracts.

For example, from the Contract Workbench program, you can:

After you add grower contracts, you can update information on the contract, block, and harvest records as long as the contract status is draft or active. The system updates these tables:

Click to jump to top of pageClick to jump to parent topicForm Used to Review Contracts

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Daily Processing (G40G211), Contract Workbench

Review a list of contracts.

Click to jump to top of pageClick to jump to parent topicReviewing Contracts

Access the Contract Search form.

Click the Contract Headers tab, the Contract Blocks tab, or the Contract Harvests tab.

See Also

Setting Processing Options for Contract Workbench (P43C00)

Click to jump to parent topicManaging Contract Headers

This section provides an overview of contract header revisions and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Header Revisions

After you add a contract, you can change information on the contract header as long as the contract status is draft or active.

Because the contract header and the contract block and harvest records have some of the same attributes or fields, you can change an attribute on the contract header and, optionally, have the system update the same attribute on corresponding block and harvest records. In this way, the system pushes the changes from the contract header to selected block and harvest records. For example, if you change or update the payment schedule on the contract header, you can selectively update block records and harvest records with the same information.

Click to jump to top of pageClick to jump to parent topicForms Used to Manage Contract Headers

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Grower Pricing and Payments Daily Processing (G40G211), Contract Workbench

View a list of existing contracts by contract header, block, or harvest.

Edit Contract Header

W43C00A

On the Contract Search form, select the Contract Headers tab and then select a contract name.

Access the Contract Header form.

Contract Header

W43C50A

On the Edit Contract Header form, select the Update Block and Harvest check box and click Save and Continue.

Push contract header revisions to contract blocks and harvests.

Header Additional Information

W43C01C

On the Edit Contract Header form, click Additional Information.

Enter additional contract addresses, dates, properties, and codes.

Copy Contract

W43C00CA

On the Contract Search form, select the Contract Headers tab and then select contract record that you want to copy. Click Copy Contract.

Copy a contract header and blocks.

Click to jump to top of pageClick to jump to parent topicRevising a Contract Header

Access the Edit Contract Header form.

Update Contract Harvest and Block

Select this check box to update some or all the associated blocks and harvests with the information that you revise on the Edit Contract Header form.

If you select this check box, the system displays the Contract Header form, which you use to push revisions from the contract header to corresponding contract blocks and harvests.

See Pushing Contract Header Revisions to Contract Blocks and Harvests.

Contract Status

To change the status of a contract from draft to active, enter a date range in the Start Date and End Date fields, and then change the status in this field.

To change the status of a contract from active to draft, the system validates that no purchase orders are associated with the contract. The system does not validate whether payments exist for the contract.

Date and Renew Fields

The status of a contract determines which of the following fields on the Edit Contract Header form are required and whether the system validates the field values.

Start Date and End Date

Draft status: The Start Date and End Date fields are not required. However, if you enter a value in one of the fields, the other field is required. If both fields contain dates, the system validates that the end date is after the start date.

Active status: If you revise the current end date, the new date must be after the current end date. The system validates that the block dates that are associated with the contract are within the date range. If the block dates are outside of the date range, the system issues an error message and you cannot change the end dates.

Renewable End Date, Renew Term, and Renew Period

Draft status: If the renew type is renew or roll, the Renewable End Date, Renew Term, and Renew Period fields are not required. However, if you enter a value in the Renewable End Date field, the system validates that the date is greater than or equal to the contract end date in the End Date field. If you enter a value in the Renew Term field, the Renew Period field is required.

Active status: If the renew type is renew, the Renewable End Date, Renew Term, and Renew Period fields are required. (These fields are not required if the renew type is roll.) If you revise the Renewable End Date field, the system validates that the date is greater than or equal to the contract end date.

Note. The Renew Term and Renew Period fields are for information only. The system does not validate the contract end date against these fields.

Note. If you change the renewable end date to a date that is prior to the current date and contract harvests exist, the system the contract harvests will be deleted.

Click to jump to top of pageClick to jump to parent topicPushing Contract Header Revisions to Contract Blocks and Harvests

Access the Contract Header form.

When you first access the Contract Header form, the system displays the payee field values from the contract header. Scroll down to the Push Selection area of the form.

Push Selection Area

In the Push Selection area of the Contract Header form, the system displays check boxes that correspond to the field values that you can push from the contract header to the contract block and harvest. You can push price type and payment schedule fields to the contract block and harvest.

  1. Select the check boxes that correspond to the information that you want to push to a block or harvest record.

  2. Select the block and harvest records that you want to update.

  3. Click Update Selected.

  4. To review the updated block record, on the Add Contract Header form, scroll down and select the block or harvest record to access the Update Contract Block form.

Click to jump to top of pageClick to jump to parent topicCopying a Contract Header and Blocks

Access the Copy Contract form.

You can copy an existing contract header to use as a template for another contract header and minimize redundant data entry. The system copies the following information from the original contract header to the new contract header:

The system does not copy the contracting entity, contract start and end dates, amendments, or harvest records that are associated with the blocks.

The system sets the status of a copied contract to draft and the renew type to nonrenewable.

Copy To Fields

The fields listed in the following table are required:

Contract Code

Enter a code that uniquely identifies the new contract.

Contract Name

Enter the name of the contract.

Contracting Entity

Enter the supplier number of the contracting entity.

Click to jump to top of pageClick to jump to parent topicDeleting a Contract Header

Access the Contract Search form.

You can delete a contract header only if no purchase orders or payments have been applied to the contract header, block, and harvest records. If one or more records do not meet this criteria, the system does not delete the contract header.

When you delete a contract header in the F43C01 table, the system deletes the entire contract. This includes the contract block records in the F43C10 table and the contract harvest records in the F43C11 table, as well as these records:

The system disassociates the contract ID from the corresponding grower harvest record in the Grower Harvest table (F40G03). This causes the link between the contract harvest record and grower harvest record to be broken. The system does not delete the grower block and harvest records that are associated with the contract block and harvest records.

When you delete a contract header, you can optionally have the system set the status of the associated grower harvest to terminate in the F40G03 table.

  1. Select the contract header record, and click Delete Contract.

  2. On the Delete Confirmation window, click Yes to proceed.

  3. On the Message window, click Yes or No to specify whether to set the status of the associated grower harvest to terminate.

    If you click Yes, the system terminates the record in the Grower Harvest table (F40G03).

Note. Alternatively, you can delete a single block or harvest record that is associated with a contract header, instead of deleting the entire contract.

See Also

Deleting a Contract Block Record

Deleting a Contract Harvest Record

Click to jump to parent topicAdding Text to Amendments

This section provides an overview of contract amendments and discusses how to add text to an amendment.

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Amendments

If you set the Display Amendments on Update processing option for the Contract Workbench program (P43C00), every time that a contract header, block, or harvest is revised, the system logs the user ID and date on which the revision was made. You can review this log on the Amendments form, which is a media object. You can also use the Amendments form to add text to describe the revisions that were made. For example, you might add text to describe why you changed the contract and who approved the change or to explain that a manual payment was issued outside of the general contract terms.

You can access the Amendments form in either of these ways:

Click to jump to top of pageClick to jump to parent topicForms Used to Add Text to Amendments

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Grower Pricing and Payments Daily Processing (G40G211), Contract Workbench

View a list of existing contracts by contract header, block, or harvest.

Edit Contract Header

W43C00A

On the Contract Search form, select the Contract Headers tab and then select a contract name.

Add text to an amendment.

Update Contract Block

W43C10A

On the Contract Search form, select the Contract Blocks tab. Enter search criteria and click Find. Select a block.

On the Edit Contract Header form, scroll down and select a block.

Revise a contract block.

Edit Contract Harvest

W43C11A

On the Contract Search form, select the Contract Harvests tab and then select a harvest record.

Add text to an amendment.

Click to jump to top of pageClick to jump to parent topicAdding Text to an Amendment

Access the Edit Contract Header form, Update Contract Block form, or Edit Contract Harvest form. Click Add Amendments or, if applicable, Edit Amendments.

Click to jump to parent topicManaging Contract Blocks

This section provides an overview of contract block revisions and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Block Revisions

You will often revise and update existing information throughout the life cycle of most grower contracts. After you add a contract, you can revise information on the contract block record as long as the contract status is draft or active.

Because the contract block and harvest records have some of the same attributes or fields, you can change an attribute on the block record and, optionally, have the system update the same attribute on corresponding harvest records with a current or future status. In this way, the system pushes the changes from the contract header to selected harvest records. For example, if you change or update the minimum and maximum quantities on the contract block, you can selectively update harvest records with the same information. The system updates both the F43C10 and F43C11 tables.

Note. You cannot change the grower block that is associated with the contract block. To assign a different grower block to a contract, you must delete the contract and add a new one.

Click to jump to top of pageClick to jump to parent topicForms Used to Manage Contract Blocks

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Daily Processing (G40G211), Contract Workbench

Select the Contract Blocks tab.

Review a list of contract blocks.

Update Contract Block

W43C10A

On the Contract Search form, select the Contract Blocks tab. Enter search criteria and click Find. Select a block.

On the Edit Contract Header form, scroll down and select a block.

Revise a contract block.

Push From Contract Block

W43C80A

On the Update Contract Block form, revise fields as necessary. Select the Update Contract Harvest check box, and click Save and Continue.

Push contract revisions to contract harvests.

Select Contract Block

W43C10SSC

On the Update Contract Block form, click Copy Contract Block.

Select the contract block record in which to copy values.

Edit Contract Header

W43C00A

On the Contract Search form, select the Contract Headers tab and then select a contract name.

Delete a contract block.

Click to jump to top of pageClick to jump to parent topicRevising a Contract Block

Access the Update Contract Block form.

You can revise fields on a contract block with a status of draft or active only.

Start Date and End Date

You can change the start and end dates on the block record only if the dates that you enter remain within the contract header date range.

If you change the end date to a date before the current date, the system issues an error message. The end date must be later than the current end date.

If you change the end date to a date later than the current date, the system validates that the date is within the contract header date range.

Ensure that you generate new harvest records, if necessary. Press the Generate/Attach Harvest button on the Update Contract Block form.

See Generating New Grower Harvests for a Contract Block.

Click to jump to top of pageClick to jump to parent topicPushing Contract Block Revisions to Contract Harvests

Access the Push From Contract Block form.

When you first access the Push From Contract Block form, the system displays the field values from the contract block. Scroll down to the Push Selection area of the form.

Push Selection Area

In the Push Selection area of the Push From Contract Block form, the system displays check boxes that correspond to the field values that you can push to a harvest record.

  1. Select the check boxes that correspond to the information that you want to push to a harvest record.

  2. Select the current or future harvest records that you want to update.

  3. Click Update Selected.

  4. To review the updated harvest record, on the Update Contract Block form, scroll down and select the harvest record to access the Edit Contract Harvest form.

Note. The system pushes the start and end dates from a contract block to a new harvest record; however, it will not push dates if the harvest record already exists.

You cannot push clauses from the contract block to the harvest record.

Click to jump to top of pageClick to jump to parent topicCopying Values from One Contract Block to Another

Access the Update Contract Block form. Click Copy Contract Block.

You can copy values from an existing contract block to another block and minimize redundant data entry. When you copy a block, the system copies most of the values from the original contract block, except for the block code, business unit, harvest records, and amendments, to the block that you have selected and overrides any values that exist on the selected block. A block record must exist in the Contract Block table (F43C10) before you can use it to copy values.

Because contract blocks can look very similar, you should consider setting up model contract blocks to use as templates so that you can quickly copy the values from the model to another block and then update that block with specific information.

Click to jump to top of pageClick to jump to parent topicDeleting a Contract Block Record

Access the Edit Contract Header form. Select the block record that you want to delete from the contract header and click Remove.

You can delete a contract block only if no purchase orders or payments have been applied to the contract harvest records. When you delete a contract block, the system deletes the block in the F43C10 table and all harvest records associated with the block in the F43C11 table, as well as payment schedules in the F43C25 table.

To delete an entire contract including the contract block and harvest records, you must delete the contract header.

See Deleting a Contract Header.

Click to jump to parent topicManaging Contract Harvests

This section provides an overview of contract harvest revisions and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Harvest Revisions

The agribusiness is unique in that it has one or multiple harvests per year. For long-range planning, you typically will have multiple contract harvest records that represent future years. Over time, these records might need to be revised. For example, you might need to revise contract harvest records if you extend the date range of a contract block and, as a result, need to add or generate harvest records.

After you add a contract, you can revise information on the contract harvest as long as the contract status is draft or active.

Note. You cannot copy an existing contract harvest record.

Click to jump to top of pageClick to jump to parent topicForms Used to Manage Contract Harvests

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Daily Processing (G40G211), Contract Workbench

Review a list of contract harvests.

Edit Contract Harvest

W43C11A

On the Contract Search form, select the Contract Harvest tab and select a harvest record.

Revise a contract harvest record.

Update Contract Block

W43C10A

On the Contract Search form, select the Contract Blocks tab and select a contract block record.

Delete a harvest record.

Click to jump to top of pageClick to jump to parent topicRevising a Contract Harvest Record

Access the Edit Contract Harvest form.

General Info

Select this tab.

Start Date and End Date

The Start Date and End Date fields appear on the Edit Contract Harvest form only if a processing option is set to display them.

After you create a harvest record, you cannot change the harvest start and end dates. The harvest start and end dates are associated with the harvest pattern, which is set up in the JD Edwards EnterpriseOne Grower Management system.

Reprice PO/Receipts

Click this button to run the Reprice Procurement/Receipts program (R45620) if you change the price on a contract. This program processes the price changes on purchase orders and receipts.

See Repricing Purchase Orders and Receipts.

Pricing

Select this tab.

Set as Base Price

Select an adjustment record, and click the Set as Base Price button to select the price that is associated with the record as the new base price.

The system places a check mark in the New Base Price check box for the adjustment record.

Click to jump to top of pageClick to jump to parent topicDeleting a Contract Harvest Record

Access the Update Contract Block form.

On the Update Contract Block form, scroll down to the Contract Harvests area of the form. Select the harvest record and click Remove.

You can delete a contract harvest record only if no purchase orders or payments have been applied to the record. To delete an entire contract including the block and harvest records, you must delete the contract header.

See Deleting a Contract Header.

Click to jump to parent topicRenewing Contracts

This section provides an overview of contract renewal and discusses how to renew a contract.

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Renewal

To renew or extend a contract, you change the end date on the contract. The contract can have one of these renew types:

Renew Type

Allowed Actions

Renew

You can change the contract end date in the End Date field to a date that is greater than the existing date. The date that you enter must be less than or equal to the renewable end date.

Roll

You can change the contract end date in the End Date field to a date that is greater than the existing date if no renewable end date exists. If a renewable end date exists, the contract end date must be less than or equal to the renewable end date.

Nonrenewable

You can change the contract end date in the End Date field to any date that is greater than the existing date.

Click to jump to top of pageClick to jump to parent topicForms Used to Renew Contracts

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Daily Processing (G40G211), Contract Workbench

Select the Contract Harvest tab and select a harvest record.

Review a list of contracts.

Edit Contract Header

W43C00A

On the Contract Search form, select the Contract Headers tab and then select a contract.

Renew a contract.

Click to jump to top of pageClick to jump to parent topicRenewing a Contract

Access the Edit Contract Header form. Scroll down to the Dates area of the form.

Click to jump to parent topicTerminating Contracts

This section provides an overview of contract termination and discusses how to terminate a contract.

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Termination

To terminate a contract, you terminate the contract header in the F4301 table. The system disassociates the contract ID from the corresponding grower harvest record in the Grower Harvest table (F40G03). When you terminate a contract, you can optionally have the system set the status of the associated grower harvest to terminate (F40G03).

The following rules apply to contract termination:

You can continue to view contracts that have been terminated. You can also copy the values from a terminated contract to another contract. You cannot, however, revise a terminated contract.

Click to jump to top of pageClick to jump to parent topicForms Used to Terminate a Contract

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Daily Processing (G40G211), Contract Workbench

Review a list of contracts.

Edit Contract Header

W43C00A

On the Contract Search form, select the Contract Headers tab and then select a contract.

Terminate a contract.

Click to jump to top of pageClick to jump to parent topicTerminating a Contract

Access the Edit Contract Header form.

Contract Status

Select the status for terminated. Click Save and Continue.

Click to jump to parent topicDeleting Contracts

This section provides an overview of contract deletion and discusses how to delete a contract.

Click to jump to top of pageClick to jump to parent topicUnderstanding Contract Deletion

You can delete a contract header only if no purchase orders or payments have been applied to the contract header, block, and harvest records. If one or more records do not meet this criteria, the system does not delete the contract header.

When you delete a contract header in the F43C01 table, the system deletes the entire contract. This includes the contract block records in the F43C10 table and the contract harvest records in the F43C11 table, as well as these records:

The system disassociates the contract ID from the corresponding grower harvest record in the Grower Harvest table (F40G03). This causes the link between the contract harvest record and grower harvest record to be broken. The system does not delete the grower block and harvest records that are associated with the contract block and harvest records.

When you delete a contract header, you can optionally have the system set the status of the associated grower harvest to terminate in the F40G03 table.

Note. Alternatively, you can delete a single block or harvest record that is associated with a contract header, instead of deleting the entire contract.

See Also

Deleting a Contract Block Record

Deleting a Contract Harvest Record

Click to jump to top of pageClick to jump to parent topicForm Used to Delete a Contract

Form Name

FormID

Navigation

Usage

Contract Search

W43C00A

Daily Processing (G40G211), Contract Workbench

Delete a contract.

Click to jump to top of pageClick to jump to parent topicDeleting a Contract

Access the Contract Search form.

  1. Select the contract header record, and click Delete Contract.

  2. On the Delete Confirmation window, click Yes to proceed.

  3. On the Message window, click Yes or No to specify whether to set the status of the associated grower harvest to terminate.

    If you click Yes, the system terminates the record in the Grower Harvest table (F40G03).