Include a Despatch Order or a Despatch in a Service Demurrage Invoice

Security Note: You need the Allow invoice maintenance security right in the Contracts domain security rights group for this activity.

Activity Steps

1. Open the Service Demurrage Invoice.
2. Select the Despatch Orders tab.
3. Enter the following search criteria as required.
   • Provider—Select from the organisations and companies defined on the Organisations panel of the Solution Explorer.
   • District—Select from the districts defined on the Organisations panel of the Solution Explorer.
   • Service Activity—Select from the Service Activity list items defined in the List Editor.
   • Start Date
   • End Date
   • Date Type—Type of date used to search for despatch orders between the Start Date and End Date. Select from Planned Despatch Date and Bill Of Lading Date.
   • Transport Type—Select from Train, Vessel, Barge and Truck.
4. To include a text string in the search criteria:
   1. Select the method to Search By from:
      • Despatch Order Name—If a parent despatch order (PDO) matches the search criteria, the child despatch orders (CDOs) of that PDO also display in the search results.
      • Despatch Name—Train, truck despatch, service trip or shipment.
      • Despatch Number—Despatch Number of a truck despatch or service trip, Consignment Number of a train, or Voyage Number of a shipment.
      • Transport Name—Name of the train, truck, barge or vessel.
   2. Enter the Search Text. Text searches are case-sensitive with SQL databases with a case-sensitive collation and with all Oracle databases.
5. To sort the search results:
   1. Select the method to Order By from Despatch Order Name, Despatch Order Date, Despatch Name, Contract, Contract Product and Organisation.
   2. Set the Sort Order to be ascending or descending.
6. Click Search.

   Note: Despatch orders that are not yet associated with a despatch can be included in a service-related invoice, but care must be taken when invoicing parent despatch orders (PDOs) and child despatch orders (CDOs). For example, for an aggregated PDO, it is the CDOs that are typically included in service invoices because only the CDOs are associated with despatches.

7. To select despatch orders or despatches, perform any of the following steps.
   1. To include a despatch order or despatch, check Selected.
   2. To exclude a despatch order or despatch, uncheck Selected.
   3. To select all despatch orders or despatches, right-click and select Select All from the menu.
   4. To de-select all despatch orders or despatches, right-click and select Deselect All from the menu.

   Note: Multiple despatch orders or despatches can be in the same invoice if they are for the same provider.

8. Select the Invoice Type for each despatch order from the invoice iteration types specified for the contract.
9. Check Selected in the Service Rate Details field group to include a rate detail. Rate details that display as costs on the snapshot of the relevant despatch order are preselected.

   Important: This is crucial if the invoice is to contain a charge for the rate detail.

10. If the Rate Detail Basis is Time, Time And Dry Mass, Time And Gross Mass or Time And Wet Mass, enter or update the Duration as required. For a cost, the duration may have been entered in the cost configuration on the contract, despatch order or despatch. The duration can be overridden. For a service charge, the duration must be entered.
11. Override the following fields if required.
    • Locations
    • Rate Detail Basis
    • Value
    • Time Basis
    • Use Calculation
    • Calc Expression

    Note: Overriding rate details of service charges in an invoice is only possible if Allow Override is checked for the rate detail configuration. Costs can be overridden. See Contract Rates for descriptions of these fields.

12. If multiple despatch orders are to be included in a single invoice, select whether to group the despatch orders. Grouping of despatch orders is required when the quality adjustment is based on the weighted average of all selected despatch orders in the group, not on each individual despatch order, nor on all despatch orders in the invoice. The despatch orders are invoiced with the total mass of each despatch order in the group, and the quality defaults to the weighted average for the despatch order group. To group despatch orders, for each despatch order, select the despatch order by which it is to be Grouped By. Example: Four despatch orders are selected for invoicing: DO1, DO2, DO3, DO4. DO1 and DO2 can be grouped in one group and DO3 and DO4 in another group.

    Despatch Order	Grouped By
    DO1	DO1
    DO2	DO1
    DO3	DO3
    DO4	DO3

13. Click Save.