Creating a New Vendor
For detailed instructions on creating new vendors, see 'Adding a vendor' in the
Koha manual.
The Name of the vendor is a required field, but beyond that, libraries can enter as much or as little information as is useful.
In 'Company details', Vendor type is a special field that can be used to categorize vendors in a way that is helpful for your library. It can either be used as free text (which is the default), or libraries can use the VENDOR_TYPE authorized value category to create a pre-populated list from which staff can select when creating a new vendor or editing an existing one:
There are no default values in the VENDOR_TYPE authorized value category, so they are completely customizable to your library.
Once added, the vendor's type will show up next to its name in parentheses:
Also in 'Contact details', Aliases are other terms or names that libraries can use to search for vendors. This can be useful if a vendor changed its name, is commonly referred to by a nickname, or has different spellings of its name. To add an alias, type it into the Aliases box and click '+ Add':
Vendors can have multiple aliases. To delete an alias, open the vendor record for editing, click the 'Remove' link next to the alias you no longer need, and click 'Save' on the record.
In 'Interfaces', libraries can save details about vendor interfaces such as websites, ordering platforms, reporting services, or support portals so that they can be easily accessed by Acquisitions staff. To delete an interface, open the vendor record and select the 'Delete interface' button below the interface you no longer need.
Searching For, Viewing, and Editing Vendors
Tracking Vendor Issues
Libraries can use the Acquisitions module to track issues or problems with their vendors. These are saved in the aqbookseller_issues table, which means that reports can be written on them. ByWater Solutions partners can submit a ticket for assistance with this report. To learn more, watch
Monday Minutes: Vendor Issues in Acquisitions. Further details are available under
Recording issues with vendors in the Koha manual.
Creating Aliases
The aliases field can be used for a former name, nickname, or different spellings of the name. Once staff add the alias, it will display on the vendor detail page. Additionally, staff can search by alias when starting their acquisitions workflow.
- Navigate to the Acquisitions Module and Search for vendor
- Click Edit Vendor
- Notice and Alias field under vendor type
- Add the alias and click the +Add
- Add as many alias' as needed
- Click save
Create Interfaces
An interface can be described or tracked for vendor website, ordering platform, or support portal that you use to manage orders or gather statistics from the vendor or organization. Within this new feature, staff can track usernames and passwords, that will be encrypted for storage, but can be decrypted and made visible in the staff interface.
This enhancement also introduces a new authorized values category, VENDOR_INTERFACE_TYPE, to define the type of interface. Staff will be able to create multiple entries within one vendor record.
- Navigate to the Acquisitions Module and Search for vendor
- Click Edit Vendor
- Scroll down to Interfaces
- Click +Add another interface
- Enter Information for the following (no fields are required)
- Name - name of interface
- Type - driven from authorized value VENDOR_INTERFACE_TYPE
- URI - the login URL of the interface
- Login - username
- Password - password to login
- Account Email - email if needed
- Notes - add any additional information
- Click Save.