> For the complete documentation index, see [llms.txt](https://docs.biscit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biscit.com/biscit-spend-management/how-tos/how-to-add-supplier-bank.md).

# How to Add Supplier Bank

**Configure Supplier Bank Details in Epicor**

1. In Epicor, navigate to Suppliers (or Financial Management > Accounts Payable > Setup > Supplier).
2. Create a new supplier or search for an existing supplier record.
3. Under the Detail tab, verify the supplier's Name and primary Currency.
4. Under the Address section, ensure the supplier's address details are entered.
5. Click Save.
6. Scroll down and expand the Banks/Remits card.
7. Click the + (Add) button to create a new bank record.
8. Fill in the following required fields:

   | **Field**                          | **Description / Instruction**                                                                                              |
   | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
   | Bank/Remit To Name                 | Enter the bank name.                                                                                                       |
   | Payment Method                     | Select BSM from the dropdown. *(Crucial: Only bank records with the BSM payment method will appear in the BSM Dashboard).* |
   | Bank Account Number                | Enter the supplier's bank account number.                                                                                  |
   | Bank Branch Code / Bank Identifier | Enter the appropriate routing code, sort code, or ABA number.                                                              |
9. Click the expanded detail view icon on the bank line to open the full Bank Detail form.
10. In the Bank Address / Pay to Information section, complete the bank's address fields:<br>

    | **Field**                         | **Description / Instruction**                          |
    | --------------------------------- | ------------------------------------------------------ |
    | Country                           | Select the valid country (e.g., USA).                  |
    | City, State/Province, Postal Code | Ensure valid, matching geographic details are entered. |

    \
    **Note:** Address validations performed by the integration validate the Bank Address fields configured on the bank record, not just the primary supplier mailing address.<br>
11. Click Save.
12. Once saved in Epicor, the bank account will automatically appear in the BSM portal for verification.
13. In the BSM Dashboard, open the left navigation menu and select Add Supplier Banks.
14. Click the Refresh icon on the top right if your newly created supplier bank does not immediately appear.
15. Locate your supplier in the list.
16. Check the status indicator column next to the supplier name:
    * Green Check / Clear: All fields are valid and ready to be added.
    * Red Error Icon: Indicates missing or invalid information (e.g., invalid routing code length, missing bank country, or invalid city/postcode). Hover over or review the error banner to see the specific fix required.
17. If errors exist, return to the Suppliers > Banks/Remits form in Epicor, correct the data, save, and refresh the BSM page.
18. Click the blue Add Selected button in the top-right corner.
19. In the Multifactor Authentication Required modal:
    * Enter your 6-digit MFA Passcode generated by your authenticator app.
    * Click Verify.
20. A confirmation dialog (Add Supplier Banks Result) will display showing the successfully added supplier and bank.
21. Click OK.

**If changes are made in Epicor to a bank account that has already been added to OFX These shouyld be synced:**

1. Navigate to Sync Supplier Banks from the left navigation menu.
2. The page will highlight discrepancies between Epicor and BSM/OFX in stacked comparison rows.
3. Select the modified supplier bank checkbox.
4. Click Sync Selected, enter your MFA passcode, and click Verify to push the updated details to OFX.

**Verify in OFX Portal:**&#x20;

1. Open the OFX portal, navigate to Recipients, search for the supplier name, and confirm that the recipient status is Active with the correct account and routing details.

Common Error Messages & Resolutions

| **Error Displayed**                                    | **Cause**                                                                                    | **Resolution**                                                                     |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| "No country is set to the bank address"                | The Country field under the Bank Detail in Epicor is empty.                                  | Open Banks/Remits > Detail in Epicor and select a valid Country.                   |
| "Supplier post code is not valid" / "Not a valid city" | Postcode format does not match the specified City/State.                                     | Correct the City, State, and Postal Code in the supplier's bank address in Epicor. |
| "Invalid ABA / Routing Code"                           | The routing number does not match the required digit length for that country/routing method. | Enter a valid ABA/routing code under Bank Identifier / Branch Code in Epicor.      |
| Supplier bank does not appear in list                  | Payment method in Epicor is not set to "BSM".                                                | In Epicor Banks/Remits, change the Payment Method to "BSM" and save.               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.biscit.com/biscit-spend-management/how-tos/how-to-add-supplier-bank.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
