--- title: Updating Vendor Payment Methods Via CSV (Business Central) slug: td/updating-vendor-payment-methods-via-csv-bc365 description: Streamline bulk updates of vendor payment info in Business Central with our CSV; export current records for easy formatting and avoid manual changes for efficiency. docTags: kOBW7Pa05SaMsJIm9Vdtp createdAt: 2022-08-18T19:33:23.000Z --- The plugin allows users to update their vendor payment information in bulk using a Comma-Separated Values (CSV) file, eliminating the need to manually change each vendor record. Keep in mind that information stored within native Business Central fields (outside of the plugin) cannot be updated using this plugin functionality. *** ## Export and Import Functionality This functionality allows you to manage your vendor records through a two-part process: Export and Import. - Export creates a file containing all your current vendor records. - Import allows you to update existing records by applying changes to your vendor data. Always export first before you begin an import. This is the best way to ensure the CSV file is structured correctly, as the row format changes depending on the type of data you are working with. You can re-import the same data multiple times to update existing rows, provided the ID fields in the file have not been modified or changed. *** ## Export Follow these steps to complete the first part of the process, exporting the CSV file. :::::WorkflowBlock :::WorkflowBlockItem ### Navigate to Payment Methods From anywhere in Business Central, you can navigate to the Payment Methods page. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/JFVNpAg1i-C6qz52vundh_screenshot-2023-07-28-at-25139-pm.png" size="72" width="586" height="46" position="center" caption="Select Payment Methods" showCaption="true"} Click on TD Bank and then **Payment Methods **to begin the export and import process. ::: ::::WorkflowBlockItem ### Export CSV Click **Export CSV** to create a CSV export file for all vendor records. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/7N78TNtKLhLMpc2vek9Dp-20260302-231537.png" size="68" width="2658" height="682" position="center" caption="Click Export CSV" showCaption="true"} :::hint{type="warning"} **IMPORTANT:** The CSV is pre-structured for import functionality; do not modify the column structures. ::: The import from Business Central triggers a minimum of one row of data. There are three different data types: - **BANK ACCOUNT: **Each vendor with a bank account creates a row with a data\_type of **BANK ACCOUNT**, allowing you to modify the vendor’s bank account. - **ADDRESS: **Each vendor with an address record creates a row with a data\_type of **ADDRESS**, allowing you to modify the vendor’s address. - **EMAIL: **Each vendor with an address record creates a row with a data\_type of **EMAIL**, allowing you to modify the vendor’s email. :::hint{type="info"} **NOTE: **Save a copy of this file for your records so you can easily re-import the original if necessary. ::: :::: ::::: *** ## Import Once you have exported the existing vendor bank information, create the import file containing your revised vendor bank information by editing the data and adding new rows if you are incorporating new vendors. Do not remove any of the column headers or add additional columns; otherwise, the import will fail. :::::WorkflowBlock ::::WorkflowBlockItem ### Prepare the File for Import Each of the three data types requires specific data fields. Use the existing records as a guide to which columns require data, and be sure to follow the general rules to avoid errors that prevent a successful import. - **BANK ACCOUNT:** To add a new bank account, add a row and enter **BANK ACCOUNT** in the data\_type column. - **ADDRESS: **To add a new address, add a row and enter **ADDRESS **in the data\_type column. - **EMAIL: **To add a new email, add a row and enter **EMAIL **in the data\_type column. Please do not fill in the email or address fields for these columns, and ensure that the other columns are completed according to the guidance provided in the table below. :::hint{type="info"} **NOTE: **Only one line entry per vendor can have the is\_default\_account set to **Y**. Enter the default\_payment\_method for the default account address record. ::Image[]{src="https://images.archbee.com/z7B2F1SpvEnr9KImiRpyQ-Xb7_gOptHStgH5lTH2l_m-20241108-194022.png?format=webp&width=800?format=webp&width=800?format=webp&width=800" size="90" width="800" height="365" position="center" caption="Only one line entry per vendor can have the "is_default_account" set to "Y"" showCaption="true"} ::: :::: :::WorkflowBlockItem ### Fill the CSV Table You need to use specific default\_payment\_method code values that correspond to your payment rail types. Since a vendor can only have one default account with a default\_payment\_method, you must ensure the payment method you choose is compatible with the corresponding data type. Navigate to** Plugin → Payment Methods** and check in the table which payment methods are listed for a vendor. Here is a complete list showing which payment rail types are supported by each data type. Use only the payment rails supported by your plugin for this specific vendor. **CSV file - table rows** | **data\_type** | **Compatible default payment\_method(s) **
**for this data type** | **Other rules** | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | BANK ACCOUNT | ACH
ACH\_NEXT\_DAY
CPA
BACS
SEPA
WIRE
EFT\_AU
WIRE\_AU
EFT\_SG
WIRE\_SG
WIRE\_NZ
EFT\_NZ
WIRE\_ZA
EFT\_ZA
INTERNATIONAL\_WIRE
INTERNATIONAL\_ACH
UK\_FPS | Leave the email and address fields empty. | | ADDRESS | CHECK | Leave the bank account and email fields empty. | | EMAIL | VCC | Leave the bank account and address fields empty | **CSV file - table columns** | **Column Name** | **Allowable Values (CASE SENSITIVE)** | **Notes** | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | data\_type | Either: ADDRESS, BANK ACCOUNT, EMAIL | **Required Field**
For **BANK ACCOUNT**, leave the email and address fields empty.
For **ADDRESS**, leave the bank account and email fields empty.
For **EMAIL**, leave the email and address fields empty. | | id | Internal ID | Leave empty if adding a new payment method. Do not modify the value if modifying existing payment information. | | erp\_vendor\_id | Business Central vendor ID | **Required Field**
Do not modify. This field protects against duplicate records. | | vendor\_name | Business Central vendor name |   | | is\_default\_account | Y/N | **Required Field**
Can only have one default Y per vendor. All others must be N. | | default\_payment\_method | Please confirm that they are in capital letters (e.g., ACH, ACH NEXT DAY, CHECK, INTERNATIONAL ACH, INTERNATIONAL WIRE, SEPA, VCC) | Anything from the list of available payment methods. To see what is enabled on the vendor, navigate to **Plugin → Payment Methods** and check in the table which payment methods are listed for that vendor.
Any unsupported payment type will result in the line failing to import. If you would like to add some payment methods to the plugin, please contact your bank. | | is\_editable | Y/N | **Required Field**
For any new lines, please enter "Y".
Do not modify an "N" and change it to a "Y"; doing this may break the import. | | email\_addresses | Any email addresses, up to 5 | Separate each email address with “,” | | country | [ISO alpha-2 country codes](https://www.iban.com/country-codes) | **Required Field For Bank Accounts**
This field accepts upper, lower, and mixed case values. Please enter the ISO alpha-2 country codes format. The import will error if the user enters the full country name (i.e., New Zealand). | | currency | [Currency codes](https://www.iban.com/currency-codes) | **Required Field For Bank Accounts**
Please enter the currency following the currency code list. This field accepts upper, lower, and mixed case values. | | account\_type | CHECKING or SAVINGS | **Required Field For Bank Accounts**
This field accepts upper, lower, and mixed case values | | account\_number | Vendor's account number | | | institution\_number | Vendor's institution number | | | transit\_number | Vendor's transit number | | | routing\_number | Vendor's routing number | | | bank\_code | | | | iban | Two letter country code, followed by two check digits, and up to 35 alphanumeric characters | | | bic | Vendor's BIC or SWIFT code for the country and bank | | | bank\_name | Anything | | | address\_line | Anything |   | | address\_line\_2 | Anything | | | address\_city | Anything |   | | address\_state\_province | Anything |   | | address\_postal\_Code | Anything |   | | local\_branch\_code | Valid branch code for this bank | Use this field for BSB codes if the country requires it | | payment\_purpose\_message | Anything |   | | payment\_purpose\_code | Valid purpose code |   | | payment\_payment\_iso\_code | Valid sender country code |   | | payment\_payment\_codeword | Valid receiving entity codeword |   | | payment\_payment\_party\_type | P, T, G, N | P = Parent, T = Subsidiary, G = Group, N = Non-related | | payment\_residential\_status | resident, nonresident |   | | sort\_code | Valid sort code for this bank | | ::: ::::WorkflowBlockItem ### Importing CSV Once the file is ready, select **Import** **CSV**. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/7N78TNtKLhLMpc2vek9Dp-20260302-231537.png" size="68" width="2658" height="682" position="center" caption="Click Export CSV" showCaption="true"} Attach the file that is ready to import and enter one valid email address to receive a status update. :::hint{type="info"} **NOTE:** You are not able to modify this email address after clicking **Import. **If the email is incorrect, you will not get the status email, but the import will complete. ::: ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/9t9nindZJGqKi_jNQc28J-20260302-231615.png" size="80" width="2072" height="1120" position="center" caption="Drop your CSV file here to upload or browse your computer" showCaption="true"} Once the file has been uploaded, a checkmark confirmation message will appear. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/YCZJaRsP-rnkYNh2VIQha-20260302-231615.png" size="70" width="2226" height="940" position="center" caption="Click Got It" showCaption="true"} Wait a few minutes to get a status update via email. :::: :::WorkflowBlockItem ### Import Confirmation Email Once the import status changes, you will receive an email notification. This email notification will let you know if the import has been successful. There are 3 options: **File Successfully Imported** ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/Ooo6tUX2y1_Kphjaopnmp_screenshot-2023-06-30-at-30610-pm.png" size="50" width="630" height="712" position="center" caption="File Was Sucessfully Imported" showCaption="true"} **Import is successful, but there are line errors.** - In that case, please download the CSV attached to the email that lists those errors and submit the file again. You may leave the error column in the newly uploaded CSV. Please note that if an error is found in one of the rows, none of the information present in that row will be updated. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/oMfKJjc9K7OTKnO95XpWq_screenshot-2023-06-30-at-25217-pm.png" size="54" width="613" height="713" position="center" caption="File Was Not Imported" showCaption="true"} **Import was not successful.** - This issue may be caused by internet connectivity problems or unsupported file formats. Please verify your internet connection, refresh the page to attempt again, or contact support if the problem persists. ::: ::::: *** ## Import CSV Example This file shows an example of what the import file can look like for one hypothetical vendor. ::Image[]{src="https://images.archbee.com/z7B2F1SpvEnr9KImiRpyQ-URBk539tYgHNwVckizb80-20241107-235004.png?format=webp&width=800" size="80" width="800" height="219" position="center" caption="Example Vendor CSV Import file" showCaption="true"} In BC365, when you select the vendor, it shows that the new bank account has been added. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/QISC35Km39dFNovTj5MkQ_screenshot-2023-06-30-at-31802-pm.png" size="60" width="735" height="413" position="center" caption="Verification that bank account has been added - Payment Setup " showCaption="true"} When you open up the bank account, you can see the values match the import. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/aIZ5ojpN2qof2Dv0DPvLU_screenshot-2023-06-30-at-31751-pm.png" size="64" width="887" height="306" position="center" caption="Bank account field values" showCaption="true"} *** ## Potential Errors | **Errors** | **Explanation** | **Solutioning** | | ----------------------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data_type` must be: BANK ACCOUNT or EMAIL or ADDRESS | `data_type` was not filled in. | Always include a data\_type, this is a mandatory field. | | `vendor_id must be filled in.` | `vendor_id` was not filled in. | Always include a vendor\_id; this is a mandatory field. | | `default_payment_method must be of a valid Payment Type.` | `default_payment_method` was not correctly filled in. | Ensure your account has this payment method enabled. | | `email_addresses contains email(s) with an invalid email format.` | The email address format was not respected. | Follow the following format: [something@email.com](#) you would like to add multiple email addresses, confirm they are comma-separated like so: [email1@email.com](#), [email2@email.com](#) | | `Both country and currency must be filled in.` | Country and currency both need to be filled in. | | | `country contains invalid country code` | Country code is not valid. | Select a valid country code from this list: [ISO alpha-2 country codes](https://www.iban.com/country-codes) | | `currency contains an invalid currency code.` | Currency code is not valid. | Select a valid currency code from this list: [Currency codes](https://www.iban.com/currency-codes) |