Assign a Set of Mark-To-Market Terms to a Despatch Order

This activity overrides default settings from the contract. See Assign a Set of Mark-To-Market Terms to a Sales or Purchase Contract.

Security Note: You need the Allow the user to maintain despatch orders security right in the Contracts domain security rights group for this activity.

Activity Steps

1. Open the Despatch Order.
2. On the Details tab, click the ellipsis (...) next to Mark To Market.

   The Mark To Market Search screen displays.

   Note: MineMarket calculates the mark-to-market (MTM) value of the despatch order with the set of MTM terms that is allocated as of that date. If the MTM is changed for the despatch order, the MTM value of historical snapshots is not updated to use the new MTM. Only snapshots from the date of the change will use the new MTM. Historical snapshots are only created if Create Copy Of Snapshots is checked in snapshot settings. See Specify Snapshot Settings.

3. Enter the following search criteria as required.
   • Delivery Terms—Select from the delivery terms defined in the Delivery Term Editor.
   • Locations—Select from the despatch locations defined on the Supply Chain panel of the Solution Explorer. Despatch locations are rail sidings, truck despatch locations, barge terminals and port locations.
   • Products—Select from the products and brands defined on the Material panel of the Solution Explorer and that match the material type of the contract.

   Note: The Material Type is the material type of the contract.

4. To include a text string in the search criteria, enter the Search Text. Search By is Mark To Market. Text searches are case-sensitive with SQL databases with a case-sensitive collation and with all Oracle databases.
5. Click Search.

   Sets of mark-to-market terms that match the search criteria, the contract pricing basis and the product of the despatch order display in the Mark To Market table.

6. Check Selected for the required set of mark-to-market terms.
7. Click OK.
8. Complete the following fields as required.
   • MTM Location—Location to be used as the expected fulfilment location of the despatch order's trades. The MTM location is used as the fulfilment location of the set of mark-to-market terms when calculating the profit and loss of a despatch order in an MTM trade. For sets of MTM terms with delivery terms of FAS, FCA or FOB, the MTM location is considered to be the loading location. For all other delivery terms, the MTM location is considered to be the unloading location. Select from the despatch locations defined on the Supply Chain panel of the Solution Explorer. Default: The MTM Location of the quota or the contract (if the quota has no MTM location).
   • MTM Reference Date—Reference date for determining the MTM date. The MTM date is used when calculating the mark-to-market value of a despatch order, in a similar way as the planned despatch date is used when calculating the value of the despatch order. If the MTM date is past, the current date is used. Default: The MTM Reference Date of the contract. Select from:
   • Bill Of Lading Date—The first available date out of: bill of lading date of the despatch order, ATD at origin, ETD at origin, ATA at origin, ETA at origin, or planned despatch date of the despatch order
   • Arrival Date At Loading—The first available date out of: ATA at origin, ETA at origin, bill of lading date of the despatch order, or planned despatch date of the despatch order
   • Arrival Date At Destination—The first available date out of: ATA at destination, ETA at destination, estimated arrival based on the travel and duration time of a route that matches the planned loading and unloading locations or quota contractual source and destination, bill of lading date of the despatch order, or planned despatch date of the despatch order
   • Planned Despatch Date—The planned despatch date of the despatch order
   • Start Of Quotation Period—The earliest QP start date of the QP's main analyte
   • End Of Quotation Period—The latest QP end date of the QP's main analyte
   • Fixed Date—A date specified on each despatch order
   • MTM Reference Date Offset—Default number of months or days offset for the mark-to-market reference date. The offset can be a positive or negative number. Not applicable if the MTM Reference Date is Fixed Date. Default: The MTM Reference Date Offset of the contract.
   • MTM Fixed Date—Date for calculating the mark-to-market value. Only applicable if the MTM Reference Date is Fixed Date.
   • Use Purchase Weights And Assays—Point until when to use purchase weights and assays in snapshots, trade profit and loss (P&L) and invoices of the sales DO. Default: As specified on the Default Values tab of the sales contract. Not applicable to purchase DOs. Select from:
     • Never—The sales DO uses its own weights and assays.
     • Until Realised—The sales DO snapshot has a weight value source of Purchase Quantity and assays value source of Purchase Quality until control has passed for the sales DO.
     • Until Assayed—The sales DO snapshot has a weight value source of Purchase Quantity and assays value source of Purchase Quality until at least one sample result has been entered at the fulfilment location for the sales DO.
     • Until Finalised—The sales DO snapshot has a weight value source of Purchase Quantity and assays value source of Purchase Quality until the assay exchange (if required) is complete, or there is a final assay result for each required analyte for the sales DO.
     • Always—The sales DO uses the weights and assays of the purchase DO.

     Note: Except for the Never option, if the sales DO is traded with multiple purchase DOs that together meet the minimum required quantity of the sales DO, the weights are aggregated and the weighted average of assays is used. However, if the trade(s) do not yet meet the minimum required quantity of the sales DO, the required quantity and specifications of the sales DO are used.

9. Click Save.