Create a Bill for Particular Lines of a Purchase Receipt
By using the REST API, you can create bills for particular lines of purchase receipts, which are available on the Purchase Receipts (PO302000) form. You can view the created bill on the Bills and Adjustments (AP301000) form. For details about the processing of inventory purchases, see Purchases of Stock Items: General Information.
System Preparation
- Deploy a new MYOB Acumatica instance with the U100 dataset. For details on deploying an instance, see Instance Deployment: To Deploy an Instance with Demo Data.
- On the Enable/Disable Features (CS100000) form, make sure that the Inventory and Order Management feature is enabled.
- If you are using Postman as the client application for testing, in the IntegrationDevelopmentGuide.postman_collection.json collection, make sure that the collection’s variables have the proper values. This collection is located in the IntegrationDevelopment\Help folder of the Help-and-Training-Examples repository on GitHub.
- To sign in to the instance in the client application, use the tenant name (which you specified when you created the instance) and the HEADOFFICE branch.
Request
You can use the following example of an HTTP request to create an AP bill for a line of a purchase receipt.
<MYOB Acumatica instance URL>
is the URL of the MYOB Acumatica
instance (such as https://my.acumatica.com/MyInstance). You can omit the instance
name in the URL (that is, you can use https://my.acumatica.com) if the instance
is installed in the root of the website.PUT ?$select=ReferenceNbr,Details&$expand=Details HTTP/1.1
Host: [<MYOB Acumatica instance URL>]/entity/Default/24.200.001/Bill
Accept: application/json
Content-Type: application/json
{
"Vendor": {
"value": "OFFICEUP"
},
"VendorRef": {
"value": "123"
},
"Description": {
"value": "Bill for particular lines of a purchase receipt"
},
"Details": [
{
"POReceiptNbr": {
"value": "000001"
},
"POReceiptLine": {
"value": 1
}
}
]
}
Usage Notes
To create an AP bill for particular lines of a purchase receipt, you need to specify the line numbers in the request by using the POReceiptLine property of the BillDetail detail entity of the Bill entity.
If you want to add all lines of a purchase receipt to an AP bill, in the BillDetail detail entity of the Bill entity, you need to specify only the receipt number of the purchase receipt.
In the request above, you can specify the Details/POReceiptType
value to create a bill for particular lines of a purchase receipt or purchase
return. If you do not specify this value, the Receipt value is used by
default.