From e81db6dbfa5a75fe81cc575c633ce205aa1acfbc Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 14:37:24 +0000
Subject: [PATCH 01/10] Initial draft
---
blog/260219-update-bills-bill-pay.md | 26 +++
docs/payables/configure-customer.md | 6 +-
docs/payables/sync/update-bill.md | 189 +++++++++++++++++++
sidebars/payables.js | 1 +
src/components/DataTypes/index.js | 2 +-
src/pages/sync-for-payables-v2-api/index.tsx | 2 +-
6 files changed, 221 insertions(+), 5 deletions(-)
create mode 100644 blog/260219-update-bills-bill-pay.md
create mode 100644 docs/payables/sync/update-bill.md
diff --git a/blog/260219-update-bills-bill-pay.md b/blog/260219-update-bills-bill-pay.md
new file mode 100644
index 000000000..a6af9db63
--- /dev/null
+++ b/blog/260219-update-bills-bill-pay.md
@@ -0,0 +1,26 @@
+---
+title: "Bill Pay: update bills with no hassle"
+date: "2026-02-19"
+tags: ["Product", "Update", "Bill Pay"]
+authors: pzaichkina
+---
+
+You can now update existing bills directly through our Bill Pay solution.
+
+
+
+## What's new?
+
+We've expanded our [Bill Pay](/payables/overview) solution with the new [Update bills](https://docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint.
+
+No more deleting and recreating bills just to fix a typo or a changed line item. With this update, your customers can edit bills in their accounting software, and we will automatically sync these changes to your platform, keeping the records accurate and up-to-date.
+
+The endpoint currently supports our FreeAgent, QuickBooks Online, and Xero integrations.
+
+## Who is this relevant for?
+
+This update is relevant for all clients using Codat's Bill Pay solution who want to give their customers a seamless bill management experience.
+
+## How to get started?
+
+You can start using the endpoint right now. Check out the [Update bills](https://docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint in our API reference, or explore Bill Pay's [Update bills](/payables/sync/update-bill) documentation for a full walkthrough.
\ No newline at end of file
diff --git a/docs/payables/configure-customer.md b/docs/payables/configure-customer.md
index 328da3312..cc2c6c32a 100644
--- a/docs/payables/configure-customer.md
+++ b/docs/payables/configure-customer.md
@@ -44,7 +44,7 @@ Remember to [authenticate](/using-the-api/authentication) when making calls to o
## Create a company
-Within Bill Pay, a company represents your SMB customer that pays and manages their bills using your application. To create it, use our [Create company (async)](/sync-for-payables-api#/operations/create-company) or [Create company (sync)](/sync-for-payables-v2-api#/operations/create-company) endpoints.
+Within Bill Pay, a company represents your SMB customer that pays and manages their bills using your application. To create it, use our [Create company](/sync-for-payables-v2-api#/operations/create-company) endpoints.
The endpoints return the company schema containing the ID that you will use to establish a connection to an accounting software.
@@ -122,7 +122,7 @@ if companyResponse.StatusCode == 200 {
## Create a connection
-Next, use the [Create connection (async)](/sync-for-payables-api#/operations/create-connection) or [Create connection (sync)](/sync-for-payables-v2-api#/operations/create-connection) endpoints to connect the company to an accounting data source via one of our integrations.
+Next, use the [Create connection](/sync-for-payables-v2-api#/operations/create-connection) endpoints to connect the company to an accounting data source via one of our integrations.
This will allow you to synchronize data with that source, fetching or creating suppliers, bills, and payment methods. In the request body, specify a `platformKey` of the accounting software you're looking to connect.
@@ -225,7 +225,7 @@ fmt.Println(connectionResponse.Connection.LinkUrl)
## Deauthorize a connection
-If your customer wants to revoke their approval and sever the connection to their accounting software, use the [Unlink connection (async)](/sync-for-payables-api#/operations/Unlink-connection) or [Unlink connection (sync)](/sync-for-payables-v2-api#/operations/Unlink-connection) endpoints.
+If your customer wants to revoke their approval and sever the connection to their accounting software, use the [Unlink connection](/sync-for-payables-v2-api#/operations/Unlink-connection) endpoints.
You can [learn more](/auth-flow/optimize/connection-management) about connection management best practices and see how you can provide this functionality in your app's UI.
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
new file mode 100644
index 000000000..35d0a4863
--- /dev/null
+++ b/docs/payables/sync/update-bill.md
@@ -0,0 +1,189 @@
+---
+title: Update bills
+description: "Update existing bills using Codat's Bill Pay solution"
+sidebar_label: Update a bill
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+:::tip Invoices or bills?
+
+We distinguish between invoices where the company _owes_ money and those where the company _is owed_ money. If the company receives an invoice and owes money as a result, we call this a **bill**.
+:::
+
+## Update bill
+
+:::info Software coverage
+
+This action is currently only supported for FreeAgent, QuickBooks Online, and Xero.
+
+:::
+
+In some cases, your SMB customer may want to update their existing bill: for example, to change a tax rate, change a nominal code for a line item, or associate it to a different supplier.
+
+Use our [Update bill](docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint to perform this operation. The following rules apply:
+
+- You can only update the bills in `Open` status, and updates to bills in any other states will be rejected.
+- You can change the `reference`, `supplierRef.id`, `issueDate`, `dueDate`, `currency`, `currencyRate`, and `lineItems[]` values.
+- During the update, all existing bill line items will removed and replaced with new line items.
+
+For integration-specific rules and errors, review the [Software requirements](/payables/sync/pay-bill#software-requirements) section.
+
+
+
+
+
+```json
+
+PUT /companies/{companyId}/connections/{dataConnectionId}/payables/bills/{billId}
+
+{
+ "reference": "INV-001",
+ "supplierRef": { "id": "supplier-id" },
+ "issueDate": "2026-01-28",
+ "dueDate": "2026-02-28",
+ "currency": "GBP",
+ "currencyRate": 1.0,
+ "status": "Open",
+ "lineItems": [
+ {
+ "description": "Service fee",
+ "unitAmount": 100.00,
+ "quantity": 1,
+ "accountRef": { "id": "account-id" },
+ "taxRateRef": { "id": "tax-rate-id" },
+ "taxAmount": 20.00,
+ "trackingRefs": [{ "id": "tracking-id" }]
+ }
+ ]
+}
+
+```
+
+
+
+
+
+#### Example FreeAgent line item update payload
+
+```json
+{
+ "description": "Consulting",
+ "unitAmount": 500,
+ "quantity": 2,
+ "accountRef": { "id": "" },
+ "taxAmount": 200,
+ "trackingRefs": [{ "id": "", "isBillable": true }]
+}
+```
+
+
+
+
+
+#### Example QBO line item update payload
+
+```json
+{
+ "description": "Consulting",
+ "unitAmount": 500,
+ "quantity": 2,
+ "accountRef": { "id": "" },
+ "taxRateRef": { "id": "" }
+}
+```
+
+
+
+
+#### Example Xero line item update payload
+
+```json
+{
+ "description": "Consulting",
+ "unitAmount": 500,
+ "quantity": 2,
+ "accountRef": { "id": "" },
+ "taxRateRef": { "id": "" },
+ "trackingRefs": [{ "id": "" }]
+}
+```
+
+
+
+
+
+### Software requirements
+
+We have summarized the key differences between the integrations that support updates to bills below:
+
+| Feature | FreeAgent | QBO | Xero |
+|--------------------------|----------------------|---------------------|---------------------|
+| **Reference max length** | 255 characters | 21 characters | 255 characters |
+| **`TaxRateRef`** | Must be `null` | Required | Required |
+| **Tax handling** | Use `taxAmount` only | Use `taxRateRef.id` | Use `taxRateRef.id` |
+| **`AccountRef` format** | Nominal code | Numeric string | GUID |
+| **Max line items** | 40 | No limit | No limit |
+
+### Validation errors
+
+You may encounter a validation error when sending a request to update a bill. In the sections below, we've included general and software-specific errors to help resolve these.
+
+#### General validation errors
+
+| Validation | Error message |
+|-----------------------------|---------------------------------------------------------|
+| Missing `supplierRef` | 'Supplier Ref' must not be empty. |
+| Missing `supplierRef.id` | 'Supplier Ref Id' must not be empty. |
+| Missing `issueDate` | 'Issue Date' must not be empty. |
+| Missing `dueDate` | 'Due Date' must not be empty. |
+| Missing currency | 'Currency' must not be empty. |
+| Invalid currency | 'Currency Length' must be equal to '3'. |
+| Currency rate <= 0 | 'Currency Rate' must be greater than '0'. |
+| Missing status | 'Status' must not be empty. |
+| Invalid status | 'Status' must be equal to 'Open'. |
+| Missing or empty line items | 'Line Items' must not be empty. |
+| Negative line items total | sum of LineItems must be greater than or equal to '0'. |
+| Reference too long | 'Reference Length' must be less than or equal to '255'. |
+| Bill not found | 404 Not Found |
+
+#### Software-specific errors
+
+
+
+
+
+| Issue | Error Message |
+|----------------------|-----------------------------------------------|
+| Invalid account code | 'Account Ref' was not found in FreeAgent. |
+| Invalid supplier ID | 'Supplier Ref Id' was not found in FreeAgent. |
+
+
+
+
+
+| Issue | Error message |
+|----------------------------------------|----------------------------------------------------------------------------|
+| Bill currency doesn't match supplier | Ensure that the currency of the bill matches the currency of the supplier. |
+| Supplier doesn't support bill currency | The chosen `supplierId` doesn't handle the bills currency. |
+
+
+
+
+
+| Issue | Error Message |
+|----------------------|-------------------------------------------|
+| Invalid account GUID | 'Account Ref' was not found in Xero. |
+| Invalid supplier ID | 'SupplierRef Id' was not found in Xero. |
+| Currency not enabled | No currency exists for code '{currency}'. |
+
+
+
+
+
+---
+
+## Read next
+
+- Enable your customers to [pay single bills](/payables/sync/pay-bill) to complete the Bill Pay process.
diff --git a/sidebars/payables.js b/sidebars/payables.js
index b636d9170..340349fba 100644
--- a/sidebars/payables.js
+++ b/sidebars/payables.js
@@ -30,6 +30,7 @@ module.exports = [
},
"payables/sync/bills",
"payables/sync/pay-bill",
+ "payables/sync/update-bill",
{
type: "doc",
id: "payables/sync/sync-data-types",
diff --git a/src/components/DataTypes/index.js b/src/components/DataTypes/index.js
index 31afb63ee..9fc120d23 100644
--- a/src/components/DataTypes/index.js
+++ b/src/components/DataTypes/index.js
@@ -49,7 +49,7 @@ const products = {
path: "/sync-for-payables-api",
},
billpaysync: {
- name: "Bill Pay (sync)",
+ name: "Bill Pay",
spec: BillPaySync,
path: "/sync-for-payables-v2-api",
},
diff --git a/src/pages/sync-for-payables-v2-api/index.tsx b/src/pages/sync-for-payables-v2-api/index.tsx
index b85537267..608380118 100644
--- a/src/pages/sync-for-payables-v2-api/index.tsx
+++ b/src/pages/sync-for-payables-v2-api/index.tsx
@@ -5,7 +5,7 @@ const URL = "/oas/Codat-Sync-Payables.json"
const PayablesApi = () => {
return (
-
+
);
}
From 66026a5cfe49251a93fd772f4d507d88970362aa Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 14:49:01 +0000
Subject: [PATCH 02/10] Fix deployment
---
docs/payables/sync/update-bill.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index 35d0a4863..a600e3fe0 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -140,7 +140,7 @@ You may encounter a validation error when sending a request to update a bill. In
| Missing `dueDate` | 'Due Date' must not be empty. |
| Missing currency | 'Currency' must not be empty. |
| Invalid currency | 'Currency Length' must be equal to '3'. |
-| Currency rate <= 0 | 'Currency Rate' must be greater than '0'. |
+| Currency rate = 0 | 'Currency Rate' must be greater than '0'. |
| Missing status | 'Status' must not be empty. |
| Invalid status | 'Status' must be equal to 'Open'. |
| Missing or empty line items | 'Line Items' must not be empty. |
From 7bffd375d38c613e7b242b9d0e73ae63d7ca3eb7 Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 14:54:58 +0000
Subject: [PATCH 03/10] Typos and build fix
---
docs/payables/sync/update-bill.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index a600e3fe0..ece00b185 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -140,11 +140,11 @@ You may encounter a validation error when sending a request to update a bill. In
| Missing `dueDate` | 'Due Date' must not be empty. |
| Missing currency | 'Currency' must not be empty. |
| Invalid currency | 'Currency Length' must be equal to '3'. |
-| Currency rate = 0 | 'Currency Rate' must be greater than '0'. |
+| Currency rate `<= 0` | 'Currency Rate' must be greater than '0'. |
| Missing status | 'Status' must not be empty. |
| Invalid status | 'Status' must be equal to 'Open'. |
| Missing or empty line items | 'Line Items' must not be empty. |
-| Negative line items total | sum of LineItems must be greater than or equal to '0'. |
+| Negative line items total | Sum of `LineItems` must be greater than or equal to '0'. |
| Reference too long | 'Reference Length' must be less than or equal to '255'. |
| Bill not found | 404 Not Found |
From c2c539c56b69e5faad1d291d149b41c4a9aa5a16 Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 15:05:37 +0000
Subject: [PATCH 04/10] Fix deployment
---
docs/payables/sync/update-bill.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index ece00b185..6951afcf8 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -140,7 +140,7 @@ You may encounter a validation error when sending a request to update a bill. In
| Missing `dueDate` | 'Due Date' must not be empty. |
| Missing currency | 'Currency' must not be empty. |
| Invalid currency | 'Currency Length' must be equal to '3'. |
-| Currency rate `<= 0` | 'Currency Rate' must be greater than '0'. |
+| Currency rate `<=0` | 'Currency Rate' must be greater than '0'. |
| Missing status | 'Status' must not be empty. |
| Invalid status | 'Status' must be equal to 'Open'. |
| Missing or empty line items | 'Line Items' must not be empty. |
@@ -176,7 +176,7 @@ You may encounter a validation error when sending a request to update a bill. In
|----------------------|-------------------------------------------|
| Invalid account GUID | 'Account Ref' was not found in Xero. |
| Invalid supplier ID | 'SupplierRef Id' was not found in Xero. |
-| Currency not enabled | No currency exists for code '{currency}'. |
+| Currency not enabled | No currency exists for code 'currency'. |
From 0edd83e7d27b50bc3fb22e5204b3225cfa45bf62 Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 15:21:13 +0000
Subject: [PATCH 05/10] Formatting
---
docs/payables/sync/update-bill.md | 60 +++++++++++++++----------------
1 file changed, 28 insertions(+), 32 deletions(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index 6951afcf8..853907c59 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -12,7 +12,7 @@ import TabItem from "@theme/TabItem";
We distinguish between invoices where the company _owes_ money and those where the company _is owed_ money. If the company receives an invoice and owes money as a result, we call this a **bill**.
:::
-## Update bill
+## Update a bill
:::info Software coverage
@@ -30,6 +30,8 @@ Use our [Update bill](docs.codat.io/sync-for-payables-v2-api#/operations/update-
For integration-specific rules and errors, review the [Software requirements](/payables/sync/pay-bill#software-requirements) section.
+---
+
@@ -63,9 +65,7 @@ PUT /companies/{companyId}/connections/{dataConnectionId}/payables/bills/{billId
-
-
-#### Example FreeAgent line item update payload
+
```json
{
@@ -80,9 +80,7 @@ PUT /companies/{companyId}/connections/{dataConnectionId}/payables/bills/{billId
-
-
-#### Example QBO line item update payload
+
```json
{
@@ -95,9 +93,7 @@ PUT /companies/{companyId}/connections/{dataConnectionId}/payables/bills/{billId
```
-
-
-#### Example Xero line item update payload
+
```json
{
@@ -128,24 +124,24 @@ We have summarized the key differences between the integrations that support upd
### Validation errors
-You may encounter a validation error when sending a request to update a bill. In the sections below, we've included general and software-specific errors to help resolve these.
+You may encounter a validation error when sending a request to update a bill. In the sections below, we`ve included general and software-specific errors to help resolve these.
#### General validation errors
| Validation | Error message |
|-----------------------------|---------------------------------------------------------|
-| Missing `supplierRef` | 'Supplier Ref' must not be empty. |
-| Missing `supplierRef.id` | 'Supplier Ref Id' must not be empty. |
-| Missing `issueDate` | 'Issue Date' must not be empty. |
-| Missing `dueDate` | 'Due Date' must not be empty. |
-| Missing currency | 'Currency' must not be empty. |
-| Invalid currency | 'Currency Length' must be equal to '3'. |
-| Currency rate `<=0` | 'Currency Rate' must be greater than '0'. |
-| Missing status | 'Status' must not be empty. |
-| Invalid status | 'Status' must be equal to 'Open'. |
-| Missing or empty line items | 'Line Items' must not be empty. |
-| Negative line items total | Sum of `LineItems` must be greater than or equal to '0'. |
-| Reference too long | 'Reference Length' must be less than or equal to '255'. |
+| Missing `supplierRef` | `Supplier Ref` must not be empty. |
+| Missing `supplierRef.id` | `Supplier Ref Id` must not be empty. |
+| Missing `issueDate` | `Issue Date` must not be empty. |
+| Missing `dueDate` | `Due Date` must not be empty. |
+| Missing currency | `Currency` must not be empty. |
+| Invalid currency | `Currency Length` must be equal to `3`. |
+| Currency rate `<=0` | `Currency Rate` must be greater than `0`. |
+| Missing status | `Status` must not be empty. |
+| Invalid status | `Status` must be equal to `Open`. |
+| Missing or empty line items | `Line Items` must not be empty. |
+| Negative line items total | Sum of `LineItems` must be greater than or equal to `0`. |
+| Reference too long | `Reference Length` must be less than or equal to `255`. |
| Bill not found | 404 Not Found |
#### Software-specific errors
@@ -154,10 +150,10 @@ You may encounter a validation error when sending a request to update a bill. In
-| Issue | Error Message |
+| Issue | Error message |
|----------------------|-----------------------------------------------|
-| Invalid account code | 'Account Ref' was not found in FreeAgent. |
-| Invalid supplier ID | 'Supplier Ref Id' was not found in FreeAgent. |
+| Invalid account code | `Account Ref` was not found in FreeAgent. |
+| Invalid supplier ID | `Supplier Ref Id` was not found in FreeAgent. |
@@ -165,18 +161,18 @@ You may encounter a validation error when sending a request to update a bill. In
| Issue | Error message |
|----------------------------------------|----------------------------------------------------------------------------|
-| Bill currency doesn't match supplier | Ensure that the currency of the bill matches the currency of the supplier. |
-| Supplier doesn't support bill currency | The chosen `supplierId` doesn't handle the bills currency. |
+| Bill currency doesn`t match supplier | Ensure that the currency of the bill matches the currency of the supplier. |
+| Supplier doesn`t support bill currency | The chosen `supplierId` doesn`t handle the bills currency. |
-| Issue | Error Message |
+| Issue | Error message |
|----------------------|-------------------------------------------|
-| Invalid account GUID | 'Account Ref' was not found in Xero. |
-| Invalid supplier ID | 'SupplierRef Id' was not found in Xero. |
-| Currency not enabled | No currency exists for code 'currency'. |
+| Invalid account GUID | `Account Ref` was not found in Xero. |
+| Invalid supplier ID | `SupplierRef Id` was not found in Xero. |
+| Currency not enabled | No currency exists for code `currency`. |
From 8946a0a7d11bf6b41343db3004bf8a99a90d714c Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 15:22:29 +0000
Subject: [PATCH 06/10] More formatting
---
docs/payables/sync/update-bill.md | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index 853907c59..56cf7b0c5 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -25,8 +25,15 @@ In some cases, your SMB customer may want to update their existing bill: for exa
Use our [Update bill](docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint to perform this operation. The following rules apply:
- You can only update the bills in `Open` status, and updates to bills in any other states will be rejected.
-- You can change the `reference`, `supplierRef.id`, `issueDate`, `dueDate`, `currency`, `currencyRate`, and `lineItems[]` values.
- During the update, all existing bill line items will removed and replaced with new line items.
+- You can change the following values:
+ - `reference`
+ - `supplierRef.id`
+ - `issueDate`
+ - `dueDate`
+ - `currency`
+ - `currencyRate`
+ - `lineItems[]`
For integration-specific rules and errors, review the [Software requirements](/payables/sync/pay-bill#software-requirements) section.
From efcb17eb05c5644c877bf866e17f51c01087903b Mon Sep 17 00:00:00 2001
From: Polina
Date: Thu, 19 Feb 2026 15:27:23 +0000
Subject: [PATCH 07/10] Formatting
---
docs/payables/sync/update-bill.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index 56cf7b0c5..d8b35ef7c 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -39,12 +39,13 @@ For integration-specific rules and errors, review the [Software requirements](/p
---
+### Example payloads
+
```json
-
PUT /companies/{companyId}/connections/{dataConnectionId}/payables/bills/{billId}
{
@@ -67,7 +68,6 @@ PUT /companies/{companyId}/connections/{dataConnectionId}/payables/bills/{billId
}
]
}
-
```
From ff2346d932c37ff02e41b0034848909803089113 Mon Sep 17 00:00:00 2001
From: Polina <112084241+pzaichkina@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:02:24 +0000
Subject: [PATCH 08/10] Fix links in Update Bills Bill Pay documentation
---
blog/260219-update-bills-bill-pay.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/blog/260219-update-bills-bill-pay.md b/blog/260219-update-bills-bill-pay.md
index a6af9db63..8daaf5d01 100644
--- a/blog/260219-update-bills-bill-pay.md
+++ b/blog/260219-update-bills-bill-pay.md
@@ -11,7 +11,7 @@ You can now update existing bills directly through our Bill Pay solution.
## What's new?
-We've expanded our [Bill Pay](/payables/overview) solution with the new [Update bills](https://docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint.
+We've expanded our [Bill Pay](/payables/overview) solution with the new [Update bills](/sync-for-payables-v2-api#/operations/update-bill) endpoint.
No more deleting and recreating bills just to fix a typo or a changed line item. With this update, your customers can edit bills in their accounting software, and we will automatically sync these changes to your platform, keeping the records accurate and up-to-date.
@@ -23,4 +23,4 @@ This update is relevant for all clients using Codat's Bill Pay solution who want
## How to get started?
-You can start using the endpoint right now. Check out the [Update bills](https://docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint in our API reference, or explore Bill Pay's [Update bills](/payables/sync/update-bill) documentation for a full walkthrough.
\ No newline at end of file
+You can start using the endpoint right now. Check out the [Update bills](/sync-for-payables-v2-api#/operations/update-bill) endpoint in our API reference, or explore Bill Pay's [Update bills](/payables/sync/update-bill) documentation for a full walkthrough.
From 468b3808ed2c8022d1e5f6fb117895d1eeb04fac Mon Sep 17 00:00:00 2001
From: Polina <112084241+pzaichkina@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:03:28 +0000
Subject: [PATCH 09/10] Fix link format in update-bill.md
Updated link format for the Update bill endpoint.
---
docs/payables/sync/update-bill.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index d8b35ef7c..666dc5ce6 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -22,7 +22,7 @@ This action is currently only supported for FreeAgent, QuickBooks Online, and Xe
In some cases, your SMB customer may want to update their existing bill: for example, to change a tax rate, change a nominal code for a line item, or associate it to a different supplier.
-Use our [Update bill](docs.codat.io/sync-for-payables-v2-api#/operations/update-bill) endpoint to perform this operation. The following rules apply:
+Use our [Update bill](/sync-for-payables-v2-api#/operations/update-bill) endpoint to perform this operation. The following rules apply:
- You can only update the bills in `Open` status, and updates to bills in any other states will be rejected.
- During the update, all existing bill line items will removed and replaced with new line items.
From 0fbe0f1b3df62e4e2df420c3ff84b9c4eb07389f Mon Sep 17 00:00:00 2001
From: Polina <112084241+pzaichkina@users.noreply.github.com>
Date: Thu, 19 Feb 2026 17:06:10 +0000
Subject: [PATCH 10/10] Fix link to software requirements in update-bill.md
---
docs/payables/sync/update-bill.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/payables/sync/update-bill.md b/docs/payables/sync/update-bill.md
index 666dc5ce6..cf5da57d1 100644
--- a/docs/payables/sync/update-bill.md
+++ b/docs/payables/sync/update-bill.md
@@ -35,7 +35,7 @@ Use our [Update bill](/sync-for-payables-v2-api#/operations/update-bill) endpoin
- `currencyRate`
- `lineItems[]`
-For integration-specific rules and errors, review the [Software requirements](/payables/sync/pay-bill#software-requirements) section.
+For integration-specific rules and errors, review the [Software requirements](/payables/sync/update-bill#software-requirements) section.
---