Page 6050 "Service Contract"

Base Application · Microsoft.Service.Contract · BC23-30 · source at ea08af5e · facts from BC29

Properties

Property	Value
Caption	Service Contract
SourceTable	Service Contract Header
PageType	Document

Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control’s own, else the bound field’s (marked).

Group	Control	Shows	ToolTip
General	Contract No.	Contract No.	Specifies the number of the service contract or service contract quote. from the table field
	Description	Description	Specifies a description of the service contract. from the table field
	Customer No.	Customer No.	Specifies the number of the customer who owns the service items in the service contract/contract quote. from the table field
	Contact No.	Contact No.	Specifies the number of the contact who will receive the service delivery. from the table field
Control13	Name	Name	Specifies the name of the customer in the service contract. from the table field
	Address	Address	Specifies the customer’s address. from the table field
	Address 2	Address 2	Specifies additional address information. from the table field
	City	City	Specifies the name of the city in where the customer is located. from the table field
Control24	County	County	—
Control13	Post Code	Post Code	Specifies the postal code. from the table field
	Country/Region Code	Country/Region Code	Specifies the country/region of the address. from the table field
	Contact Name	Contact Name	Specifies the name of the person you regularly contact when you do business with the customer in this service contract. from the table field
General	Phone No.	Phone No.	Specifies the customer telephone number. from the table field
	Mobile Phone No.	`SellToContact."Mobile Phone No."`	Specifies the customer’s mobile telephone number.
	E-Mail	E-Mail	Specifies the customer’s email address. from the table field
	Contract Group Code	Contract Group Code	Specifies the contract group code assigned to the service contract. from the table field
	Salesperson Code	Salesperson Code	Specifies the code of the salesperson assigned to this service contract. from the table field
	Starting Date	Starting Date	Specifies the starting date of the service contract. from the table field
	Status	Status	Specifies the status of the service contract or contract quote. from the table field
	Responsibility Center	Responsibility Center	Specifies the code of the responsibility center, such as a distribution hub, that is associated with the involved user, company, customer, or vendor. from the table field
	Change Status	Change Status	Specifies if a service contract or contract quote is locked or open for changes. from the table field
Content	ServContractLines	part Page 6052 “Service Contract Subform”	—
Invoicing	Bill-to Customer No.	Bill-to Customer No.	Specifies the number of the customer that you send or sent the invoice or credit memo to. from the table field
	Bill-to Contact No.	Bill-to Contact No.	Specifies the number of the contact person at the customer’s billing address. from the table field
Control27	Name	Bill-to Name	Specifies the name of the customer that you send or sent the invoice or credit memo to. from the table field
	Address	Bill-to Address	Specifies the address of the customer to whom you sent the invoice. from the table field
	Address 2	Bill-to Address 2	Specifies an additional line of the address. from the table field
	City	Bill-to City	Specifies the city of the address. from the table field
Control33	Bill-to County	Bill-to County	Specifies the county code of the customer’s billing address. from the table field
Control27	Post Code	Bill-to Post Code	Specifies the postal code of the customer’s billing address. from the table field
	Country/Region	Bill-to Country/Region Code	Specifies the country/region code of the customer’s billing address. from the table field
	Contact	Bill-to Contact	Specifies the name of the contact person at the customer’s billing address. from the table field
	Phone No.	`BillToContact."Phone No."`	Specifies the telephone number of the person at the customer’s billing address.
	Mobile Phone No.	`BillToContact."Mobile Phone No."`	Specifies the mobile telephone number of the person at the customer’s billing address.
	Email	`BillToContact."E-Mail"`	Specifies the email address of the person at the customer’s billing address.
