Purpose

This guide helps clarify which SAP fields to use when mapping your data. Where field selection is ambiguous, we highlight this and recommend appropriate SAP fields. This mapping is a suggestion and it might not work for some SAP implementations.

Note: Each section includes context on potential challenges you may encounter during mapping.

Mapping for Components Import

This section proposes a mapping structure for importing components from SAP to Luminovo. Fields in bold are mandatory in Luminovo. For further details, consult our API documentation.

Data Structure Field	SAP Tag (Field Name)	Notes
`category`	`WGBEZ` (Material Group Description)	SAP categorization field for grouping materials.
`component.data.parts[].manufacturer`	`EMNFR` (Manufacturer)	SAP’s manufacturer field in material master.
`component.data.parts[].mpn`	`IDNLF` (Supplier Material Number)	Tracks manufacturer part numbers.
`component.type`	`KZKFG` (Configuration Control Flag)	SAP supports standard (“OffTheShelf”) vs. custom materials using this indicator.
`CPN`	`KUNNR` (Customer Number)	For customer-specific part numbers; SAP uses `KUNNR` for customer identification.
`description`	`MAKTX` (Material Description)	Standard SAP material description field.
`internal_part_number.revision`	(Custom field or `notes`)	SAP typically lacks a distinct revision field; consider adding in `notes`.
`internal_part_number.value`	`MATNR` (Material Number)	Core SAP material identifier.

Alternative Tags

Field	Primary SAP Tag	Alternative SAP Tags / Notes
`component.data.parts[].mpn`	`IDNLF`	Some customers create custom fields like `ZZ_MPN` for flexibility.
`description`	`MAKTX`	Extended descriptions are sometimes maintained in `MLTX` for BOM text.
`CPN`	`KUNNR`	SAP users sometimes create custom fields like `ZZ_CPN` to isolate customer-specific part numbers.
`internal_part_number.revision`	(Custom field or `notes`)	SAP may manage revisions through the `ECN` (Engineering Change Number) process for strict control.

Mapping for Inventories Import

This section outlines the mapping structure for importing inventory data from SAP to Luminovo.

Data Structure Field	SAP Tag (Field Name)	Notes
`availability.available_stock`	`LABST` (Available Stock)	Standard SAP field for available inventory.
`availability.lead_time`	`PLIFZ` (Planned Delivery Time)	Standard SAP lead time field in material master.
`availability.on_order`	`EISBE` (Scheduled Receipts)	Tracks stock that’s on order but not yet received.
`availability.total_stock`	`INSKZ` (Total Stock Indicator)	Indicates total stock, including available and reserved.
`customer.name`	`KUNNR` (Customer Number)	Standard SAP field for customer identification.
`customer.number`	`KUNNR` (Customer Number)	Same as above; SAP uses numeric identifiers for customers.
`import_context`	(Custom field or `notes`)	SAP doesn't have a direct tag; consider adding to `notes`.
`notes`	`TEXT` (Long Text / Notes)	Standard SAP text field for comments and additional details.
`one_time_costs.description`	(Custom field or `notes`)	SAP doesn’t have a dedicated description field for costs.
`one_time_costs.price.amount`	`NETPR` (Net Price)	Standard SAP field for pricing details.
`one_time_costs.price.currency`	`WAERS` (Currency)	Standard SAP field for currency.
`packaging`	`VERP` (Packaging Material)	Packaging type for material management.
`part.internal_part_number.value`	`MATNR` (Material Number)	Core SAP material identifier.
`prices[].moq`	`BSTMI` (Minimum Order Quantity)	SAP’s MOQ field in purchasing details.
`prices[].mpq`	`BSTMA` (Maximum Lot Size)	SAP's maximum lot size field.
`prices[].unit_price.amount`	`NETPR` (Net Price)	Same as one-time costs; SAP tracks per-unit pricing here.
`prices[].unit_price.currency`	`WAERS` (Currency)	Tracks currency for unit prices.
`supplier.stock_location`	`LGORT` (Storage Location)	SAP's field for stock location in inventory management.
`supplier.supplier`	`LIFNR` (Supplier)	Identifies the vendor or supplier.
`supplier.supplier_number`	`LIFNR` (Supplier Number)	Same as above; SAP uses numeric identifiers for suppliers.
`supplier.supplier_part_number`	`IDNLF` (Supplier Material Number)	Tracks supplier-specific part numbers.
`supplier.type` = `"Internal"`	(Custom field or `notes`)	SAP doesn’t have a direct “Internal” flag; may need to be tracked as text.
`unit_of_measurement.quantity`	`MENGE` (Quantity)	Standard SAP field for quantity.
`unit_of_measurement.unit`	`MEINS` (Base Unit of Measure)	Standard SAP unit of measure field.
`valid_until`	`VERPR` (Valid-To Date)	Can be stored in SAP’s validity period for pricing records or inventory entries.

