Managing bills
Create and fetch bills using Sync for Payables
In Codat's API a Bill represents an invoice from a supplier. This is an accounts payable invoice.
Bills can be retrieved using Sync for Payables.
You can also create bills within your system and then create them within your customers' accounting software.
We distinguish between invoices where the company owes money vs. is owed money. If the company has received an invoice, and owes money to someone else (accounts payable) we call this a Bill.
Get a list of existing bills
You can get a list of bills for a company using Sync for Payables:
GET https://api.codat.io/companies/{companyId}/data/bills?page=1&pageSize=100
Query parameters can be used to filter and narrow the returned results:
supplierRef.supplierName=acme increturns only bills associated to the specified supplierdueDate>2023-06-01&&dueDate<2023-06-30returns only bills due for payment between June 1st and June 30thamountDue>0returns only outstanding bills with due amounts
You can also retrieve any associated attachments for a given bill such as a pdf copy of the invoice issued by the supplier.
Create a new bill
Bills should correspond to a supplier. You'll need to ensure the corresponding supplier exists before creating a new bill.
You can also create a new bill in your company's accounting software to represent goods or services purchased from a supplier.
POST https://api.codat.io/companies/{companyId}/connections/{connectionId}/push/bills
Upload a copy of the invoice
In some cases where a bill is being created in your application, the company may also want to save a copy of the pdf invoice against the bill in their accounting software. This can be supported via the bill attachments endpoint
POST https://api.codat.io/companies/{companyId}/connections/{connectionId}/push/bills/{billId}/attachments
Read next
- Payment mapping - Enable SMBs to choose how to make payments