Table of Contents

Item Service Codes

In addition to linking Standard Service Codes to a Service Item for use in Service Contracts, you can assign Standard Service Codes directly to an item or to a service item. An item service code holds the items, resources, costs, and G/L accounts that belong together for that item, for example for a wheel, a pump, or a motor.

Each line of an item service code defines how it is handled when the code is inserted into a service quote or service order: as a regular line, as a replacement of a Service BOM component, or as part of an analysis. This lets you define fixed sets of parts and work once, for example a package for a destructive analysis, and insert all lines in one step. You do not have to set the Spare Part Action (DM) on each service line in the Service Item Worksheet. For more information, see Packages for Analysis and Replacement.

Prerequisites

Before you can assign or insert item service codes, the following conditions must be met:

  • The service item has an active Service BOM. For more information, see Service BOM.
  • Standard service codes are assigned to items in that Service BOM, or to the service item.
  • The Item Service Code field on the Numbering FastTab of the Configure to Order Setup page contains a number series.

To assign standard service codes to an item or service item

  1. Open the item or service item to assign standard service codes to.
  2. On the Related menu, choose Item > Item Service Codes (Item Card or Item List) or Service Item > Item Service Codes (Service Item Card).
  3. The Standard Service Codes page opens, filtered to the codes already assigned to that item or service item.
  4. Choose New to create a new standard service code. The Code field is replaced by a Search Code field, and the Source Type and Source No. fields show the item or service item the code is assigned to. The Code itself is assigned automatically from the number series configured in the Item Service Code field on the Numbering FastTab of the Configure to Order Setup page.
  5. In the Lines FastTab, enter the items, resources, costs, or G/L accounts required for the code, as for any other Standard Service Code. Optionally select the Spare Part or Wear Part checkbox on a line to mark it as a spare or wear part. When the line's Spare Part Action is Replace Component, these checkboxes narrow the Service BOM components that the line can be linked to when the code is used with the Get Item Service Codes action.
  6. Optionally, define how the line is handled when the code is inserted. For more information, see To define the spare part action of a service code line.
Note

The Standard Service Codes list page only shows codes without an assigned item or service item source when it is opened without a source filter (for example, from the Tell Me search). Codes assigned to an item or service item only appear there when opened through the Item Service Codes action on the related item or service item, or through a page that filters by source.

Packages for Analysis and Replacement

An item service code is a fixed package of service lines that you define once for an item or a service item. When you insert the code, all lines of the package are created in one step. The Spare Part Action on each line defines what the package is for:

Package Lines of the package Use it when
Analysis package Lines with the Spare Part Action Analysis A fixed set of parts and resources is used to analyze a repair item, for example for a destructive analysis.
Replacement package Lines with the Spare Part Action Replace Component The parts replace components of the Service BOM, for example during maintenance.
Mixed package Lines with different actions A standard task contains both, plus regular lines with Ignore.

An analysis package contains the provisional lines of a repair quotation, such as consumables and labor. After the customer accepts the quotation, you convert the service quote into a service order and create the construction order for the analysis lines. For more information, see the In-House Repair walkthrough.

If the parts of a repair vary from case to case, set the spare part action on the service lines instead. For more information, see To set a different spare part action manually.

To define the spare part action of a service code line

The Spare Part Action field on a code line is the instruction. The Spare Part Action (DM) field on the inserted service line is the result.

  1. Open the standard service code, as described in To assign standard service codes to an item or service item. Make sure that the page is editable.

  2. In the Lines FastTab, choose the AssistEdit button in the Spare Part Action field of the line. You cannot type in this field.

  3. Choose one of the following options. If you close the menu without choosing an option, the field keeps its current value.

    Option Choose it when Effect on the service line No effect when
    Ignore The line is a regular service line, such as a resource or a consumable. The service line has no spare part action. Not applicable.
    Replace Component The line is a part that replaces a component of the Service BOM. The service line is linked to the matching component, and the Spare Part Action (DM) is Component Replaced. No component or more than one component matches. The service line has no spare part action and no component reference.
    Analysis The line is a part or a resource that is used for the analysis of a repair. The Spare Part Action (DM) is Analysis. The line is assigned to the repair service line. No repair service line exists. The Repair Item Line No. stays empty. Lines of a type other than Item or Resource are not taken over into the construction order for the analysis.
  4. For Replace Component, optionally select Spare Part or Wear Part on the line. If you do, the Service BOM component must have the same setting. If you select neither, the component is found by item number only.

When you insert the code, the service lines are created as described in the table. For the matching rules and the repair assignment, see Repair Lines from Item Service Codes. For the analysis process, see the In-House Repair walkthrough.

Important

Before you insert a code that contains Analysis lines, make sure that a repair service line exists. Mark the component that the code belongs to, or a component above it in the Service BOM structure, as Service Repair in the same selection. Alternatively, select the Repair field on the service document and make sure that a service line with the Spare Part Action (DM) Component Repaired exists above the inserted lines on the same service item line. Without a repair service line, the Repair Quote Worksheet and Construction Order actions on the analysis line of a service order stop with an error because the Repair Item Line No. field has no value.

