> ## 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.
# Bunker Report
> Complete walkthrough of the Bunker Report — BDN table, biofuel dialog, blend components, and worked examples.
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
```mermaid theme={"system"}
flowchart LR
A[Barge Alongside] --> B[Bunker Hose Connected]
B --> C[Commenced Bunkering]
C --> D[Bunkering Completed]
D --> E[Bunker Hose Disconnected]
E --> F[Barge Cast Off]
```
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
| Field | Meaning |
| ------------------------ | ---------------------------------------------------------------------- |
| Voyage Number | Current voyage number. |
| Port | Port where the bunker was lifted. Use the autocomplete. |
| Supplier | Bunker supplier name. Use the autocomplete. |
| Barge Name | Name of the supply barge. Leave blank for ex-pipe delivery. |
| Barge Alongside | Local date / time the barge came alongside + GMT offset. |
| Bunker Hose Connected | Local date / time + GMT. |
| Commenced Bunkering | Local date / time + GMT. |
| Bunkering Completed | Local date / time + GMT. |
| Bunker Hose Disconnected | Local date / time + GMT. |
| Barge Cast Off | Local date / time + GMT. |
| Remarks | Free text — quality / quantity issues, delays, surveyor disputes, etc. |
***
## Fuel Type & Quantity Lifted
Add one row per fuel grade lifted.
```mermaid theme={"system"}
flowchart TD
A[Open Bunker Report] --> B[Fill VOYAGE header\n& timestamps]
B --> C[Add row to\nFuel Type table]
C --> D{Grade lifted?}
D --> |HSFO| E[Enter BDN Number,\nBDN Qty, Vessel Received Qty,\nViscosity, Density, LCV,\nSulphur %, Water %]
D --> |VLSFO / LSMGO / etc.| E
E --> F{More grades?}
F -- Yes --> C
F -- No --> G{Any bio fuel\nor blend?}
G -- No --> H[Documents & Remarks\n→ Submit]
G -- Yes --> I[Click + Add Bio Fuel]
```
### BDN row fields
| Field | Meaning |
| ------------------------ | ---------------------------------------------------------------------- |
| Fuel Category | Drop-down — `HSFO`, `VLSFO`, `VLSFO (≤40 cSt)`, `LSMGO`, `ULSFO`, etc. |
| BDN Number | Bunker Delivery Note number from the supplier. |
| BDN Quantity | Quantity per the BDN, in MT. |
| Vessel Received Quantity | Quantity per the vessel's own measurements, in MT. |
| Viscosity | From the BDN / Certificate of Quality. |
| Density | From the BDN / Certificate of Quality. |
| LCV | From 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 delivers | What 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
| Field | Meaning |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Vessel Code | Auto-populated from settings. |
| Bunkering Port | Auto-copied from the main bunker report header. |
| Bunkering Date / Time | Auto-copied from the parent BDN row. |
| BDN Number | Same BDN number as the parent row — links the bio fuel entry to the parent BDN. |
| BDN Quantity | Total 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 Category | Select `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:**
| Code | Name |
| -------- | ----------------------------- |
| `(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
```mermaid theme={"system"}
flowchart TD
A[Click + Add Bio Fuel] --> B[Fill dialog:\nVessel Code, Port,\nDate, BDN Number,\nBDN Quantity]
B --> C{Fuel Category\nselected?}
C -- Single bio category\ne.g. HVO, UCO, FAME --> D[Click Save]
D --> E[New row added to\nBDN Bio Fuel table\nlinked to parent BDN]
C -- Blend --> F[Click Save]
F --> G[Blend Component\ndialog opens]
G --> H[Enter Component 1\nfossil base + quantity MT]
H --> I[Enter Component 2\nbio part + quantity MT]
I --> J{Ternary blend?}
J -- No --> K[Leave Component 3\nas None]
J -- Yes --> L[Enter Component 3\n+ quantity MT]
K --> M{Component\nquantities sum\nto parent BDN qty?}
L --> M
M -- Yes --> N[Click Save]
N --> O[BDN Bio Fuel table shows\nparent Blend row +\none row per component]
M -- No --> P[Correct quantities\nuntil sum matches]
P --> M
```
### Blend Component dialog fields
| Field | Meaning |
| -------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Blend Component 1 | First 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 2 | Second 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 3 | Optional 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
| Scenario | BDN Qty | Component 1 | Component 2 | Component 3 |
| ------------------------- | ------- | ---------------------------------------------------- | ---------------------------------------- | ---------------------- |
| Pure HVO bunker | 100 MT | *(no blend dialog — pick `(HVO)…` as Fuel Category)* | — | — |
| B24 FAME / VLSFO bunker | 500 MT | `(VLA80)VLSFO>80` 380 MT | `(FAME) Diesel` 120 MT | None |
| B30 FAME / VLSFO bunker | 500 MT | `(VLA80)VLSFO>80` 350 MT | `(FAME) Diesel` 150 MT | None |
| Tri-fuel HFO + HVO + FAME | 800 MT | `HFO` 600 MT | `(HVO)Hydrotreated Vegetable Oil` 100 MT | `(FAME) Diesel` 100 MT |
| Pure UCO bunker | 80 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
| Field | Meaning |
| --------------------- | ----------------------------------------------------------------- |
| Letter of Protest | Yes / No — select Yes if any LOP was issued during the bunkering. |
| Cert of Quality Rec'd | Yes / No. |
| Remarks | Any discrepancies, delays, or quality observations. |
***
## Master's Name
First and last name of the reporting Master. Required.