---
title: Purchase Order
slug: xero/purchase-order
description: Learn how to request a purchase order (PO) using JSON and receive a response from Xero with this comprehensive document. Understand the essential parameters of the Purchase Order object, including contact, date, status, line items, tax details, and more. 
docTags: 
createdAt: 2021-11-02T07:45:01.000Z
---

When requesting a PO, use the requestJSON to pass the PO data, and the response will have responseJSON which stores the POs response returned by Xero.

The Purchase Order object has the following parameters.

### Purchase Order

| **Field Name**              | **Data Type**                                                                | **Description**                                         |
| --------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------- |
| Contact                     | [Contact](docId\:xpSz7quTZphbPo3vuSTz_)                                      | The ID (Unique Xero ID) for the referenced customer     |
| DateString                  | String                                                                       | Date purchase order was issued                          |
| DateVariable                | String                                                                       | Date purchase order was issued                          |
| DeliveryDate                | Date                                                                         | Date purchase order is due                              |
| Status                      | String                                                                       | Status of the purchase order                            |
| LineAmountTypes             | String                                                                       | Type of Amounts like Tax Exclusive,inclusive and no tax |
| LineItems                   | **[LineItem](https://docs.breadwinner.com/xero/purchase-order#xj-lineitem)** | Individual line items of a transaction                  |
| SubTotal                    | Decimal                                                                      | Total of invoice excluding taxes                        |
| TotalTax                    | Decimal                                                                      | Total tax on purchase order                             |
| Total                       | Decimal                                                                      | Total of purchase order tax inclusive                   |
| CurrencyCode                | String                                                                       | The currency that purchase order has been raised in     |
| CurrencyRate                | Decimal                                                                      | The currency rate for a multicurrency purchase order    |
| PurchaseOrderID             | String                                                                       | Unique identifier for this object and ReadOnly field    |
| PurchaseOrderNumber         | String                                                                       | Unique alpha numeric code identifying purchase order    |
| Reference                   | String                                                                       | Additional reference number                             |
| BrandingThemeID             | String                                                                       |                                                         |
| DeliveryAddress             | String                                                                       | ****                                                    |
| AttentionTo                 | String                                                                       |                                                         |
| DeliveryInstructions        | String                                                                       |                                                         |
| Telephone                   | String                                                                       |                                                         |
| Salesforce\_Account\_Id     | String                                                                       | To link Purchase Order with Salesforce Account          |
| Salesforce\_Opportunity\_Id | String                                                                       | To link Purchase Order with Salesforce Opportunity      |

### LineItem 

| **Field Name** | **Data Type**                                                                                | **Description**              |
| -------------- | -------------------------------------------------------------------------------------------- | ---------------------------- |
| ItemCode       | String                                                                                       | Code of the Product          |
| Description    | String                                                                                       | Description of the line item |
| TaxType        | String                                                                                       |                              |
| AccountCode    | String                                                                                       |                              |
| LineItemID     | String                                                                                       |                              |
| UnitAmount     | Decimal                                                                                      |                              |
| Quantity       | Decimal                                                                                      |                              |
| DiscountRate   | Decimal                                                                                      |                              |
| Tracking       | **[TrackingCategory](https://docs.breadwinner.com/xero/purchase-order#qe-trackingcategory)** |                              |

### TrackingCategory

| **Field Name**     | **Data Type**  | **Description** |
| ------------------ | -------------- | --------------- |
| Name               | String         |                 |
| Option             | String         |                 |
| TrackingCategoryID | String         |                 |