Business Process Automation

Demurrage Transaction Agent Actions

This page is accessed via Business Process Automation > Agents and Milestones > Automation Agent.

If you select DEMURRAGE TRANSACTION in the Agent Type field and do not select anything in the Data Type Association field, the agent actions listed here are available.

To use agent actions from other agent types (business objects), select the appropriate data type association. By selecting a data type association, an automation agent of one agent type (business object) can run related agent actions of a different agent type (business object). For example, an automation agent with a shipment agent type can run agent actions available for the order release agent type. To do this, select a data type association of SHIPMENT TO ORDER RELEASE. See the actions topic for more details.

Action

Description

Ad Hoc Notify Contact

This is a utility agent action. See Ad Hoc Notify Contact.

Assign Variable

This is a utility agent action. See Assign Variable.

Calculate Charges

This calculates demurrage transaction charges. Calculation of charges is typically triggered at the end event of a particular demurrage transaction. However, you trigger the calculate charges action without a demurrage transaction end event, in order to determine the demurrage liability accrued until a certain date on a particular demurrage transaction.

The calculation is a two step process:

  • Calculate the demurrage debit (chargeable days) and credit days for a demurrage transaction based on demurrage rules. In some instances, there can be multiple type charges applied to a particular demurrage transaction. Hence, the chargeable day’s information is captured per charge type/ demurrage transaction line item (special service). All these different demurrage transaction charges are modeled as different special services.
  • Calculation of charges is determined per charge type. Each charge type/demurrage transaction line item is modeled as shipment special service and chargeable days as special service duration. Based on the defined demurrage rules, each demurrage transaction charge type/ demurrage transaction line item would either create a new NFRC buy/sell shipment or add as special service to either inbound or outbound shipment. These shipments are rated using the existing OTM rating. Once rating is performed on the newly created NFRC shipment or added as special service to inbound or outbound shipment, it saves the shipment and links it to each of the corresponding demurrage transaction lines.

Note: This action can only be performed on demurrage transactions with the following statuses: DT_TRANSACTION.DT_TRANSACTION_STARTED or DT_TRANSACTION_ENDED and DT_APPROVAL.DT_APPROVAL_NOT_APPROVED.

See the Calculate Charges action.

Call Service

This is a utility agent action. See Call Service.

Copy Involved Parties to Demurrage Transaction

This agent action copies involved party qualifiers to the demurrage transaction from inbound shipment/outbound shipment based on the data type association selected in the agent action definition.

Parameters:

Associated Object: The following values exist:

  • Inbound Shipment: Used to copy involved party qualifiers from associated inbound shipment to demurrage transaction.
  • Outbound Shipment: Used to copy involved party qualifiers from associated outbound shipment to demurrage transaction.

From Involved Party Qualifier: Used to select the specific qualifier ID to copy from inbound shipment/outbound shipment.

To Involved Party Qualifier: Used to select the specific qualifier ID of demurrage transaction to copy into.

Copy Refnums to Demurrage Transaction

This agent action copies reference numbers to the demurrage transaction from inbound shipment/outbound shipment/equipment based on data type association selected in the agent action definition.

Parameters:

Associated Object: The following values exist:

  • Inbound Shipment: Used to copy reference numbers from associated inbound shipment to demurrage transaction.
  • Outbound Shipment: Used to copy reference numbers from associated outbound shipment to demurrage transaction.
  • Equipment - Used to copy reference numbers from associated equipment to demurrage transaction.

From Refnum Qualifier: Used to select the specific qualifier ID to copy from inbound shipment/outbound shipment/ equipment.

To Refnum Qualifier: Used to select the specific qualifier ID of demurrage transaction to copy into.

Copy Remarks to Demurrage Transaction

This agent action will copy remarks to demurrage transaction from Inbound shipment/outbound shipment/equipment based on data type association selected in the agent action definition.

Parameters:

Associated Object: The following values exist:

  • Inbound Shipment: Used to copy remarks from associated inbound shipment to demurrage transaction.
  • Outbound Shipment: Used to copy remarks from associated outbound shipment to demurrage transaction.
  • Equipment: Used to copy remarks from associated equipment to demurrage transaction.

From Remark Qualifier: Used to select the specific qualifier ID to copy from inbound shipment/outbound shipment/ equipment.

To Remark Qualifier: Used to select the specific qualifier ID of demurrage transaction to copy into.

Direct SQL Update

This is a utility agent action. See Direct SQL Update.

Dont Persist

This is a utility agent action. See Dont Persist.

Else

This is a utility agent action. See Else.

Elseif

This is a utility agent action. See Elseif.

Endfor

This is a utility agent action. See Endfor.

Endif

This is a utility agent action. See Endif.

EndLock

This is a utility agent action. See Endlock.

Estimate Distance

This is a utility agent action. See Estimate Distance.

For

This is a utility agent action. See For.

For Each

This is a utility agent action. See For Each.

If

This is a utility agent action. See If.

Lock

This is a utility agent action. See Lock.

Log

This is a utility agent action. See Log.

Log to Transmission Report

This is a utility agent action. See Log to Transmission Report.

Notify Contact

This is a utility agent action. See Notify Contact.

Persist

This is a utility agent action. See Persist.

Print Document

This is a utility agent action. See Print Document.

Queue Event

This is a utility agent action. See Queue Event.

Raise Error

This is a utility agent action. See Raise Error.

Raise Event

This is a utility agent action. See Raise Event.

Raise Internal Event

This is a utility agent action. See Raise Internal Event.

Recalculate Charges

This agent action recalculates demurrage transaction charges. The recalculation of charges is done based on already determined charge types/demurrage transaction line item chargeable day details.

Calculate Charges has three steps. Recalculate charges only does the third step - calculate charges.

See the Recalculate Charges action.

Schedule Event

This is a utility agent action. See Schedule Event.

Send Integration

This is a utility agent action. See Send Integration.

Set Event Status

See the Set Event Status action.

Parameters:

Event Status Code ID

Event Date/Time

Set Internal Status

This is a utility agent action. See Set Internal Status.

Set Status

This is a utility agent action. See Set Status.

Stop

This is a utility agent action. See Stop.

Wait

This is a utility agent action. See Wait.

 

Related Topics