Note

Lines with no value in Spare Part Action, or with Ignore, are not linked to a Service BOM component, even if Spare Part or Wear Part is selected. Choose Replace Component on every line that you want to link.

Note

The Spare Part Action field is shown on every line of a standard service code, but it is evaluated only when the code is inserted with Get Item Service Codes.

To use a package for analysis and replacement

  1. Define the package: create the standard service code with its lines, as described in To assign standard service codes to an item or service item.
  2. Set the Spare Part Action on each line, as described in To define the spare part action of a service code line.
  3. Insert the package with the Get Item Service Codes action. To assign the lines to a repair, mark the component to repair as Service Repair in the same selection.
  4. Review the inserted service lines in the Service Item Worksheet.

You can select several codes in one run, for example an analysis package and a replacement package together.

Example

You define the code Analysis front wheel for a bicycle. It contains a consumable item and a resource line for the analysis work. Both lines have the Spare Part Action Analysis. When you insert the code on a service quote in which the wheel is marked as Service Repair, both lines are created as analysis lines and are assigned to the repair service line.

Insert Item Service Codes

On a service quote or service order, you select item service codes along the structure of the service item's active Service BOM. This records which component is affected and inserts the lines of the selected codes as service lines. A component selected in the same step can be marked as repaired, which creates a repair service line that the inserted lines are assigned to, as part of the In-House Repair process.

To insert item service codes into a service order or service quote

  1. Open a Service Order or Service Quote and go to the line for the service item.
  2. On the Actions menu, choose Functions > Get Item Service Codes.
  3. The Service Code Selection page opens, showing the active Service BOM of the service item as a tree, indented by Level. Standard service codes assigned to the service item, and to the item of the Service BOM header, are shown directly below the top line. Each Service BOM component that has item service codes assigned to it is shown together with those codes as child lines, identified by their Search Code.
  4. Choose Edit List to make the checkboxes on the lines editable.
  5. To insert a code's lines as service lines, select the Select checkbox on the code line. This checkbox is only available on code lines, not on component lines.
  6. Choose the OK button to insert the service lines for every selected code.

The quantities of a code's lines are multiplied by the Quantity of the line the code belongs to. For a component, this quantity is taken from the Expected Quantity of the corresponding Service BOM line. For codes shown directly below the top line, this quantity is 1.

Note

The Quantity field is not shown on the Service Code Selection page by default. Add it through personalization to review or change it before the service lines are inserted.

If the service item has no active Service BOM, the action does not open a selection page and no service lines are created. If the Currency Code of a selected standard service code differs from the Currency Code of the service document, the process stops with an error and no service lines are inserted, including the repair service lines of the same run. Running the action again inserts the selected lines a second time; existing service lines are not detected or updated.

Service Code Selection Page

The fields on the Service Code Selection page are described in the following table.

Field Description
Level Specifies the level of the line in the Service BOM structure. The line is indented according to this value.
Service Repair Specifies whether a repair service line is created for this component, as part of the In-House Repair process. Available on component lines only.
Select Specifies whether the lines of this standard service code are inserted as service lines. Available on code lines only.
No. Specifies the item number of the Service BOM component. Empty on code lines.
Description Specifies the description of the Service BOM component or of the standard service code.
Service Search Code Specifies the search code of the standard service code. Empty on component lines.
Type Specifies the standard service code type. Empty on component lines.
Quantity Specifies the factor by which the quantities of the code's lines are multiplied. Taken from the expected quantity of the Service BOM line. Not shown by default.

Use with In-House Repair

Marking a component as Service Repair also creates a repair service line and links the inserted code lines to it, as part of the In-House Repair process. Lines with the Spare Part Action Replace Component can be linked automatically to a matching Service BOM component. Lines with the Spare Part Action Analysis are created as analysis lines. For details, see Repair Lines from Item Service Codes.

To copy item service codes when copying an item

When copying an item using the standard Copy Item function, select the Item Service Codes checkbox in the Configure to Order FastTab to also copy the source item's assigned standard service codes, including their lines, to the new item.

Note

Only standard service codes with Source Type = Item are copied. Standard service codes assigned to a service item are not copied by the Copy Item function.

When to use which function

To See
Insert the lines of predefined standard service codes along the Service BOM structure, and create repair service lines for selected components. Get Item Service Codes, described on this page.
Insert individual lines of the active Service BOM as service lines in the Service Item Worksheet, without a predefined set of lines. Insert Service Lines from Service BOM to Service Item Worksheet
Insert standard service code lines automatically when a service order is created from a service contract. Pre-defined Service Worksheets for Service Contracts

See Also

Service BOM
Service Documents
Create Construction Document from Service Item Worksheet
In-House Repair


Feedback
Submit feedback for this page .