Invoicing	Your Reference	Your Reference	Specifies the customer’s reference number. from the table field
	Serv. Contract Acc. Gr. Code	Serv. Contract Acc. Gr. Code	Specifies the code associated with the service contract account group. from the table field
	Shortcut Dimension 1 Code	Shortcut Dimension 1 Code	Specifies the code for Shortcut Dimension 1, which is one of two global dimension codes that you set up in the General Ledger Setup window. from the table field
	Shortcut Dimension 2 Code	Shortcut Dimension 2 Code	Specifies the code for Shortcut Dimension 2, which is one of two global dimension codes that you set up in the General Ledger Setup window. from the table field
	Payment Terms Code	Payment Terms Code	Specifies a formula that calculates the payment due date, payment discount date, and payment discount amount. from the table field
	Payment Method Code	Payment Method Code	Specifies how to make payment, such as with bank transfer, cash, or check. from the table field
	Direct Debit Mandate ID	Direct Debit Mandate ID	Specifies the direct-debit mandate that the customer has signed to allow direct-debit collection of payments. from the table field
	Currency Code	Currency Code	Specifies the currency used to calculate the amounts in the documents related to this contract. from the table field
Shipping	Ship-to Code	Ship-to Code	Specifies a code for an alternate shipment address if you want to ship to another address than the one that has been entered automatically. This field is also used in case of drop shipment. from the table field
Ship-to	Name	Ship-to Name	Specifies the name of the customer at the address that the items are shipped to. from the table field
	Name 2	Ship-to Name 2	Specifies an additional part of the name of the customer that the items are shipped to. from the table field
	Address	Ship-to Address	Specifies the address that the items are shipped to. from the table field
	Address 2	Ship-to Address 2	Specifies an additional part of the ship-to address, in case it is a long address. from the table field
	City	Ship-to City	Specifies the city of the address that the items are shipped to. from the table field
Control38	Ship-to County	Ship-to County	Specifies the county of the address. from the table field
Ship-to	Post Code	Ship-to Post Code	Specifies the postal code of the address that the items are shipped to. from the table field
	Country/Region	Ship-to Country/Region Code	Specifies the country/region code of the address. from the table field
	Phone No.	Ship-to Phone No.	Specifies the telephone number of the company’s shipping address. from the table field
Service	Service Zone Code	Service Zone Code	Specifies the code of the service zone of the customer ship-to address. from the table field
	Service Period	Service Period	Specifies a default service period for the items in the contract. from the table field
	First Service Date	First Service Date	Specifies the date of the first expected service for the service items in the contract. from the table field
	Response Time (Hours)	Response Time (Hours)	Specifies the response time for the service contract.
	Service Order Type	Service Order Type	Specifies the service order type assigned to service orders linked to this contract. from the table field
Invoice Details	Annual Amount	Annual Amount	Specifies the total amount for all service contract lines that will be invoiced annually for the service contract or contract quote, disregarding starting date and expiration date. Changes to this amount will be distributed among the service contract lines. from the table field
	Allow Unbalanced Amounts	Allow Unbalanced Amounts	Specifies if the contents of the Calcd. Annual Amount field are copied into the Annual Amount field in the service contract or contract quote. from the table field
	Calcd. Annual Amount	Calcd. Annual Amount	Specifies the sum of the Line Amount field values on all contract lines associated with the service contract or contract quote, disregarding starting date and expiration date. from the table field
	Active Annual Amount	`Rec.GetActiveAnnualAmount()`	Specifies the sum of the Line Amount field values on all contract lines associated with the service contract or contract quote, respecting the contract expiration date.
	InvoicePeriod	Invoice Period	Specifies the invoice period for the service contract. from the table field
	NextInvoiceDate	Next Invoice Date	Specifies the date of the next invoice for this service contract. from the table field
	AmountPerPeriod	Amount per Period	Specifies the amount that will be invoiced for each invoice period for the service contract. from the table field
	Next Invoice Period	`Rec.NextInvoicePeriod()`	Specifies the ending date of the next invoice period for the service contract.
	Last Invoice Date	Last Invoice Date	Specifies the date when this service contract was last invoiced. from the table field
	Prepaid	Prepaid	Specifies that this service contract is prepaid. from the table field
	Automatic Credit Memos	Automatic Credit Memos	Specifies that a credit memo is created when you remove a contract line. from the table field
	Invoice after Service	Invoice after Service	Specifies that you can only invoice the contract if you have posted a service order since last time you invoiced the contract. from the table field
	Combine Invoices	Combine Invoices	Specifies you want to combine invoices for this service contract with invoices for other service contracts with the same bill-to customer. from the table field
	Contract Lines on Invoice	Contract Lines on Invoice	Specifies that you want the lines for this contract to appear as text on the invoice. from the table field
	No. of Unposted Invoices	No. of Unposted Invoices	Specifies the number of unposted service invoices linked to the service contract. from the table field
	No. of Unposted Credit Memos	No. of Unposted Credit Memos	Specifies the number of unposted credit memos linked to the service contract. from the table field
	No. of Posted Invoices	No. of Posted Invoices	Specifies the number of posted service invoices linked to the service contract. from the table field
	No. of Posted Credit Memos	No. of Posted Credit Memos	Specifies the number of posted credit memos linked to this service contract. from the table field
