Das Koha-Erwerbungsmodul ermöglicht es der Bibliothek, Bestellungen und Lieferanten sowie die Haushaltsmittel zu überwachen und zu verwalten.

  • Get there: More > Acquisitions


Before using the Acquisitions Module you will want to make sure that you have completed all of the set up.

First, set your Acquisitions System Preferences and Acquisitions Administration to match your library’s workflow. Before setting your EDI accounts and Bibliotheks-EANs you will need to have entered your vendors.

On the main acquisitions page you will see your library’s funds listed.



If the total line is confusing for the funds you have set up you can hide it by adding

#funds_total {display:none;}

to the IntranetUserCSS preference.

To see all active funds you can click the checkbox next to ‚Show active and inactive‘ above the funds table.

To see a history of all orders in a fund you can click on the linked amount and it will run a search for you.


Learn more in the Budget/Fund Tracking section of this manual.


Before any orders can be places you must first enter at least one vendor.

Neuer Lieferant

To add a vendor click the ‚New Vendor‘ button on the Acquisitions page


The vendor add form is broken into three pieces

  • The first section is for basic information about the Vendor


    • Of these fields, only the Vendor name is required, the rest of the information should be added to help with generating claim letters and invoices

  • The second section is for information regarding your contact at the Vendor’s office


    • None of these fields are required, they should only be entered if you want to keep track of your contact’s information within Koha

      • Primary acquisitions contact: check this box if this person is your primary contact regarding acquisitions from this vendor

      • Primary serials contact: check this box if this person is your primary contact regarding serial acquisitions from this vendor

      • Contact when ordering? check this box if you want to be able to send your orders by email directly to this person

      • Contact about late orders? check this box if you want to be able to send your acquisitions claims by email directly to this person

      • Contact about late issues? check this box if you want to be able to send your serials claims by email directly to this person

    • You can add more than one contact per vendor by clicking on the ‚Add another contact‘ button

  • The final section is for billing information


    • To be able to order from a vendor you must make them ‚Active‘

    • For List Prices and Invoice Prices choose the currency

    • If your library is charged tax mark your Tax Number as registered

    • Note if you list prices and/or invoice prices include tax

    • If the vendor offers a consistent blank discount, enter that in the ‚Discount‘ field

      • Sie können bei der Bestellung einen exemplaspezifischen Rabatt eingeben

    • Enter your tax rate if your library is charged taxes on orders

    • If you know about how long it usually takes orders to arrive from this vendor you can enter a delivery time. This will allow Koha to estimate when orders will arrive at your library on the late orders report.

    • Notes are for internal use

Lieferant anzeigen/bearbeiten

To view a vendor’s information page you must search for the vendor from the Acquisitions home page. Your search can be for any part of the Vendor’s name:


From the results, click on the name of the vendor you want to view or edit


To make changes to the vendor, simply click the ‚Edit vendor‘ button.

If the vendor has no baskets attached to it then a ‚Delete vendor‘ button will also be visible and the vendor can be deleted. Otherwise you will see a ‚Receive shipment‘ button.



Sie können Lieferverträge (mit Anfangs- und Enddatum) einem bestimmten Lieferanten zuweisen. Am Jahresende können Sie dann den Umsatz mit diesem Lieferanten sehen. In manchen Fällen werden Lieferverträge mit einem minimalen bzw. maximalen Jahresbetrag abgeschlossen.

Neue Vereinbarung

Am oberen Rand einer Lieferantendetailansicht gibt es eine Schaltfläche ‚Neue Vereinbarung‘.


The contract form will ask for some very basic information about the contract



You cannot enter a contract retrospectively. The end date must not be before today’s date.

Sobald eine Vereinbarung gespeichert ist, erscheint sie unter der Händlerinformation.


It will also be an option when creating a basket


Managing Suggestions

Purchase suggestions can be generated in one of two ways. You can create suggestions via the staff client either for the library or on the patron’s behalf from their record. Depending on your settings in the Anschaffungsvorschlag system preference, patrons may also be able to make purchase suggestions via the OPAC. When a suggestion is waiting for library review, it will appear on the Acquisitions home page next to the vendor search.


It will also appear on the main staff dashboard under the module labels:


