> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to record a service on a stock item

> Once a unit's service is done, set its service date and reset its use count on the Attributes tab, so it drops out of your maintenance view.

> [card] [Open in TWICE Admin](https://admin.twicecommerce.com/inventory/stock-items)
>
> inventory/stock-items

Record a finished service on the unit itself: set the day it was serviced and reset the count of use since then, so the unit leaves the view that lists what is due. [Attributes](https://www.twicecommerce.com/docs/concepts/admin/attributes.md) explains how a stock item keeps its own values.

## Prerequisites

> [!WARNING]
>
> **Required permissions:**
>
> * **Create and edit stock items** (`inventory:stock_item_attributes:manage`) to change the unit's attribute values. Every built-in role holds it, Member included. See [Users & Roles](https://www.twicecommerce.com/docs/settings/users-roles.md).

> [!NOTE]
>
> **Have ready before you start:**
>
> * **The service attributes on the unit**: a **Date** attribute for the last service and a **Number** attribute counting use since it. See [Add a stock item attribute](https://www.twicecommerce.com/docs/guides/inventory/add-a-stock-item-attribute.md).
> * **The day the work was finished.**

## The walkthrough

**1. Open the unit**

Select **Inventory** in the left sidebar, click the tab of your maintenance view above the table, such as Due for service, and click the unit's row. The stock item's page opens, with its tabs under its name.

**2. Open the Attributes tab**

Click **Attributes** in the row of tabs. The tab shows the unit's attribute values in cards, one card per attribute group.

**3. Set the service date**

In the card that holds your service attributes, click the calendar button at the right end of the date field, such as Last service date, and pick the day the work was finished. A banner with **Discard** and **Save changes** appears at the top of the page.

**4. Reset the use count**

Clear the number field that counts use, such as Uses since service, and enter 0.

**5. Save the changes**

Click **Save changes** in the banner at the top of the page. The banner closes, and the two fields keep their new values.

## How do I know it worked?

* **The Attributes tab shows the new date and a count of 0** when you open the unit again.
* **The unit is gone from your maintenance view**, and the count beside the view's tab name drops.
* **The unit is bookable again** once the reservation you made for the work ends. If the work finished early, shorten the reservation: see [Edit a reservation](https://www.twicecommerce.com/docs/guides/inventory/edit-a-reservation.md).

## Troubleshooting / common pitfalls

> [accordion] The service attribute is not on the unit
>
> It has not been added to this unit yet. Click **Add Attribute** on the card that should hold it, and add it with its value. See [Add a stock item attribute](https://www.twicecommerce.com/docs/guides/inventory/add-a-stock-item-attribute.md).

> [accordion] The field cannot be typed in
>
> It is a formula attribute, which works its value out from other fields and is read-only on the stock item. Change the values the formula reads instead. See [Attributes](https://www.twicecommerce.com/docs/concepts/admin/attributes.md#formula-attributes).

## Related articles

> [card] [Attributes](https://www.twicecommerce.com/docs/concepts/admin/attributes.md)
>
> Attribute formats, formulas, and the values a stock item keeps.

> [card] [Maintenance and reservations](https://www.twicecommerce.com/docs/guides/inventory/maintenance-programme)
>
> Every walkthrough for servicing units and holding them out of use.

> [card] [Save a maintenance view](https://www.twicecommerce.com/docs/guides/inventory/save-a-maintenance-view.md)
>
> List the units due for service in a saved view.

> [card] [Attach a document to a stock item](https://www.twicecommerce.com/docs/guides/inventory/attach-a-document-to-a-stock-item.md)
>
> Keep the service report on the unit.

> [card] [Edit a reservation](https://www.twicecommerce.com/docs/guides/inventory/edit-a-reservation.md)
>
> Change a reservation's dates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.