Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    Alma
    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Alma
    3. Product Documentation
    4. Alma Online Help (English)
    5. Integrations with External Systems
    6. Resource Management
    7. Setting Up New Order Integration Profile

    Setting Up New Order Integration Profile

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. Creating a New Order API Integration Profile
      1. Step 1
      2. Step 2
    Translatable

    This profile synchronizes records from a vendor’s database to PO lines.

    This profile works with any vendor that uses the new order API, and is also used if the order is created using the API by a REST client. For more information, see the following in the Developer Network:

    • For Institutions: Setting up a real-time acquisitions workflow with participating vendors

    • Using multiple New Order API integration profiles

    • How the bibliographic record is determined 

    For information on other profiles, see Configuring Integration Profiles.

    Creating a New Order API Integration Profile

    To create an integration profile, navigate to Configuration > General > Integration Profiles and fill in the information for steps 1 and 2 as described below.

    Step 1

    Fill in the information in the following fields and then select Next to go to step 2.

    Step 1 of the integration profile.

    Step 1 of the Integration Profile
    Integration Profile Step 1 
    Field Description
    Use network zone For Collaborative Networks, the Use network zone checkbox appears. For more information, see Managing Import Profiles.
    Code  The code of the profile. This field is mandatory.
    Name The name of the profile. This field is mandatory.
    Integration Type Select New Order API. This field is mandatory.
    System The system that Alma integrates with. This field is mandatory.
    Default Mark this checkbox to set this profile as the default. 
    Note that when no profile is configured for a specific vendor, the default is used.
    Description A description of the integration profile. 

    Step 2

    Fill in the information in the following fields and then select Save to create the integration profile.

    Step 2 of the integration profile.

    Step 2 of the integration profile
    Integration Profile Step 2
    Field Description
    NORMALIZATION
    Correct the data using

    During metadata import, the MARC 21 Bib Initial Normalization and MARC 21 BIB normalize on save tasks are applied to the loaded data to correct the imported records, in addition to the normalization option selected here (Note that this does not apply to Authority and Initial Authority import profile types). You can see details of the MARC 21 Bib Initial Normalization process at Resources > Cataloging > Metadata Configuration; select MARC 21 Bibliographic; select the Normalization Processes tab; select MARC 21 Bib Initial Normalization.

    When records are imported, the normalization processes identified here are applied/processed before matching and merging/overlaying occur.

    Select Add BIB to Collection in this dropdown list to configure Alma to automatically assign imported digital titles to a collection according to the value of the 787 field of the MARC record. For more information, see Preparing the XML Metadata File.

    If fixed position fields (such as the MARC 21 LDR/008 and CNMARC LDR/100) are missing from the source content when CSV or Excel files are selected for the Physical source format in your import profile, these fixed position fields are created from the normalization process that you select here. If no normalization processes was selected and the fixed position fields are missing, the default template is used when the enable_import_computer_generated customer parameter is set to true. (see enable_import_computer_generated for more information).

    A normalization will run after the crosswalk. In addition, the MARC 21 Bib Initial Normalization  will apply to metadata import even if disabled. If you don't want any specific initial normalization drool, you will need to delete that drool. 

    VALIDATION
    Handle invalid data using Select how to handle invalid data as it is imported. For more information, see Working with Validation Exception Profiles.

    Ex Libris recommends using the MarcXML Bib Import validation exception profile.
     
    MATCH
    Serial match method The method used to match serial data. For a detailed description and examples of some of these methods, see Match Methods – Explanations and Examples.
    Non Serial match method The method used to match non-serial data. For a detailed description and examples of some of these methods, see Match Methods – Explanations and Examples.
    Upon no match Indicate whether to import the records for which a matching record was not found in Alma:
    • Import - Select to import the records to local institution. 
    • Add to Network Zone - (Network Zone only)
    The default varies by import profile type.
    Prefer record with the same inventory type (electronic/physical) Give preference to a matching bibliographic record that contains the same type of inventory as the records that you are importing.

    This option is also supported when implementing a Network Zone and for real-time ordering (see Real-Time Ordering), if configured in the profile.

    When preference is given to the inventory type, the best match is determined as follows during the import:

    Alma determines the source record's inventory type using the Inventory Operations field (see Creating/Editing an Import Profile: Inventory Information):

    • None - No preference based on inventory.
    • Physical - The preference is based on physical inventory.
    • Electronic - The preference is based on electronic inventory.
    • Mixed - The inventory type (electronic or physical) is determined for each bibliographic record according to the mapping of the Resource type field. 
      The input file should include P for physical and E for electronic in the field that is defined as Resource type.
      For example, if the Resource type field is 888 $d, each record in the input file should include:
      • <datafield tag="888" ind2=" " ind1=" "> <subfield code="d">P</subfield> </datafield>
      • OR <datafield tag="888" ind2=" " ind1=" "><subfield code="d">E</subfield></datafield>

    Alma determines the inventory type for each matching record as follows:

    • If the matching record includes both physical and electronic inventory, the inventory is considered to be mixed.
    • If the matching record includes only physical or electronic inventory, the inventory of the matched record is considered to be of that type of inventory.
    • If only one of the matching records contains the same inventory type as the source (electronic or physical records), it will be considered a match. If there are multiple matching records that contain the same inventory type as the source, no preference will be based on inventory type.
    • If only one of the matching records contains mixed inventory, and there are no matching records that contain only electronic or physical records, the mixed record will be considered a match. Otherwise, no preference will be based on inventory type.
    MANAGEMENT TAGS
    Synchronize with External Catalog?

    The following options are available for synchronizing with the External Catalog:

    • Publish bibliographic records
    • Publish holdings only
    • Don’t publish
    VALIDATION OF ORDER INFORMATION
    Do not create order in case of:
    • Order is not fully funded 
    • Invalid fund code 
    • Fund balance insufficient to cover encumbrance 
    View article in the Exlibris Knowledge Center
    1. Back to top
      • Upload Electronic Holdings from Preselect
      • Upload Electronic Holdings from Oxford University Press
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Content Type
      Documentation
      Language
      English
      Product
      Alma
    2. Tags
      This page has no tags.
    1. © Copyright 2026 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved