@zeniai/client-epic-state 5.0.81 → 5.0.82-beta0ND

package/lib/esm/view/expenseAutomationView/reducers/transactionsViewReducer.js

@@ -5,6 +5,7 @@ import { toMonthYearPeriodId, } from '../../../commonStateTypes/timePeriod';
 import { isVendorTransaction } from '../../../entity/transaction/stateTypes/vendorTransaction';
 import { filterAutoTabLineItems, mergeTabSpecificLineItems, removeTransactionFromTabView, setEntityRecommendationForLineIdInLocalData, shouldAutoSelectAndAdd, toSetAllLineItemsToCategoryClass, toTransactionDetailLocalData, } from '../helpers/transactionCategorizationLocalDataHelper';
 import { DEFAULT_COMPLETED_SUB_TAB, } from '../types/completedSubTab';
+import { TRANSACTIONS_TABS, } from '../types/transactionsViewState';
 export const initialTransactionTabViewState = {
     saveStatus: {
         fetchState: 'Not-Started',
@@ -1040,7 +1041,18 @@ const expenseAutomationTransactionsView = createSlice({
                 };
             },
         },
+        removeTransactionFromAllTabs: {
+            prepare(transactionId) {
+                return { payload: { transactionId } };
+            },
+            reducer(draft, action) {
+                const { transactionId } = action.payload;
+                for (const tab of TRANSACTIONS_TABS) {
+                    removeTransactionFromTabView(draft.transactionCategorizationView[tab], transactionId);
+                }
+            },
+        },
     },
 });
-export const { fetchTransactionCategorization, updateTransactionCategorizationUIState, updateTransactionFilters, initializeTransactionCategorizationViewLocalData, saveTransactionCategorizationLocalData, fetchTransactionCategorizationFailure, saveTransactionCategorization, updateTransactionCategorization, updateCurrentSelectedTransactionCategorizationTab, updateTransactionCategorizationCompletedSubTab, updateTransactionCategorizationSaveStatus, markTransactionAsNotMiscategorized, updateStatusForTransactionNotMiscategorizedUpdateForCategorization, updateSelectedVendorForTransaction, updateSelectedCustomerForTransaction, setAllItemsToCategoryClassInLocalDataForCategorization, updateTotalCountForTransactionCategorization, updateParentTotalCountForTab, fetchTransactionCategorizationSuccess, resetOtherTabsFetchState, fetchTransactionCategorizationView, updateSelectedCheckboxTransactionIds, clearExpenseAutomationTransactionsViewPerTabView, clearExpenseAutomationTransactionsView, setEntityRecommendationForLineIdsForCategorization, markCategoryClassRecommendationsInProgressForCategorization, markCategoryClassRecommendationsCompletedForCategorization, markCategoryClassRecommendationsFailureForCategorization, updateSelectedTransactionId, syncTransactionCategorizationFromDetailSave, backgroundRefetchReviewTab, updateTransactionCategorizationUploadReceiptState, uploadTransactionCategorizationReceiptSuccess, } = expenseAutomationTransactionsView.actions;
+export const { fetchTransactionCategorization, updateTransactionCategorizationUIState, updateTransactionFilters, initializeTransactionCategorizationViewLocalData, saveTransactionCategorizationLocalData, fetchTransactionCategorizationFailure, saveTransactionCategorization, updateTransactionCategorization, updateCurrentSelectedTransactionCategorizationTab, updateTransactionCategorizationCompletedSubTab, updateTransactionCategorizationSaveStatus, markTransactionAsNotMiscategorized, updateStatusForTransactionNotMiscategorizedUpdateForCategorization, updateSelectedVendorForTransaction, updateSelectedCustomerForTransaction, setAllItemsToCategoryClassInLocalDataForCategorization, updateTotalCountForTransactionCategorization, updateParentTotalCountForTab, fetchTransactionCategorizationSuccess, resetOtherTabsFetchState, fetchTransactionCategorizationView, updateSelectedCheckboxTransactionIds, clearExpenseAutomationTransactionsViewPerTabView, clearExpenseAutomationTransactionsView, setEntityRecommendationForLineIdsForCategorization, markCategoryClassRecommendationsInProgressForCategorization, markCategoryClassRecommendationsCompletedForCategorization, markCategoryClassRecommendationsFailureForCategorization, updateSelectedTransactionId, syncTransactionCategorizationFromDetailSave, backgroundRefetchReviewTab, removeTransactionFromAllTabs, updateTransactionCategorizationUploadReceiptState, uploadTransactionCategorizationReceiptSuccess, } = expenseAutomationTransactionsView.actions;
 export default expenseAutomationTransactionsView.reducer;

