# createPurchaseItem

## Overview

Adopts an item for purchasing by creating its purchasing record (PurchaseItem). Only adopted items can be added to purchase order lines. Returns the PurchaseItem ID.

## Modules Commands Used

- [purchase] CreatePurchaseItem

## Exception Handling

| Error Code | Description |
| --- | --- |
| PURCHASE_ITEM_NOT_FOUND | The referenced item does not exist |
| PURCHASE_DUPLICATE_PURCHASE_ITEM | The item already has a purchasing record |