Ready to Learn?Ex Libris products all provide open APIs

Cancellations

 Alma supports sending cancellation requests of orders to vendors via EDI. In Alma, EDI is defined as one of the possible channels of communication with the vendors (in addition to emails). If a vendor is defined as an EDI vendor that supports cancellation requests (that is, the "Cancellation" check box is selected in the EDI Information tab), Alma attempts to send the cancellations via EDI. The message structure in EDI is as follows:
 

see EDIfact standard for cancellations.

 

Message Segments

  1. UNH (header):

UNH+{sender's unique message reference number)+OSTENQ:D:96A:UN:EAN008’

  • Sender's unique message reference number - By convention, incorporates a sequence number of the message within the interchange.
  • ORDCHG– cancellation
  • D – message type version number
  • 96A = message type release number - EDIFACT Directory D.96A
  • UN = controlling agency
  • EAN008 = association-assigned code - EAN version number

 

  1. BGM (Beginning of Message):

BGM+230+{sender's unique message reference number}+4'

  • sender's unique message reference number - same as in UNH

 

  1. DTM (Date Time Message):

DTM+137:{message date}:102'

  • message date - in CCYYMMDD format

 

  1. NAD (Name and Address): 

NAD+BY+{buyer identification}::9'
NAD+SU+{supplier identification}::9'

  • Identification - For BY, it is the Alma library. For SU it is the vendor code.

 

  1. LIN  (line number):

LIN+{cancellation line number}'

  • line number – Alma creates a separate message for each calcellation, hence only one line item will appear in a cancellation message.

 

  1. IMD (item description):

IMD+L+{bibliographic information code}+::{bibliographic information}.'Alma populates the following bibliographic information (if exists):

  • 009 – contributor
  • 050 – title
  • 109 – publisher

 

  1. RFF (referance):

    RFF+LI:{order number}’

  • order number - the Alma PO line number

 

  1. FTX (free text):

    FTX+LI:{free text}’

  • free text - related to the specific line

 

Cancellation sample: