<commit_before>---
title: Purchase Order Receipt v3
layout: reference
---

# Purchase Order Receipt
Purchase order receipts are records that indicate purchase order lines were completed and received. This API provides methods to create a new purchase order receipt, and retrieve, update, or delete an existing purchase order receipt.

* [Create a new purchase order receipt](#post)
* [Update purchase order line item with receipt information](#put-receipts)
* [Get existing purchase order receipt](#get)
* [Delete existing purchase order receipt](#delete)
* [Schema](#schema-receipt)
* [Response schema](#schema-response)
* [Receipt schema](#schema-receipt)
* [Error codes](#error-codes)

## Version

3.0  

## <a name="post"></a>Create a new purchase order receipt 

```
POST /api/v3.0/invoice/purchaseordersreceipts
```

Creates purchase order receipt, associates it to purchase order line item, and returns update status.

### <a name="8"></a>Parameters  

Name|Type|Format|Description
---|---|---|---
`purchaseOrderReceipt`|-|`body`|The details of the purchase order receipt.

### Input  

[Schema](#schema-receipt)

```json
{
  "Deleted": false,
  "DeliverySlipNumber": "DSN1",
  "GoodsReceiptNumber": "RCPT1",
  "ID": "1000001",
  "LineItemExternalID": "LN000001",
  "PurchaseOrderNumber": "PO12345",
  "ReceivedDate": "2018-09-15 00:00:00.0",
  "ReceivedQuantity": "14.5",
  "UnitOfMeasureCode": "DA",
  "URI": "string",
  "Version": "2.0"
}
```

### Response  

[Response schema](#schema-response)

## <a name="put-receipts"></a>Update purchase order line item with receipt information  

```
PUT /api/v3.0/invoice/purchaseorderreceipts
```
### Parameters  

Name|Type|Format|Description
---|---|---|---
`purchaseOrderReceipt`|-|`body`|Purchase order receipt information.

### Input  

[Receipt schema](#schema-receipt)

### Response  

[Response schema](#schema-response)


## <a name="get"></a>Get existing purchase order receipt 

```
GET /api/v3.0/invoice/purchaseorderreceipts?purchaseOrderNumber=PO1&lineItemExternalID=L1&goodsReceiptNumber=GRN1
```

### Parameters  

Name|Type|Format|Description<commit_msg>Corrects API name in URI<commit_after>---
title: Purchase Order Receipt v3
layout: reference
---

# Purchase Order Receipt
Purchase order receipts are records that indicate purchase order lines were completed and received. This API provides methods to create a new purchase order receipt, and retrieve, update, or delete an existing purchase order receipt.

* [Create a new purchase order receipt](#post)
* [Update purchase order line item with receipt information](#put-receipts)
* [Get existing purchase order receipt](#get)
* [Delete existing purchase order receipt](#delete)
* [Schema](#schema-receipt)
* [Response schema](#schema-response)
* [Receipt schema](#schema-receipt)
* [Error codes](#error-codes)

## Version

3.0  

## <a name="post"></a>Create a new purchase order receipt

```
POST /api/v3.0/invoice/purchaseorderreceipts
```

Creates purchase order receipt, associates it to purchase order line item, and returns update status.

### <a name="8"></a>Parameters  

Name|Type|Format|Description
---|---|---|---
`purchaseOrderReceipt`|-|`body`|The details of the purchase order receipt.

### Input  

[Schema](#schema-receipt)

```json
{
  "Deleted": false,
  "DeliverySlipNumber": "DSN1",
  "GoodsReceiptNumber": "RCPT1",
  "ID": "1000001",
  "LineItemExternalID": "LN000001",
  "PurchaseOrderNumber": "PO12345",
  "ReceivedDate": "2018-09-15 00:00:00.0",
  "ReceivedQuantity": "14.5",
  "UnitOfMeasureCode": "DA",
  "URI": "string",
  "Version": "2.0"
}
```

### Response  

[Response schema](#schema-response)

## <a name="put-receipts"></a>Update purchase order line item with receipt information  

```
PUT /api/v3.0/invoice/purchaseorderreceipts
```
### Parameters  

Name|Type|Format|Description
---|---|---|---
`purchaseOrderReceipt`|-|`body`|Purchase order receipt information.

### Input  

[Receipt schema](#schema-receipt)

### Response  

[Response schema](#schema-response)


## <a name="get"></a>Get existing purchase order receipt

```
GET /api/v3.0/invoice/purchaseorderreceipts?purchaseOrderNumber=PO1&lineItemExternalID=L1&goodsReceiptNumber=GRN1
```

### Parameters  

Name|Type|Format|Description
{'fraction_non_alphanumeric': 0.15702867889045605, 'fraction_numerical': 0.024917724494593323, 'mean_word_length': 5.122302158273381, 'pattern_counts': {'":': 22, '<': 19, '<?xml version=': 0, '>': 19, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5136646', 'n_tokens_mistral': 1487, 'n_tokens_neox': 1311, 'n_words': 353}