Aerial view of container ships and tugs in a busy port channel

Key takeaways

  • Treat missing values, conflicting sources and incompatible units as different exceptions.
  • Keep the original input visible beside any proposed interpretation.
  • Do not allow a plausible total to conceal an unsupported assumption.
  • Resolve the cause and recalculate the affected comparison consistently.
  • Return the corrected case to evaluation so the same failure remains visible.

Identify the exception before proposing a fix

A port-cost input may be absent, two messages may supply different quantities, or a value may lack a clear currency or basis. Each situation requires a different question.

Do not label every problem low confidence. That label tells the user little about what to investigate. A useful exception says that a source quantity conflicts with the selected worksheet value, or that the duration basis of a quoted expense is not stated.

Keep the source and the assistant's proposed interpretation separate. If the system suggests a likely unit or classification, the user should recognise it as a proposal. The suggestion must not become indistinguishable from information actually supplied by an authorised source.

This article proposes a review framework for commercial assistance. It does not describe the capabilities of any particular system or authorise automated voyage, contractual or payment decisions.

Recognise the limits of the supported task

NISTIR 8312 includes knowledge limits among its explainability principles: systems should recognise when conditions fall outside their designed scope.

For the original workflow proposed here, define what the assistant is allowed to prepare. It might organise supplied inputs and calculate an estimate under approved assumptions. That does not mean it can determine whether a contractual clause applies or whether a proposed operational arrangement is suitable.

An out-of-scope question should reach the appropriate person with the relevant evidence. The assistant can identify the missing decision without trying to manufacture an answer. A clearly bounded exception is a useful output when the alternative is an unsupported conclusion.

Avoid treating an available historical value as permission to fill a gap. A previous voyage may have different scope, timing or conditions. If a human chooses to use it as a provisional assumption, record that decision and its limitation explicitly.

Separate input, model and authority problems

Exception typeExample in a proposed estimateReview needed
Missing inputA quoted expense has no confirmed amountObtain the relevant source or approve a labelled assumption
Conflicting evidenceA later message differs from the selected quantityEstablish which source applies to the case
Unit or basis mismatchA charge is entered on an unclear period basisClarify the original meaning before conversion
Model mismatchA cost is counted in overlapping categoriesReview the calculation structure and inclusion rules
Scope limitThe requested output requires contractual interpretationRefer the actual question to the authorised adviser
Authority gapA proposed assumption has no responsible acceptanceObtain the decision from the designated owner

These categories can coexist. An unclear charge basis may also reveal that the chosen calculation structure cannot represent the actual proposal. Preserve both findings rather than closing the issue after fixing only the visible field.

The exception record should point to the affected result. A reviewer can then judge whether the issue prevents the comparison from being used or whether a clearly limited provisional view remains appropriate.

Avoid silent normalisation

Some transformations are useful when their meaning is explicit, such as presenting approved inputs consistently. The danger is changing meaning while presenting the result as a routine formatting operation.

For example, converting a period-based expense requires knowing what period the source actually covers. Relabelling a value with the worksheet's preferred unit does not establish that basis. The exception should remain open until the relationship is understood.

Similarly, do not choose one of two conflicting source values merely because it produces a more plausible total. Plausibility can prompt investigation, but it is not evidence that a particular value is correct.

Record any accepted transformation with enough information to reproduce it. The reviewer should be able to identify the original value, the approved interpretation and the calculation applied. That is more useful than a generic statement that the data was cleaned.

Fictional case: the expense basis is inferred incorrectly

A fictional estimate assistant receives a supplier message containing a service amount and a description of the proposed attendance. The message does not clearly state whether the amount covers the whole attendance or a repeating period. The worksheet expects a period-based value.

The assistant inserts the amount into the expected field and calculates a complete-looking estimate. A reviewer notices that the summary is more definite than the source. The total is internally consistent with the inserted assumption, but the assumption itself has not been established.

The desk marks the expense basis unresolved and asks the supplier for clarification through the authorised contact. Once the scope is confirmed, the preparer updates the input, recalculates the relevant alternatives and explains the change in the review note.

The team adds this fictional pattern to its evaluation cases. The desired future behaviour is to flag the ambiguous basis, not to reproduce the previously inferred value simply because a human once corrected the worksheet afterward.

Decide how the estimate can be used while an issue is open

An unresolved exception need not make every part of the work unusable. The owner may allow a provisional scenario to support a defined discussion while withholding acceptance for a more consequential decision. State that boundary in the output.

Keep alternative assumptions separate when the point of the exercise is to explore uncertainty. Do not combine a conservative assumption in one alternative with a favourable assumption in another without explaining the difference.

If the unresolved issue can change the preferred comparison, make that dependency prominent. A small-looking input may matter materially when the alternatives are close or when the expense is repeated across the model.

The appropriate decision depends on the actual task and authority arrangements. The assistant should not decide that the issue is immaterial solely because its own output remains numerically stable.

Close the exception with a traceable resolution

Record the evidence received, the human decision made and the parts of the estimate recalculated. If the original comparison was circulated, determine whether its conclusion or permitted use has changed and communicate the correction through the agreed route.

Do not close the exception merely because someone entered a value. The closure should explain why the new value is suitable and whether any conditions remain. A replacement assumption may be better documented without becoming a confirmed fact.

Check related records. If the same unsupported interpretation appears in several alternatives, correcting only one worksheet can leave the comparison inconsistent. The review should follow the assumption wherever it was used.

Learn from the failure without generalising too far

Add a representative case to testing and verify the expected exception behaviour after a relevant system change. Preserve the distinction between a rule that applies generally and a decision specific to one supplier response or voyage.

Do not turn a one-off human resolution into an automatic default for every future message. The lesson may be to ask a better question, not to select the same answer more quickly.

Track recurring causes so the team can improve input requests, model design or user instructions. A repeated exception can reveal a weak interface between commercial information and the estimate structure.

Common mistakes

Avoid filling missing information from an unrelated historical case, hiding a basis change as formatting or selecting the value that makes the total look plausible. Do not confuse a complete worksheet with a supported estimate.

Another mistake is closing an exception after data entry without recording the evidence and decision behind the change.

Where Zeaclub fits

Zeaclub offers digitalised procedures across the voyage workflow.

Zeaclub provides 24/7 operating systems and worldwide coverage.

Explore Zeaclub

Learn about Zeaclub

Educational information only; not legal, financial or trading advice. Contract wording and applicable rules control. Verify current requirements and obtain qualified advice before acting.

Frequently asked questions

Should the assistant always choose the most likely interpretation?

No. Where meaning affects the estimate, preserve the ambiguity and seek the appropriate review. A plausible interpretation is still a proposal until supported or explicitly accepted as an assumption.

Can an estimate be used with an open exception?

The responsible owner may permit a bounded provisional use. State the unresolved issue, its possible consequence and the limits of that use clearly.

Does correct arithmetic prove the input was interpreted correctly?

No. Arithmetic can be consistent with an unsuitable assumption. Review the source meaning and calculation basis separately.

What should be saved when the exception closes?

Retain the original issue, resolution evidence, accepted interpretation, affected recalculation and any remaining conditions. Include the case in appropriate future evaluation.

Primary sources