Wenn Sie auf ‚Anschaffungsvorschläge verwalten‘ klicken, gelangen Sie in das Werkzeug zur Bearbeitung von Anschaffungsvorschlägen. Wenn keine Vorschläge auf Bearbeitung warten, können Sie das Werkzeug auch über den Link ‚Anschaffungsvorschläge verwalten‘ auf der linken Seite im Modul Erwerbung erreichen.


Ihre Anschaffungsvorschläge werden in unterschiedliche Kategorien eingeordnet. Akzeptiert, Zu bearbeiten, Geprüft, Bestellt und Abgelehnt. Bei jedem akzeptierten oder abgelehnten Anschaffungsvorschlag werden der Name des Bearbeiters und die Gründe für die Akzeptierung oder Ablehnung (bei ‚Status‘) angezeigt.

An ‚Accepted‘ suggestion is one that you have marked as ‚Accepted‘ using the form below the suggestions. A ‚Pending‘ suggestion is one that is awaiting action from the library. A ‚Checked‘ suggestion is one that has been marked as ‚Checked‘ using the form before the suggestions. An ‚Ordered‘ suggestion is on that has been ordered using the ‚From a purchase suggestion‘ link in your basket. A ‚Rejected‘ suggestion is one that you have marked at ‚Rejected‘ using the form below the list of suggestions.

Für Bibliotheken, die eine grosse Menge von Anschaffungsvorschlägen zu verwalten haben, stehen am linken Rand der Seite Filter zur Verfügung, die helfen, die Anzahl der auf der Seite angezeigten Titel einzugrenzen.


Wenn Sie auf die blauen Überschriften klicken, öffnen sich die Filteroptionen. Wenn Sie auf ‚[löschen]‘ klicken, werden alle Filter geleert und alle Anschaffungsvorschläge angezeigt.


Auf der Seite mit den Anschaffungsvorschlägen wird automatisch auf die Anschaffungsvorschläge für Ihre Bibliothek eingeschränkt. Um auch die Anschaffungsvorschläge anderer Bibliotheken zu sehen, können Sie den Filter unter ‚Erwerbungsinformationen‘ aufheben oder ändern.


Beim Bearbeiten von ‚zu bearbeitenden‘ Vorschlägen können Sie Titel über die Checkbox neben den einzelnen Vorschlägen markieren und dann den neuen Status auswählen und eine Begründung erfassen. Sie können auf diese Weise auch Anschaffungsvorschläge vollständig löschen, indem Sie ‚Markierte löschen‘ verwenden.


Eine zusätzliche Möglichkeit der Bearbeitung von Anschaffungsvorschlägen ist, diese nacheinander über den verlinkten Titel aufzurufen und den Status und weitere Informationen einzutragen.


Clicking ‚edit‘ to the right of the suggested title or at the to pof the suggestion detail page will open a suggestion editing page.


In diesem Formular können Sie den Anschaffungsvorschlag bearbeiten (mehr Details hinzufügen oder die Eingaben des Benutzers korrigieren). Sie können den Vorschlag hier auch akzeptieren oder ablehnen.

  • Wenn Sie einen Vorschlag als ‚Zu bearbeiten‘ markieren, wird dieser wieder im Reiter ‚Zu bearbeiten‘ angezeigt.

Reasons for accepting and rejecting suggestions are defined by the SUGGEST authorized value.


Wenn Sie als Ihre Begründung ‚Andere…‘ wählen, können Sie einen freien Text in das Eingabefeld eingeben. Wählen Sie abbrechen rechts neben der Box um wieder die normierte Liste mit Texten zu erhalten.


You can also assign this suggestion to a fund.


This edit can trigger a notice (defined in the Notices & Slips tool with the TO_PROCESS notice) to the fund owner that there is a suggestion ready for them to manage if you have turned on the cron job to generate these notices.

Once you have clicked ‚Submit‘ the suggestion will be moved to the matching tab. The status will also be updated on the patron’s account in the OPAC and an email notice will be sent to the patron using the template that matches the status you have chosen.


Placing Orders

To place an order you must first search for the vendor or bookseller you want to send the order to.


If you are planning on using EDIFACT to submit your order you will need to first set up your library’s EDI accounts and EANs.

Create a basket


If you’re using EDI for ordering you will want to download your order record from your vendor before starting the process in Koha.

To create a basket you must first search for the vendor you’re ordering from:


And click the ‚New basket‘ button to the right of the vendor name.


You can also add to an existing basket by clicking the ‚Add to basket‘ link to the far right of each basket’s information in the results table.

After clicking ‚New basket‘ you will be asked to enter some information about the order:


  • Wenn Sie einen Korb einrichten, sollten Sie ihm einen sprechenden Namen geben der bei der späteren Identifizierung hilft.

  • Rechnungsselle und Lieferort angeben (Voreinstellung ist die Login-Bibliothek)

  • Falls Sie den Lieferanten wechseln möchten verwenden Sie die entsprechende Auswahlliste.

  • Die Notizfelder sind optional und können beliebige Informationen enthalten

  • If you’re ordering standing items (items which arrive regularly) then you will want to check the ‚Orders are standing‘ box for this basket

If you have added contracts to the vendor you’re ordering from, you will also have an option to choose which contract you’re ordering these items under.


When finished, click ‚Save‘


Nachdem Sie den Bestellkopf angelegt haben werden Ihnen verschiedene Optionen für das Anlegen von Bestellposten angeboten.

  • Wenn Sie ein zusätzliches Exemplar zu einem Titel nachbestellen möchten, können Sie den Datensatz einfach im System suchen.


    • In der Trefferliste können Sie ‚Bestellen‘ auswählen, um zum Bestellformular zu gelangen


      • Alle zum Exemplar gehörenden Angaben werden unter ‚Katalogdetails‘ angezeigt.

  • If you allow patrons to make purchase suggestions (learn more in the Managing Suggestions section of this manual), then you can place orders from those suggestions. In order to keep track of suggestions that have been ordered and received you must place the order using this link.


    • From the results, click ‚Order‘ next to the item you want to order and you will be presented with the order form including a link to the suggestion


      • In diesem Formular können Sie wenn nötig Änderungen an den Katalogdaten vornehmen.

      • Die Bestellposition im Korb enthält einen Link zum entsprechenden Vorschlag.


    • Orders added to the basket in this way will notify the patron via email that their suggestion has been ordered and will update the patron’s ‚My purchase suggestions‘ page in the OPAC.

  • If you’re using the Serials module you can link your subscription order information to acquisitions by choosing to order ‚From a subscription‘

    • Nachdem der Bestell-Link angeklickt wurde, wird eine Seite mit Suchoptionen angezeigt, über die nach dem Abonnement gesucht werden kann.


    • Die Ergebnisse erscheinen auf der rechten Seite des Formulars, und jedes Abonnement hat einen ‚Bestellen‘-Link auf der rechten Seite


    • Wenn sie auf ‚Bestellen‘ klicken, erscheint die Information zum Abonnement im Bestellformular ohne die Auswahl ‚Exemplar hinzufügen‘, da Sie nur ein Abonnement bestellen und ein Exemplar nicht notwendig ist


  • Um ein neues Buch zu bestellen, klicken Sie auf ‚Bestellung aus Neuaufnahme‘.


    • Es wird ein leeres Formular angezeigt, wo Sie alle notwendigen Details bezüglich des zu bestellendenTitels eingeben können.


      If the default form does not have catalog details fields necessary to place an order, enable the UseACQFrameworkForBiblioRecords preference which will allow the ACQ MARC framework to customize the display of fields when ordering.

  • If you want to search other libraries for an item to purchase, you can use the ‚From an external source‘ option that will allow you to order from a MARC record found via a Z39.50 search.


    • Bei den Resultaten klicken Sie auf den Bestell-Link neben dem Medium, das Sie erwerben möchten.


    • If the item you’re ordering from an external source looks like it might be a duplicate, Koha will warn you and give you options on how to proceed.


      • Bei der Warnung können Sie wählen, ob Sie einfach eine weitere Kopie des existierenden bibliographischen Datensatzes bestellen, einen neuen Satz erstellen oder die Bestellung dieses Titels löschen wollen.

    • Im sich öffnenden Formular können Sie die Titeldaten bearbeiten.


  • The next option for ordering is to order from a staged record (learn more about staging records).


    This is the option you will choose if you have an order file from your vendor.

