Bonded Duty-Free Diplomacy, Ship/Airport Tax-Free Retail & Customs Diplomatic Privilege (PRO-1B) ERP: Passport/Boarding-Pass Barcode Validation, KRA iCMS Bonded Quota Deduction, Multi-Currency POS & Sealed Tamper-Evident Bagging

International airport duty-free operators (at Jomo Kenyatta International Airport — JKIA, Moi International Airport — MIA Mombasa, Kilimanjaro, Entebbe, and Zanzibar), diplomatic duty-free commissaries serving embassies, High Commissions, and UN agencies in Gigiri/Nairobi, and bonded ship/airline chandlers operate under some of the strictest customs bond controls in East Africa. Every bottle of spirits, fragrance, luxury watch, tobacco carton, or diplomatic vehicle/provision sits under a suspended Customs Bond Guarantee until it is proven to have exited the customs territory on an international flight/vessel or been sold within an accredited diplomat’s approved PRO-1B quota. Running bonded mother warehouses, airside retail shops, and diplomatic commissaries on generic retail POS software leads to customs bond penalty assessments from unverified boarding passes or exceeded diplomatic quotas, multi-currency exchange-rate leakage, expiring bonded stock penalties after the statutory warehousing limit, and manual KRA iCMS ex-bond reconciliation backlogs.

At devManue, we engineer specialized Bonded Duty-Free Airport Retail & Diplomatic Commissary (PRO-1B) ERP & POS platforms. Our architecture embeds real-time passport/boarding-pass and diplomatic quota enforcement directly into the checkout lane while maintaining a bottle-level customs bond sub-ledger across mother bonded warehouses and airside stores.

1. 2D IATA Boarding-Pass (BCBP), Passport MRZ & Diplomatic PRO-1B Quota Enforcement at POS

Unlike domestic supermarkets, a duty-free checkout terminal cannot legally complete a sale unless the buyer’s international travel status or diplomatic privilege is cryptographically verified and linked to the receipt.

• IATA Resolution 792 2D Boarding Pass (BCBP) & Passport MRZ Scanner Integration: At airport duty-free lanes, scanning the passenger’s boarding pass and passport instantly parses Passenger Name, PNR, Carrier, Flight Number, Departure Airport (NBO/MBA), Destination Airport, and Flight Date—automatically blocking sales to domestic passengers (e.g., NBO -> MBA or NBO -> KIS), enforcing destination-country liquid/tobacco allowance alerts, and preventing duplicate boarding-pass reuse across terminals.
• Diplomatic PRO-1B Approval & Embassy Quota Ledger: For diplomatic duty-free commissaries, the ERP maintains each accredited mission’s and diplomat’s approved Ministry of Foreign Affairs (MFA) & KRA Customs PRO-1B periodic quota for spirits, wine, beer, tobacco, and provisions—deducting every purchase in real time and blocking checkout if an item exceeds the diplomat’s remaining authorized liters/units.
• ICAO Security Tamper-Evident Bag (STEB) Serialization for Liquids (LAGs): When selling Liquids, Aerosols, and Gels (LAGs >100 ml) to transit passengers, the POS requires scanning the unique serial barcode of the ICAO-compliant Security Tamper-Evident Bag (STEB) and prints the sealed-bag serial number directly onto the itemized duty-free receipt inside the bag.

2. Boarding-Pass / Diplomatic Quota Gate, Multi-Currency POS & Bonded Liability Engine

Every item in a bonded warehouse carries both its landed CIF cost in USD/EUR and its suspended Import Duty, Excise Duty, VAT, IDF, and RDL liability in KES. Our bonded POS and customs engine validates passenger/diplomatic eligibility, handles multi-currency split tenders, and tracks the exact customs bond exposure released upon sale:

from decimal import Decimal, ROUND_HALF_UP

class BondedDutyFreePosAndCustomsQuotaEngine:
    """
    Validates international flight departure (via IATA BCBP) or Diplomatic
    PRO-1B quota balance, computes multi-currency (USD/EUR/KES) POS checkout,
    and reconciles KRA Customs Bond suspended duty/excise/VAT acquittal.
    """
    @staticmethod
    def evaluate_duty_free_checkout_and_bond_acquittal(
        sale_channel: str,  # "AIRPORT_DEPARTURE" | "DIPLOMATIC_PRO1B"
        origin_airport_iata: str,
        destination_airport_iata: str,
        domestic_airports_set: set,
        diplomatic_pro1b_remaining_liters: Decimal,
        cart_spirits_and_wine_liters: Decimal,
        cart_total_usd: Decimal,
        usd_to_kes_pos_rate: Decimal,
        suspended_customs_duty_and_excise_kes: Decimal,
        steb_bag_serial_number: str,
    ) -> dict:
        if sale_channel == "AIRPORT_DEPARTURE":
            is_international_flight = (
                origin_airport_iata in domestic_airports_set
                and destination_airport_iata not in domestic_airports_set
                and bool(destination_airport_iata.strip())
            )
            allowance_compliant = cart_spirits_and_wine_liters <= Decimal("4.00")
            steb_valid = (cart_spirits_and_wine_liters == Decimal("0.0")) or (len(steb_bag_serial_number.strip()) >= 8)
            checkout_authorized = is_international_flight and allowance_compliant and steb_valid
        else:
            # Diplomatic PRO-1B Commissary Sale
            checkout_authorized = cart_spirits_and_wine_liters <= diplomatic_pro1b_remaining_liters
            steb_valid = True

        cart_equivalent_kes = (cart_total_usd * usd_to_kes_pos_rate).quantize(
            Decimal("0.01"), rounding=ROUND_HALF_UP
        )
        new_pro1b_balance_liters = max(
            Decimal("0.00"), diplomatic_pro1b_remaining_liters - cart_spirits_and_wine_liters
        ).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)

        return {
            "checkout_authorized": checkout_authorized,
            "cart_total_usd": cart_total_usd,
            "cart_equivalent_kes": cart_equivalent_kes,
            "steb_tamper_bag_verified": steb_valid,
            "remaining_pro1b_quota_liters": new_pro1b_balance_liters,
            "customs_bond_liability_acquitted_kes": suspended_customs_duty_and_excise_kes if checkout_authorized else Decimal("0.00"),
            "pos_verdict": "APPROVED_ISSUE_BONDED_RECEIPT" if checkout_authorized else "BLOCKED_DOMESTIC_FLIGHT_OR_QUOTA_EXCEEDED",
        }

3. Bonded Warehouse Aging Alerts, Pre-Order Gate Delivery & KRA iCMS Ex-Bond Reconciliation

Behind the retail floor, our ERP protects the operator’s customs bond guarantee and maximizes passenger spend:

• Customs Bond Guarantee Utilization & Statutory Warehousing Expiry Radar: Tracks every inbound KRA iCMS Warehousing Entry (C17) by bond number, calculating real-time utilized vs. available bank/insurance bond guarantee in KES, and raising 90/60/30-day alerts before any bonded consignment reaches its statutory warehousing limit (preventing forced duty-paid clearance or customs auction).
• Multi-Currency Split-Tender POS & Pre-Order "Click & Collect at Gate": Allows travelers to pay in a single transaction combining physical USD/EUR/GBP notes, Visa/Mastercard, and KES M-Pesa STK Push (automatically calculating change in the selected currency), or pre-order online for sealed delivery at the departure boarding gate.
• Automated KRA iCMS Ex-Warehouse Acquittal Schedules: Aggregates daily verified boarding-pass and PRO-1B sales by original inbound Customs Entry (HS Code, Tariff Line, Bond Number, and Quantity) to generate the consolidated ex-bond acquittal return without manual spreadsheet vlookups.