Bills

// List all bills for the business
const { data: bills, pagination } = await client.bills.list({
  page: 1,
  limit: 25,
});

// Filter by status
const { data: pendingBills } = await client.bills.list({
  status: 'pending_approval',
});

// List personal bills
const { data: myBills } = await client.bills.listPersonal({
  limit: 10,
});

const bill = await client.bills.getById(billId);
console.log(bill.vendorName, bill.totalAmount, bill.status);

const bill = await client.bills.create({
  vendorId: 42,
  dueDate: '2025-04-30',
  lineItems: [
    { description: 'Consulting services', amount: 5000.00 },
    { description: 'Travel expenses', amount: 1200.00 },
  ],
});

const bills = await client.bills.batchCreate([
  { vendorId: 42, dueDate: '2025-04-30', lineItems: [{ description: 'Invoice #001', amount: 500 }] },
  { vendorId: 43, dueDate: '2025-05-15', lineItems: [{ description: 'Invoice #002', amount: 750 }] },
]);

const updated = await client.bills.update(billId, {
  dueDate: '2025-05-15',
  note: 'Extended payment terms',
});

const updated = await client.bills.batchUpdate([
  { id: 1, note: 'Updated note' },
  { id: 2, dueDate: '2025-06-01' },
]);

await client.bills.delete(billId);

const result = await client.bills.submitForApproval(billId, {
  comment: 'Please review and approve.',
});

const result = await client.bills.approve(billId, {
  comment: 'Approved for payment.',
});

const result = await client.bills.schedulePayment(billId, {
  scheduledDate: '2025-04-20',
  paymentMethod: 'bank_transfer',
});

const result = await client.bills.reschedulePayment(billId, {
  scheduledDate: '2025-05-01',
});

const result = await client.bills.markPaid(billId, {
  paidDate: '2025-04-20',
  paymentReference: 'TXN-12345',
});

const result = await client.bills.cancel(billId, {
  reason: 'Duplicate bill',
});

const result = await client.bills.revertToDraft(billId);

const result = await client.bills.retryPayment(billId);

const summary = await client.bills.getStatusSummary();
console.log(`Draft: ${summary.draft}`);
console.log(`Pending: ${summary.pendingApproval}`);
console.log(`Paid: ${summary.paid}`);

const transitions = await client.bills.getAllowedTransitions(billId);
console.log('Allowed transitions:', transitions);

const history = await client.bills.getHistory(billId);
for (const entry of history) {
  console.log(`${entry.action} by ${entry.userId} at ${entry.timestamp}`);
}

const formData = new FormData();
formData.append('files', invoicePdf);

const results = await client.bills.upload(formData);

const formData = new FormData();
formData.append('files', invoicePdf);

const validation = await client.bills.validate(formData);

const blob = await client.bills.export({
  format: 'csv',
  status: 'paid',
  startDate: '2025-01-01',
});

const zipBlob = await client.bills.downloadAttachments({
  billIds: [1, 2, 3],
});

const result = await client.bills.bulkApprove({
  billIds: [1, 2, 3],
  comment: 'Batch approved.',
});
console.log(`Approved: ${result.succeeded}, Failed: ${result.failed}`);

const result = await client.bills.bulkMarkPaid({
  billIds: [4, 5, 6],
});

const result = await client.bills.bulkSchedulePayment({
  billIds: [7, 8, 9],
  scheduledDate: '2025-05-01',
});

const result = await client.bills.bulkUnschedule({
  billIds: [7, 8],
});

const result = await client.bills.bulkCancelPayment({
  billIds: [10, 11],
});

const result = await client.bills.bulkRetryPayment({
  billIds: [12, 13],
});

const result = await client.bills.bulkDelete({
  billIds: [14, 15],
});

const result = await client.bills.bulkUpdate({
  updates: [
    { billId: 1, note: 'Updated' },
    { billId: 2, dueDate: '2025-06-01' },
  ],
});

const result = await client.bills.bulkRemind({
  billIds: [20, 21, 22],
});