Acquisitions

Get there: More > Administration > System preferences > Acquisitions

EDIFACT

EDIFACT

Asks: ___ EDIFACT message exchange for acquisitions

Default: Enable

Values:

  • Disable

  • Enable

Description:

  • This system preference is the main switch to turn on or turn off the EDIFACT feature in Koha.

EdifactInvoiceImport

Asks: ___ automatically import EDIFACT invoice message files when they are downloaded.

Default: Do

Values:

  • Do

  • Don’t

Description:

  • This feature allows libraries to delay the importing of EDI invoices until a time of their choosing. If the system preference is set to ‚Don’t‘ the invoices are imported into the database but the invoice processing is skipped. Instead, any invoice file listed in EDIfact messages with a status of ‚New‘ will have an ‚Import‘ button to process the invoice manually.

EdifactLSQ

Asks: Map sequence code (GIR:LSQ) field to ___ in items.

Default: location

Values:

  • collection

  • location

Description:

  • EDItEUR describes the LSQ segment as „A code or other designation which identifies stock which is to be shelved in a specified sequence or collection.“ In Koha, this could be interpreted as either the item’s location or collection (ccode).

  • This system preference is used to indicate to Koha to which field this should be mapped.

Policy

AcqCreateItem

Asks: Create an item when ___.

Default: placing an order

Values:

  • cataloging a record

  • placing an order

  • receiving an order

Description:

  • This preference lets you decide when you’d like to create an item record in Koha.

  • If you choose to add an item record when ‚placing an order‘, you will enter item information in as you add records in your basket.

  • If you choose to add the item when ‚receiving an order‘ you will be asked for item record information when you’re receiving orders in acquisitions.

  • If you choose to add the item when ‚cataloging a record‘ then item records will not be created in acquisitions at all. You will need to go to the cataloging module to add the items.

  • Note that this setting can be overridden when creating a basket.

AcqEnableFiles

Asks: ___ enable the ability to upload and attach arbitrary files to invoices.

Default: Don’t

Values:

  • Do

  • Don’t

Description:

AcqItemSetSubfieldsWhenReceiptIsCancelled

Asks: Upon canceling a receipt, update the item’s subfields if they were created when placing an order (e.g. o=5|a=“bar foo““). ___

Description:

  • This preference is used in conjunction with the AcqItemSetSubfieldsWhenReceived preference. If you have the system set to enter default values when you receive you will want to have those values revert back if the receipt is canceled. This preference allows you to do that.

AcqItemSetSubfieldsWhenReceived

Asks: Upon receiving items, update their subfields if they were created when placing an order (e.g. o=5|a=“foo bar“). ___

Description:

  • This preference allows you to set default values for items that you receive via acquisitions. Enter the data as subfield=value and split your values with a bar ( | ). For example you can remove the Ordered status on the item automatically when you receive it just by entering 7=0 in this preference. That will set the Not for Loan status (subfield 7) to 0 which is available.

AcquisitionsDefaultEmailAddress

Version

This system preference was added in version 23.11 of Koha.

Asks: Use the from email address ___ when sending acquisitions order and claim notices.

Description:

  • This system preference allows you to set a different email address for sending orders and claims from the acquisitions module.

  • If left empty, it will use instead the first email address available in this order:

AcquisitionsDefaultReplyTo

Version

This system preference was added in version 23.11 of Koha.

Asks: Use the reply-to email address ___ when sending acquisitions order and claim notices.

Description:

AcqViewBaskets

Asks: Show baskets ___

Default: created or managed by staff member

Values:

  • in system, regardless of owner

  • from staff member’s library

  • created or managed by staff member

Description:

  • When in acquisitions, this preference allows you to control whose baskets you can see when looking at a vendor.

  • The default value of ‚created or managed by staff member‘ makes it so that you only see the baskets you created.

  • Choosing to see baskets ‚from staff member’s library‘ will show you the baskets created by anyone at the branch you’re logged in at.

  • Finally, you can choose to set this preference to show you all baskets regardless of who created it (‚in system, regardless of owner‘).

  • Regardless of which value you choose for this preference, superlibrarians can see all baskets created in the system.

