SAP tableObjectVBEHModuleSD_O2C

VBEH table — Schedule Line History for Sales Documents

VBEH holds the history of schedule line changes for sales documents, mainly scheduling agreements, preserving the superseded date and quantity values each time a schedule line in VBEP is overwritten by a new forecast or JIT delivery schedule. It exists so cumulative quantities and delivery performance can be reconstructed after the current schedule line has already been updated.

This page covers what a VBEH row actually represents, the keys it shares with VBAK, VBAP and VBEP, and how to prove from the data that a schedule line was changed rather than newly created. The pitfalls section focuses on the mistake of treating VBEH as a general-purpose change log rather than a narrow scheduling-agreement history table.

Reviewed by an ERPClimb SAP consultant on 15 Sept 2026· 944 words

What it stores

One row in VBEH represents a historical snapshot of a schedule line that existed before it was updated by a later delivery schedule transmission or manual change, primarily in the context of scheduling agreements used in repetitive manufacturing and JIT/EDI delivery scenarios. When a customer sends a new forecast or JIT delivery schedule, the incoming data overwrites the current schedule line in VBEP; VBEH is where the prior date and quantity for that schedule line are kept so the system, and the consultant, can reconstruct what the schedule looked like before the overwrite. It is not a log of every sales document change. Standard sales orders processed without scheduling agreement functionality typically do not generate entries here. The table matters almost exclusively in automotive and high-frequency EDI supply scenarios where cumulative quantities and delivery performance against a rolling schedule are tracked.

Key fields

  • MANDT - client, always the first restriction in any selection
  • VBELN - sales document number, shared with VBAK, VBAP and VBEP, identifies the scheduling agreement
  • POSNR - item number within the sales document, joins to VBAP and VBEP
  • ETENR - schedule line number within the item, joins to VBEP; identifies which specific schedule line the history row belongs to
  • Remaining fields carry the superseded schedule line date and quantity plus change metadata; exact field names beyond the keys above are not asserted here and should be confirmed against the current data dictionary before being used in a query or program

How it joins the data model

  • VBEH-VBELN = VBAK-VBELN
  • VBEH-VBELN = VBAP-VBELN and VBEH-POSNR = VBAP-POSNR
  • VBEH-VBELN = VBEP-VBELN, VBEH-POSNR = VBEP-POSNR, VBEH-ETENR = VBEP-ETENR
  • VBEH-VBELN = VBFA-VBELV where a scheduling agreement item has been referenced downstream into deliveries

How to read it safely

Always restrict by MANDT first, then by VBELN, since the table has no meaningful index for broad, document-less scans. In practice a consultant almost never queries VBEH cold; the entry point is a specific scheduling agreement and item found through VA33 or a JIT monitor, and VBEH is checked afterward to see what a given schedule line used to say. Because the table only fills for scheduling agreement processing with active history recording, a query against a random sales order number will usually return nothing, and that emptiness is expected rather than a sign of a data problem. Volume can be significant for customers with frequent EDI transmissions, so date or change-related restrictions, where available, should be applied rather than pulling the full history for a long-running scheduling agreement.

How to prove it in the data

Symptom: a planner reports that a JIT/forecast delivery schedule quantity for a scheduling agreement item looks different from what was communicated last week. Selection: read VBEP for the current VBELN, POSNR, ETENR to get today's date and quantity, then read VBEH for the same VBELN, POSNR, ETENR to retrieve the prior values recorded before the last inbound schedule update overwrote them. The comparison confirms whether the change came from a genuine new customer transmission or from a manual change inside the sales document.

ECC vs S/4HANA

VBEH continues to exist as a standard table in S/4HANA for scheduling agreement and JIT delivery schedule processing; no confirmed compatibility view replacement is asserted here. The functional behaviour around scheduling agreements and their history tracking has not been observed to change in a way that removes VBEH's role, but any specific release-level statement about restructuring should be verified against the system in question rather than assumed from this page.

Common pitfalls

  • Treating VBEH like CDHDR/CDPOS: it is not a generic change document table, it only captures schedule line history for scheduling agreement processing, so an unrelated sales order field change will never show up here
  • Assuming an empty VBEH result for a document means nothing was ever changed; it more often means the document is a standard order type that never wrote history rows in the first place
  • Confusing VBEH's historical quantity with the currently valid cumulative quantity; the current figure lives in VBEP and the related scheduling agreement cumulative quantity fields, not in VBEH
  • Trying to reconstruct a full timeline of every schedule change purely from VBEH without also checking VBFA and delivery documents, since goods movement against a schedule line can affect cumulative quantities independently of a schedule update
  • Selecting on ETENR alone across documents, which produces meaningless cross-document matches since schedule line numbers restart within each item

Whose problem this is

This is an SD order-to-cash question, specifically the scheduling agreement or automotive JIT consultant, since VBEH only becomes relevant in that narrow process. Where volume growth or archiving of scheduling agreement history is the concern, basis or data management joins the conversation, but the interpretation of what a given history row means stays with the SD functional owner.

Related SAP objects

Reviewed pages this object connects to in the ERPClimb knowledge graph.

Source: ERPClimb — https://erpclimb.com/sap-tables/vbehERPClimb is an independent platform and is not affiliated with SAP SE. Reference pages are written and reviewed by SAP consultants for learning and troubleshooting.