Vendor Bill

Vendor bills are records which you can use to track payables as they arrive from vendors.

For information about working with vendor bills in the UI, see Vendor Bills.

NetSuite exposes the vendor bill record to REST web services. This record enables you to manage a specific vendor bill record.

The REST API Browser includes information about the field names and field types of the vendor bill record. It also includes the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser's vendorBill reference page.

For information about using the REST API Browser, see The REST API Browser.

The vendor bill record contains the following subrecord:

billingAddress

The following elements are not accessible through REST web services:

expensePlanMessage
accountingBookDetail
taxDetails

Record ID

The record ID for a vendor bill REST record is vendorBill.

Usage Notes

Starting in 2026.1, when you set the grossAmt field for a taxable transaction line through REST web services, NetSuite recalculates the line amount field based on the applicable tax code, tax rate, and tax rounding rules. This behavior matches the NetSuite UI. In previous releases, REST web services ignored submitted grossAmt values, so setting this field didn't recalculate the line amount field.

Code Samples

The following samples show some common actions for a vendor bill.

Creating a Vendor Bill

              POST {{COMPANY_URL}}/services/rest/record/v1/vendorBill
{ "entity":{"id": {{vendorId}} }, "item": { "items": [{ "item": {"id": {{ItemId}} }, "rate": 10 }] }
}

Reading a Vendor Bill

              GET {{COMPANY_URL}}/services/rest/record/v1/vendorBill/{{id}}?expandSubResources=true

Updating a Vendor Bill

              PATCH {{COMPANY_URL}}/services/rest/record/v1/vendorBill/{{id}}
{ "memo": "This is a test"
}

Deleting a Vendor Bill

              DELETE {{COMPANY_URL}}/services/rest/record/v1/vendorBill/{{id}}