xtraCHEF: Get Started With the Item Library

Dernière mise à jour : 8 avr. 2026, 10 h 10

The Item library sets you up for pinpoint accuracy on your recipe costing and inventory values.

In this Article:

 

Item Library Overview

 

The Item library houses all of your Invoice Item and Product information. As you continue to upload invoices, the Item library will grow and enable much of xtraCHEF's food cost, recipe, and inventory reporting. The Item library also enables you to customize your ingredients and inventory items, create products and assigning invoice items to them, view your item's last purchased date and recent price, and get extra insight into certain products through the favorites feature. Adding products is done via a link to a new page.

 

The new Item Library

 

Back to top
 

Key Points of the Item Library

  • Last Purchased and Most Recent Price (see above) are the newest columns added to the report.
  • Use the Location, Category, Product, and Vendors filters at the top to narrow down your results to a specific product or item. Select More Filters to see items by their Status or Last Purchase Date.
  • If you use the search bar to search for a product, xtraCHEF will display all invoice items associated with that product across all locations (unless you have a filter on).
  • Select Download all to create a spreadsheet file of this information. You'll be notified when this file is ready to view.
  • You can also select the checkbox for any number of items and the Categorize button will become available. This allows you to bulk update the category for the selected items.

 

When you're ready, select the View products link at the top of the Item library. This allows you to directly view and edit products on this page.


Back to top

Item Review via the Item Library

  1. Begin by navigating to Item Library using the xtraCHEF navigation bar.
  2. All unreviewed items appear at the top of this report with a To Review status. You can select the More Filters button and select To Review > Apply filters to only view items needing approval.
  3. Select the hyperlinked name to open the detailed view of your invoice item.
  4. Select the yellow highlight (Item seen on: Row X) to quickly locate an item on the associated invoice. Verify the different unit measurements for this product (Purchase unit, Pack, Size, Unit, and Inventory unit). If you need to, brush up on the definitions of these terms and check out the examples towards the end of this article.

    Line Items Details tile with different unit measurements

    1. Use the blue box at the bottom to help verify your inputs. If the sentences do not make sense, consider adjusting the Purchase unit, Pack, Size, Unit, and/or Inventory unit fields.

      "Check your work" tile at the bottom of the detailed view of the item library

  5. You can also assign a Product, a Category, and, by way of Category, a GL code to this item.
  6. Once you're finished, select Approve.

 

Back to top

 

Item Library Definitions

FieldDescription
Purchase Unit (UOM)This is the purchasing unit or UOM displayed on the invoice.
PackIf there is more than one measurable unit within a case, this is where you’ll enter the quantity. For example, If there are 6 bottles in a case, the value here will be ‘6.’ If not defined, then the default value is 1.
SizeThis is where you’ll enter the number value of the units within each “pack.” For example, if there are six 750ml bottles in a case, the “size” is ‘750.’ If not defined, then the system will default to a value of 
UnitThis is the Purchase unit of each pack. In the example above, this would be ‘ml.’
Inventory unit (Item UOM)This is only required when the pack value is more than 1. This is where you’ll name the packs in the case. Continuing the example from above, this would be ‘bottle.’ If Inventory unit is not defined and a pack is more than 1, then the system will default a value to 'each.’
CategoryThis allows you to select a corresponding General Ledger Code and/or Custom Category for accounting extracts or reporting purposes. If you have synced your Chart of Accounts or created General Ledger Codes and Categories, those options will exist for you to choose from in the Category drop-down.
ProductThis field is essential for Recipe and Inventory functions. They should be considered ingredients for all intents and purposes and allow you to group multiple invoice items together. If you would like to learn more about products, visit our article titled xtraCHEF: What are Products?

 
Back to top
 

Item Library Examples

Protein

This 4-and-a-half-minute video will walk through common protein examples you may encounter when reviewing items in xtraCHEF. Examples include:

  • Protein by the pound (for use by weight)
  • Protein by the case/pack (for use by weight)
  • Protein by the case/pack (for use by each)

Tip: Use the chapters located in the video's progress bar to skip between the examples. 
 


Back to top
 

Liquor

Liquor by the case: Let's look at a liquor example. Based on an invoice, we should know an invoice item's Purchase unit. In this case, whether it was purchased by the case or by the bottle.

If our liquor is purchased by the case for $61.07, and there are 12 bottles of 1 liter within it, we could then safely assume that the breakdown is as follows:
 

Purchase unitPackSizeUnitInventory unit
Case121LiterBottle


By entering that same information into the Item library, xtraCHEF can then break out that per case cost of $61.07 into a cost per bottle/cost per liter. Moving forward, xtraCHEF would then know how to calculate your costs for Inventory values and by volume for cocktail recipes.

 

Example invoice item page in the Item library with the information above entered in


Liquor by the bottle: If the purchase unit indicates your liquor is purchased by the bottle, you can simplify your Item library breakdown to the following:
 

Purchase unitPackSizeUnitInventory unit
Bottle11LiterN/A
 
By entering that same information into the Item library, xtraCHEF can then break out that cost for both the individual bottle and cost per liter.
 
 
Example invoice item page in the Item library with the information above entered in
 
Note: Verifying all liquor by the liter (rather than by fluid ounce, milliliter, etc.) will help with reporting consistency.
 
 

