@zeniai/client-epic-state 5.1.91 → 5.1.92

package/lib/entity/snackbar/snackbarApiError.d.ts

@@ -0,0 +1,8 @@
+import { ZeniAPIStatus } from '../../responsePayload';
+interface SnackbarMessageVariable {
+    variableName: string;
+    variableValue: string;
+}
+/** Undefined when the status carries no message, so the snackbar falls back to its generic copy. */
+export declare const apiErrorSnackbarVariables: (status: ZeniAPIStatus | undefined) => SnackbarMessageVariable[] | undefined;
+export {};

package/lib/entity/snackbar/snackbarApiError.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiErrorSnackbarVariables = void 0;
+/** Placeholder in every `failed` snackbar string, swapped for the API's message. */
+const API_ERROR_TOKEN = '_api-error_';
+/** Undefined when the status carries no message, so the snackbar falls back to its generic copy. */
+// Pass only platform statuses: a local `createZeniAPIStatus` holds internal debug text.
+const apiErrorSnackbarVariables = (status) => {
+    const message = status?.message?.trim() ?? '';
+    if (message === '') {
+        return undefined;
+    }
+    return [{ variableName: API_ERROR_TOKEN, variableValue: message }];
+};
+exports.apiErrorSnackbarVariables = apiErrorSnackbarVariables;

package/lib/esm/entity/snackbar/snackbarApiError.js

@@ -0,0 +1,11 @@
+/** Placeholder in every `failed` snackbar string, swapped for the API's message. */
+const API_ERROR_TOKEN = '_api-error_';
+/** Undefined when the status carries no message, so the snackbar falls back to its generic copy. */
+// Pass only platform statuses: a local `createZeniAPIStatus` holds internal debug text.
+export const apiErrorSnackbarVariables = (status) => {
+    const message = status?.message?.trim() ?? '';
+    if (message === '') {
+        return undefined;
+    }
+    return [{ variableName: API_ERROR_TOKEN, variableValue: message }];
+};

package/lib/esm/index.js

@@ -839,7 +839,7 @@ export { getInvoicingPlanById } from './entity/invoicing/plan/planSelector';
 export { getInvoicingProductById } from './entity/invoicing/product/productSelector';
 // ── Invoicing: settings ───────────────────────────────────────────────────────
 export { clearInvoicingSettings, connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, resetInvoicingBrandingFormDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingBrandingFormDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
-export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsHubView, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
 export { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, initialInvoicingBrandingFormLocalData, } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
 export { isStripeConnectedFromSettings } from './view/invoicing/settingsView/invoicingSettingsHelpers';
 // ── Invoicing: QBO integration ────────────────────────────────────────────────

package/lib/esm/view/invoicing/createCreditNote/createCreditNoteEpic.js

@@ -1,6 +1,7 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCreditNotes } from '../../../entity/invoicing/creditNote/creditNoteReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { localDataToCreateCreditNotePayload, } from './createCreditNotePayload';
@@ -29,6 +30,7 @@ export const createCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/createInvoice/createInvoiceEpic.js

@@ -3,6 +3,7 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingInvoiceAddresses } from '../../../entity/invoicing/invoice/invoicePayload';
 import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { addInvoiceToList } from '../invoiceList/invoiceListReducer';
