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.
...
Page Contents
| Table of Contents |
|---|
...
Alma Invoice Structure
Alma invoices are comprised of invoice_details (mandatory) and invoice_lines (not mandatory). The migration of Aleph invoices creates:
- One Alma Invoice for each Aleph invoice header (Z77): Aleph invoice headers without attached invoice line item should not be migrated
- One Alma Invoice Line for each Aleph invoice line item (Z75) matching an invoice header (Z77).
- Invoice migration ensures the total invoice amounts are correct, not necessarily the net breakdowns.
- VAT is included in the total invoice amount. VAT details are mapped to Alma invoice and invoice lines notes (Z77_VAT_CODE, Z77_VAT_AMOUNT, 77_VAT_RECEIVER, Z75_VAT_CODE, and Z75_VAT_AMOUNT).
Page Contents
...
...
Crosswalks: Aleph code values to Alma code values
...
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 Field | Alma Field | Additional Information |
| Aleph General Invoice | ||
| Line items (count) | doesn't migrate to Alma | |
| Total Amount Gen. Invoice | Total Amount | |
| Total Amount Line Items | Total invoice lines amount | |
| Vendor Code | Vendor Code | |
| Invoice Number | Invoice Number | |
| Net Amount | doesn't migrate to Alma | |
| Shipment Amount | Shipment | |
| Overhead Amount | doesn't migrate to Alma | There is data in this field: 16,492 contain a value greater than zero; 198,865 records contain 0. (7/26/23) |
| Insurance Amount | doesn't migrate to Alma | 98 records contain a value greater than zero (7/26/23) |
| Discount Amount | doesn't migrate to Alma | 7510 records contain a value greater than zero (7/26/23) |
| Total Amount | Total amount | VAT is included in the total invoice amount. |
| Total Amount incl. VAT | ||
| Local Amount | ||
| Refers to Invoice | Invoice Reference # | |
| Type | Notes?, Payment method - see crosswalk above | Do we want to map the Aleph value to Notes for reference? This value also sets the Payment Method in Alma. See crosswalk above. |
| Status | Status | |
| Currency | Included in Total invoice lines amount | |
| Explicit Ratio | doesn't migrate to Alma | |
| Debit | Total invoice lines amount does not include a minus sign. | |
| Credit | Total invoice lines amount includes a minus sign. | |
| Invoice Date | Invoice Date | |
| Received Date | doesn't migrate to Alma | |
| Shipment Date | doesn'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 Percent | n/a | |
| VAT Amount | VAT details are mapped to Alma invoice and invoice lines notes | |
| VAT per Line Item | n/a | |
| Add VAT to Amount | n/a | |
| Note | Notes Tab | |
| Payment Date | Payment Date | |
| Check Number | Payment Identifier | |
| Amount | Payment Amount | |
| Status | Payment Status | Values in Alma are
|
| Approval Dep. | ||
| Approval Number | Notes Tab | |
| Aleph Line Item Form | ||
| Vendor Code | Vendor | |
| Invoice Number | In banner at top of screen | |
| Net Amount | Price | |
| Estimated Price | n/a | |
| Added Amount | n/a | |
| Currency | Included in Amount | |
| Total Amount | Total Price | |
| Object Code | Reporting Code | |
| Total, Incl. VAT | n/a | |
| VAT Percent | n/a | |
| Local Amount | n/a | |
| VAT Amount | n/a | |
| Number of Units | Quantity | |
| Debit | Invoice line amount does not include a minus sign. No - in Total invoice lines amount | |
| Credit | Invoice line amount does not include a minus sign. | |
| Note | Note | |
| Aleph Invoice Line Items columns | ||
| Seq. | Line # | |
| Order No. | PO Line # | |
| Net Amt. | Price | |
| Total Amt. | Total Price | |
| Note: | Note | |
| Budget | Funds | |
| Object Code | Reporting Code | |
| Local Amt. | Allocated Fund Transaction - Amount | |
| Units in Ord | Available in invoice line view | |
| Units in Inv | Available in invoice line view | |
...