Price Update	Price Update Period	Price Update Period	Specifies the price update period for this service contract. from the table field
	Next Price Update Date	Next Price Update Date	Specifies the next date you want contract prices to be updated. from the table field
	Last Price Update %	Last Price Update %	Specifies the price update percentage you used the last time you updated the contract prices. from the table field
	Last Price Update Date	Last Price Update Date	Specifies the date you last updated the contract prices. from the table field
	Print Increase Text	Print Increase Text	Specifies the standard text code printed on service invoices, informing the customer which prices have been updated since the last invoice. from the table field
	Price Inv. Increase Code	Price Inv. Increase Code	Specifies the standard text code printed on service invoices, informing the customer which prices have been updated since the last invoice. from the table field
Details	Expiration Date	Expiration Date	Specifies the date when the service contract expires, which is when the service contract is no longer valid. The date is copied to the Contract Expiration Date field for a newly added service contract line. The date in this field must not be earlier than the value in the Starting Date field.
	Cancel Reason Code	Cancel Reason Code	Specifies a reason code for canceling the service contract. from the table field
	Max. Labor Unit Price	Max. Labor Unit Price	Specifies the maximum unit price that can be set for a resource on all service orders and lines for the service contract. from the table field
FactBoxes	Documents	part Page 1178 “Doc. Attachment List Factbox”	—
	Control1902018507	part Page 9082 “Customer Statistics FactBox”	—
	Control1900316107	part Page 9084 “Customer Details FactBox”	—

Actions

Group	Action	ToolTip	Runs
Service Overview	Service Orders	Open the list of ongoing service orders.	Page 5901 “Service List”
	Posted Service Shipments	Open the list of posted service shipments.
	Posted Service Invoices	Open the list of posted service invoices.	Page 5968 “Service Document Registers”
Contract	Dimensions	View or edit dimensions, such as area, project, or department, that you can assign to sales and purchase documents to distribute costs and analyze transaction history.
	Service Discounts	View or edit the discounts that you grant for the contract on spare parts in particular service item groups, the discounts on resource hours for resources in particular resource groups, and the discounts on particular service costs.	Page 6058 “Contract/Service Discounts”
	Service Hours	View the service hours that are valid for the service contract. This window displays the starting and ending service hours for the contract for each weekday.	Page 5916 “Service Hours”
Statistics	Statistics	View statistical information, such as the value of posted entries, for the record.	Page 6059 “Contract Statistics”
	Trendscape	View a detailed account of service item transactions by time intervals.	Page 6060 “Contract Trendscape”