Wine
Note: Since wine is commonly sold in 0.75 liter bottles, we recommend verifying all wine by each (rather than by liter/milliliter/fluid ounce) to assist with with reporting accuracy and consistency.

 

Wine by the case: If our wine is purchased by the case for $61.07, and there are 12 bottles within it, we could then safely assume that the breakdown is as follows:
 

Purchase unitPackSizeUnitInventory unit
Case121EachBottle


By entering that same information into the Item library, xtraCHEF can then convert the $61.07 per case cost to a cost per case and individual bottle.

 

Example invoice item page in the Item library with the information above entered in


Wine by the bottle: If the purchase unit indicates your wine is purchased by the bottle you can simplify your Item library breakdown to the following:
 

Purchase unitPackSizeUnitInventory unit
Bottle11EachN/A


By entering that same information into the Item library, xtraCHEF can then break out the cost for the bottle.

 

Example invoice item page in the Item library with the information above entered in

 

Back to top

 

Kegs


A 1/2 Barrel Keg:

Purchase unitPackSizeUnitInventory unit
Keg115.5GalKeg

 

A 1/4 Barrel Keg:

Purchase unitPackSizeUnitInventory unit
Keg17.75GalKeg


A 1/6 Barrel Keg:

Purchase unitPackSizeUnitInventory unit
Keg15.2GalKeg

 

Back to top


Bottles and Cans


In most bottles/cans cases, the purchase unit will indicate your item(s) is purchased by the case. In these instances, we will set our Purchase unit to Case, Pack to the #of cans/bottles within the case, Size to 1, and unit to each. You can also set the Inventory unit to either can or bottle to further describe it.

Below is an example of a case of 6 cans.
 

Purchase unitPackSizeUnitInventory unit
Case61EachCan



By entering that same information into the Item library, xtraCHEF can then break out the cost for both the case and can.

Example invoice item page in the Item library with the information above entered in

 

Back to top

 

Examples Continued
 

A case of 10 lb apples. This Invoice Item can be configured in two ways depending on how you want to take inventory:
 

Purchase unitPackSizeUnitInventory unit
Case101LbLb
Case110LbN/A
 

A bag of 5 lb sugar. This Invoice Item can be configured in two ways depending on how you want to take inventory:
 

Purchase unitPackSizeUnitInventory unit
Bag51LbLb
Bag15LbN/A
 

Back to top

 

Edit Invoice Item Details

By selecting an approved invoice item in the Item library, you're able to drill into the details associated with it and change them, if necessary. If this item is marked To Review, use these steps to approve the items and its details.
 

The invoice item editing screen

 

From here, scroll down to the Line Item Details tile and you'll notice the Purchase unit, Pack, Size, Unit, Inventory unit (if applicable), Product, and Category fields can all be edited. You can even add a new product directly on this page by typing its name directly in the Product field.
 

Editable fields in an invoice item's detail page  
 

Note: Editing the Category field will subsequently change the GL code field. If your Category field is empty, this Invoice Item may be awaiting action in Map invoice items.

 

Once you've made the edits to this invoice item, you can double-check your work by using the sentence in the blue box at the bottom. If you don't agree with the structure of the statement, continue to make edits until it's correct based on the invoice item itself and how it's shipped to you.

 

"Check your work: does this sentence make sense?" example

 

Back to top
 

View Your Products 

In xtraCHEF, Products refer to your ingredients and inventory items. As you're getting started, your list of products will form the foundation for your restaurant to begin using Recipe and Inventory functions. After creating your products, you can immediately begin building your recipes and inventory counts. To learn more about products and how to create them, consider reading xtraCHEF: Get Started With Products and xtraCHEF: Create Products. Products also allow you to group line items from your invoices together that are substitutes for the same invoice item. This will ensure your plate costs and inventory values are calculated correctly, regardless of any substitutions or replacements.

 

To view or change product details, select View products at the top of the Item library.

 

View products button highlighted in item library

 

This will reload the page to display all your current Products
 

List of products in the Item library

 

Selecting a Product name lets you view all the invoice items tied to that product and make changes to the product or invoice items. You can also take several actions after selecting Edit product:

  • Customize or change the Product NameYield, Unit, or Density Calculator conversion (at the bottom of the sidebar) by selecting the corresponding fields and making your changes before selecting Save changes.
  • You can directly edit a product's invoice information in this sidebar. This includes the Purchase unit, Pack, Size, Size unit, and Inventory unit. Review how these terms interact with each other in the Item Library Definitions section above. Select Save changes when you're done here.
  • If you decide you no longer need a certain product, select Delete product to remove it.
  • Similarly in this sidebar, selecting the blue minus icon will remove an individual invoice item from this product.

 

Product sidebar with invoice deletion icon highlighted

 

Lastly, from the Product page in the Item library, select the three dots to the very right of the product. Theres a couple options here:

 

Product side of the Item library with the three dots menu expanded and highlighted

 

  • Select View last invoice to pull the most recent invoice with an item associated with that product.
  • Select Rename product to give this product a new name.
  • Select Product details for a closer look at the invoice items, recipes, and inventory count lists that this product is associated with.
    • This is a quick method to reconcile where this product lives and how it flows through xtraCHEF. 


Back to top

 

Additional Resources

 

Back to top