FNB Bank Statement Integration
Use this guide to configure and verify direct import of FNB statement transactions into bank reconciliation.
Outcome
After this guide:
- Statement transactions are retrieved from FNB API for selected date ranges.
- Bank reconciliation lines are created automatically.
- Re-import does not duplicate previously imported transactions.
Before You Start
- Confirm FNB credentials are issued for the target environment.
- Confirm Bank Integration Setup is editable.
- Confirm the Bank Account No. in Business Central matches the account registered at FNB.
- Prepare a date range with known transactions for testing.
Step 1: Configure FNB Credentials
- Open Bank Integration Setup.
- In the FNB section, enter FNB Client ID, FNB Client Secret, and FNB API Base URL.
- Enter base URL without trailing slash.
- Save.
Environment base URLs:
| Environment | Base URL |
|---|---|
| Integration | https://api.i.fnb.co.za/apigateway |
| Pre-production | https://api.p.fnb.co.za/apigateway |
| Production | https://api.fnb.co.za/apigateway |
Pass criteria:
- Credentials are saved.
- Base URL matches credential environment.
Step 2: Verify Bank Account Identity
- Open Bank Account Card used for reconciliation import.
- Confirm Bank Account No. exactly matches FNB registered account number.
- Save if corrected.
Pass criteria:
- Bank Account No. is correct.
Step 3: Run First Import
- Open Bank Acc. Reconciliation.
- Set Statement Date.
- Run Import FNB Bank Statement action.
- On request page, enter Start Date and End Date.
- Confirm End Date is on or after Start Date.
- Complete import.
Pass criteria:
- Import completes without authentication or request errors.
- Reconciliation lines are created for returned transactions.
Step 4: Validate Imported Data
- Review new reconciliation lines.
- Confirm key fields are populated as expected: transaction date, description, reference, and amount.
Pass criteria:
- Imported lines are usable for matching and posting workflows.
Step 5: Validate Duplicate Protection
- Re-run import for the same date range.
- Confirm previously imported transactions are skipped.
Pass criteria:
- No duplicate lines are created for already imported transactions.
Completion Checklist
The setup is complete when all checks below are true:
- Credentials and base URL are correct.
- Bank account number is correctly aligned with FNB.
- Initial import creates reconciliation lines.
- Repeat import skips duplicates.