Ritzy One — Bahrain Customs Manifest (Liner)

1 Availability

The Customs Manifest action appears on a saved Liner job only when all three hold:

Company Country = BAHRAIN (System Settings → Company & Tax).
The Liner module (LN) is licensed.
The TFP API credentials are present in settings (see below).

2 Configure API credentials

The credentials are stored as application settings (KEYPAIRS). Set these keys (via the DBA/settings tools):

Key	Meaning
`BH_API_ENDPOINT`	TFP manifest API URL (e.g. the OFOQ `/tfp-service…/api/v1/manifest/sea` endpoint).
`BH_API_USER`	API username (Basic auth).
`BH_API_SECRET`	API password/secret (Basic auth).
`BH_DECL_OFFICE`	Optional — Customs declaration office code.
`BH_SUBMITTER_ID`	Optional — submitter registration/TIN (defaults to the company CR/Business No).

Until the keys are set

the Customs Manifest button stays hidden and the API returns "credentials not configured".

3 Prepare the job data

The manifest is built from the Liner job. These fields must be complete or submission is blocked:

Header: Vessel (with country), Voyage No, Currency, Rotation No, Cargo Remarks.
Each Bill of Lading: Loading & Discharge port codes, Shipper / Consignee (with registration/PIN), Notify party.
Each container: Container No, ISO code, Goods description, HS code, Package type & count, Gross weight.

4 Submit & track

Open a saved job → Customs Manifest. In the drawer:

Choose type/container→ Preview XML→ Submit to Customs→ Check Status

Manifest Type: Master / House / Amend. The first submission is a Master (Original); once a manifest number is returned, resubmitting sends an Amend automatically.
Container: Containerised (68) / Non-container (69) / Bulk (19).
Preview XML builds the message and lists any missing mandatory fields without sending.
Submit to Customs sends it; the returned manifest number / status is logged.
Check Status re-queries the platform for the latest processing status.

Every attempt is kept in the submission log at the bottom of the drawer (reference id, type, manifest number, status).

5 Troubleshooting

Symptom	Fix
No Customs Manifest button	Company country isn't `BAHRAIN`, Liner module not licensed, or API keys not set.
"credentials not configured"	Set `BH_API_USER/SECRET/ENDPOINT` in settings.
Missing-field warning on submit	Complete the listed header / BL / container fields, then retry.
HTTP 401 / 403 from customs	Verify the API user/secret and endpoint URL.
Rejected / validation errors	Open the log row's status; correct the flagged data and resubmit (an Amend is sent automatically once a manifest number exists).

Field mapping

The message follows the TFP GOV-CBR WCO manifest specification. A few values are still simplified pending final UAT sign-off; see the internal Bahrain Manifest WCO Discrepancies note for details.