MineMarket Marketing Service
The MineMarket Marketing Service is a back-end process that oversees calculating a state for every despatch order (and optionally every contract quota) in the system. The state is a set of values that represents the most up-to-date data, based on contractual terms, and using the most recent weights and assays present in the system.
The MineMarket Marketing Service monitors changes in assays, weights and contractual terms, and reprocesses the state of the despatch orders and quotas that are affected by the changes. If despatch orders have been allocated to trades, the MineMarket Marketing Service calculates the profit or loss of the trade. The MineMarket Marketing Service runs each time applicable data is changed and saved, and warehousing is complete.
By default, saved changes to the following MineMarket objects trigger the MineMarket Marketing Service to recalculate despatch order states:
- Base data (price series or analyte quality forecasts if settings for these are enabled on the Options screen, premium matrixes)
- Despatch orders (including DO specifications, required quantity, fulfilled status; overrides to quotation pricing (QP), assay rules or tolling details; DO-specific contract charges; toll returns)
- Sales/purchase contract terms (including currencies, payable analytes, QP headers, QP lines, payable percentages, contract charges, budgeted costs, costs, service charges, demurrage/despatch conditions, taxes, payment terms, assay rules, tolling configuration)
- Sales/purchase contract quotas and contract products (quality specifications)
- Freight/service contracts (address commissions, rate details, taxes, demurrage/despatch conditions)
- Despatches (route points, delays, shipment laycans)
- Bulk transactions assigned to despatch orders
- Discrete unit movements assigned to despatch orders
- Despatch contributor statements (if the setting is enabled on the Options screen)
- Samples (composite samples or lot samples linked to despatch orders)
- Adjustments to packages linked to despatch orders
- Assay exchanges
- Invoices and invoice revaluations
Changes to hedge positions and hedging allocations trigger the MineMarket Marketing Service to recalculate trade profit and loss for related despatch orders, but do not recalculate the despatch order states.
Changes to exchange rates or interest rates do not trigger the MineMarket Marketing Service to recalculate despatch order states.
The Snapshot Trigger Priority Editor can be used to configure which object changes trigger the MineMarket Marketing Service to recalculate despatch order snapshots, and with which priority. For example, changes to the despatch order itself would be high priority, but changes to the contract may be set to be low priority.
The Marketing Service Errors screen can be used to view despatch orders with contractual or data errors on the default snapshot.
Detailed status of the MineMarket Marketing Service can be viewed on the Monitored Services screen in the MineMarket Client.
Statistics for the MineMarket Marketing Service are included on the Server Statistics screen.
Despatch orders pending recalculation by the MineMarket Marketing Service are listed in the DODownstreamRegister table in the MineMarket database.
If a user has the Allow the user to recalculate despatch order snapshots on the MineMarket Client domain security right, they can recalculate the most recent default snapshot on the MineMarket Client. The snapshot is still queued for recalculation using the MineMarket Marketing Service. See Domain Security Rights - Contracts.