Order from a staged file


  • Verwenden Sie ‚Bestellungen hinzufügen‘ um Datensätze aus der Datei der Bestellung hinzuzufügen.


  • Next to each title is a checkbox, check the items you would like to order, or choose ‚Check all‘ at the top. Depending on your settings in the MarcFieldsToOrder preference Koha will populate the next screen with with the relevant Quantity, Price, Fund, Statistic 1, and Statistic 2 found within the staged file.


  • Auf dem Reiter ‚Exemplarinformationen‘ können Sie Exemplarangaben machen, die dann für die Generierung aller bestellten Exemplare verwendet werden - zum Beispiel den Medientyp, die Sammlung und den ‚Nicht ausleihbar‘-Status.


  • If no information is imported in the fund information from the MARC with the MarcFieldsToOrder preference, the ‚Default accounting details‘ tab can be used to apply values related to the accounting.


  • The final option for ordering is to order from a list of titles with the highest hold ratios

    • Diese Option bringt Sie zum Report über Vormerkraten, über den Titel mit vielen Vormerkungen ermittelt und Exemplare nachbestellt werden können. Neben jedem Titel wird hierzu ein Link mit der empfohlenen Anzahl an nachzubestellenden Exemplaren angezeigt über den eine Bestellung erzeugt werden kann.


With any of the above ordering options you’re presented with an option to notify patrons of the new item when it’s received. The contents of that notification can be edited in the Notices & Slips tool and will have the code of ACQ_NOTIF_ON_RECEIV. In the ‚Patrons‘ section you will see an option to ‚Add user‘. Click that button to add patrons who will be notified of the new issue.

Patron notification search

  • Suchen Sie im nun angezeigten Fenster die Benutzer, die Sie benachrichtigen möchten, und wählen Sie diese aus.

  • Sobald Sie fertig sind, können Sie das Fenster schließen und die Liste der Benutzer wird im Abschnitt ‚Benutzer‘ angezeigt


After bringing in the bib information (for all import methods except for the staged file), if your AcqCreateItem system preference is set to add an item when ordering you will enter the item info next. You need to fill out at least one item record and then click the ‚Add‘ button at the bottom left of the item form.


After clicking the ‚Add item‘ button below the item record the item will appear above the form and then you can enter your next item the same way (if ordering more than one item).


Nach Eingabe der Informationen zum Titel müssen die Buchungsdetails zur Bestellung erfasst werden.


  • Anzal enthält die Zahl der Exemplare, die Sie bei der obigen Bestellung eingetragen haben.

    • Wichtig

      You cannot edit the quantity manually, you must click ‚Add‘ below the item form to add as many items as you’re ordering.

  • The list of funds is populated by the funds you have assigned in the Acquisitions Administration area.

  • The currency pull down will have the currencies you set up in the Acquisitions Administration area.

  • Der Lieferantenpreis ist der Preis vor Steuern und vor Abzug von Rabatten.

  • If the price is uncertain, check the uncertain price box.

    • Eine Bestellung mit einem unsicheren Preis kann nicht geschlossen werden.

  • If you are charged sales tax, choose that from the gstrate field

  • Geben Sie den Rabatt für diese Lieferung ein. Nach der Eingabe betätigen Sie die Tabulator-Taste und Koha wird die darunter liegenden Kostenfelder automatisch einfüllen.

  • If you added Planning Values when creating the Fund, those values will appear in the two Planning Value fields.

Once you have filled in all of the fields click ‚Save‘ to add the item to your basket. If your price goes over the amount available in the fund you will be presented with a confirmation.


The confirmation warning will allow you order past your fund amount if you so choose.

After an item is added to the basket you will be presented with a basket summary.


If you would like to see more details you can check the ‚Show all details‘ checkbox


Von hier aus können Sie Exemplare bearbeiten oder entfernen, die sie hinzugefügt haben.

  • ‚Bestellung löschen‘ entfernt die Bestellposition, aber lässt den zugehörigen Titelsatz im Katalog.

  • Choosing to ‚Delete order and catalog record‘ removes both the order line and the record in the catalog.

    • Ein Titelsatz kann unter Umständen nicht gelöscht werden. Wenn dies der Fall ist, erscheint ein Hinweis mit dem Grund.


In der Zusammenfassung haben Sie außerdem die Möglichkeit, die Information, die Sie zum Korb eingegeben haben, durch Klicken des ‚Bestellposten bearbeiten‘-Knopfes zu ändern, den Korb durch Klicken des ‚Bestellung stornieren‘-Knopfes vollständig zu löschen oder durch Klicken des ‚Bestellung als CSV exportieren‘-Knopfes als CSV-Datei zu exportieren.