AcqWarnOnDuplicateInvoice

Asks: ___ when the librarian tries to create an invoice with a duplicate number.

Default: Do not warn

Values:

  • Do not warn

  • Warn

Description:

  • When set to ‚Warn‘, Koha will let staff know if an invoice with the same number has already been created. The staff member will have a choice to either receive on the existing invoice or create a new one with the same number.

Screenshot of a warning message that says 'This invoice number has already been used. Would you like to receive on an existing invoice?' with an option to receive on the existing invoice or 'Create new invoice anyway'.

BasketConfirmations

Asks: When closing or reopening a basket, ___.

Default: always ask for confirmation

Values:

  • always ask for confirmation

  • do not ask for confirmation

Descriptions:

  • This preference adds the option to skip confirmations on closing and reopening a basket. If you skip the confirmation, you do not create a new basket group.

CalculateFundValuesIncludingTax

Version

This system preference was added in version 23.11 of Koha.

Asks: ___ tax in the calculated fund values (spent, ordered).

Values:

  • Exclude

  • Include

Default: Include

Description:

  • This system preference specifies whether the library funds values include the tax amount or not.

  • This preference applies to all vendors regardless of their configuration.

  • When this preference is set to ‚Exclude‘, librarians creating and receiving orders will enter prices as they appear on the invoice - e.g., the costs including tax. The value deducted from the library funds will, however, correspond to the prices excluding tax. This is useful for libraries that can claim back tax: their funds totals will still be accurate, reflecting the amounts actually used.

CancelOrdersInClosedBaskets

Version

This system preference was added in version 23.11 of Koha.

Asks: ___ cancelling order lines in closed baskets.

Values:

  • Don’t allow

  • Allow

Default: Don’t allow

Description:

  • This system preference is used to enable the ability to cancel orders in baskets that are already closed (meaning the order was sent to the vendor). This is useful if vendors cannot supply the ordered item and you don’t want to reopen the basket or go through the receive shipment process.

ClaimsBccCopy

Asks: ___ blind copy (BCC) to logged in user when sending serial or acquisitions claims notices.

Default: Don’t send

Values:

  • Don’t send

  • Send

Description:

CurrencyFormat

Asks: Display currencies using the following format ___

Default: 360,000.00 (US)

Values:

  • 360’000.00 (CH)

  • 360 000,00 (FR)

  • 360,000.00 (US)

Description:

  • This system preference controls how prices are displayed in Koha.

EmailPurchaseSuggestions and EmailAddressForSuggestions

Asks: Choose email address that new purchase suggestions will be sent to: ___. If you choose EmailAddressForSuggestions you have to enter a valid email address: ___

Default: none

Values:

  • none

  • email address of library

  • EmailAddressForSuggestions

  • KohaAdminEmailAddress

Description:

  • If you want Koha to send purchase suggestions via email, choose which email address it should send them to

    • none will deactivate this feature

    • email address of library will use the email address entered in the libraries settings

    • if you choose EmailAddressForSuggestions, enter the email address in the input field

    • if you choose KohaAdminEmailAddress, the email will be sent to the main email address, as entered in KohaAdminEmailAddress

  • You can customize the message that is sent with the Notices and slips tool, the letter code is NEW_SUGGESTION

MarcFieldsToOrder

Asks: Set the mapping values for a new order line created from a MARC record in a staged file.

Description:

  • This preference includes MARC fields to check for order information to use when you order from a new .mrc file or when you order from a staged file in acquisitions. You can use the following fields:

    • price,

    • quantity,

    • budget_code,

    • discount,

    • sort1, and

    • sort2.

    For example:

    price: 947$a|947$c
    quantity: 969$h
    budget_code: 922$a
    

Varovanie

Requires YAML syntax to work

This means

  • Make sure there is NO space between the field name and the colon

  • Make sure there IS a space between the colon and the value

  • Make sure each pair is on its own line

MarcItemFieldsToOrder

Asks: Set the mapping values for new item records created from a MARC record in a staged file.

