Skip to main content
Record a bill as soon as an invoice arrives. Only the line items are required, so you can add the vendor, bank details and invoice file later.

​
Create a bill

Send the line items to Create a bill. Amounts are in minor units, so 120000 USD is $1,200.00, and the bill takes its currency from the lines.
The bill is created as a draft, with the total and outstanding balance filled in:
Use your AP system’s invoice id as the X-Idempotency-Key. Retrying the request then returns the same bill instead of creating a duplicate. See Idempotency.
Add the rest when you have it: the destination to pay, the invoice number and dates, notes, and the invoice file in documentIds. A bill needs an invoiceDate before it can sync to your accounting platform, where invoiceNumber becomes the bill’s number. The vendor is any contact on your legal entity that isn’t archived, usually one with recipientType: vendor. If you don’t have one yet, create it with Create a contact and its bank details with Create a destination.

​
Edit a bill

Update a bill changes only the fields you send. lineItems replaces the whole list: lines with an id are kept and updated, lines without one are added, and lines you leave out are removed.
Amounts and line items can only change while the bill is draft or rejected. To add more files, use Attach documents to a bill.

​
Delete or void a bill

  • Delete a bill removes a bill that hasn’t been paid: one that is draft, rejected or pending_approval.
  • Void a bill cancels payments that are awaiting approval or scheduled and puts the bill back in draft, so you can change it or pay it another way. A bill whose payment is already on its way (payment_pending) or settled can’t be voided; cancel a pending ACH payment with Cancel an ACH transfer instead.

​
Find bills

List bills returns bills sorted by due date, so the first page is what’s due soonest. Filter by status, vendorContactId, dueFrom and dueTo, or overdue=true. To check whether a vendor’s invoice is already in Slash, pass invoiceNumber with vendorContactId.