Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.appliedaifoundation.org/llms.txt

Use this file to discover all available pages before exploring further.

Download PDF

Open the original PDF guideline
The Bunker Report records every bunker lifting — fuel supplied from a barge, ex-pipe from a terminal, or ship-to-ship from another vessel. It is submitted in addition to the usual Noon / Arrival / Departure reports for the same day, never as a replacement. When to send: At the completion of every bunkering, before the next scheduled performance report.
The submission flow (Submit → copy encoded block → paste into a plain-text Outlook email) is the same as for every other Metaweave form. See the Forms Guidelines → Submission of Metaweave Forms for the email template, recipient list, and subject-line rules.

​
Bunker Event Timeline

All six timestamps must form a monotonic chain — each event must be at or after the previous one. The validation layer will block submission if they are out of order.

​
VOYAGE Section

​
Header fields

FieldMeaning
Voyage NumberCurrent voyage number.
PortPort where the bunker was lifted. Use the autocomplete.
SupplierBunker supplier name. Use the autocomplete.
Barge NameName of the supply barge. Leave blank for ex-pipe delivery.
Barge AlongsideLocal date / time the barge came alongside + GMT offset.
Bunker Hose ConnectedLocal date / time + GMT.
Commenced BunkeringLocal date / time + GMT.
Bunkering CompletedLocal date / time + GMT.
Bunker Hose DisconnectedLocal date / time + GMT.
Barge Cast OffLocal date / time + GMT.
RemarksFree text — quality / quantity issues, delays, surveyor disputes, etc.

​
Fuel Type & Quantity Lifted

Add one row per fuel grade lifted.

​
BDN row fields

FieldMeaning
Fuel CategoryDrop-down — HSFO, VLSFO, VLSFO (≤40 cSt), LSMGO, ULSFO, etc.
BDN NumberBunker Delivery Note number from the supplier.
BDN QuantityQuantity per the BDN, in MT.
Vessel Received QuantityQuantity per the vessel’s own measurements, in MT.
ViscosityFrom the BDN / Certificate of Quality.
DensityFrom the BDN / Certificate of Quality.
LCVFrom the BDN / Certificate of Quality.
Sulphur %From the BDN / Certificate of Quality.
Water %From the BDN / Certificate of Quality.

​
Bio Fuel and Blends

When the BDN delivers a biofuel or a blended grade (a fossil base mixed with one or more bio components), use the + Add Bio Fuel button below the Fuel Type table. There are two cases:
BDN deliversWhat to enter
Pure bio fuel (e.g. 100 MT HVO)One parent BDN row + one Bio Fuel entry tagged with the bio category. No blend dialog.
Blend of fossil + bio (e.g. 500 MT B30 of VLSFO + FAME)One parent BDN row + one “Blend” Bio Fuel entry + one component row per blended fuel (2–3 components allowed). Component quantities must sum to the parent BDN quantity.

​
Add BioFuel dialog fields

FieldMeaning
Vessel CodeAuto-populated from settings.
Bunkering PortAuto-copied from the main bunker report header.
Bunkering Date / TimeAuto-copied from the parent BDN row.
BDN NumberSame BDN number as the parent row — links the bio fuel entry to the parent BDN.
BDN QuantityTotal BDN quantity in MT. For a pure bio delivery this is the bio quantity itself; for a blend this is the total delivered including the fossil base.
Fuel CategorySelect Blend if the BDN is a mixture, or pick the specific bio category for a single bio fuel (see list below).
Supported bio fuel categories:
CodeName
(ETH)Ethanol
(BD)BioFT-Diesel
(HVO)Hydrotreated Vegetable Oil
(LBM)Liquefied Bio-Methane
(BM)Bio-Methanol
(PVO)Pure Vegetable Oil
(DME)Dimethyl Ether
(BH2)Bio-H2
(ED)e-diesel
(EM)e-methanol
(ELNG)e-LNG
(ELPG)e-LPG
(EH2)e-H2
(ENH3)e-NH3
(EDME)e-DME
(FAME)FAME Diesel
(HTL)Hydrothermal Liquefaction Oil
(UPO)Upgraded Pyrolysis Oil
(UCO)Used Oils and Fats
(ALO)Algae Oil

​
Bio fuel / blend decision tree

​
Blend Component dialog fields

FieldMeaning
Blend Component 1First component fuel type — the fossil base (e.g. (VLA80)VLSFO>80, HFO, LFO, MGO). Mandatory.
BDN Quantity (Component 1)Quantity of the first component in MT. Mandatory, must be > 0.
Blend Component 2Second component — usually the bio part (e.g. (FAME) Diesel, (HVO)Hydrotreated Vegetable Oil). Mandatory.
BDN Quantity (Component 2)Quantity of the second component in MT. Mandatory, must be > 0.
Blend Component 3Optional third component for a ternary blend. Leave as None for a 2-component blend.
BDN Quantity (Component 3)Required only if Component 3 is set.
The sum of all component BDN quantities must equal the parent BDN Quantity from the Add BioFuel dialog. The shore pipeline computes the bio percentage from component masses — do not enter percentages, only mass in MT.

​
Worked Examples

ScenarioBDN QtyComponent 1Component 2Component 3
Pure HVO bunker100 MT(no blend dialog — pick (HVO)… as Fuel Category)——
B24 FAME / VLSFO bunker500 MT(VLA80)VLSFO>80 380 MT(FAME) Diesel 120 MTNone
B30 FAME / VLSFO bunker500 MT(VLA80)VLSFO>80 350 MT(FAME) Diesel 150 MTNone
Tri-fuel HFO + HVO + FAME800 MTHFO 600 MT(HVO)Hydrotreated Vegetable Oil 100 MT(FAME) Diesel 100 MT
Pure UCO bunker80 MT(no blend dialog — pick (UCO)… as Fuel Category)——

​
Editing or removing a Bio Fuel entry

  • Each row in the BDN Bio Fuel table can be deleted using the trash icon at the end of the row. Deleting a parent Blend row also removes its components.
  • To correct a quantity or component selection, delete the parent row and re-enter via + Add Bio Fuel. There is no direct in-line edit — the dialog flow is the only path that keeps the parent/component link consistent.

​
Documents & Remarks

FieldMeaning
Letter of ProtestYes / No — select Yes if any LOP was issued during the bunkering.
Cert of Quality Rec’dYes / No.
RemarksAny discrepancies, delays, or quality observations.

​
Master’s Name

First and last name of the reporting Master. Required.