@@ -36,6 +37,7 @@ export const createInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe(f
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/discountAction/discountActionEpic.js

@@ -1,8 +1,9 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCoupons } from '../../../entity/invoicing/coupon/couponReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingDiscountAction, runInvoicingDiscountActionFailure, runInvoicingDiscountActionSuccess, } from './discountActionReducer';
 /** Snackbar copy per action kind; unlisted kinds run without one. */
 const SNACKBAR_SECTION_BY_KIND = {
@@ -14,13 +15,15 @@ export const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => ac
     const { action: kind, id } = action.payload;
     const requestBody = { action: kind };
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/discounts/${encodeURIComponent(id)}/actions`;
@@ -39,7 +42,7 @@ export const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => ac
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingDiscountActionFailure({

package/lib/esm/view/invoicing/dunningAction/dunningActionEpic.js

@@ -1,8 +1,9 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingDunningCases } from '../../../entity/invoicing/dunningCase/dunningCaseReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingDunningAction, runInvoicingDunningActionFailure, runInvoicingDunningActionSuccess, } from './dunningActionReducer';
 /**
  * Snackbar copy is per action kind; anything not listed here runs without one.
@@ -15,13 +16,15 @@ const SNACKBAR_SECTION_BY_KIND = {
 export const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(runInvoicingDunningAction.match), mergeMap((action) => {
     const { action: kind, body, id } = action.payload;
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/dunning/${encodeURIComponent(id)}/${kind}`;
@@ -40,7 +43,7 @@ export const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => act
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingDunningActionFailure({

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewPayload.js

@@ -80,6 +80,8 @@ const buildSubFamilyPayload = (localData, subFamily, clearEmptyValues) => {
     }
     return payload;
 };
+/** `unit` is the item's unit of measure, not a currency; `CURRENCY_CODE` above prices sub-families. */
+const DEFAULT_CATALOG_ITEM_UNIT = 'USD';
 /**
  * Build the parent catalog-item request body from the form draft. Creates omit
  * both parent and sub-family IDs; edits retain returned sub-family IDs.
@@ -101,10 +103,9 @@ export const localDataToSaveInvoicingCatalogItemPayload = (localData, isCreate)
     if (description != null) {
         itemPayload.description = description;
     }
-    const unit = trimOrUndefined(localData.unit);
-    if (unit != null) {
-        itemPayload.unit = unit;
-    }
+    // The form no longer collects a unit; an item that already has one keeps it.
+    itemPayload.unit =
+        trimOrUndefined(localData.unit) ?? DEFAULT_CATALOG_ITEM_UNIT;
     if (localData.itemApplicability === 'restricted' &&
         localData.applicableItems.length > 0) {
         itemPayload.applicable_items = localData.applicableItems;

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/saveInvoicingCatalogItemEpic.js

@@ -2,6 +2,7 @@ import { forkJoin, from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { mergeInvoicingPlanSubFamily, updateInvoicingPlans, } from '../../../entity/invoicing/plan/planReducer';
 import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { addInvoicingCatalogItem } from '../invoicingCatalogListView/invoicingCatalogListViewReducer';
@@ -45,6 +46,7 @@ export const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actio
                             messageSection: 'invoicing_catalog_item_saved',
                             messageText: 'failed',
                             type: 'error',
+                            variables: apiErrorSnackbarVariables(failedProductResponse.status),
                         }),
                     ]);
                 }
@@ -94,6 +96,7 @@ export const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actio
                 messageSection: 'invoicing_catalog_item_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/saveInvoicingCouponEpic.js

@@ -1,6 +1,7 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCoupons } from '../../../entity/invoicing/coupon/couponReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { addInvoicingCouponToList } from '../couponView/couponViewReducer';
@@ -57,6 +58,7 @@ export const saveInvoicingCouponEpic = (actions$, state$, zeniAPI) => actions$.p
                 messageSection: 'invoicing_coupon_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/editInvoicingCustomerDetailView/saveInvoicingCustomerEpic.js

@@ -3,6 +3,7 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingCustomerAddresses } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload';
 import { updateInvoicingCustomers } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
@@ -59,6 +60,7 @@ export const saveInvoicingCustomerEpic = (actions$, state$, zeniAPI) => actions$
                 messageSection: 'invoicing_customer_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/editInvoicingSubscriptionDetailView/saveInvoicingSubscriptionEpic.js

@@ -3,6 +3,7 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingSubscriptionAddresses } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
 import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
@@ -45,6 +46,7 @@ export const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => acti
                     messageSection: 'invoicing_subscription_saved',
                     messageText: 'failed',
                     type: 'error',
+                    variables: apiErrorSnackbarVariables(response.status),
                 }),
             ];
         }

package/lib/esm/view/invoicing/invoiceAction/invoiceActionEpic.js

@@ -3,8 +3,9 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingInvoiceAddresses } from '../../../entity/invoicing/invoice/invoicePayload';
 import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingInvoiceAction, runInvoicingInvoiceActionFailure, runInvoicingInvoiceActionSuccess, updateInvoicingInvoice, } from './invoiceActionReducer';
 /** Snackbar copy per action kind; unlisted kinds run without one. */
 const SNACKBAR_SECTION_BY_KIND = {
@@ -16,13 +17,15 @@ export const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => act
     action.payload.action !== 'issue-credit-note'), mergeMap((action) => {
     const { action: kind, body, invoiceId } = action.payload;
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/${kind}`;
@@ -42,7 +45,7 @@ export const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => act
                 error: response.status,
                 invoiceId,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingInvoiceActionFailure({
@@ -80,6 +83,7 @@ export const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => action
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/invoicingQboView/epics/retryInvoicingQboSyncTaskEpic.js

@@ -1,5 +1,6 @@
 import { from, of } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { apiErrorSnackbarVariables } from '../../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { fetchInvoicingQboSyncHealth, retryInvoicingQboSyncTask, retryInvoicingQboSyncTaskFailure, retryInvoicingQboSyncTaskSuccess, } from '../invoicingQboViewReducer';
@@ -28,6 +29,7 @@ export const retryInvoicingQboSyncTaskEpic = (actions$, _state$, zeniAPI) => act
                 messageSection: 'invoicing_qbo_sync_health_retry',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/invoicingQboView/epics/startInvoicingQboBackfillEpic.js

@@ -1,5 +1,6 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
+import { apiErrorSnackbarVariables } from '../../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { fetchInvoicingQboSyncHealth, startInvoicingQboBackfill, startInvoicingQboBackfillFailure, startInvoicingQboBackfillSuccess, } from '../invoicingQboViewReducer';
@@ -27,6 +28,7 @@ export const startInvoicingQboBackfillEpic = (actions$, _state$, zeniAPI) => act
                 messageSection: 'invoicing_qbo_backfill',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/issueCreditNote/issueCreditNoteEpic.js

@@ -1,6 +1,7 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCreditNotes } from '../../../entity/invoicing/creditNote/creditNoteReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { fetchInvoiceDetail } from '../invoiceDetail/invoiceDetailReducer';
@@ -32,6 +33,7 @@ export const issueCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe(
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/recordPayment/recordPaymentEpic.js

@@ -2,6 +2,7 @@ import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
 import { updateInvoicingTransactions } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { fetchInvoiceDetail } from '../invoiceDetail/invoiceDetailReducer';
@@ -40,6 +41,7 @@ export const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe(fi
                     messageSection: 'invoicing_payment_recorded',
                     messageText: 'failed',
                     type: 'error',
+                    variables: apiErrorSnackbarVariables(response.status),
                 }),
             ]);
         }), catchError((error) => from([
@@ -82,6 +84,7 @@ export const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe(fi
                 messageSection: 'invoicing_payment_recorded',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/settingsView/settingsViewEpics.js

@@ -1,8 +1,9 @@
 import { from, of } from 'rxjs';
 import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, updateInvoicingSettings, updateInvoicingSettingsFailure, updateInvoicingStripeConnection, } from './settingsViewReducer';
 export const fetchInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingSettings.match), switchMap(() => {
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
@@ -59,13 +60,15 @@ export const disconnectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => act
 export const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(saveInvoicingSettings.match), mergeMap((action) => {
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
     const { settings, snackbarSection } = action.payload;
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     return zeniAPI
@@ -79,7 +82,7 @@ export const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions
         }
         return from([
             saveInvoicingSettingsFailure(response.status),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         saveInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Save settings REST API call errored out ' +

package/lib/esm/view/invoicing/settingsView/settingsViewSelector.js

@@ -1,3 +1,4 @@
+import { getInvoicingQboAccountMappingId, } from '../../../entity/invoicing/invoicingCommonPayload';
 import { getFormattedAddress } from '../../addressView/addressViewSelector';
 import { getInvoicingConfigView } from '../invoicingConfigView/invoicingConfigViewSelector';
 import { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, } from './invoicingBrandingFormConfig';
@@ -30,6 +31,57 @@ export const getInvoicingSettingsView = (state) => {
         stripeConnectState: stripeFetchState,
     };
 };
+/**
+ * Gates the Enable Invoicing action: payments must be able to land (Stripe
+ * connected *and* accepting charges) and the QBO accounting step must be
+ * finished, so an enabled tenant can always book what it invoices.
+ *
+ * Deliberately not part of `deriveInvoicingOnboardingStatus`, which routes the
+ * module off the config flags alone. Folding these in there would (a) demote a
+ * live tenant to the settings tree the moment an integration broke, stranding
+ * its existing invoices, and (b) deadlock the route gate, which fetches only the
+ * config — never the settings or QBO connection these read.
+ */
+export function deriveInvoicingEnablePrerequisites(settings, isQboConnected, qboAccountMappingKindOptions) {
+    const isStripeConnected = settings?.stripe_connected === true &&
+        settings?.stripe_account?.charges_enabled === true;
+    const accountMappings = settings?.qbo?.account_mappings ?? undefined;
+    // An empty option list means the config has not landed yet — treating that as
+    // configured would let `every` pass vacuously and unlock the button early.
+    const isQboConfigured = isQboConnected &&
+        qboAccountMappingKindOptions.length > 0 &&
+        qboAccountMappingKindOptions.every((option) => getInvoicingQboAccountMappingId(accountMappings, option.code) != null);
+    return {
+        canEnable: isStripeConnected && isQboConfigured,
+        isQboConfigured,
+        isStripeConnected,
+    };
+}
+/**
+ * The settings hub's composite of everything it derives from the store: whether
+ * to offer Enable Invoicing at all, the in-flight flag for that action, and the
+ * two integration prerequisites kept separate so the hub can name the step still
+ * outstanding instead of showing a dead button.
+ *
+ * `canEnableInvoicing` folds in the onboarding step, so the screen does not need
+ * to re-check it: the footer is only offered mid-onboarding and only once both
+ * integrations are ready.
+ *
+ * Deliberately not folded into `getInvoicingConfigView`: that selector gates
+ * every invoicing route and stays a pure read of the config slice. The settings
+ * and QBO slices read here are only fetched once a settings screen is mounted.
+ */
+export const getInvoicingSettingsHubView = (state) => {
+    const { enableState, qboAccountMappingKindOptions, status } = getInvoicingConfigView(state);
+    const { canEnable, isQboConfigured, isStripeConnected } = deriveInvoicingEnablePrerequisites(state.invoicingSettingsViewState.settings, state.invoicingQboViewState.connection?.connected === true, qboAccountMappingKindOptions);
+    return {
+        canEnableInvoicing: status === 'settings' && canEnable,
+        isEnablingInvoicing: enableState.fetchState === 'In-Progress',
+        isQboConfigured,
+        isStripeConnected,
+        status,
+    };
+};
 /**
  * Bundled view for the branding settings form: the draft `localData` (seeded
  * from the existing settings until the user edits), the business-address label

package/lib/esm/view/invoicing/subscriptionAction/subscriptionActionEpic.js

@@ -3,8 +3,9 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingSubscriptionAddresses } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
 import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingSubscriptionAction, runInvoicingSubscriptionActionFailure, runInvoicingSubscriptionActionSuccess, } from './subscriptionActionReducer';
 /**
  * Each lifecycle action reports with its own copy. Keyed loosely because the
@@ -24,13 +25,15 @@ export const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) =
     const { action: kind, body, id } = action.payload;
     const requestBody = { action: kind, ...(body ?? {}) };
     const snackbarSection = SNACKBAR_SECTION_BY_ACTION[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/subscriptions/${encodeURIComponent(id)}/actions`;
@@ -50,7 +53,7 @@ export const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) =
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingSubscriptionActionFailure({

package/lib/esm/view/vendorTabView/vendorTabViewReducer.js

@@ -53,5 +53,5 @@ const vendorTabView = createSlice({
         });
     },
 });
-export const { clearVendorTabView, fetchVendorTabView, updateVendorTabViewTab, } = vendorTabView.actions;
+export const { clearVendorTabView, fetchVendorTabView, updateVendorTabViewTab } = vendorTabView.actions;
 export default vendorTabView.reducer;

package/lib/index.d.ts

@@ -137,7 +137,7 @@ import { getTaskGroupById } from './entity/taskGroup/taskGroupSelector';
 import { TaskGroupState } from './entity/taskGroup/taskGroupState';
 import { TaskGroupTemplate } from './entity/taskGroupTemplate/taskGroupTemplateState';
 import { DoSignInPayload, deleteConnection, doMagicLinkSignIn, doSignIn, doSignOut, fetchActiveTenant, fetchAllTenants, fetchExcludedResources as fetchExcludedResourcesForTenant, fetchExternalConnections as fetchExternalConnectionsForTenant, fetchSubscriptionSummaryForTenant, initEmailConnectOAuth, resendVerifyDeviceOTP, resetSignInState, saveAPIKeyConnection, saveConnectorCredentials, saveExternalConnection as saveExternalConnectionForTenant, saveOAuthConnection, sendEmailMagicLinkToUser, sendSessionHeartbeat, toExternalIntegrationType, toExternalSupportedTool, updateCurrentTenant, updateSignInState, verifyDeviceWithTwoFA } from './entity/tenant/tenantReducer';
-import { CurrentTenant, TenantBaseView, TenantCoreDetailsView, TenantView, TenantsBaseOrdered, TenantsOrdered, DEFAULT_RECEIPTS_EMAIL, getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getReceiptsEmail, getTenantBaseById, getTenantBaseViewForTenantId, getTenantBaseViewForTenantView, getTenantsBaseByCheckInDateSelector, getTenantsByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, isOtherProductsEnabledForTenant, isTenantBankingOnly, isTenantBookkeepingEnabled, isTenantCardsOnly, isTenantUsingZeniCOA, isZeniDomainTenant, toTenantCoreDetailsView } from './entity/tenant/tenantSelector';
+import { CurrentTenant, DEFAULT_RECEIPTS_EMAIL, TenantBaseView, TenantCoreDetailsView, TenantView, TenantsBaseOrdered, TenantsOrdered, getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getReceiptsEmail, getTenantBaseById, getTenantBaseViewForTenantId, getTenantBaseViewForTenantView, getTenantsBaseByCheckInDateSelector, getTenantsByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, isOtherProductsEnabledForTenant, isTenantBankingOnly, isTenantBookkeepingEnabled, isTenantCardsOnly, isTenantUsingZeniCOA, isZeniDomainTenant, toTenantCoreDetailsView } from './entity/tenant/tenantSelector';
 import { CapitalizableAccount, CapitalizableAccounts, CapitalizableClassificationType, CapitalizableMatchPattern, Connection, LoggedInUser, RoleResource, Tenant, TenantProductSettings } from './entity/tenant/tenantState';
 import { ToastNotificationPayload } from './entity/toastNotification/toastNotificationPayload';
 import { pushToastNotification } from './entity/toastNotification/toastNotificationReducer';
@@ -1211,8 +1211,8 @@ export { getInvoicingPlanById } from './entity/invoicing/plan/planSelector';
 export { getInvoicingProductById } from './entity/invoicing/product/productSelector';
 export type { InvoicingCatalogItemDetailView } from './view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewSelector';
 export { clearInvoicingSettings, connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, resetInvoicingBrandingFormDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingBrandingFormDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
-export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
-export type { InvoicingBrandingFormView, InvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsHubView, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export type { InvoicingBrandingFormView, InvoicingSettingsHubView, InvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
 export type { InvoicingBrandingFormLocalData } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
 export { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, initialInvoicingBrandingFormLocalData, } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
 export { isStripeConnectedFromSettings } from './view/invoicing/settingsView/invoicingSettingsHelpers';

package/lib/index.js

@@ -84,7 +84,7 @@ exports.updateInvoicingCustomerFilters = exports.setInvoicingCustomerActiveTab =
 exports.updateInvoicingTransactionFilters = exports.setInvoicingTransactionActiveTab = exports.fetchInvoicingTransactionListPage = exports.fetchInvoicingTransactionList = exports.clearInvoicingTransactionListView = exports.updateInvoicingTransactions = exports.removeInvoicingTransaction = exports.clearAllInvoicingTransactions = exports.getInvoicingSubscriptionDetail = exports.getInvoicingSubscriptionById = exports.fetchInvoicingSubscriptionDetail = exports.clearInvoicingSubscriptionDetailView = exports.getInvoicingSubscriptionListView = exports.INVOICING_SUBSCRIPTION_TABS = exports.INVOICING_SUBSCRIPTION_COLUMNS = exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS = exports.ALL_INVOICING_SUBSCRIPTION_SORT_KEYS = exports.updateInvoicingSubscriptionFilters = exports.setInvoicingSubscriptionActiveTab = exports.fetchInvoicingSubscriptionListPage = exports.fetchInvoicingSubscriptionList = exports.fetchInvoicingSubscriptionCounts = exports.clearInvoicingSubscriptionListView = exports.updateInvoicingSubscriptions = exports.removeInvoicingSubscription = exports.clearAllInvoicingSubscriptions = exports.resetPromotionalCreditAction = exports.submitAddPromotionalCredits = exports.getInvoicingSetupIntentFetchState = exports.getInvoicingSetupIntent = exports.getInvoicingSentPaymentLinkMagicUrl = exports.getInvoicingSentPaymentLinkEmail = exports.getInvoicingPlaidLinkTokenFetchState = exports.getInvoicingPlaidLinkToken = exports.getInvoicingPaymentMethodSaveState = exports.getInvoicingPaymentLinkSendState = exports.sendInvoicingPaymentLink = exports.saveInvoicingPaymentMethod = exports.resetInvoicingCustomerPaymentMethod = exports.fetchInvoicingPlaidLinkToken = exports.createInvoicingSetupIntent = exports.getInvoicingCustomerDetail = exports.fetchInvoicingCustomerDetailPage = exports.fetchInvoicingCustomerDetail = exports.clearInvoicingCustomerDetailView = exports.getInvoicingCustomerListView = exports.INVOICING_CUSTOMER_TABS = exports.INVOICING_CUSTOMER_COLUMNS = exports.ALL_INVOICING_CUSTOMER_TAB_IDS = exports.ALL_INVOICING_CUSTOMER_SORT_KEYS = void 0;
 exports.fetchInvoicingCouponDetail = exports.clearInvoicingCouponDetailView = exports.getInvoicingCouponById = exports.getInvoicingCouponListView = exports.getInvoicingCouponListNextCursor = exports.getInvoicingCouponListItems = exports.getInvoicingCouponListHasMore = exports.getInvoicingCouponListFilters = exports.getInvoicingCouponListFetchState = exports.getInvoicingCouponCounts = exports.INVOICING_COUPON_TABS = exports.INVOICING_COUPON_COLUMNS = exports.ALL_INVOICING_COUPON_TAB_IDS = exports.ALL_INVOICING_COUPON_SORT_KEYS = exports.updateInvoicingCouponFilters = exports.setInvoicingCouponActiveTab = exports.fetchInvoicingCouponListPage = exports.fetchInvoicingCouponList = exports.fetchInvoicingCouponCounts = exports.clearInvoicingCouponView = exports.updateInvoicingCoupons = exports.removeInvoicingCoupon = exports.clearAllInvoicingCoupons = exports.getInvoicingCreditNoteDetail = exports.getInvoicingCreditNoteById = exports.fetchInvoicingCreditNoteDetail = exports.clearInvoicingCreditNoteDetailView = exports.getInvoicingCreditNoteListView = exports.INVOICING_CREDIT_NOTE_TABS = exports.INVOICING_CREDIT_NOTE_COLUMNS = exports.ALL_INVOICING_CREDIT_NOTE_TAB_IDS = exports.ALL_INVOICING_CREDIT_NOTE_SORT_KEYS = exports.updateInvoicingCreditNoteFilters = exports.setInvoicingCreditNoteActiveTab = exports.fetchInvoicingCreditNoteListPage = exports.fetchInvoicingCreditNoteList = exports.fetchInvoicingCreditNoteCounts = exports.clearInvoicingCreditNoteListView = exports.updateInvoicingCreditNotes = exports.removeInvoicingCreditNote = exports.clearAllInvoicingCreditNotes = exports.getInvoicingTransactionDetail = exports.getInvoicingTransactionById = exports.fetchInvoicingTransactionDetail = exports.clearInvoicingTransactionDetailView = exports.getInvoicingTransactionListView = exports.INVOICING_TRANSACTION_TABS = exports.INVOICING_TRANSACTION_COLUMNS = exports.ALL_INVOICING_TRANSACTION_TAB_IDS = exports.ALL_INVOICING_TRANSACTION_SORT_KEYS = void 0;
 exports.resetSaveInvoicingSettings = exports.resetInvoicingBrandingFormDraft = exports.fetchInvoicingSettings = exports.disconnectInvoicingStripe = exports.connectInvoicingStripe = exports.clearInvoicingSettings = exports.getInvoicingProductById = exports.getInvoicingPlanById = exports.getInvoicingCatalogItemDetail = exports.fetchInvoicingCatalogItemDetail = exports.clearInvoicingCatalogItemDetailView = exports.getInvoicingCatalogListView = exports.INVOICING_PRODUCT_COLUMNS = exports.ALL_INVOICING_PRODUCT_SORT_KEYS = exports.updateInvoicingCatalogProductFilters = exports.updateInvoicingCatalogPlanFilters = exports.fetchInvoicingCatalogProductList = exports.fetchInvoicingCatalogPlanList = exports.fetchInvoicingCatalogListPage = exports.fetchInvoicingCatalogCounts = exports.clearInvoicingCatalogListView = exports.updateInvoicingProducts = exports.removeInvoicingProduct = exports.clearAllInvoicingProducts = exports.updateInvoicingPlans = exports.removeInvoicingPlan = exports.mergeInvoicingPlanSubFamily = exports.clearAllInvoicingPlans = exports.getInvoicingDunningEmailPreview = exports.getInvoicingDunningCaseDetail = exports.getInvoicingDunningCaseById = exports.invalidateInvoicingDunningEmailPreview = exports.fetchInvoicingDunningEmailPreviewPage = exports.fetchInvoicingDunningCaseDetail = exports.clearInvoicingDunningCaseDetailView = exports.getInvoicingDunningCaseListView = exports.INVOICING_DUNNING_CASE_TABS = exports.INVOICING_DUNNING_CASE_COLUMNS = exports.ALL_INVOICING_DUNNING_CASE_TAB_IDS = exports.ALL_INVOICING_DUNNING_CASE_SORT_KEYS = exports.updateInvoicingDunningCaseFilters = exports.setInvoicingDunningCaseActiveTab = exports.fetchInvoicingDunningCaseListPage = exports.fetchInvoicingDunningCaseList = exports.fetchInvoicingDunningCaseCounts = exports.clearInvoicingDunningCaseListView = exports.updateInvoicingDunningCases = exports.removeInvoicingDunningCase = exports.clearAllInvoicingDunningCases = exports.getInvoicingCouponDetail = void 0;
-exports.getInvoicingConfigView = exports.updateInvoicingConfig = exports.resetInvoicingConfigActionStates = exports.fetchInvoicingConfig = exports.enableInvoicing = exports.clearInvoicingConfig = exports.acceptInvoicingTerms = exports.withInvoicingQboAccountMappingId = exports.toInvoicingQboCustomerMatchingMode = exports.getInvoicingQboAccountMappingId = exports.INVOICING_QBO_CUSTOMER_MATCHING_MODES = exports.getInvoicingQboView = exports.startInvoicingQboBackfill = exports.retryInvoicingQboSyncTask = exports.fetchInvoicingQboSyncHealth = exports.fetchInvoicingQboConnection = exports.fetchInvoicingQboClasses = exports.fetchInvoicingQboAccounts = exports.clearInvoicingQboView = exports.isStripeConnectedFromSettings = exports.initialInvoicingBrandingFormLocalData = exports.entityToInvoicingBrandingFormLocalData = exports.INVOICING_BUSINESS_ADDRESS_TYPE = exports.getInvoicingSettingsView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = exports.getInvoicingBrandingFormView = exports.updateInvoicingSettings = exports.updateInvoicingBrandingFormDraft = exports.submitInvoicingBrandingForm = exports.saveInvoicingSettings = void 0;
+exports.getInvoicingConfigView = exports.updateInvoicingConfig = exports.resetInvoicingConfigActionStates = exports.fetchInvoicingConfig = exports.enableInvoicing = exports.clearInvoicingConfig = exports.acceptInvoicingTerms = exports.withInvoicingQboAccountMappingId = exports.toInvoicingQboCustomerMatchingMode = exports.getInvoicingQboAccountMappingId = exports.INVOICING_QBO_CUSTOMER_MATCHING_MODES = exports.getInvoicingQboView = exports.startInvoicingQboBackfill = exports.retryInvoicingQboSyncTask = exports.fetchInvoicingQboSyncHealth = exports.fetchInvoicingQboConnection = exports.fetchInvoicingQboClasses = exports.fetchInvoicingQboAccounts = exports.clearInvoicingQboView = exports.isStripeConnectedFromSettings = exports.initialInvoicingBrandingFormLocalData = exports.entityToInvoicingBrandingFormLocalData = exports.INVOICING_BUSINESS_ADDRESS_TYPE = exports.getInvoicingSettingsView = exports.getInvoicingSettingsHubView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = exports.getInvoicingBrandingFormView = exports.updateInvoicingSettings = exports.updateInvoicingBrandingFormDraft = exports.submitInvoicingBrandingForm = exports.saveInvoicingSettings = void 0;
 const allowedValue_1 = require("./commonStateTypes/allowedValue");
 Object.defineProperty(exports, "isAllowedValueWithCode", { enumerable: true, get: function () { return allowedValue_1.isAllowedValueWithCode; } });
 Object.defineProperty(exports, "isAllowedValueWithID", { enumerable: true, get: function () { return allowedValue_1.isAllowedValueWithID; } });
@@ -3137,6 +3137,7 @@ var settingsViewSelector_2 = require("./view/invoicing/settingsView/settingsView
 Object.defineProperty(exports, "getInvoicingBrandingFormView", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingBrandingFormView; } });
 Object.defineProperty(exports, "getInvoicingSettings", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettings; } });
 Object.defineProperty(exports, "getInvoicingSettingsFetchState", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettingsFetchState; } });
+Object.defineProperty(exports, "getInvoicingSettingsHubView", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettingsHubView; } });
 Object.defineProperty(exports, "getInvoicingSettingsView", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettingsView; } });
 var invoicingBrandingFormConfig_1 = require("./view/invoicing/settingsView/invoicingBrandingFormConfig");
 Object.defineProperty(exports, "INVOICING_BUSINESS_ADDRESS_TYPE", { enumerable: true, get: function () { return invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE; } });

package/lib/view/invoicing/createCreditNote/createCreditNoteEpic.js

@@ -4,6 +4,7 @@ exports.createCreditNoteEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const creditNoteReducer_1 = require("../../../entity/invoicing/creditNote/creditNoteReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const createCreditNotePayload_1 = require("./createCreditNotePayload");
@@ -32,6 +33,7 @@ const createCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, op
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/createInvoice/createInvoiceEpic.js

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
 const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceListReducer_1 = require("../invoiceList/invoiceListReducer");
@@ -39,6 +40,7 @@ const createInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, oper
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/discountAction/discountActionEpic.js

@@ -4,6 +4,7 @@ exports.runInvoicingDiscountActionEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const couponReducer_1 = require("../../../entity/invoicing/coupon/couponReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const discountActionReducer_1 = require("./discountActionReducer");
@@ -17,13 +18,15 @@ const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => actions$.
     const { action: kind, id } = action.payload;
     const requestBody = { action: kind };
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/discounts/${encodeURIComponent(id)}/actions`;
@@ -42,7 +45,7 @@ const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => actions$.
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, discountActionReducer_1.runInvoicingDiscountActionFailure)({

package/lib/view/invoicing/dunningAction/dunningActionEpic.js

@@ -4,6 +4,7 @@ exports.runInvoicingDunningActionEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const dunningCaseReducer_1 = require("../../../entity/invoicing/dunningCase/dunningCaseReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const dunningActionReducer_1 = require("./dunningActionReducer");
@@ -18,13 +19,15 @@ const SNACKBAR_SECTION_BY_KIND = {
 const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(dunningActionReducer_1.runInvoicingDunningAction.match), (0, operators_1.mergeMap)((action) => {
     const { action: kind, body, id } = action.payload;
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/dunning/${encodeURIComponent(id)}/${kind}`;
@@ -43,7 +46,7 @@ const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => actions$.p
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, dunningActionReducer_1.runInvoicingDunningActionFailure)({

package/lib/view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewPayload.js

@@ -83,6 +83,8 @@ const buildSubFamilyPayload = (localData, subFamily, clearEmptyValues) => {
     }
     return payload;
 };
+/** `unit` is the item's unit of measure, not a currency; `CURRENCY_CODE` above prices sub-families. */
+const DEFAULT_CATALOG_ITEM_UNIT = 'USD';
 /**
  * Build the parent catalog-item request body from the form draft. Creates omit
  * both parent and sub-family IDs; edits retain returned sub-family IDs.
@@ -104,10 +106,9 @@ const localDataToSaveInvoicingCatalogItemPayload = (localData, isCreate) => {
     if (description != null) {
         itemPayload.description = description;
     }
-    const unit = trimOrUndefined(localData.unit);
-    if (unit != null) {
-        itemPayload.unit = unit;
-    }
+    // The form no longer collects a unit; an item that already has one keeps it.
+    itemPayload.unit =
+        trimOrUndefined(localData.unit) ?? DEFAULT_CATALOG_ITEM_UNIT;
     if (localData.itemApplicability === 'restricted' &&
         localData.applicableItems.length > 0) {
         itemPayload.applicable_items = localData.applicableItems;

package/lib/view/invoicing/editInvoicingCatalogItemDetailView/saveInvoicingCatalogItemEpic.js

@@ -5,6 +5,7 @@ const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const planReducer_1 = require("../../../entity/invoicing/plan/planReducer");
 const productReducer_1 = require("../../../entity/invoicing/product/productReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoicingCatalogListViewReducer_1 = require("../invoicingCatalogListView/invoicingCatalogListViewReducer");
@@ -48,6 +49,7 @@ const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actions$.pip
                             messageSection: 'invoicing_catalog_item_saved',
                             messageText: 'failed',
                             type: 'error',
+                            variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(failedProductResponse.status),
                         }),
                     ]);
                 }
@@ -97,6 +99,7 @@ const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actions$.pip
                 messageSection: 'invoicing_catalog_item_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/editInvoicingCouponDetailView/saveInvoicingCouponEpic.js

@@ -4,6 +4,7 @@ exports.saveInvoicingCouponEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const couponReducer_1 = require("../../../entity/invoicing/coupon/couponReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const couponViewReducer_1 = require("../couponView/couponViewReducer");
@@ -60,6 +61,7 @@ const saveInvoicingCouponEpic = (actions$, state$, zeniAPI) => actions$.pipe((0,
                 messageSection: 'invoicing_coupon_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/editInvoicingCustomerDetailView/saveInvoicingCustomerEpic.js

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicingCustomerPayload_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload");
 const invoicingCustomerReducer_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const addressViewReducer_1 = require("../../addressView/addressViewReducer");
@@ -62,6 +63,7 @@ const saveInvoicingCustomerEpic = (actions$, state$, zeniAPI) => actions$.pipe((
                 messageSection: 'invoicing_customer_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/editInvoicingSubscriptionDetailView/saveInvoicingSubscriptionEpic.js

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicingSubscriptionPayload_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload");
 const invoicingSubscriptionReducer_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const addressViewReducer_1 = require("../../addressView/addressViewReducer");
@@ -48,6 +49,7 @@ const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => actions$.pi
                     messageSection: 'invoicing_subscription_saved',
                     messageText: 'failed',
                     type: 'error',
+                    variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
                 }),
             ];
         }

package/lib/view/invoicing/invoiceAction/invoiceActionEpic.js

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
 const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceActionReducer_1 = require("./invoiceActionReducer");
@@ -19,13 +20,15 @@ const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => actions$.p
     action.payload.action !== 'issue-credit-note'), (0, operators_1.mergeMap)((action) => {
     const { action: kind, body, invoiceId } = action.payload;
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/${kind}`;
@@ -45,7 +48,7 @@ const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => actions$.p
                 error: response.status,
                 invoiceId,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, invoiceActionReducer_1.runInvoicingInvoiceActionFailure)({
@@ -84,6 +87,7 @@ const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/invoicingQboView/epics/retryInvoicingQboSyncTaskEpic.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.retryInvoicingQboSyncTaskEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const snackbarApiError_1 = require("../../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../../responsePayload");
 const invoicingQboViewReducer_1 = require("../invoicingQboViewReducer");
@@ -31,6 +32,7 @@ const retryInvoicingQboSyncTaskEpic = (actions$, _state$, zeniAPI) => actions$.p
                 messageSection: 'invoicing_qbo_sync_health_retry',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/invoicingQboView/epics/startInvoicingQboBackfillEpic.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.startInvoicingQboBackfillEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const snackbarApiError_1 = require("../../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../../responsePayload");
 const invoicingQboViewReducer_1 = require("../invoicingQboViewReducer");
@@ -30,6 +31,7 @@ const startInvoicingQboBackfillEpic = (actions$, _state$, zeniAPI) => actions$.p
                 messageSection: 'invoicing_qbo_backfill',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/issueCreditNote/issueCreditNoteEpic.js

@@ -4,6 +4,7 @@ exports.issueCreditNoteEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const creditNoteReducer_1 = require("../../../entity/invoicing/creditNote/creditNoteReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceDetailReducer_1 = require("../invoiceDetail/invoiceDetailReducer");
@@ -35,6 +36,7 @@ const issueCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, ope
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/recordPayment/recordPaymentEpic.js

@@ -5,6 +5,7 @@ const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
 const invoicingTransactionReducer_1 = require("../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceDetailReducer_1 = require("../invoiceDetail/invoiceDetailReducer");
@@ -43,6 +44,7 @@ const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, opera
                     messageSection: 'invoicing_payment_recorded',
                     messageText: 'failed',
                     type: 'error',
+                    variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
                 }),
             ]);
         }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
@@ -85,6 +87,7 @@ const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, opera
                 messageSection: 'invoicing_payment_recorded',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

package/lib/view/invoicing/settingsView/settingsViewEpics.js

@@ -4,6 +4,7 @@ exports.saveInvoicingSettingsEpic = exports.disconnectInvoicingStripeEpic = expo
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const settingsViewReducer_1 = require("./settingsViewReducer");
@@ -65,13 +66,15 @@ exports.disconnectInvoicingStripeEpic = disconnectInvoicingStripeEpic;
 const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.saveInvoicingSettings.match), (0, operators_1.mergeMap)((action) => {
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
     const { settings, snackbarSection } = action.payload;
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     return zeniAPI
@@ -85,7 +88,7 @@ const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(
         }
         return (0, rxjs_1.from)([
             (0, settingsViewReducer_1.saveInvoicingSettingsFailure)(response.status),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, settingsViewReducer_1.saveInvoicingSettingsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Save settings REST API call errored out ' +

package/lib/view/invoicing/settingsView/settingsViewSelector.d.ts

@@ -1,7 +1,8 @@
 import { FetchState, FetchStateAndError } from '../../../commonStateTypes/common';
-import { InvoicingNamedOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingNamedOption, InvoicingQboAccountMappingKindOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../reducer';
 import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingOnboardingStatus } from '../invoicingConfigView/invoicingConfigViewPayload';
 import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
 /**
  * Shared primitive: the raw invoicing settings. Consumed internally by other
@@ -27,6 +28,45 @@ export interface InvoicingSettingsView {
  * Stripe-connect fetch state.
  */
 export declare const getInvoicingSettingsView: (state: RootState) => InvoicingSettingsView;
+export interface InvoicingEnablePrerequisites {
+    canEnable: boolean;
+    isQboConfigured: boolean;
+    isStripeConnected: boolean;
+}
+/**
+ * Gates the Enable Invoicing action: payments must be able to land (Stripe
+ * connected *and* accepting charges) and the QBO accounting step must be
+ * finished, so an enabled tenant can always book what it invoices.
+ *
+ * Deliberately not part of `deriveInvoicingOnboardingStatus`, which routes the
+ * module off the config flags alone. Folding these in there would (a) demote a
+ * live tenant to the settings tree the moment an integration broke, stranding
+ * its existing invoices, and (b) deadlock the route gate, which fetches only the
+ * config — never the settings or QBO connection these read.
+ */
+export declare function deriveInvoicingEnablePrerequisites(settings: InvoicingSettingsPayload | undefined, isQboConnected: boolean, qboAccountMappingKindOptions: InvoicingQboAccountMappingKindOption[]): InvoicingEnablePrerequisites;
+export interface InvoicingSettingsHubView {
+    canEnableInvoicing: boolean;
+    isEnablingInvoicing: boolean;
+    isQboConfigured: boolean;
+    isStripeConnected: boolean;
+    status?: InvoicingOnboardingStatus;
+}
+/**
+ * The settings hub's composite of everything it derives from the store: whether
+ * to offer Enable Invoicing at all, the in-flight flag for that action, and the
+ * two integration prerequisites kept separate so the hub can name the step still
+ * outstanding instead of showing a dead button.
+ *
+ * `canEnableInvoicing` folds in the onboarding step, so the screen does not need
+ * to re-check it: the footer is only offered mid-onboarding and only once both
+ * integrations are ready.
+ *
+ * Deliberately not folded into `getInvoicingConfigView`: that selector gates
+ * every invoicing route and stays a pure read of the config slice. The settings
+ * and QBO slices read here are only fetched once a settings screen is mounted.
+ */
+export declare const getInvoicingSettingsHubView: (state: RootState) => InvoicingSettingsHubView;
 export interface InvoicingBrandingFormView {
     dateFormatOptions: InvoicingNamedOption[];
     localData: InvoicingBrandingFormLocalData;

package/lib/view/invoicing/settingsView/settingsViewSelector.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInvoicingBrandingFormView = exports.getInvoicingSettingsView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = void 0;
+exports.getInvoicingBrandingFormView = exports.getInvoicingSettingsHubView = exports.getInvoicingSettingsView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = void 0;
+exports.deriveInvoicingEnablePrerequisites = deriveInvoicingEnablePrerequisites;
+const invoicingCommonPayload_1 = require("../../../entity/invoicing/invoicingCommonPayload");
 const addressViewSelector_1 = require("../../addressView/addressViewSelector");
 const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 const invoicingBrandingFormConfig_1 = require("./invoicingBrandingFormConfig");
@@ -36,6 +38,58 @@ const getInvoicingSettingsView = (state) => {
     };
 };
 exports.getInvoicingSettingsView = getInvoicingSettingsView;
+/**
+ * Gates the Enable Invoicing action: payments must be able to land (Stripe
+ * connected *and* accepting charges) and the QBO accounting step must be
+ * finished, so an enabled tenant can always book what it invoices.
+ *
+ * Deliberately not part of `deriveInvoicingOnboardingStatus`, which routes the
+ * module off the config flags alone. Folding these in there would (a) demote a
+ * live tenant to the settings tree the moment an integration broke, stranding
+ * its existing invoices, and (b) deadlock the route gate, which fetches only the
+ * config — never the settings or QBO connection these read.
+ */
+function deriveInvoicingEnablePrerequisites(settings, isQboConnected, qboAccountMappingKindOptions) {
+    const isStripeConnected = settings?.stripe_connected === true &&
+        settings?.stripe_account?.charges_enabled === true;
+    const accountMappings = settings?.qbo?.account_mappings ?? undefined;
+    // An empty option list means the config has not landed yet — treating that as
+    // configured would let `every` pass vacuously and unlock the button early.
+    const isQboConfigured = isQboConnected &&
+        qboAccountMappingKindOptions.length > 0 &&
+        qboAccountMappingKindOptions.every((option) => (0, invoicingCommonPayload_1.getInvoicingQboAccountMappingId)(accountMappings, option.code) != null);
+    return {
+        canEnable: isStripeConnected && isQboConfigured,
+        isQboConfigured,
+        isStripeConnected,
+    };
+}
+/**
+ * The settings hub's composite of everything it derives from the store: whether
+ * to offer Enable Invoicing at all, the in-flight flag for that action, and the
+ * two integration prerequisites kept separate so the hub can name the step still
+ * outstanding instead of showing a dead button.
+ *
+ * `canEnableInvoicing` folds in the onboarding step, so the screen does not need
+ * to re-check it: the footer is only offered mid-onboarding and only once both
+ * integrations are ready.
+ *
+ * Deliberately not folded into `getInvoicingConfigView`: that selector gates
+ * every invoicing route and stays a pure read of the config slice. The settings
+ * and QBO slices read here are only fetched once a settings screen is mounted.
+ */
+const getInvoicingSettingsHubView = (state) => {
+    const { enableState, qboAccountMappingKindOptions, status } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
+    const { canEnable, isQboConfigured, isStripeConnected } = deriveInvoicingEnablePrerequisites(state.invoicingSettingsViewState.settings, state.invoicingQboViewState.connection?.connected === true, qboAccountMappingKindOptions);
+    return {
+        canEnableInvoicing: status === 'settings' && canEnable,
+        isEnablingInvoicing: enableState.fetchState === 'In-Progress',
+        isQboConfigured,
+        isStripeConnected,
+        status,
+    };
+};
+exports.getInvoicingSettingsHubView = getInvoicingSettingsHubView;
 /**
  * Bundled view for the branding settings form: the draft `localData` (seeded
  * from the existing settings until the user edits), the business-address label

package/lib/view/invoicing/subscriptionAction/subscriptionActionEpic.js

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicingSubscriptionPayload_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload");
 const invoicingSubscriptionReducer_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const subscriptionActionReducer_1 = require("./subscriptionActionReducer");
@@ -27,13 +28,15 @@ const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) => actio
     const { action: kind, body, id } = action.payload;
     const requestBody = { action: kind, ...(body ?? {}) };
     const snackbarSection = SNACKBAR_SECTION_BY_ACTION[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/subscriptions/${encodeURIComponent(id)}/actions`;
@@ -53,7 +56,7 @@ const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) => actio
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, subscriptionActionReducer_1.runInvoicingSubscriptionActionFailure)({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.1.91",
+  "version": "5.1.92",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",