@zeniai/client-epic-state 5.1.89 → 5.1.91-betaAK0

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/entity/tenant/tenantPayload.d.ts

@@ -96,6 +96,7 @@ interface TenantPayload {
     capitalization_onboarding_shown_for_fixed_asset?: boolean;
     capitalization_onboarding_shown_for_prepaid?: boolean;
     master_tos_info?: MasterTOSInfoPayload;
+    receipts_email?: string | null;
     reimbursement_info?: UserReimbursementInfoDataPayload;
     zeni_book_close_date?: string;
     zeni_book_close_month_and_year?: string;

package/lib/entity/tenant/tenantReducer.js

@@ -1044,6 +1044,7 @@ function mapTenantPayloadToTenant(payload, userTenantPayload) {
         masterTOSInfo: payload.master_tos_info != null
             ? (0, userRolePayload_1.toMasterTOSInfo)(payload.master_tos_info)
             : undefined,
+        receiptsEmail: payload.receipts_email ?? undefined,
         rewardsLastViewedTime: userTenantPayload?.rewards_feature_last_viewed_time != null
             ? (0, zeniDayJS_1.date)(userTenantPayload.rewards_feature_last_viewed_time)
             : undefined,

package/lib/entity/tenant/tenantSelector.d.ts

@@ -92,4 +92,6 @@ export declare const getIsAccountingProjectsEnabled: (state: RootState) => boole
 export declare const isTenantBookkeepingEnabled: (tenant: Tenant | undefined) => boolean;
 export declare const isOtherProductsEnabledForTenant: (tenant: Tenant | undefined) => boolean;
 export declare const isTenantTreasuryEnabled: (tenant: Tenant | undefined) => boolean;
+export declare const DEFAULT_RECEIPTS_EMAIL = "receipts@zeni.ai";
+export declare function getReceiptsEmail(tenantState: TenantState, tenantId: ID | undefined): string;
 export {};

package/lib/entity/tenant/tenantSelector.js

@@ -3,10 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isTenantTreasuryEnabled = exports.isOtherProductsEnabledForTenant = exports.isTenantBookkeepingEnabled = exports.getIsAccountingProjectsEnabled = exports.getIsAccountingClassesEnabled = exports.isTenantAccountingServicesEnabled = exports.isTenantCardsOnly = exports.isTenantBankingOnly = exports.toTenantCoreDetailsView = exports.getCurrentTenantExternalConnections = exports.isTenantUsingZeniCOA = exports.isZeniDomainTenant = exports.getTenantBaseViewForTenantView = exports.getTenantsCoreDetailsByCheckInDateSelector = exports.getTenantsBaseByCheckInDateSelector = exports.getTenantBaseById = exports.getTenantsByCheckInDateSelector = exports.getCurrentTenant = exports.getTenantBaseViewForTenantId = void 0;
+exports.DEFAULT_RECEIPTS_EMAIL = exports.isTenantTreasuryEnabled = exports.isOtherProductsEnabledForTenant = exports.isTenantBookkeepingEnabled = exports.getIsAccountingProjectsEnabled = exports.getIsAccountingClassesEnabled = exports.isTenantAccountingServicesEnabled = exports.isTenantCardsOnly = exports.isTenantBankingOnly = exports.toTenantCoreDetailsView = exports.getCurrentTenantExternalConnections = exports.isTenantUsingZeniCOA = exports.isZeniDomainTenant = exports.getTenantBaseViewForTenantView = exports.getTenantsCoreDetailsByCheckInDateSelector = exports.getTenantsBaseByCheckInDateSelector = exports.getTenantBaseById = exports.getTenantsByCheckInDateSelector = exports.getCurrentTenant = exports.getTenantBaseViewForTenantId = void 0;
 exports.getTenant = getTenant;
 exports.getTenantIdByCompanyId = getTenantIdByCompanyId;
 exports.getOnboardingTenantByTenantId = getOnboardingTenantByTenantId;
+exports.getReceiptsEmail = getReceiptsEmail;
 const toolkit_1 = require("@reduxjs/toolkit");
 const orderBy_1 = __importDefault(require("lodash/orderBy"));
 const companySelector_1 = require("../company/companySelector");
@@ -330,3 +331,12 @@ const isTenantTreasuryEnabled = (tenant) => {
         : false;
 };
 exports.isTenantTreasuryEnabled = isTenantTreasuryEnabled;
+exports.DEFAULT_RECEIPTS_EMAIL = 'receipts@zeni.ai';
+function getReceiptsEmail(tenantState, tenantId) {
+    const receiptsEmail = tenantId != null
+        ? tenantState.tenantsById[tenantId]?.receiptsEmail
+        : undefined;
+    // API can send empty string; treat it as "not configured"
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- intentional empty-string fallback
+    return receiptsEmail || exports.DEFAULT_RECEIPTS_EMAIL;
+}

package/lib/entity/tenant/tenantState.d.ts

@@ -111,6 +111,7 @@ export interface Tenant {
     bookCloseDate?: ZeniDate;
     hubSpotId?: ID;
     masterTOSInfo?: MasterTOSInfo;
+    receiptsEmail?: string;
     rewardsLastViewedTime?: ZeniDate;
     userReimbursementInfo?: UserReimbursementInfo;
     zeniBookCloseDate?: ZeniDate;

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/entity/tenant/tenantReducer.js

@@ -1032,6 +1032,7 @@ function mapTenantPayloadToTenant(payload, userTenantPayload) {
         masterTOSInfo: payload.master_tos_info != null
             ? toMasterTOSInfo(payload.master_tos_info)
             : undefined,
+        receiptsEmail: payload.receipts_email ?? undefined,
         rewardsLastViewedTime: userTenantPayload?.rewards_feature_last_viewed_time != null
             ? date(userTenantPayload.rewards_feature_last_viewed_time)
             : undefined,

package/lib/esm/entity/tenant/tenantSelector.js

@@ -308,3 +308,12 @@ export const isTenantTreasuryEnabled = (tenant) => {
         ? tenant.productSettings.isTreasuryEnabled === true
         : false;
 };
+export const DEFAULT_RECEIPTS_EMAIL = 'receipts@zeni.ai';
+export function getReceiptsEmail(tenantState, tenantId) {
+    const receiptsEmail = tenantId != null
+        ? tenantState.tenantsById[tenantId]?.receiptsEmail
+        : undefined;
+    // API can send empty string; treat it as "not configured"
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions -- intentional empty-string fallback
+    return receiptsEmail || DEFAULT_RECEIPTS_EMAIL;
+}

package/lib/esm/index.js

@@ -71,7 +71,7 @@ import { getSnackbar } from './entity/snackbar/snackbarSelector';
 import { ALL_WEEK_DAYS, toDayOfWeek, toPriorityCodeType, toTaskStatusCodeType, } from './entity/task/taskState';
 import { getTaskGroupById } from './entity/taskGroup/taskGroupSelector';
 import { 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 { getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getTenantBaseById, getTenantBaseViewForTenantId, getTenantBaseViewForTenantView, getTenantsBaseByCheckInDateSelector, getTenantsByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, isOtherProductsEnabledForTenant, isTenantBankingOnly, isTenantBookkeepingEnabled, isTenantCardsOnly, isTenantUsingZeniCOA, isZeniDomainTenant, toTenantCoreDetailsView, } from './entity/tenant/tenantSelector';
+import { 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 { pushToastNotification } from './entity/toastNotification/toastNotificationReducer';
 import { getLastNotificationTime, getNotifications, } from './entity/toastNotification/toastNotificationSelector';
 import { mapFileEntityToAttachment, toContentType, toContentTypeStrict, } from './entity/transaction/stateTypes/attachment';
@@ -482,7 +482,7 @@ export { toTimeframeTick, mapTimePeriodtoTimeframeTick, toTimePeriod, toAbsolute
 export { toVendorSpendTrendFilterTabsTypeStrict, } from './entity/vendorExpense/vendorExpenseSelector';
 export { getNumberOfPeriods };
 export { SCHEDULE_DAYS_OF_MONTH, toScheduleDaysOfMonth, toMonth, toMonthStrict, toQuarter, toQuarterStrict, };
-export { getTenantBaseById, getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getTenantsByCheckInDateSelector, getTenantsBaseByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, toTenantCoreDetailsView, getTenantBaseViewForTenantView, getTenantBaseViewForTenantId, isZeniDomainTenant, isTenantUsingZeniCOA, fetchActiveTenant, fetchAllTenants, updateCurrentTenant, clearAll, doMagicLinkSignIn, verifyDeviceWithTwoFA, resendVerifyDeviceOTP, sendEmailMagicLinkToUser, doSignIn, updateSignInState, doSignOut, sendSessionHeartbeat, resetSignInState, fetchExcludedResourcesForTenant, fetchExternalConnectionsForTenant, saveExternalConnectionForTenant, deleteConnection, saveAPIKeyConnection, saveConnectorCredentials, saveOAuthConnection, initEmailConnectOAuth, toExternalIntegrationType, toExternalSupportedTool, fetchSubscriptionSummaryForTenant, isTenantBankingOnly, isTenantCardsOnly, isTenantBookkeepingEnabled, isOtherProductsEnabledForTenant, };
+export { getTenantBaseById, getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getTenantsByCheckInDateSelector, getTenantsBaseByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, toTenantCoreDetailsView, getTenantBaseViewForTenantView, getTenantBaseViewForTenantId, isZeniDomainTenant, isTenantUsingZeniCOA, fetchActiveTenant, fetchAllTenants, updateCurrentTenant, clearAll, doMagicLinkSignIn, verifyDeviceWithTwoFA, resendVerifyDeviceOTP, sendEmailMagicLinkToUser, doSignIn, updateSignInState, doSignOut, sendSessionHeartbeat, resetSignInState, fetchExcludedResourcesForTenant, fetchExternalConnectionsForTenant, saveExternalConnectionForTenant, deleteConnection, saveAPIKeyConnection, saveConnectorCredentials, saveOAuthConnection, initEmailConnectOAuth, toExternalIntegrationType, toExternalSupportedTool, fetchSubscriptionSummaryForTenant, isTenantBankingOnly, isTenantCardsOnly, isTenantBookkeepingEnabled, isOtherProductsEnabledForTenant, DEFAULT_RECEIPTS_EMAIL, getReceiptsEmail, };
 export { toAccountType, toAccountGroupType, getAccountGroupKey, getAllAccounts, getTransactionFilterAccountOptions, };
 export { getAllClasses, getClassById, getClassFilterOptions, } from './entity/class/classSelector';
 export { getForecast };
@@ -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

@@ -84,6 +84,8 @@ const buildSubFamilyPayload = (localData, subFamily, clearEmptyValues) => {
  * 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.
  */
+/** Sent for every catalog item now that the form does not collect a unit. */
+const DEFAULT_CATALOG_ITEM_UNIT = 'USD';
 export const localDataToSaveInvoicingCatalogItemPayload = (localData, isCreate) => {
     const description = trimOrUndefined(localData.description);
     const productCode = trimOrUndefined(localData.productCode) ?? toProductCode(localData.name);
@@ -101,10 +103,10 @@ 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, so a new item is created with the fixed
+    // default; an item that already carries one keeps it when saved from the form.
+    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,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 { runInvoicingInvoiceAction, runInvoicingInvoiceActionFailure, runInvoicingInvoiceActionSuccess, updateInvoicingInvoice, } from './invoiceActionReducer';
@@ -80,6 +81,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;