If you’re using EDI for your order you can click the ‚Create EDIFACT order‘ button when you’re done to send the file to the vendor and close the basket.


Wenn Sie alle Bestellposten angelegt haben und die Bestellung vollständig ist können Sie die ‚Bestellung schließen‘. Dies bedeutet das die Bestellung abgeschlossen ist und an den Lieferanten versandt wurde.


You must close the basket to be able to receive items when they arrive. Only items in closed baskets will show as ready to receive.

If you have your BasketConfirmations preference set to show a confirmation, you will be asked if you are sure about closing the basket.


When closing the basket you can choose to add the basket to a group for easy printing and retrieval. If you check the box to ‚Attach this basket to a new basket group‘ you will be brought to the group list where you can print a PDF of the order.



A basket with at least one item marked as ‚uncertain price‘ will not be able to be closed.


Clicking the ‚Uncertain Prices‘ button will call up a list of items with uncertain prices to quick editing. From that list, you can quickly edit the items by entering new prices and quantities.



Wichtig: Die Seite Unsichere Preise ist unabhängig von einzelnen Bestellungen. Sie zeigt alle unsicheren Preise für einen einzelnen Lieferanten.

Once your order is entered you can search for it through acquisitions or view the information on the biblio detail page in the staff client (if the AcquisitionDetails preference is set to ‚Display).


Bestellgruppe anlegen

A basket group is simply a group of baskets. In some libraries, you have several staff members that create baskets, and, at the end of a period of time, someone then groups them together to send to the vendor in bulk. That said, it is possible to have one basket in a basket group if that’s the workflow used in your library.

Printing baskets

When you are finished adding items to your basket, click ‚Close this Basket.‘


You will be asked if you want to ‚Attach this basket to a new basket group with the same name‘. A basket group is necessary if you want to be able to print PDFs of your orders.


Ihre komplette Bestellung wird in der Bestellübersicht zum Ausdruck oder für weitere Änderungen angezeigt.


If you closed the basket before generating the EDIFACT order you can do so from the basket grouping page.

Basket Grouping EDIFACT

Clicking the ‚Print‘ button next to your order will generate a PDF for printing, which will have all of your library information followed by the items in your order.




You must close the basket to be able to receive items when they arrive. Only items in closed baskets will show as ready to receive.

Orders can be received from the vendor information page


or the vendor search results page


Klicken Sie auf den Link ‚Lieferung empfangen‘. Nun können Sie die Rechnungsnummer und weitere Informationen zur Lieferung eingeben.


Beim Zugang werden alle Exemplare angezeigt, die noch beim Lieferanten bestellt sind, unabhängig von der Zuordnung zu einer einzelnen Bestellung.


Um ein bestimmtes Exemplar in Empfang zu nehmen klicken Sie auf ‚Zugang‘ rechts neben dem Exemplar.


In diesem Fenster können Sie die Kosten bearbeiten. Sie können auch nur einen Teil der Bestellpositionen mit den entsprechenden Checkboxen als geliefert markieren, falls es sich um eine Teillieferung handelt. Die Werte in den Feldern ‚Ersatzkosten‘ und ‚Istkosten‘ belegen beim Speichern den Titelsatz in Unterfeld v (Kosten, Ersatzkosten) und Unterfeld g (Kosten, normaler Einkaufspreis).


Sie können die einzelnen Bestellpositionen mit den entsprechenden Links bearbeiten. Sie können so die zugehörigen Signaturen oder Barcodes eingeben, falls Sie dies zum Zeitpunkt der Entgegennahme tun möchten. Nachdem Sie die notwendigen Änderungen an der Bestellung oder den Bestellpositionen vorgenommen haben, klicken Sie auf ‚Speichern‘, um die Exemplare als ‚erhalten‘ zu markieren.


If you have your AcqItemSetSubfieldsWhenReceived preference set to add or change values on received items those changes will take place after you hit ‚Save‘.


If the item is no longer available from this vendor you can transfer the order to another vendor’s basket by clicking the ‚Transfer‘ link to the right of the title. This will pop up a vendor search box.


