Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Purpose:  This page describes data value crosswalks and data element mapping for the migration of Invoice data from Aleph to Alma.  This migration guide and video from ExLibris provide instructions to complete a migration form prior to the automated migration of Aleph data to Alma.  The decisions we need to make about invoice data migration are outlined on this page.

...

The Aleph Invoice type maps to the Payment Method in Alma.  The following section defines the steps needed to decide how we want to crosswalk the Aleph Invoice Type values to Alma Payment methods.

Next Steps

1. Review the list of Alma Payment Methods below to become familiar with them.

...

According to this Aleph to Alma migration guide, the Aleph Invoice Payment Status maps to the Alma Payment Status.  This table lists the record counts in Aleph for each payment status.  From the documentation, "If you generally did not include the payment status of the invoice in Aleph, it is highly recommended that you update the relevant payment statuses for all invoices before migration. Invoices with a payment status other than Paid migrate to Alma with InReview status. Having large amounts of invoices with this status makes it difficult to manage the workflow of invoices in Alma.

Next steps

Ask ExLibris if we can create a crosswalk for our Invoice Status values since we generally use the custom Duke "C" value rather than P. If not, investigate the best method to edit the non-P records.

...

This table describes the Alma target field for each Invoice field in Aleph. Note: Much of this content was copied from Harvard's data mapping guides, last updated in 2018. Please consider this page a draft until the Duke team verifies that this mapping information is current and concurs with Duke's migration decisions.  For reference, Aleph invoice screenshots are included below.


Aleph FieldAlma FieldAdditional Information
Aleph General Invoice
Line items (count)doesn't migrate to Alma
Total Amount Gen. InvoiceTotal Amount
Total Amount Line ItemsTotal invoice lines amount
Vendor CodeVendor Code
Invoice NumberInvoice Number
Net Amountdoesn't migrate to Alma
Shipment AmountShipment
Overhead Amountdoesn't migrate to AlmaThere is data in this field: 16,492 contain a value greater than zero; 198,865 records contain 0. (7/26/23)
Insurance Amountdoesn't migrate to Alma

98 records contain a value greater than zero (7/26/23)

Discount Amountdoesn't migrate to Alma7510 records contain a value greater than zero (7/26/23)
Total AmountTotal amount

VAT is included in the total invoice amount. 

Total Amount incl. VAT

Local Amount

Refers to InvoiceInvoice Reference #
TypeNotes?, Payment method - see crosswalk aboveDo we want to map the Aleph value to Notes for reference?  This value also sets the Payment Method in Alma.  See crosswalk above.
StatusStatus


CurrencyIncluded in Total invoice lines amount 
Explicit Ratiodoesn't migrate to Alma
DebitTotal invoice lines amount does not include a minus sign.
CreditTotal invoice lines amount includes a minus sign. 
Invoice DateInvoice Date
Received Datedoesn't migrate to Alma
Shipment Datedoesn't migrate to Alma
VAT Recipient

Not used in Aleph - all records null in 77_VAT_RECEIVER as of 7/26/23

VAT details are mapped to Alma invoice and invoice lines notes (Z77_VAT_CODE, Z77_VAT_AMOUNT, 77_VAT_RECEIVER, Z75_VAT_CODE).
VAT Percentn/a
VAT AmountVAT details are mapped to Alma invoice and invoice lines notes
VAT per Line Itemn/a
Add VAT to Amountn/a
NoteNotes Tab
Payment DatePayment Date
Check NumberPayment Identifier
AmountPayment Amount
StatusPayment StatusValues in Alma are 
  • In Review: The invoice was created but not yet reviewed
  • In Approval:- The invoice is waiting for manual approval
  • Ready to be Paid: The invoice was approved and is ready to be sent to the ERP
  • Waiting for Payment: The invoice was approved and sent to the ERP (or skipped the ERP if the institution does not use one)
  • Closed: The invoice is paid and closed
Approval Dep.

Approval NumberNotes Tab
Aleph Line Item Form
Vendor CodeVendor 
Invoice NumberIn banner at top of screen
Net AmountPrice
Estimated Pricen/a
Added Amountn/a
CurrencyIncluded in Amount
Total AmountTotal Price
Object CodeReporting Code
Total, Incl. VATn/a
VAT Percentn/a
Local Amountn/a
VAT Amountn/a
Number of UnitsQuantity
DebitInvoice line amount does not include a minus sign.  No - in Total invoice lines amount 
CreditInvoice line amount does not include a minus sign.
NoteNote
Aleph Invoice Line Items columns
Seq.Line #
Order No.PO Line #
Net Amt.Price
Total Amt.Total Price
Note:Note
BudgetFunds
Object CodeReporting Code
Local Amt.Allocated Fund Transaction - Amount
Units in OrdAvailable in invoice line view
Units in InvAvailable in invoice line view

...