package/lib/esm/view/expenseAutomationView/selectors/transactionCategorizationSelector.js

@@ -8,6 +8,7 @@ import { getSupportedTransactionsByIds } from '../../../entity/transaction/trans
 import { applyTransactionFilters, } from '../transactionFilterHelpers';
 import { getAccountList, getNestedAccountListHierarchy, getUncategorizedAccounts, } from '../../accountList/accountListSelector';
 import { getClassList, getNestedClassListHierarchy, } from '../../classList/classListSelector';
+import { getResolvedTransferAccounts } from '../../createTransferEntry/createTransferEntrySelector';
 import { getProjectList } from '../../projectList/projectListSelector';
 import { getAllSteps } from '../selectorTypes/expenseAutomationViewSelectorTypes';
 // Walks the tab's transactionReviewLocalDataById map and returns
@@ -81,8 +82,11 @@ export const toTransactionView = (transaction, transactionLocalData) => {
         transactionLocalData,
     };
 };
+// Re-exported here for back-compat. New code should import from
+// `view/createTransferEntry/createTransferEntrySelector`.
+export { getLastTransferEntryReplacement } from '../../createTransferEntry/createTransferEntrySelector';
 export function getExpenseAutomationTransactionView(state) {
-    const { accountState, classState, classListState, accountListState, expenseAutomationTransactionsViewState, expenseAutomationViewState, projectState, projectListState, transactionState, monthEndCloseChecksState, monthEndCloseChecksViewState, } = state;
+    const { accountState, classState, classListState, accountListState, createTransferEntryState, expenseAutomationTransactionsViewState, expenseAutomationViewState, projectState, projectListState, transactionState, monthEndCloseChecksState, monthEndCloseChecksViewState, } = state;
     const { selectedTransactionCategorizationCompletedSubTab, selectedTransactionCategorizationTab, } = expenseAutomationTransactionsViewState;
     const { uiState, refreshStatus, saveStatus, markAsNotMiscategorizedStatus, transactionIdsBySelectedPeriod, transactionReviewLocalDataById, selectedCheckBoxTransactionIds, transactionIdsWithUnsavedData, uploadReceiptStatusById, selectedTransactionId, selectedTransactionLineId, filters, } = expenseAutomationTransactionsViewState.transactionCategorizationView[selectedTransactionCategorizationTab];
     const uncategorizedIncomeExpense = getUncategorizedAccounts(accountState, accountListState, 'accountList');
@@ -214,6 +218,7 @@ export function getExpenseAutomationTransactionView(state) {
         : [];
     const transactionCompletionStatus = allSteps.find((step) => step.step === 'transaction_categorization')?.completionStatus;
     const completionStatus = transactionCompletionStatus ?? 'incomplete';
+    const { transferAccountsList, creditCardTransferAccountsList } = getResolvedTransferAccounts(state);
     const inFlightCategoryClassRecommendationsByTransactionId = getCategorizationInFlightRecommendationsByTransactionId(state);
     const hasInFlightCategoryClassRecommendations = getCategorizationHasInFlightRecommendations(state);
     return {
@@ -238,6 +243,7 @@ export function getExpenseAutomationTransactionView(state) {
         refreshStatus,
         saveStatus,
         markAsNotMiscategorizedStatus,
+        createTransferEntryStatus: createTransferEntryState.createTransferEntryStatus,
         completionStatus,
         totalCountByTab,
         parentTabTotalCountByTab,
@@ -245,6 +251,8 @@ export function getExpenseAutomationTransactionView(state) {
         uploadReceiptStatusById,
         selectedTransactionId,
         selectedTransactionLineId,
+        creditCardTransferAccountsList,
+        transferAccounts: transferAccountsList,
         selectedTransactionCategorizationCompletedSubTab,
     };
 }

package/lib/esm/view/onboardingView/customerView/epic/customerDetails/acknowledgeOnboardingAiFinanceTeamEpic.js

@@ -0,0 +1,40 @@
+import { from, of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateCompanies } from '../../../../../entity/company/companyReducer';
+import { openSnackbar } from '../../../../../entity/snackbar/snackbarReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../../responsePayload';
+import { acknowledgeOnboardingAiFinanceTeam, acknowledgeOnboardingAiFinanceTeamFailure, acknowledgeOnboardingAiFinanceTeamSuccess, } from '../../onboardingCustomerViewReducer';
+export const acknowledgeOnboardingAiFinanceTeamEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(acknowledgeOnboardingAiFinanceTeam.match), mergeMap((action) => {
+    const { companyId } = action.payload;
+    const payload = {
+        is_onboarding_ai_finance_team_acknowledged: true,
+    };
+    return zeniAPI
+        .putAndGetJSON(`${zeniAPI.apiEndPoints.tenantMicroServiceBaseUrl}/1.0/companies/${companyId}`, payload)
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const actions = [
+                updateCompanies({
+                    payload: response.data.companies,
+                    schema: {},
+                }),
+                acknowledgeOnboardingAiFinanceTeamSuccess(),
+            ];
+            return from(actions);
+        }
+        else {
+            return of(openSnackbar({
+                messageSection: 'onboarding_customer_view_complete',
+                messageText: 'failed',
+                type: 'error',
+                variables: [
+                    {
+                        variableName: '_api-error_',
+                        variableValue: response.status.message,
+                    },
+                ],
+            }), acknowledgeOnboardingAiFinanceTeamFailure(response.status));
+        }
+    }), catchError((error) => of(acknowledgeOnboardingAiFinanceTeamFailure(createZeniAPIStatus('Unexpected Error', 'Acknowledge - Onboarding AI Finance Team errored out' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/onboardingView/customerView/onboardingCustomerViewReducer.js

@@ -10,60 +10,29 @@ export const initialState = {
     dashboardLoadedStatus: initialStatus,
     currentStep: 'link_payment_account',
     companyDetails: {
+        autoFilledFields: [],
         localData: undefined,
     },
-    companyOfficerUpdateStatus: {
-        Officer_1: {
+    companyOfficerUpdateStatus: (() => {
+        const emptyOfficerSlot = {
+            autoFilledFields: [],
             localData: undefined,
             sendOtpStatus: initialStatus,
             otpverificationStatus: initialStatus,
-        },
-        Officer_2: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_3: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_4: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_5: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_6: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_7: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_8: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_9: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-        Officer_10: {
-            localData: undefined,
-            sendOtpStatus: initialStatus,
-            otpverificationStatus: initialStatus,
-        },
-    },
+        };
+        return {
+            Officer_1: { ...emptyOfficerSlot },
+            Officer_2: { ...emptyOfficerSlot },
+            Officer_3: { ...emptyOfficerSlot },
+            Officer_4: { ...emptyOfficerSlot },
+            Officer_5: { ...emptyOfficerSlot },
+            Officer_6: { ...emptyOfficerSlot },
+            Officer_7: { ...emptyOfficerSlot },
+            Officer_8: { ...emptyOfficerSlot },
+            Officer_9: { ...emptyOfficerSlot },
+            Officer_10: { ...emptyOfficerSlot },
+        };
+    })(),
     primaryContactDetails: {},
     paymentAccountDetails: {
         fetchStatus: initialStatus,
@@ -180,6 +149,38 @@ const onboardingCustomerView = createSlice({
                 };
             },
         },
+        acknowledgeOnboardingAiFinanceTeam: {
+            reducer(draft) {
+                draft.aiFinanceTeamAcknowledgementStatus = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+            prepare(companyId) {
+                return {
+                    payload: { companyId },
+                };
+            },
+        },
+        acknowledgeOnboardingAiFinanceTeamSuccess(draft) {
+            draft.aiFinanceTeamAcknowledgementStatus = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        acknowledgeOnboardingAiFinanceTeamFailure: {
+            reducer(draft, action) {
+                draft.aiFinanceTeamAcknowledgementStatus = {
+                    fetchState: 'Error',
+                    error: action.payload,
+                };
+            },
+            prepare(error) {
+                return {
+                    payload: error,
+                };
+            },
+        },
         updateOnboardingCustomerViewDashboardLoaded: {
             reducer(draft) {
                 draft.dashboardLoadedStatus = {
@@ -592,7 +593,49 @@ const onboardingCustomerView = createSlice({
         clearOnboardingCustomerView(draft) {
             Object.assign(draft, initialState);
         },
+        /** Merge AI-parsed officer fields into the officer's onboarding localData. */
+        applyKycDocumentAutofillForOnboarding: {
+            reducer(draft, action) {
+                const { officerType, values, autoFilledFieldNames } = action.payload;
+                const slot = draft.companyOfficerUpdateStatus[officerType];
+                slot.localData = Object.assign({}, slot.localData, values);
+                slot.autoFilledFields = Array.from(new Set([...slot.autoFilledFields, ...autoFilledFieldNames]));
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        /** Merge AI-parsed company fields into companyDetails onboarding localData. */
+        applyKybDocumentAutofillForOnboarding: {
+            reducer(draft, action) {
+                const { values, autoFilledFieldNames } = action.payload;
+                draft.companyDetails.localData = Object.assign({}, draft.companyDetails.localData, values);
+                const prev = draft.companyDetails.autoFilledFields ?? [];
+                draft.companyDetails.autoFilledFields = Array.from(new Set([...prev, ...autoFilledFieldNames]));
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        /** Wipe AI-autofill badges during onboarding. */
+        clearKycKybAutofillForOnboarding: {
+            reducer(draft, action) {
+                const { officerType } = action.payload;
+                if (officerType != null) {
+                    draft.companyOfficerUpdateStatus[officerType].autoFilledFields = [];
+                }
+                else {
+                    draft.companyDetails.autoFilledFields = [];
+                    Object.keys(draft.companyOfficerUpdateStatus).forEach((key) => {
+                        draft.companyOfficerUpdateStatus[key].autoFilledFields = [];
+                    });
+                }
+            },
+            prepare(payload = {}) {
+                return { payload };
+            },
+        },
     },
 });
-export const { fetchOnboardingCustomerView, fetchOnboardingCustomerSetupView, fetchOnboardingCustomerSetupViewSuccess, fetchOnboardingCustomerSetupViewFailure, updateOnboardingCustomerViewCompleteStatus, updateOnboardingCustomerViewCompleteStatusSuccess, updateOnboardingCustomerViewCompleteStatusFailure, updateOnboardingCustomerViewDashboardLoaded, updateOnboardingCustomerViewDashboardLoadedSuccess, updateOnboardingCustomerViewDashboardLoadedFailure, updateOnboardingCustomerView, updateOnboardingCustomerViewSuccess, updateOnboardingCustomerViewFailure, updateOnboardingPaymentAccountStatus, updateOnboardingPaymentAccountStatusSuccess, updateOnboardingPaymentAccountStatusFailure, updateOnboardingPaymentAccountLoginStatus, updateOnboardingPaymentAccountLoginStatusSuccess, updateOnboardingPaymentAccountLoginStatusFailure, establishOnboardingPlaidConnection, establishOnboardingPlaidConnectionSuccess, establishOnboardingPlaidConnectionFailure, getOnboardingPlaidLinkToken, getOnboardingPlaidLinkTokenSuccess, getOnboardingPlaidLinkTokenFailure, updateCurrentStep, updateOnboardingCustomerViewAccountDetails, updateOnboardingCustomerViewLocalStoreData, saveOnboardingCustomerViewDataInLocalStore, saveOnboardingCompnayOfficerPhoneInLocalStore, updateOnboardingCustomerViewUIState, sendOnboardingOfficerOtp, sendOnboardingOfficerOtpSuccess, sendOnboardingOfficerOtpFailure, resendOnboardingOfficerOtp, verifyOnboardingOfficerOtp, verifyOnboardingOfficerOtpSuccess, verifyOnboardingOfficerOtpFailure, clearOnboardingCustomerViewDataInLocalStore, clearOnboardingCustomerView, } = onboardingCustomerView.actions;
+export const { fetchOnboardingCustomerView, fetchOnboardingCustomerSetupView, fetchOnboardingCustomerSetupViewSuccess, fetchOnboardingCustomerSetupViewFailure, updateOnboardingCustomerViewCompleteStatus, updateOnboardingCustomerViewCompleteStatusSuccess, updateOnboardingCustomerViewCompleteStatusFailure, acknowledgeOnboardingAiFinanceTeam, acknowledgeOnboardingAiFinanceTeamSuccess, acknowledgeOnboardingAiFinanceTeamFailure, updateOnboardingCustomerViewDashboardLoaded, updateOnboardingCustomerViewDashboardLoadedSuccess, updateOnboardingCustomerViewDashboardLoadedFailure, updateOnboardingCustomerView, updateOnboardingCustomerViewSuccess, updateOnboardingCustomerViewFailure, updateOnboardingPaymentAccountStatus, updateOnboardingPaymentAccountStatusSuccess, updateOnboardingPaymentAccountStatusFailure, updateOnboardingPaymentAccountLoginStatus, updateOnboardingPaymentAccountLoginStatusSuccess, updateOnboardingPaymentAccountLoginStatusFailure, establishOnboardingPlaidConnection, establishOnboardingPlaidConnectionSuccess, establishOnboardingPlaidConnectionFailure, getOnboardingPlaidLinkToken, getOnboardingPlaidLinkTokenSuccess, getOnboardingPlaidLinkTokenFailure, updateCurrentStep, updateOnboardingCustomerViewAccountDetails, updateOnboardingCustomerViewLocalStoreData, saveOnboardingCustomerViewDataInLocalStore, saveOnboardingCompnayOfficerPhoneInLocalStore, updateOnboardingCustomerViewUIState, sendOnboardingOfficerOtp, sendOnboardingOfficerOtpSuccess, sendOnboardingOfficerOtpFailure, resendOnboardingOfficerOtp, verifyOnboardingOfficerOtp, verifyOnboardingOfficerOtpSuccess, verifyOnboardingOfficerOtpFailure, clearOnboardingCustomerViewDataInLocalStore, clearOnboardingCustomerView, applyKycDocumentAutofillForOnboarding, applyKybDocumentAutofillForOnboarding, clearKycKybAutofillForOnboarding, } = onboardingCustomerView.actions;
 export default onboardingCustomerView.reducer;

package/lib/esm/view/spendManagement/commonSetup/epic/setup/parseUploadedKybDocumentEpic.js

@@ -0,0 +1,49 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { isSuccessResponse } from '../../../../../responsePayload';
+import { applyKybDocumentAutofillForOnboarding } from '../../../../onboardingView/customerView/onboardingCustomerViewReducer';
+import { parseUploadedKybDocument } from '../../kycKybAutofillActions';
+import { mapCoiToCompanyDetails, mapTaxEinToCompanyDetails, } from '../../kycKybParseMapper';
+import { applyKybDocumentAutofillForSetup } from '../../setupViewReducer';
+const PROCESS_DOCUMENT_SYNC_PATH = '/1.0/documents/process/sync';
+export const parseUploadedKybDocumentEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(parseUploadedKybDocument.match), mergeMap((action) => {
+    const { target, companyId, fileId, documentType } = action.payload;
+    const url = `${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}${PROCESS_DOCUMENT_SYNC_PATH}`;
+    const requestPayload = {
+        provided_document_type: documentType,
+        files: [{ file_id: fileId }],
+        processing_priority: 10,
+        metadata: { source: 'kyc_kyb_autofill' },
+    };
+    return zeniAPI
+        .postAndGetJSON(url, requestPayload)
+        .pipe(mergeMap((response) => {
+        if (!isSuccessResponse(response) || response.data == null) {
+            return of();
+        }
+        let result;
+        switch (documentType) {
+            case 'certificate_of_incorporation':
+                result = mapCoiToCompanyDetails(response.data);
+                break;
+            case 'tax_ein':
+                result = mapTaxEinToCompanyDetails(response.data);
+                break;
+        }
+        if (result.autoFilledFieldNames.length === 0) {
+            return of();
+        }
+        const applyAction = target === 'setup'
+            ? applyKybDocumentAutofillForSetup({
+                companyId,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            })
+            : applyKybDocumentAutofillForOnboarding({
+                companyId,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            });
+        return of(applyAction);
+    }), catchError(() => of()));
+}));

package/lib/esm/view/spendManagement/commonSetup/epic/setup/parseUploadedKycDocumentEpic.js

@@ -0,0 +1,58 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { getCountryList } from '../../../../../entity/countryList/countryListSelector';
+import { isSuccessResponse } from '../../../../../responsePayload';
+import { applyKycDocumentAutofillForOnboarding } from '../../../../onboardingView/customerView/onboardingCustomerViewReducer';
+import { parseUploadedKycDocument } from '../../kycKybAutofillActions';
+import { mapDrivingLicenseToOfficer, mapPassportToOfficer, mapSsnCardToOfficer, } from '../../kycKybParseMapper';
+import { applyKycDocumentAutofillForSetup } from '../../setupViewReducer';
+const PROCESS_DOCUMENT_SYNC_PATH = '/1.0/documents/process/sync';
+export const parseUploadedKycDocumentEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(parseUploadedKycDocument.match), mergeMap((action) => {
+    const { target, companyId, officerType, fileId, documentType } = action.payload;
+    const url = `${zeniAPI.apiEndPoints.communicationAgentMicroServiceBaseUrl}${PROCESS_DOCUMENT_SYNC_PATH}`;
+    const requestPayload = {
+        provided_document_type: documentType,
+        files: [{ file_id: fileId }],
+        processing_priority: 10,
+        metadata: { source: 'kyc_kyb_autofill' },
+    };
+    return zeniAPI
+        .postAndGetJSON(url, requestPayload)
+        .pipe(mergeMap((response) => {
+        if (!isSuccessResponse(response) || response.data == null) {
+            return of();
+        }
+        const allCountries = getCountryList(state$.value.countryListState, 'nationalityCountryList').countries;
+        let result;
+        switch (documentType) {
+            case 'passport':
+                result = mapPassportToOfficer(response.data, allCountries);
+                break;
+            case 'driving_license':
+                result = mapDrivingLicenseToOfficer(response.data);
+                break;
+            case 'social_security_card':
+                result = mapSsnCardToOfficer(response.data);
+                break;
+        }
+        if (result.autoFilledFieldNames.length === 0) {
+            return of();
+        }
+        const applyAction = target === 'setup'
+            ? applyKycDocumentAutofillForSetup({
+                companyId,
+                officerType,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            })
+            : applyKycDocumentAutofillForOnboarding({
+                companyId,
+                officerType,
+                values: result.values,
+                autoFilledFieldNames: result.autoFilledFieldNames,
+            });
+        return of(applyAction);
+    }), catchError(() => 
+    // Autofill is best-effort; swallow errors silently so the user can keep typing.
+    of()));
+}));

package/lib/esm/view/spendManagement/commonSetup/kycKybAutofillActions.js

@@ -0,0 +1,12 @@
+/**
+ * Trigger actions for the KYC / KYB autofill epics.
+ *
+ * These actions don't mutate state — the epic listens for them, calls
+ * document-communication-agent's sync endpoint, and dispatches the appropriate
+ * `applyKyc/KybDocumentAutofillFor{Setup,Onboarding}` against the matching
+ * slice. Co-located with the rest of the commonSetup module because the entire
+ * autofill flow is auxiliary to the setup view; there is no separate state.
+ */
+import { createAction } from '@reduxjs/toolkit';
+export const parseUploadedKycDocument = createAction('commonSetup/parseUploadedKycDocument');
+export const parseUploadedKybDocument = createAction('commonSetup/parseUploadedKybDocument');

package/lib/esm/view/spendManagement/commonSetup/kycKybParseMapper.js

@@ -0,0 +1,205 @@
+/**
+ * Pure mappers from ExtendAI parser payloads to our form-side local-data shapes.
+ *
+ * Each mapper filters out fields below KYC_KYB_AUTOFILL_MIN_CONFIDENCE and returns
+ * both the merged values and the list of field names that were autofilled so the
+ * UI can show the ✦ AI badge next to each.
+ */
+import { date } from '../../../zeniDayJS';
+import { toZeniUrl } from '../../../zeniUrl';
+import { KYC_KYB_AUTOFILL_MIN_CONFIDENCE, } from './types/kycKybAutofill';
+const emptyResult = () => ({
+    values: {},
+    autoFilledFieldNames: [],
+});
+const isConfident = (field) => {
+    if (field == null) {
+        return false;
+    }
+    if (field.value == null) {
+        return false;
+    }
+    return field.confidence >= KYC_KYB_AUTOFILL_MIN_CONFIDENCE;
+};
+const assignAutofilledValue = (result, key, value) => {
+    if (value == null) {
+        return;
+    }
+    if (typeof value === 'string' && value.trim() === '') {
+        return;
+    }
+    result.values[key] = value;
+    result.autoFilledFieldNames.push(key);
+};
+const tryParseDate = (rawDate) => {
+    const parsedDate = date(rawDate);
+    if (parsedDate.isValid()) {
+        return parsedDate;
+    }
+    return undefined;
+};
+const normalizeNationality = (rawNationality, countries) => {
+    const needle = rawNationality.trim().toLowerCase();
+    if (needle === '') {
+        return undefined;
+    }
+    // Exact ISO-2 / ISO-3 match.
+    const isoMatch = countries.find((country) => country.countryCode.toLowerCase() === needle);
+    if (isoMatch != null) {
+        return isoMatch.countryCode;
+    }
+    // Common nationality adjectives map to country names (e.g. "American" → "United States").
+    const adjectiveToCountry = {
+        american: 'united states',
+        british: 'united kingdom',
+        indian: 'india',
+        canadian: 'canada',
+        australian: 'australia',
+        german: 'germany',
+        french: 'france',
+        chinese: 'china',
+        japanese: 'japan',
+        mexican: 'mexico',
+        brazilian: 'brazil',
+    };
+    const resolvedName = adjectiveToCountry[needle] ?? needle;
+    const nameMatch = countries.find((country) => country.countryName.toLowerCase() === resolvedName);
+    return nameMatch?.countryCode;
+};
+const splitFullName = (fullName) => {
+    const parts = fullName.trim().split(/\s+/);
+    if (parts.length === 1) {
+        return { firstName: parts[0], lastName: '' };
+    }
+    const lastName = parts[parts.length - 1];
+    const firstName = parts.slice(0, -1).join(' ');
+    return { firstName, lastName };
+};
+/** Passport → Company Officer. */
+export const mapPassportToOfficer = (parsed, allNationalityCountries) => {
+    const result = emptyResult();
+    if (isConfident(parsed.first_name)) {
+        assignAutofilledValue(result, 'firstName', parsed.first_name.value);
+    }
+    if (isConfident(parsed.last_name)) {
+        assignAutofilledValue(result, 'lastName', parsed.last_name.value);
+    }
+    if (isConfident(parsed.date_of_birth)) {
+        const parsedDate = tryParseDate(parsed.date_of_birth.value);
+        if (parsedDate != null) {
+            assignAutofilledValue(result, 'birthday', parsedDate);
+        }
+    }
+    if (isConfident(parsed.nationality)) {
+        const isoCode = normalizeNationality(parsed.nationality.value, allNationalityCountries);
+        if (isoCode != null) {
+            assignAutofilledValue(result, 'nationalityCountryCode', isoCode);
+        }
+    }
+    return result;
+};
+/** Driving License → Company Officer. */
+export const mapDrivingLicenseToOfficer = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.first_name)) {
+        assignAutofilledValue(result, 'firstName', parsed.first_name.value);
+    }
+    if (isConfident(parsed.last_name)) {
+        assignAutofilledValue(result, 'lastName', parsed.last_name.value);
+    }
+    if (isConfident(parsed.date_of_birth)) {
+        const parsedDate = tryParseDate(parsed.date_of_birth.value);
+        if (parsedDate != null) {
+            assignAutofilledValue(result, 'birthday', parsedDate);
+        }
+    }
+    // address_* fields are mapped at a higher layer (addressView reducer) — kept here as values
+    // only, the consuming epic dispatches the address payload separately.
+    return result;
+};
+/** SSN Card → Company Officer (name only — SSN value not yet returned by parser). */
+export const mapSsnCardToOfficer = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.full_name)) {
+        const { firstName, lastName } = splitFullName(parsed.full_name.value);
+        if (firstName !== '') {
+            assignAutofilledValue(result, 'firstName', firstName);
+        }
+        if (lastName !== '') {
+            assignAutofilledValue(result, 'lastName', lastName);
+        }
+    }
+    return result;
+};
+/** Certificate of Incorporation → Company Details. */
+export const mapCoiToCompanyDetails = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.company_legal_name)) {
+        assignAutofilledValue(result, 'companyLegalName', parsed.company_legal_name.value);
+    }
+    if (isConfident(parsed.ein)) {
+        assignAutofilledValue(result, 'taxIdOrEIN', parsed.ein.value);
+    }
+    if (isConfident(parsed.phone_number)) {
+        assignAutofilledValue(result, 'phone', parsed.phone_number.value);
+    }
+    if (isConfident(parsed.product_description)) {
+        assignAutofilledValue(result, 'companyDescription', parsed.product_description.value);
+    }
+    if (isConfident(parsed.website)) {
+        try {
+            assignAutofilledValue(result, 'website', toZeniUrl(parsed.website.value));
+        }
+        catch {
+            // ignore — malformed URL string from OCR
+        }
+    }
+    if (isConfident(parsed.industry)) {
+        assignAutofilledValue(result, 'companyIndustryType', parsed.industry.value);
+    }
+    if (isConfident(parsed.sub_industry)) {
+        assignAutofilledValue(result, 'companySubIndustry', parsed.sub_industry.value);
+    }
+    if (isConfident(parsed.type_of_incorporation)) {
+        assignAutofilledValue(result, 'typeOfIncorporation', parsed.type_of_incorporation.value);
+    }
+    if (isConfident(parsed.date_of_incorporation)) {
+        const parsedDate = tryParseDate(parsed.date_of_incorporation.value);
+        if (parsedDate != null) {
+            assignAutofilledValue(result, 'incDate', parsedDate);
+        }
+    }
+    if (isConfident(parsed.state_of_incorporation)) {
+        assignAutofilledValue(result, 'stateOfIncorporation', parsed.state_of_incorporation.value);
+    }
+    if (isConfident(parsed.countries_of_operations)) {
+        assignAutofilledValue(result, 'countriesOfOperations', parsed.countries_of_operations.value);
+    }
+    if (isConfident(parsed.source_of_funds)) {
+        assignAutofilledValue(result, 'sourceOfFunds', parsed.source_of_funds.value);
+    }
+    if (isConfident(parsed.transaction_volume_expectations)) {
+        assignAutofilledValue(result, 'transactionVolume', parsed.transaction_volume_expectations.value);
+    }
+    if (isConfident(parsed.purpose_of_account)) {
+        assignAutofilledValue(result, 'purposeOfAccount', parsed.purpose_of_account.value);
+    }
+    if (isConfident(parsed.regulated_status)) {
+        assignAutofilledValue(result, 'regulatedStatus', parsed.regulated_status.value);
+    }
+    if (isConfident(parsed.us_nexus)) {
+        assignAutofilledValue(result, 'usNexus', parsed.us_nexus.value);
+    }
+    return result;
+};
+/** Tax EIN letter → Company Details. */
+export const mapTaxEinToCompanyDetails = (parsed) => {
+    const result = emptyResult();
+    if (isConfident(parsed.legal_business_name)) {
+        assignAutofilledValue(result, 'companyLegalName', parsed.legal_business_name.value);
+    }
+    if (isConfident(parsed.ein)) {
+        assignAutofilledValue(result, 'taxIdOrEIN', parsed.ein.value);
+    }
+    return result;
+};