IMOS - Bunker Invoice

Home > Bunkering > Bunker Invoice


You can follow alternate bunker invoicing workflows to support different business situations. For example, you can create a Bunker Invoice before a Bunker Requirement or a Bunker Purchase has been entered, or before knowing the operational lifting quantities. If you want, you can bind the invoice to a bunker purchase or to the operational quantity at a later time. To support this flexibility, you can create a Bunker Invoice in several ways.

Creating a Bunker Invoice

  1. To create a Bunker Invoice, use one of these methods:

    • On the Bunker Requirement form, right-click the selected vendor inquiry (the one with the S check box selected) and then click Create Bunker Invoice.

    • On the Voyage Bunkers form, right-click a Bunker Liftings line item and then click Create Bunker Invoice.

    • On the Voyage Invoices panel, click a Bunker Invoice card with Status: Uninvoiced.

    • On the Bunker Purchase form, click Create Bunker Invoice.

    • On the Operations menu …, under Bunkers, click Bunker Invoice.

    • Create the invoice in Financials, on the Create Bunker Invoices list.

image-20250502-173405.png
  1. On the Bunker Invoice, do one of the following:

    • Complete at least the required fields.

    • If an uninvoiced Bunker Purchase matches the values you enter, a selection list appears of the possible matching Bunker Purchases appears. Select the appropriate one; its values populate the invoice.

  2. Complete any other relevant fields.

  3. To approve, post, reject, export, or email an invoice, on the toolbar, click Invoice.

  4. To attach documents or links, or to open an attachment, click Attachments. You can add attachments only after you save the Bunker Invoice with the required fields. 

Barging costs are included in the total cost of the Bunker Invoice automatically when the configuration flag CFGEnableBunkerInvLumpsumFields is enabled. When it is disabled, you must re-enter the barging costs in the invoice for the total costs to recalculate and include them. This flag also applies to other operations invoice forms, including Time Charter Payment, Bareboat Payment, Time Charter Bill, Freight Invoice, Claim Invoice, Demurrage/Despatch, and Voyage Other Revenues and Expenses.

The Financials Invoice link to access the Transaction Data Entry form is available in Bunker invoices when the configuration flag CFGAccessTDEFormFromOpsInvoice is enabled.

Viewing a Bunker Invoice

  • To view all Bunker Invoices, on the Transaction Summary, apply a filter to the Description column.

  • To view all Bunker Invoices related to a voyage, open its Invoices panel.

  • To view a specific Bunker Invoice, do any of the following:

Binding a Bunker Invoice

You can create a Bunker Invoice before a Bunker Requirement or purchase has been entered and then bind the invoice to a bunker purchase later. In another case, you might create a Bunker Invoice before knowing the operational lifting quantities. Again, you can bind the invoice to the operational quantity at a later time.

If a Bunker Invoice is not bound to a Bunker Lifting, some columns in the Report Designer are empty (for example, Lifting Date GMT). Binding the Bunker Invoice to the Bunker Lifting and saving the voyage makes the values appear in the report.

Binding a Purchase to an Invoice

When you create an invoice independent of a vendor inquiry, you can later associate the invoice with the purchase.

  1. On the Bunker Requirement form, right-click the selected line item and then click Bind to Bunker Invoice.

  2. On the Bunker Invoice form, click Search Button.png  and retrieve the invoice.

  3. To save the information, click Save button.png .

Binding a Lifting to an Invoice

If you created a Bunker Invoice before knowing the operational lifting quantities, complete the following steps to associate the invoice with the quantity lifted, as recorded in the Voyage Manager.

  1. On the Voyage Bunkers form, right-click a Bunker Liftings line item and then click Bind Bunker Invoice.

  2. On the Bunker Invoice form, to save the information, click  Save button.png .

Automatically Posting a Bunker Invoice

With the use of the Messaging Service, you can automatically post Bunker Invoices after they are imported into the system. Bunker Invoices default to nonrebillable-type invoices because a Bunker Invoice is always a transaction with a third-party vendor. To make them rebillable-type invoices, change the XML.

If you have purchased the Messaging Service, the full Messaging Service Manual is available on request.


Related Configuration Flags

Name/Flag

Description

Enable Bunker Invoice Lumpsum Fields
CFGEnableBunkerInvLumpsumFields

Enables display of lumpsum fields for barging costs and other costs in the Bunker Invoice form, augmenting the rate fields so these costs can be entered independent of invoice quantity.

Tax on Tax PST
CFGTaxOnTaxPST

Causes PST Tax to consider all items on the invoice as taxable, including other tax lines, rather than applying only to non-tax invoice items.

Auto Post Bunker Invoice
CFGAutoPostBinv

Bunker Invoices that are imported as Pending are automatically posted as long as they are within acceptable thresholds defined in CFGAutoPostBinvTotalTolerance, CFGAutoPostBinvPriceTolerance, and CFGAutoPostBinvQtyTolerance.

In addition to validating that amounts are within the tolerances defined:

  • The related Bunker Inquiry/Purchase must be status Ordered.

  • The related Bunker Requirement must be status Approved.

  • The PO Number on the incoming Invoice must match that on the Bunker Inquiry/Purchase.

  • The voyage information defined in the Invoice must match that on the Requirement.

If any of the validations fails, the invoice is still imported as Pending status.

Auto Post Bunker Invoice Total Tolerance
CFGAutoPostBinvTotalTolerance

When CFGAutoPostBinv is enabled, pending bunker invoices imported through the Messaging Service are automatically posted if they meet certain data validations. Set the tolerance here in base currency for the acceptable difference between the bunker invoice's total amount and the related ordered inquiry's total amount.

Auto Post Bunker Invoice Price Tolerance
CFGAutoPostBinvPriceTolerance

When CFGAutoPostBinv is enabled, pending bunker invoices imported through the Messaging Service are automatically posted if they meet certain data validations. Set the tolerance here in base currency for the acceptable difference between the bunker invoice's price per metric ton and the related ordered inquiry's price per metric ton.

Auto Post Bunker Invoice Quantity Tolerance
CFGAutoPostBinvQtyTolerance

When CFGAutoPostBinv is enabled, pending bunker invoices imported through the Messaging Service are automatically posted if they meet certain data validations. Set the tolerance here in metric tons for the acceptable difference between the bunker invoice's Inv Qty and Opr Qty.

Preserve Line Items on Bunker Invoice Post
CFGPreserveLineItemsOnBINVPost

When posting a bunker invoice, all individual items are preserved; barging and other costs are not added to the base price.

Enable Veslink Bunkering Form Date Sync
CFGEnableVeslinkBunkeringFormDateSync

When enabled, upon submission and approval of a Veslink Bunkering Form, the Bunkering Completed time and date field from that form is synced with the Bunker Requirement Delivery field and the Bunker Invoice Delivery Date field, if they exist. If there are multiple requirements for the given port call, it updates each one of them.

Default Unactual
CFGDefaultUnactual

When enabled, the Status of a newly created bunker, freight, equipment, hire, or commission invoice is set to Pending by default.

Link Bunker Invoice With Purch Match Vendor
CFGActLinkBINVWithPurchMatchVendor

If CFGActLinkBINVWithPurchaseNo is enabled so that Bunker Invoices can link to Bunker Purchases by PO Number, this flag controls whether or not the Bunker Invoice vendor must match the Bunker Purchase vendor for the link to be made. To allow for non-matching vendors, this flag should be disabled.