Contract	Filed Contracts	View service contracts that are filed.	Page 6073 “Filed Service Contract List”
	Comments	View or add comments for the record.	Page 5911 “Service Comment Sheet”
	Attachments	Add a file as an attachment. You can attach images as well as documents.
	Gain/Loss Entries	View the contract number, reason code, contract group code, responsibility center, customer number, ship-to code, customer name, and type of change, as well as the contract gain and loss. You can print all your service contract gain/loss entries.	Page 6064 “Contract Gain/Loss Entries”
History	Change Log	View all changes that have been made to the service contract.	Page 6063 “Contract Change Log”
	Warranty Ledger Entries	View all the ledger entries for the service item or service order that result from posting transactions in service documents that contain warranty agreements.	Page 5913 “Warranty Ledger Entries”
	Service Ledger Entries	View all the ledger entries for the service item or service order that result from posting transactions in service documents.	Page 5912 “Service Ledger Entries”
General	Print	Prepare to print the document. A report request window for the document opens where you can specify what to include on the print-out.
	Attach as PDF	Create a PDF file and attach it to the document.
New Documents	Create Service Credit Memo	Create a new credit memo for the related service invoice.
	Create Service Invoice	Create a service invoice for a service contract that is due for invoicing.
Lock	Lock Contract	Make sure that the changes will be part of the contract.
	Open Contract	Open the service contract.
Functions	Select Contract Lines	Open the list of all the service items that are registered to the customer and select which to include in the contract.
	Remove Contract Lines	Remove the selected contract lines from the service contract, for example because you remove the corresponding service items as they are expired or broken.
	Sign Contract	Confirm the contract.
	Change Customer	Change the customer in a service contract. If a service item that is subject to a service contract is registered in other contracts owned by the customer, the owner is automatically changed for all service item-related contracts and all contract-related service items.
	Copy Document…	Copy document lines and header information from another service contractor to this contract to quickly create a similar document.
	File Contract	Record and archive a copy of the contract. Service contracts are automatically filed when you convert contract quotes to service contracts or cancel service contracts.
Reporting	Contract Details	—	Report 5971 “Service Contract-Detail”
	Contract Gain/Loss Entries	—	Report 5983 “Contract Gain/Loss Entries”
	Contract Invoicing	—	Report 5984 “Contract Invoicing”
	Contract Price Update - Test	—	Report 5985 “Contract Price Update - Test”
	Prepaid Contract	—	Report 5986 “Prepaid Contr. Entries - Test”
	Expired Contract Lines	—	Report 5987 “Expired Contract Lines - Test”

Events published

OnCreateServiceCreditMemoOnBeforeAction(var ServiceContractHeader: Record "Service Contract Header"; var IsHandled: Boolean) (integration)
OnCreateServiceCreditMemoOnAfterInitCodeunit(var ServiceContractHeader: Record "Service Contract Header"; var ServiceContractLine: Record "Service Contract Line"; var ServContractManagement: Codeunit ServContractManagement) (integration)

Procedures

CheckRequiredFields()

Plus 17 local procedures.

Triggers

OnAfterGetCurrRecord, OnAfterGetRecord, OnInit, OnNewRecord, OnOpenPage

Relations

source table Table 5965 “Service Contract Header”

Pages and codeunits on this table

Page 9321 “Service Contracts” (card page)

Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an Object::"Name" argument. Interface dispatch and calls through events are not counted, so the list is not complete.

Codeunit 365 “Format Address” (1 call: ActivateFields → UseCounty)
Codeunit 5700 “User Setup Management” (1 call: OnNewRecord → GetServiceFilter)
Codeunit 6477 “Serv. Document No. Visibility” (1 call: SetDocNoVisible → ServiceDocumentNoIsVisible)

Called by

Codeunit 6467 “Serv. Interaction Log Mgt.” (1 call: OnBeforeShowDocument → (object))
Page 6051 “Service Contract List” (1 call: OpenRelatedCard → (object))

Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: bcatlas_resolve_node(object_type: "page", object_name: "Service Contract"), then bcatlas_get_procedure_body or bcatlas_get_neighbors on the returned id.