Create a Bill for Particular Lines of a Purchase Receipt

If you are using the contract-based REST API to integrate MYOB Acumatica with an external system, this external system can create bills for particular lines of purchase receipts. For details about the processing of inventory purchases, see Purchases of Stock Items: General Information.

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.
Note:
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.

System Preparation

Before you test the code below, you need to do the following to configure your client application and the MYOB Acumatica instance to be used:
  1. 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.
  2. On the Enable/Disable Features (CS100000) form, make sure that the Inventory and Order Management feature is enabled.
  3. If you use 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.
  4. 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.
Tip:
Make sure the financial periods are open for the year for which you are creating an AP bill. If the financial periods are not open, the creation of the AP fill fails with an error, such as Post Period cannot be empty. For details about how to open financial periods, see an example in Opening Financial Periods: Process Activity.

Request

You can use the following example of an HTTP request to create an AP bill for a line of a purchase receipt.

Tip:
In the request example below, <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

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.