Alternative Tags

Field	Primary SAP Tag	Alternative SAP Tags / Notes
`availability.available_stock`	`LABST`	Some companies track this via `SALK3` for multi-plant inventory.
`availability.lead_time`	`PLIFZ`	SAP sometimes tracks vendor-specific lead time using `EINE-PLIFZ`.
`availability.on_order`	`EISBE`	Some setups may extend this using custom fields like `ZZ_ONORD`.
`supplier.supplier`	`LIFNR`	Some organizations maintain alternate supplier references in `LFA1-LIFNR_ALT`.
`unit_of_measurement.unit`	`MEINS`	Some customers use `ZMEIN` for non-standard units like "reels" or "packs."

Mapping for Assembly Import

This section details the mapping structure required to import assembly data from SAP to Luminovo.

Data Structure Field	SAP Tag (Field Name)	Notes
`bom_items[].designators`	(Custom field or `notes`)	SAP doesn’t have a direct tag; may be added as text.
`bom_items[].do_not_place`	(Custom field or `notes`)	No direct SAP equivalent; can be tracked in `notes`.
`bom_items[].notes`	(Custom field or `notes`)	SAP notes can hold additional information.
`bom_items[].part_options[].internal_part_number`	`MATNR` (Material Number)	Standard SAP field for material identification.
`bom_items[].quantity`	`MINBM`, `BSTMI`, or `BSTMA`	Use depending on business rules (minimum or max quantity).
`bom_items[].sourced_by`	LIFNR (Vendor)	Identifies the supplier for sourcing.
`bom_items[].unit`	MEINS (Base Unit of Measure)	Standard SAP field for unit of measure.
`CPN[].customer`	KUNNR (Customer Number)	For customer-specific information.
`CPN[].revision`	(Custom field or `notes`)	Can be added as a comment or extra field if needed.
`CPN[].value`	IDNLF (Supplier Material Number)	Maps to supplier material number.
`industry`	(Custom field or `notes`)	SAP may require an industry-specific field extension.
`internal_part_number.revision`	(Custom field or `notes`)	SAP typically doesn’t have a distinct revision field; consider adding in `notes`.
`internal_part_number.value`	`MATNR` (Material Number)	Core SAP material identifier.
`name`	MAKTX (Material Description)	Describes the material in SAP.
`subassemblies[].internal_part_number`	`MATNR` (Material Number)	Standard SAP field for subassemblies.
`subassemblies[].quantity`	BOM Component Quantity (`MENGE`)	Represents quantity within the assembly structure.
`type`	(Custom field or `notes`)	Can be added to `notes` or configured as a custom field.

Alternative Tags

Field	Primary SAP Tag	Alternative SAP Tags / Notes
`internal_part_number.value`	`MATNR`	Some companies use `ZEINR` (Custom Part Number) or classification values (via `CL02`).
`notes`	`TEXT` or `LTXA1`	Long text entries may also go into `STXL`/`STXB` tables for BOM documentation.
`part_options[].mpn`	`IDNLF`	Some companies define custom fields like `ZZ_MPN` for enhanced traceability.
`quantity`	`MENGE` or `BSTMI`	Some customers use `EKPO-MENGE` in purchasing for better tracking.
`approved_inventory_sites`	`LGORT` (Storage Location)	For multi-site inventory, companies may extend `WERKS` (Plant) data.
`type`	(Custom field or `notes`)	Some SAP setups define `ZTYPE` or classify materials via `CL02` (Class System).