---
title: "Table 8057 Subscription Header"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/table/8057-subscription-header/
type: table
id: 8057
name: "Subscription Header"
app: "Subscription Billing"
namespace: Microsoft.SubscriptionBilling
versions: "26-29"
build: 29.0.54011.55644
countries: "W1, DE, US"
source: "https://jonas-paprotka.de/ref/table/8057-subscription-header/source/?v=28 https://jonas-paprotka.de/ref/table/8057-subscription-header/source/"
checked: 2026-11-20
changed: 2026-10-05
subject: "Microsoft Dynamics 365 Business Central"
license: "Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/"
---

# Table 8057 Subscription Header

JOP-AL, https://jonas-paprotka.de/ref/table/8057-subscription-header/

| | |
| --- | --- |
| App | Subscription Billing |
| Namespace | Microsoft.SubscriptionBilling |
| Versions | 26-29 |
| Minors | W1 26.0-29.0; DE 26.0-29.0; US 26.0-29.0, [every minor](https://jonas-paprotka.de/ref/table/8057-subscription-header/editions.json) |
| Source file | Service Objects/Tables/SubscriptionHeader.Table.al |

## Fields

| Id | Name | Type | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- |
| 2 | End-User Customer No. | Code[20] | 26-29 | - | - |
| 3 | No. | Code[20] | 26-29 | - | - |
| 4 | Bill-to Customer No. | Code[20] | 26-29 | - | - |
| 5 | Bill-to Name | Text[100] | 26-29 | - | - |
| 6 | Bill-to Name 2 | Text[50] | 26-29 | - | - |
| 7 | Bill-to Address | Text[100] | 26-29 | - | - |
| 8 | Bill-to Address 2 | Text[50] | 26-29 | - | - |
| 9 | Bill-to City | Text[30] | 26-29 | - | - |
| 10 | Bill-to Contact | Text[100] | 26-29 | - | - |
| 12 | Ship-to Code | Code[10] | 26-29 | - | - |
| 13 | Ship-to Name | Text[100] | 26-29 | - | - |
| 14 | Ship-to Name 2 | Text[50] | 26-29 | - | - |
| 15 | Ship-to Address | Text[100] | 26-29 | - | - |
| 16 | Ship-to Address 2 | Text[50] | 26-29 | - | - |
| 17 | Ship-to City | Text[30] | 26-29 | - | - |
| 18 | Ship-to Contact | Text[100] | 26-29 | - | - |
| 20 | Item No. | Code[20] | 26-29 | Pending 26.0 | Replaced by field Source No. |
| 21 | Description | Text[100] | 26-29 | - | - |
| 23 | Serial No. | Code[50] | 26-29 | - | - |
| 24 | Version | Text[100] | 26-29 | - | - |
| 25 | Key | Text[100] | 26-29 | - | - |
| 26 | Provision Start Date | Date | 26-29 | - | - |
| 27 | Provision End Date | Date | 26-29 | - | - |
| 28 | Quantity | Decimal | 26-29 | - | - |
| 34 | Customer Price Group | Code[10] | 26-29 | - | - |
| 50 | Type | Enum Service Object Type | 26-29 | - | - |
| 51 | Source No. | Code[20] | 26-29 | - | - |
| 52 | Created in Contract line | Boolean | 26-29 | - | - |
| 79 | End-User Customer Name | Text[100] | 26-29 | - | - |
| 80 | End-User Customer Name 2 | Text[50] | 26-29 | - | - |
| 81 | End-User Address | Text[100] | 26-29 | - | - |
| 82 | End-User Address 2 | Text[50] | 26-29 | - | - |
| 83 | End-User City | Text[30] | 26-29 | - | - |
| 84 | End-User Contact | Text[100] | 26-29 | - | - |
| 85 | Bill-to Post Code | Code[20] | 26-29 | - | - |
| 86 | Bill-to County | Text[30] | 26-29 | - | - |
| 87 | Bill-to Country/Region Code | Code[10] | 26-29 | - | - |
| 88 | End-User Post Code | Code[20] | 26-29 | - | - |
| 89 | End-User County | Text[30] | 26-29 | - | - |
| 90 | End-User Country/Region Code | Code[10] | 26-29 | - | - |
| 91 | Ship-to Post Code | Code[20] | 26-29 | - | - |
| 92 | Ship-to County | Text[30] | 26-29 | - | - |
| 93 | Ship-to Country/Region Code | Code[10] | 26-29 | - | - |
| 94 | Customer Reference | Text[35] | 26-29 | - | - |
| 95 | Archived Sub. Lines exist | Boolean | 26-29 | - | - |
| 96 | Variant Code | Code[10] | 26-29 | - | - |
| 107 | No. Series | Code[20] | 26-29 | - | - |
| 171 | End-User Phone No. | Text[30] | 26-29 | - | - |
| 172 | End-User E-Mail | Text[80] | 26-29 | - | - |
| 173 | End-User Fax No. | Text[30] | 26-29 | - | - |
| 200 | Planned Sub. Lines exist | Boolean | 26-29 | - | - |
| 5052 | End-User Contact No. | Code[20] | 26-29 | - | - |
| 5053 | Bill-to Contact No. | Code[20] | 26-29 | - | - |
| 5425 | Unit of Measure | Code[10] | 26-29 | - | - |
| 8000 | Vendor No. | Code[20] | 28-29 | - | - |
| 8001 | Vendor Name | Text[100] | 28-29 | - | - |
| 8002 | Vendor Name 2 | Text[50] | 28-29 | - | - |
| 8003 | Vendor Item No. | Text[50] | 28-29 | - | - |
| 8010 | Manufacturer Code | Code[10] | 28-29 | - | - |
| 8011 | Manufacturer Name | Text[50] | 28-29 | - | - |
| 8020 | Salesperson Code | Code[20] | 28-29 | - | - |
| 8021 | Sales Order No. | Code[20] | 28-29 | - | - |
| 8022 | Item Ledger Entry No. | Integer | 28-29 | - | - |
| 8023 | Last Sales Invoice No. | Code[20] | 28-29 | - | - |

## Keys

| Name | Fields | Sum fields | Versions |
| --- | --- | --- | --- |
| PK, clustered | No. | - | 26-29 |
| SK1 | Item Ledger Entry No. | - | 28-29 |

## Procedures

| Name | Parameters | Returns | Access | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- | --- |
| DeleteServiceObjectFromContract | () | - | internal | 26-29 | - | - |
| InitForSourceNo | (ContractLineType: Enum "Contract Line Type"; SourceNo: Code[20]) | - | internal | 26-29 | - | - |
| UpdateCustomerDataFromCustomerContract | (CustomerContract: Record "Customer Subscription Contract") | - | internal | 26-29 | - | - |
| SetHideValidationDialog | (NewHideValidationDialog: Boolean) | - | public | 26-29 | - | - |
| AssistEdit | (OldServiceObject: Record "Subscription Header") | Boolean | internal | 26-29 | - | - |
| CopyEndUserAddressToShipToAddress | () | - | internal | 26-29 | - | - |
| CopyEndUserAddressToBillToAddress | () | - | internal | 26-29 | - | - |
| RecallModifyAddressNotification | (NotificationID: Guid) | - | internal | 26-29 | - | - |
| GetModifyBillToCustomerAddressNotificationId | () | Guid | internal | 26-29 | - | - |
| DontNotifyCurrentUserAgain | (NotificationID: Guid) | - | internal | 26-29 | - | - |
| LookupEndUserCustomerName | () | Boolean | internal | 26-29 | - | - |
| CalculateShipToBillToOptions | (var ShipToOptions: Option "Default (End-User Address)","Alternate Shipping Address","Custom Address"; var BillToOptions: Option "Default (Customer)","Another Customer","Custom Address"; ServiceObject: Record "Subscription Header") | - | internal | 26-29 | - | - |
| InsertServiceCommitmentsFromStandardServCommPackages | () | - | public | 26-29 | - | - |
| InsertServiceCommitmentsFromStandardServCommPackages | (ServiceAndCalculationStartDate: Date) | - | public | 26-29 | - | - |
| InsertServiceCommitmentsFromServCommPackage | (ServiceAndCalculationStartDate: Date; var ServiceCommitmentPackage: Record "Subscription Package") | - | public | 26-29 | - | - |
| InsertServiceCommitmentsFromServCommPackage | (ServiceAndCalculationStartDate: Date; ServiceEndDate: Date; var ServiceCommitmentPackage: Record "Subscription Package"; UsageBasedBillingPackageLinesOnly: Boolean) | - | public | 26-29 | - | - |
| OpenServiceObjectCard | (ServiceObjectNo: Code[20]) | - | internal | 26-29 | - | - |
| UpdateServicesDates | () | - | internal | 26-29 | - | - |
| UpdateAmountsOnServiceCommitmentsBasedOnExchangeRates | () | - | internal | 26-29 | - | - |
| GetCurrencyCodeFromCustomerServiceCommitment | () | Code[10] | internal | 26-29 | - | - |
| FilterServiceCommitmentsWithoutContract | (var ServiceCommitment: Record "Subscription Line") | - | internal | 26-29 | - | - |
| FilterOnItemNo | (ItemNo: Code[20]) | - | internal | 26-29 | - | - |
| InsertFromItemNoAndCustomerContract | (var ServiceObject: Record "Subscription Header"; ItemNo: Code[20]; SourceQuantity: Decimal; ProvisionStartDate: Date; CustomerContract: Record "Customer Subscription Contract") | - | internal | 26-27 | - | - |
| SetUnitPriceAndUnitCostFromExtendContract | (NewUnitPrice: Decimal; NewUnitCost: Decimal) | - | internal | 26-29 | - | - |
| ResetCalledFromExtendContract | () | - | internal | 26-29 | - | - |
| ArchiveServiceCommitments | () | - | internal | 26-29 | - | - |
| GetSerialNoDescription | () | Text | internal | 26-29 | - | - |
| SkipInsertServiceCommitmentsFromStandardServCommPackages | (Skip: Boolean) | - | internal | 26-29 | - | - |
| GetContractLineTypeFromServiceObject | () | Enum Contract Line Type | internal | 26-29 | - | - |
| GetSalesLineType | () | Enum Sales Line Type | internal | 26-29 | - | - |
| GetPurchaseLineType | () | Enum Purchase Line Type | internal | 26-29 | - | - |
| IsItem | () | Boolean | internal | 26-29 | - | - |
| SetPrimaryAttributeValueAndCaption | (var PrimaryAttributeValue: Text[250]; var PrimaryAttributeValueCaption: Text) | - | internal | 26-29 | - | - |
| GetPrimaryAttributeValue | () | Text[250] | internal | 26-29 | - | - |
| InsertFromItemNoAndCustomerContract | (var ServiceObject: Record "Subscription Header"; ItemNo: Code[20]; VariantCode: Code[10]; SourceQuantity: Decimal; ProvisionStartDate: Date; CustomerContract: Record "Customer Subscription Contract") | - | public | 28-29 | - | - |
| UpdateVendorAndManufacturerFromItem | (Item: Record Item) | - | internal | 28-29 | - | - |

## Events

| Kind | Name | Parameters | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- |
| Integration event | OnAfterIsShipToAddressEqualToEndUserAddress | (EndUserSubscriptionHeader: Record "Subscription Header"; ShipToSubscriptionHeader: Record "Subscription Header"; var Result: Boolean) | 26-29 | - | - |
| Integration event | OnAfterGetCustomerSubscriptionContractSetup | (SubscriptionHeader: Record "Subscription Header"; var SubscriptionContractSetup: Record "Subscription Contract Setup"; CalledByFieldNo: Integer) | 26-29 | - | - |
| Integration event | OnAfterSetFieldsBilltoCustomer | (var SubscriptionHeader: Record "Subscription Header"; Customer: Record Customer) | 26-29 | - | - |
| Integration event | OnAfterCopyEndUserAddressToBillToAddress | (var SubscriptionHeader: Record "Subscription Header") | 26-29 | - | - |
| Integration event | OnAfterCopyEndUserCustomerAddressFieldsFromCustomer | (var SubscriptionHeader: Record "Subscription Header"; EndUserCustomer: Record Customer; CurrentFieldNo: Integer) | 26-29 | - | - |
| Integration event | OnAfterCopyShipToCustomerAddressFieldsFromCustomer | (var SubscriptionHeader: Record "Subscription Header"; EndUserCustomer: Record Customer) | 26-29 | - | - |
| Integration event | OnAfterCopyShipToCustomerAddressFieldsFromShipToAddr | (var SubscriptionHeader: Record "Subscription Header"; ShipToAddress: Record "Ship-to Address") | 26-29 | - | - |
| Integration event | OnAfterCopyEndUserAddressToShipToAddress | (var SubscriptionHeader: Record "Subscription Header") | 26-29 | - | - |
| Integration event | OnBeforeAssistEdit | (var SubscriptionHeader: Record "Subscription Header"; OldSubscriptionHeader: Record "Subscription Header"; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeConfirmBillToContactNoChange | (var SubscriptionHeader: Record "Subscription Header"; xSubscriptionHeader: Record "Subscription Header"; CurrentFieldNo: Integer; var Confirmed: Boolean; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeConfirmEndUserContactNoChange | (var SubscriptionHeader: Record "Subscription Header"; xSubscriptionHeader: Record "Subscription Header"; CurrentFieldNo: Integer; var Confirmed: Boolean; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeCopyShipToCustomerAddressFieldsFromCustomer | (var SubscriptionHeader: Record "Subscription Header"; Customer: Record Customer; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeCopyShipToCustomerAddressFieldsFromShipToAddr | (var SubscriptionHeader: Record "Subscription Header"; ShipToAddress: Record "Ship-to Address"; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeInitInsert | (var SubscriptionHeader: Record "Subscription Header"; xSubscriptionHeader: Record "Subscription Header"; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeLookupBillToPostCode | (var SubscriptionHeader: Record "Subscription Header"; var PostCodeRec: Record "Post Code") | 26-29 | - | - |
| Integration event | OnBeforeLookupEndUserPostCode | (var SubscriptionHeader: Record "Subscription Header"; var PostCodeRec: Record "Post Code") | 26-29 | - | - |
| Integration event | OnBeforeLookupShipToPostCode | (var SubscriptionHeader: Record "Subscription Header"; var PostCodeRec: Record "Post Code") | 26-29 | - | - |
| Integration event | OnBeforeValidateBillToPostCode | (var SubscriptionHeader: Record "Subscription Header"; var PostCodeRec: Record "Post Code") | 26-29 | - | - |
| Integration event | OnBeforeValidateEndUserPostCode | (var SubscriptionHeader: Record "Subscription Header"; var PostCodeRec: Record "Post Code") | 26-29 | - | - |
| Integration event | OnBeforeValidateShipToPostCode | (var SubscriptionHeader: Record "Subscription Header"; var PostCodeRec: Record "Post Code") | 26-29 | - | - |
| Integration event | OnBeforeUpdateEndUserCust | (var SubscriptionHeader: Record "Subscription Header"; var Contact: Record Contact; var Customer: Record Customer; ContactNo: Code[20]) | 26-29 | - | - |
| Integration event | OnInitFromContactOnAfterInitNoSeries | (var SubscriptionHeader: Record "Subscription Header"; var xSubscriptionHeader: Record "Subscription Header") | 26-29 | - | - |
| Integration event | OnValidateEndUserCustomerNoAfterInit | (var SubscriptionHeader: Record "Subscription Header"; var xSubscriptionHeader: Record "Subscription Header") | 26-29 | - | - |
| Integration event | OnAfterUpdateBillToCont | (var SubscriptionHeader: Record "Subscription Header"; Customer: Record Customer; Contact: Record Contact) | 26-29 | - | - |
| Integration event | OnAfterUpdateBillToCust | (var SubscriptionHeader: Record "Subscription Header"; Contact: Record Contact) | 26-29 | - | - |
| Integration event | OnAfterUpdateEndUserCont | (var SubscriptionHeader: Record "Subscription Header"; Customer: Record Customer; Contact: Record Contact) | 26-29 | - | - |
| Integration event | OnAfterUpdateEndUserCust | (var SubscriptionHeader: Record "Subscription Header"; Contact: Record Contact) | 26-29 | - | - |
| Integration event | OnBeforeValidateBillToCustomerName | (var SubscriptionHeader: Record "Subscription Header"; var Customer: Record Customer) | 26-29 | - | - |
| Integration event | OnBeforeValidateEndUserCustomerName | (var SubscriptionHeader: Record "Subscription Header"; var Customer: Record Customer) | 26-29 | - | - |
| Integration event | OnUpdateEndUserCustOnBeforeContactIsNotRelatedToAnyCustomerErr | (var SubscriptionHeader: Record "Subscription Header"; Contact: Record Contact; var ContactBusinessRelation: Record "Contact Business Relation"; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnUpdateBillToCustOnBeforeContactIsNotRelatedToAnyCustomerErr | (var SubscriptionHeader: Record "Subscription Header"; Contact: Record Contact; var ContactBusinessRelation: Record "Contact Business Relation"; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnUpdateBillToCustOnBeforeFindContactBusinessRelation | (Contact: Record Contact; var ContBusinessRelation: Record "Contact Business Relation"; var ContactBusinessRelationFound: Boolean; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnUpdateEndUserCustOnBeforeFindContactBusinessRelation | (Cont: Record Contact; var ContBusinessRelation: Record "Contact Business Relation"; var ContactBusinessRelationFound: Boolean; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnValidateBillToCustomerNoOnAfterConfirmed | (var SubscriptionHeader: Record "Subscription Header") | 26-29 | - | - |
| Integration event | OnBeforeUpdateBillToCust | (var SubscriptionHeader: Record "Subscription Header"; ContactNo: Code[20]; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnBeforeCheckContactRelatedToCustomerCompany | (SubscriptionHeader: Record "Subscription Header"; CurrFieldNo: Integer; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnAfterCalculateShipToBillToOptions | (var ShipToOptions: Option "Default (End-User Address)","Alternate Shipping Address","Custom Address"; var BillToOptions: Option "Default (Customer)","Another Customer","Custom Address"; SubscriptionHeader: Record "Subscription Header") | 26-29 | - | - |
| Integration event | OnBeforeRecalculateLines | (var SubscriptionHeader: Record "Subscription Header"; xSubscriptionHeader: Record "Subscription Header"; ChangedFieldName: Text; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnRecalculateLinesOnBeforeConfirm | (var SubscriptionHeader: Record "Subscription Header"; xSubscriptionHeader: Record "Subscription Header"; ChangedFieldName: Text; HideValidationDialog: Boolean; var Confirmed: Boolean; var IsHandled: Boolean) | 26-29 | - | - |
| Integration event | OnAfterDatesCalculatedOnInsertSubscriptionLinesFromSubscriptionPackage | (var SubscriptionLine: Record "Subscription Line"; SubscriptionPackageLine: Record "Subscription Package Line") | 26-29 | - | - |
| Integration event | OnBeforeInsertSubscriptionLineFromSubscriptionPackageLine | (var SubscriptionLine: Record "Subscription Line"; SubscriptionPackageLine: Record "Subscription Package Line") | 26-29 | - | - |
| Integration event | OnAfterInsertSubscriptionLineFromSubscriptionPackage | (var SubscriptionLine: Record "Subscription Line"; SubscriptionPackage: Record "Subscription Package"; SubscriptionPackageLine: Record "Subscription Package Line") | 26-29 | - | - |
| Integration event | OnAfterInsertFromItemNoAndCustomerContract | (var SubscriptionHeader: Record "Subscription Header"; CustomerSubscriptionContract: Record "Customer Subscription Contract") | 26-29 | - | - |

## Trigger events

| Name | Parameters | ElementName | Docs |
| --- | --- | --- | --- |
| OnBeforeInsertEvent | (var Rec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onbeforeinsertevent-table-trigger/ |
| OnAfterInsertEvent | (var Rec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onafterinsertevent-table-trigger/ |
| OnBeforeModifyEvent | (var Rec: Record "Subscription Header"; var xRec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onbeforemodifyevent-table-trigger/ |
| OnAfterModifyEvent | (var Rec: Record "Subscription Header"; var xRec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onaftermodifyevent-table-trigger/ |
| OnBeforeDeleteEvent | (var Rec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onbeforedeleteevent-table-trigger/ |
| OnAfterDeleteEvent | (var Rec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onafterdeleteevent-table-trigger/ |
| OnBeforeRenameEvent | (var Rec: Record "Subscription Header"; var xRec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onbeforerenameevent-table-trigger/ |
| OnAfterRenameEvent | (var Rec: Record "Subscription Header"; var xRec: Record "Subscription Header"; RunTrigger: Boolean) | '' | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onafterrenameevent-table-trigger/ |
| OnBeforeValidateEvent | (var Rec: Record "Subscription Header"; var xRec: Record "Subscription Header"; CurrFieldNo: Integer) | per field, ElementName: field name | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onbeforevalidateevent-table-trigger/ |
| OnAfterValidateEvent | (var Rec: Record "Subscription Header"; var xRec: Record "Subscription Header"; CurrFieldNo: Integer) | per field, ElementName: field name | https://jonas-paprotka.de/docs/dev-itpro/developer/triggers-auto/events/table/devenv-onaftervalidateevent-table-trigger/ |

## Source

Symbols: Microsoft.SubscriptionBilling.symbols.3099ffc7-4cf7-4df6-9b96-7e4bc2bb587c, https://dynamicssmb2.pkgs.visualstudio.com/DynamicsBCPublicFeeds/_packaging/MSSymbols/nuget/v3/index.json, highest build per major on 2026-11-20.
AL source 28: https://github.com/microsoft/BCApps, MIT, releases/28.x at 408a4cc8d3a4c54b60464cc14c964479facb9ba0.
AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at 4303e5e584d3aa5d9e98cbc615525a5396ad6ed7.

JOP-AL, 2026-11-20.