Description:

  • This preference automatically generates items in Koha with populated information based on a 9XX field and subfield. You can use the following fields:

    • homebranch,

    • holdingbranch,

    • itype,

    • nonpublic_note,

    • public_note,

    • loc,

    • ccode,

    • notforloan,

    • uri,

    • copyno,

    • price,

    • replacementprice,

    • itemcallnumber,

    • coded_location_qualifier,

    • barcode, and

    • enumchron.

  • You can also use the following special fields:

    • quantity, and

    • budget_code.

For example:

homebranch: 975$a
holdingbranch: 975$b
public_note: 975$z
loc: 975$c

Varovanie

Requires YAML syntax to work

This means

  • Make sure there is NO space between the field name and the colon

  • Make sure there IS a space between the colon and the value

  • Make sure each pair is on its own line

Version

The support for the coded_location_qualifier, barcode, and enumchron fields was added to Koha in version 24.05.

OrderPriceRounding

Asks: ___ to nearest cent.

Default: Don’t round

Values:

  • Don’t round

  • Round

Description:

  • This system preference determines whether full precision values or rounded values should be used in price calculations.

  • This is particularly important when your tax rates have more decimals than your currency

PurgeSuggestionsOlderThan

Asks: Keep accepted or rejected purchase suggestions for a period of ___ days.

Varovanie

Leave this field empty if you don’t want to activate this automatic feature.

Description:

  • Enter the number of days after which you want to automatically delete accepted or rejected purchase suggestions.

  • For example: [30] will purge suggestions older than 30 days.

Poznámka

The number of days is based on the ‚managed on‘ date.

  • This system preference requires the cronjob purge_suggestions.pl to be active and called without a specific number of days (‘–days‘ parameter).

TaxRates

Asks: Tax rates are ___

Default: 0

Description:

  • This preference allows the library to define goods and services tax rates for acquisitions.

  • The first item in the list will be selected by default.

Poznámka

Enter this value as a number (.06) versus a percent (6%).

For more than one value, separate with | (pipe).

For example

0|0.05|0.1496

will give you choices of tax rates of 0%, 5% and 14.96%

Varovanie

The database only accepts values up to 4 decimals, further values will be rounded.

UniqueItemFields

Asks: The following database columns should be unique in an item: ___

Default: barcode

Description:

  • If this preference is left blank when adding items in acquisitions there will be no check for uniqueness. This means that a duplicate barcode can be created in acquisitions which will cause errors later when checking items in and out.

UseACQFrameworkForBiblioRecords

Asks: ___ the framework ‚ACQ‘ for bibliographic records fields

Default: Don’t use

Values:

  • Don’t use

  • Use

Description:

  • This system preference allows you to use the ACQ bibliographic framework to customize the bibliographic record fields that are shown when ordering from acquisitions

  • Note that this does not affect the item fields (in MARC21, field 952), which are always taken from the ACQ framework regardless of this system preference

Printing

1PageOrderPDFText

Version

This system preference was added to Koha in version 24.05.

Asks: Text to be used above the order table in the English 1-page order PDF file.

Default:

Order number must appear on all related correspondence, shipping papers
and invoices. Notify us immediately if
you are unable to supply item(s).

Description:

  • This system preference is used to customize the text printed above the order table when using the ‚English 1-Page‘ option in the OrderPdfFormat system preference.

Poznámka

Press enter to add line breaks to your sentence.

Dôležité

To prevent the bottom of your text from being cut off by the order table please do not save more than 3 lines of text in this system preference.

OrderPdfFormat

Asks: Use the ___ layout when printing basket groups.

Default: English 3-page

Values:

  • English 1-page

  • English 2-page

  • English 3-page

  • German 2-page

  • French 3-page

Description:

  • This preference determines how basket groups are printed when exported as PDFs.

  • A 1-page layout will have vendor information and ordered titles on the same page. The text above the orders table can be customized with the 1PageOrderPDFText system preference.

  • A 2-page layout will have vendor information on the first page and ordered titles on the second page

  • A 3-page layout will additionally have a page with basket information