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.

...

Z77_P_STATUS Payment statusDescriptionCount(10/3/23)
CPaid and sent to R/3216029
YPayment authorization given311
PPaid4
NNot ready to be paid89
RReady to be paid3
null
194


10/3/23: Per Chana at EL, they determine that the invoice is closed by the following mapping:.  I've included counts to list how many records in Aleph as of 10/3/23 match that criteria.

Next Step

Review the table below to determine whether any data cleanup is needed or if we're OK with invoices moving to Alma with the status values listed in the blue section of the table.

If Aleph invoice contains these values...

Migrate invoice to Alma as...

Z77_P_STATUS Payment status

Z77_I_DATE Invoice date

Z77_P_DATE Payment DateOther/notesCount of invoices matching this criteria in Aleph (10/3/23)

Alma Payment Status

Entry point in Alma

'P' Paid


4PAIDCLOSED
null!= 0  (an invoice date value exists)!= 0 (a payment date value exists)
0PAID CLOSED
Any other custom values taken from tab48.lng (At Duke we use 'C' - Paid and sent to R/3)
!= 0 (a payment date value exists)
215451PAIDCLOSED
Any other custom values taken from tab48.lng (At Duke we use 'C' - Paid and sent to R/3)

= 0 (a payment date value doesn't exist)


578PENDINGNEW
null= 0 (an invoice date value doesn't exist)
Incomplete invoice header194Won't migrate to Alma
null!= 0 (an invoice date value exists)= 0 (a payment date value doesn't exist)
0PENDINGNEW
'N' Not ready to be paid


89PENDINGNEW
'R' Ready to be paid

Z77-APPROVAL_DEPARTMENT is null0PENDING WAITING_APPROVAL
'R' Ready to be paid

Z77-APPROVALDEPARTMENT is not null3PENDINGWAITING_SEND
'Y'  Payment notification sent


311PENDINGWAITING_PAYMENT


...

Data Mapping

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

...