From the results you can click ‚Choose‘ to the right of the vendor you would like to reorder this item from.


You will then be presented with the open baskets for that vendor to choose from. To move the item simply click ‚Choose‘ to the right of the basket you would like to add the item to.


Once you have chosen you will be presented with a confirmation message.


Wenn Sie den Empfang der Bestellungen abgeschlossen haben, können sie auf eine andere Seite navigieren oder im unteren Seitenbereich auf die Schaltfläche ‚Lieferung abschließen‘ klicken.

If the item cannot be found anywhere you can cancel the order by clicking ‚Delete order‘ to the far right. This will prompt you to enter your reason and confirm cancellation.


In der Anzeige des Korbes sehen Sie auch ob ein Exemplar gliefert oder storniert wurde.



Bei der Entgegennahme von Bestellungen werden die Informationen zur Rechnung erfasst. Rechnungen können über den entsprechenden Reiter im linken Bereich der Seite ‚Erwerbung‘ gesucht werden.


Die Suchresultate werden im Bereich rechts neben den Suchoptionen angezeigt.


In der Resultatliste können Sie auf den Link ‚Details‘ klicken um die Rechnung anzuzeigen oder auf ‚Schließen‘ um festzuhalten, dass die Rechnung abgeschlossen bzw. bezahlt ist.


If you’re allowing the uploading of acquisitions files with the AcqEnableFiles preference you will see the option to manage invoice files next to the link to ‚Go to receipt page‘


To see or attach new files click the ‚Manage invoice files‘ link


From here you can find a file to upload and/or see the files you have already attached.


From the invoice search results you can also merge together two invoices should you need to. Simply click the checkbox to the left of the invoices you would like to merge and click the ‚Merge selected invoices‘ button at the bottom of the page. You will be presented with a confirmation screen:


Click on the row of the invoice number you would like to keep and it will be highlighted in yellow. Enter any different billing information in the fields provided and click ‚Merge‘. The two invoices will become one.

Claims & Late Orders

If you have entered in an email address for the vendors in your system you can send them claim emails when an order is late. Before you can send claims you will need to set up an acquisitions claim notice.

Upon clicking on the link to ‚Late Orders‘ from the Acquisitions page you will be presented with a series of filter options on the left hand side. These filters will be applied only closed baskets.



Die Auswahlliste der Lieferanten zeigt nur solche mit Verspätung auf abgeschlossenen Bestellungen.

Once you filter your orders to show you the things you consider to be late you will be presented with a list of these items.


To the right of each late title you will be see a checkbox. Check off the ones you want a claim letter sent to and click ‚Claim Order‘ at the bottom right of the list. This will automatically send an email to the vendor at the email address you have on file.


Das voraussichtliche Lieferdatum wird aus der bei den Lieferanteninformationen eingegebenen üblichen Lieferzeit errechnet.

If you would rather use a different acquisition claim letter (other than the default) you can create that in the notices module and choose it from the menu above the list of late items.


Acquisition Searches

Im oberen Bereich der verschiedenen Erwerbungsseiten befindet sich ein Suchfeld, in dem Sie entweder eine Lieferanten- oder eine Bestellungssuche durchführen können.


In der Lieferantensuche können Sie auch mit Teilen des Lieferantennamens suchen.


Mit ‚Bestellung suchen‘ können Sie nach bestellten Titeln mit oder ohne Angabe des Lieferanten suchen.


Sie können Angaben in einem oder beiden Feldern machen und einen beliebigen Teil des Titels oder Lieferantennamens eingeben.


Wenn Sie auf das Pluszeichen neben der Lieferantensuche klicken, werden weitere Suchoptionen verfügbar


Wenn Sie auf ‚Erweiterte Suche‘ auf der rechten Seite neben der Schaltfläche ‚Suche‘ klicken, bekommen Sie alle verfügbaren Suchoptionen angezeigt.


Budget/Fund Tracking

On the main acquisitions page there will be a table showing you all of your active funds and a breakdown of what has been ordered or spent against them.


Clicking on the linked amounts under spent or ordered will show you a summary of the titles ordered/received on that budget.


EDI Process

Previous sections explain all ordering options, this section pulls out the parts related to EDI or EDIFACT ordering to help those who are only using EDI for ordering.


Koha uses the EDIFACT standard not the X12 standard for electronic ordering.

EDI Questions for Vendors

You will want to gather the following information from your vendors before beginning the set up process in Koha.

EDI Accounts: This is the basic connection information for your vendor. This will be used to fill in the :ref:`EDI Accounts` section.

  • Vendor: The name of the vendor

  • Description: A short description if additional explanation is needed ( especially if you have multiple accounts for one vendor ).

  • Transport: Does the vendor transmit EDI files via FTP, SFTP, or something else the requires special processing?

  • Remote host: The URL or IP address of the FTP/SFTP server

  • Username: The username for the above server

  • Password: The password for the above server

  • Download directory: The path on the server that contains files for Koha to download and process

  • Upload directory: The path on the server that Koha will upload files to for your vendor to process

  • Qualifier: Who assigned the SAN below?

    • Choose one of the following:

      1. EAN International

      (31B) US SAN Agency

      1. Assigned by supplier

      2. Assigned by buyer

  • SAN: The identifier for the vendor

    Buyer qualifier and SAN are optional. Some vendors require a second buyer identifier in addition to the account EAN.

  • Buyer qualifier: Who assigned the SAN below?

    • Choose one of the following:

      1. EAN International

      (31B) US SAN Agency

      1. Assigned by supplier

      2. Assigned by buyer

  • Buyer SAN: The identifier for the library

  • Quotes enabled: [y/n] Does this vendor support sending and receiving quotes via EDIfact and do you want to send and receive quotes via EDIfact?

  • Orders enabled: [y/n] Does this vendor support sending and receiving orders via EDIfact and do you want to send and receive orders via EDIfact?

  • Invoices enabled:[y/n] Does this vendor support sending and receiving invoices via EDIfact and do you want to send and receive invoices via EDIfact?

  • Order file suffix: The file suffix for order files

  • Quote file suffix: The file suffix for quote files

  • Invoice file suffix: The file suffix for invoice files

  • Account number(s): (list them all)

  • Account description(s): (the summary of what this number is for)

EANs: Each library using EDIfact needs to specify a buyer identifier know as a SAN or EAN. This will fill in the :ref:`Library EANs <library-eans-label>` setting.

  • Library

  • EAN

    • Choose one of the following:

      1. EAN International

      (31B) US SAN Agency

      1. Assigned by supplier

      2. Assigned by buyer

MARC Order Fields or Grid Ordering: These values will fill in the :ref:`MarcFieldsToOrder` preference.

  • price: MARC21 field that contains the item price

  • quantity: MARC21 field that contains the number of items for the given record

  • budget_code: MARC21 field that contains the Koha budget code to be debited

  • discount: MARC21 field the contains the discount as a percentage the the price will be discounted by

  • sort2: MARC21 field that will populate custom field sort1

  • sort2: MARC21 field that will populate custom field sort2

EDI Setup

Before you begin ordering using EDI you will want to take the following steps:

EDI Ordering

The first step in ordering using EDI happens on the book vendor’s website. Each seller will use different language, but you will need to place your order on their site and then download the MARC order file. Some language that you might see included „basket“, „order“, „cart“, and/or „MARC order.“ Once you have this MARC file downloaded to your computer you will want to log in to Koha and continue the process there.

Visit the Stage MARC Records for Import tool and upload your file. Once presented with the confirmation screen proceed to Acquisitions.

In Acquisitions create a basket for the vendor you ordered from. From the basket, choose to order from a staged file and click ‚Order‘ next to the file you downloaded from your vendor and staged in Koha.

From the confirmation screen you will see all of the data in the MARC file related to your order. If you are not seeing fields such as fund and quantity filled in then be sure to confirm that your MarcFieldsToOrder preference is set right.

Once you have added all of the items to the basket you can click the ‚Create EDIFACT order‘ button.


This will generate a pending file in the EDIFACT Messages in Koha. The pending files will be processed by the EDI Cron Job and sent to your vendor.

EDI Invoicing

When the book vendor is done processing your files they will send an invoice via EDI as well. The EDI Cron Job will grab invoices and mark items found in the invoice as received and update your funds without any need for manual intervention.

EDIFACT Messages

Eine Liste aller gesendeten und empfangenen Benachrichtigungen kann unter „Edifact-Benachrichtigungen“ eingesehen werden.