From 21a611f1b75cfaffbf8b5401fb3ea80e01d1da8c Mon Sep 17 00:00:00 2001
From: Marshal <marshal@example.com>
Date: Thu, 20 Aug 2026 07:16:18 +0000
Subject: [PATCH] fix(portal): surface document upload on cleared bookings
 until payment

---
 .../BookingDetailPage/components/ClearanceCard.tsx  |  2 +-
 .../src/pages/bookings/clearance/ClearanceFlow.tsx  | 13 +------------
 .../pages/bookings/clearance/bookingNextAction.ts   |  9 +++++----
 3 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx
index 3002356f7..f5fa3f934 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/BookingDetailPage/components/ClearanceCard.tsx
@@ -66,7 +66,7 @@ export function ClearanceCard({ booking }: { booking: Freight.IBooking }) {
           isBookAction
             ? "Book your shipment — enter the cargo details and pick a shipment day inside an open booking window."
             : "Pick a shipment day and proceed to operation."
-        }`}
+        } You can still add documents to this shipment until it is paid.`}
       </Alert>
     ) : status === "DOCUMENTS_UNDER_REVIEW" ? (
       <Alert color="blue" radius="md" icon={<Clock size={18} />}>
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx b/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx
index 7a7a55b71..fd8739a4a 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx
+++ b/apps/edr-freight-web/portal/src/pages/bookings/clearance/ClearanceFlow.tsx
@@ -95,7 +95,7 @@ export function ClearanceFlow({ booking, flow, footer }: ClearanceFlowProps) {
           {needsCompletion
             ? "Clearance is finalized. Complete your booking now — enter the cargo details and pick a shipment day inside an open booking window."
             : awaitingGlCompletion
-              ? "Customs clearance is complete. Global Logistics is completing your booking (cargo details and shipment day) — you will be notified when payment is due."
+              ? "Customs clearance is complete. Global Logistics is completing your booking (cargo details and shipment day) — you will be notified when payment is due. You can still add documents below until the shipment is paid."
               : clearance.includesCustoms
                 ? "Customs clearance is complete and your cleared documents are available below. You can now proceed to operation."
                 : "Your documents are approved. You can now proceed to operation."}
@@ -209,17 +209,6 @@ export function ClearanceFlow({ booking, flow, footer }: ClearanceFlowProps) {
         </>
       )}
 
-      {/* Clearance is done but the shipment is not paid yet: documents stay
-          open, so say so — otherwise the upload box below reads as leftover UI. */}
-      {canUpload && !isInitialUpload && status !== "DOCUMENTS_UNDER_REVIEW" ? (
-        <Alert color="blue" variant="light" radius="md" mt="md" p="xs">
-          <Text fz="12px">
-            Need to send something else? You can still add documents to this
-            shipment until it is paid.
-          </Text>
-        </Alert>
-      ) : null}
-
       {canUpload ? (
         <ClearanceAdHocUploadSection
           rows={adHoc}
diff --git a/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts b/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts
index 297b0c152..354220e21 100644
--- a/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts
+++ b/apps/edr-freight-web/portal/src/pages/bookings/clearance/bookingNextAction.ts
@@ -130,13 +130,14 @@ export function getBookingNextAction(
   booking: ActionBooking,
 ): BookingNextAction | null {
   if (booking.status === "CLEARANCE_READY" && isBareInstance(booking)) {
-    // Customs (Path B): GL completes the booking — the customer can only view
-    // the finished clearance in the modal.
+    // Customs (Path B): GL completes the booking, so there is no schedule step
+    // for the customer here — but documents stay open until the shipment is
+    // paid, so the modal is still an action surface, not a read-only view.
     if (booking.customsClearingEnabled) {
       return {
         kind: "SCHEDULE_OPERATION",
-        label: "View clearance",
-        title: "Clearance complete",
+        label: "Documents",
+        title: "Clearance documents",
       };
     }
     // Non-customs (Path A): straight to the booking form — cargo + shipment