Vendor Bill API

Create, read, update, and delete vendor bills.

---

Endpoints

Method	Endpoint	Description
GET	/record/v1/vendorBill	List vendor bills
GET	/record/v1/vendorBill/{id}	Get specific bill
POST	/record/v1/vendorBill	Create bill
PATCH	/record/v1/vendorBill/{id}	Update bill
DELETE	/record/v1/vendorBill/{id}	Delete bill

---

Key Fields

Field	Type	Description	Required
entity	object	Vendor	Yes
tranDate	string	Bill date	Yes
dueDate	string	Payment due date	Auto-calculated
subsidiary	object	Subsidiary	Yes (OneWorld)
currency	object	Currency	Yes
total	number	Total amount (read-only)	-
amountPaid	number	Amount paid (read-only)	-
amountRemaining	number	Balance due (read-only)	-
terms	object	Payment terms	No
tranId	string	Vendor invoice number	No
createdFrom	object	Source PO	No
item	collection	Line items	Conditional
expense	collection	Expense lines	Conditional

---

Example: Create Bill from PO

POST /record/v1/vendorBill
Content-Type: application/json

{
  "entity": {
    "id": "789"
  },
  "tranDate": "2025-12-25",
  "subsidiary": {
    "id": "1"
  },
  "currency": {
    "id": "1"
  },
  "createdFrom": {
    "id": "2001"
  },
  "tranId": "VEND-INV-12345",
  "item": {
    "items": [
      {
        "item": { "id": "789" },
        "quantity": 100,
        "rate": 25.00
      }
    ]
  }
}

---

Example: Create Expense Bill

POST /record/v1/vendorBill
Content-Type: application/json

{
  "entity": {
    "id": "789"
  },
  "tranDate": "2025-12-25",
  "subsidiary": {
    "id": "1"
  },
  "currency": {
    "id": "1"
  },
  "memo": "Office rent - December 2025",
  "expense": {
    "items": [
      {
        "account": { "id": "150" },
        "amount": 5000.00,
        "memo": "Monthly rent"
      }
    ]
  }
}

---

Query Filters

Find Unpaid Bills

GET /record/v1/vendorBill?q=amountRemaining > 0

Find by Vendor

GET /record/v1/vendorBill?q=entity='789'

Find Overdue Bills

GET /record/v1/vendorBill?q=dueDate < SYSDATE AND amountRemaining > 0

---

See Also

• Purchase Order - Source POs
• Vendor Payment - Pay bills
• Vendor Credit - Vendor credits
• Item Receipt - Receive items