--- title: Updating Vendor via CSV slug: santander/updating-vendor-via-csv docTags: qsTTpmTCpLZnj3pL4Rz_Z createdAt: 2022-10-27T19:12:23.000Z --- The plugin allows you to update their vendor payment information in bulk through CSV files, eliminating the need for manual changes to each individual record. You can use this process to edit existing vendor records, to add additional line items to existing vendors, and to create new vendor records. Keep in mind that information stored inside native Intacct cannot be updated in the plugin. *** ## 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. Follow these steps to begin the export and import process. :::::WorkflowBlock :::WorkflowBlockItem ### Navigate to Payment Methods From anywhere in Intacct, you can navigate to the Payment Methods page. Click on the Santander Fusion button and then **Payment Methods.** ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/HITy6growPTkO8b7fC4G8_screenshot-2024-06-06-at-41418-pm.png" size="60" width="514" height="232" position="center" caption="Select Payment Methods" showCaption="true"} ::: ::::WorkflowBlockItem ### Export CSV Click **Export CSV**. A CSV file containing all previously saved vendors is generated. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/c1hBWwXSFsmhfrCknKXla_screenshot-2024-06-06-at-41234-pm.png" size="80" width="818" height="108" position="center" caption="Select Export" showCaption="true"} :::hint{type="warning"} **IMPORTANT:** The CSV is pre-structured for import functionality; do not modfiy the column structures. ::: The import from Intacct 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. ::: :::: ::::WorkflowBlockItem ### Prepare the File for Import Once you have exported the existing vendor information, create the import file containing your revised vendor 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. 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** 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 | Intacct vendor ID | **Required Field**
Do not modify. This field protects against duplicate records. | | vendor\_name | Intacct 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 ### Import CSV Once the file is ready, select the **Import** **CSV **button. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/c1hBWwXSFsmhfrCknKXla_screenshot-2024-06-06-at-41234-pm.png" size="80" width="818" height="108" position="center" caption="Select Import" 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/xZqYM1nF7VvQBs2q58NCr_screenshot-2024-06-06-at-41241-pm.png" size="80" width="1434" height="700" position="center" caption="Add Import CSV" showCaption="true"} Once the file has been uploaded, a checkmark will appear. You can expect an email with a status update within a few minutes. ::Image[]{src="https://api.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/Ygqdr9N10zUL5FQ7JlWiJ_screenshot-2024-06-06-at-41320-pm.png" size="80" width="1484" height="622" position="center" caption="Processing Begins" showCaption="true"} :::: :::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/fvNP04K_etLejFI2Ma3zD-NG-SnfmVzuqQgIvY7AsiK-20250904-212802.png" size="50" width="1060" height="1214" position="center" caption="File Successfully 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?format=webp&width=800" size="80" width="800" height="219" position="center" caption="Example Vendor CSV Import file" showCaption="true"} On the Payment Methods page, when you select the vendor, it shows that the bank account has been added. ::Image[]{src="https://app.archbee.com/api/optimize/MM6nC_bKbIkwCRqiFZqEu/vk17KC_tARbst1HBQ6afr_screenshot-2024-06-06-at-42552-pm.png" size="84" width="1096" height="598" position="center" caption="Click on Bank Account" 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/PVWpX86DSqPPS7gLVkEDb_screenshot-2024-06-06-at-42540-pm.png" size="80" width="1920" height="934" position="center" caption="Confirm Values" showCaption="true"} *** ## Potential Errors | **Potential errors** | **Explanation** | **Steps to fix the error** | | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data_type` must be: DEFAULT PAYMENT METHOD or DOMESTIC BANK ACCOUNT or INTERNATIONAL BANK ACCOUNT | `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.` | Email address format was not respected. | Follow the following format: [something@email.com](#) If you would like to add multiple email addresses, ensure they are comma-separated as below: [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) |