Merge branch 'main' into feat/si-reporting

Author: pzaichkina

blog/260304-dynamic-branded-link-urls.md

@@ -0,0 +1,44 @@
+---
+title: "Dynamic client-branded Hosted Link URLs"
+date: "2026-03-04"
+tags: ["Product", "Update", "Link"]
+authors: pmckinney
+---
+
+Every client using our Hosted Link auth flow now automatically gets a personalized branded Link URL.
+
+<!--truncate-->
+
+## What's new?
+
+When you create a company and share a [Hosted Link](/auth-flow/authorize-hosted-link) URL from the [Codat Portal](https://app.codat.io), the URL now automatically includes a URL-safe version of your Codat client name. For example, if your client name is "Platypus Payments", your Link URLs will look like this:
+
+```
+link.codat.io/platypus-payments/company/{companyId}
+```
+
+Previously, [Hosted Link](/auth-flow/authorize-hosted-link) clients who wanted a custom Link URL, had to ask us for a manual code change. Our new approach generates branded URLs dynamically based on your client name, so every client benefits from a professional, branded experience from day one.
+
+:::tip Existing URLs are unaffected
+All existing Hosted Link URLs won't change and will continue to work exactly as before. 
+
+Any current workflows or methods of generating Link URLs (such as via API or using the **Invite company** button) are unaffected by this change and won't have a custom URL.
+:::
+
+### Why does this matter?
+
+- **Instant branding:** Your branded Link URL is ready from the instant you start using Codat.
+- **Increased trust:** Your customers recognize your company name in the URL when connecting their financial data.
+- **Professional experience:** Every Link URL you share is consistent and on-brand, delivering a polished onboarding experience.
+
+This update builds on our recently added [enhanced company branding in Link](/updates/260218-link-branding-updates), which introduced logos, brand colors, and hero images to the Link flow. Together, these updates mean your brand is present from the first thing your customers see all the way through the connection experience.
+
+## Who is this relevant for?
+
+This update applies to all clients using [Hosted Link](/auth-flow/authorize-hosted-link).
+
+## How to get started?
+
+No action is required. From **March 13, 2026**, your newly generated Link URLs will automatically use your client name. All existing URLs will continue to function as expected.
+
+To further customize the Link experience with your logo, brand colors, and hero image, see our documentation on [Branding settings](/auth-flow/customize/branding) and [Link settings](/auth-flow/customize/customize-link).

blog/260402-java-sdk-deprecation.md

@@ -0,0 +1,58 @@
+---
+title: "2026-04-02: Deprecation of Java client SDK"
+date: "2026-03-05"
+tags: ["Deprecation"]
+authors: vpellcodat
+---
+
+On **April 2, 2026**, Codat will deprecate and archive the [Java client SDK](https://github.com/codatio/client-sdk-java).
+
+<!--truncate-->
+
+To focus our efforts on the SDKs where we can deliver the most value, we are deprecating the Java client SDK across all Codat solutions. 
+
+Instead, we will concentrate our resources on our more widely adopted [TypeScript](https://github.com/codatio/client-sdk-typescript), [Python](https://github.com/codatio/client-sdk-python), [C#](https://github.com/codatio/client-sdk-csharp), and [Go](https://github.com/codatio/client-sdk-go) SDKs.
+
+## What's changing
+
+The Java client SDK will no longer be maintained across all Codat solutions. This includes all packages published under the `io.codat` group on [Maven Central](https://search.maven.org/search?q=g:io.codat):
+
+| Package | Maven Central artifact |
+| --- | --- |
+| **Platform** | `io.codat:platform` |
+| **Bank Feeds** | `io.codat:bank-feeds` |
+| **Sync for Commerce** | `io.codat:sync.commerce` |
+| **Sync for Expenses** | `io.codat:sync.expenses` |
+| **Lending** | `io.codat:lending` |
+| **Sync for Payroll** | `io.codat:sync.payroll` |
+| **Sync for Payables** | `io.codat:sync.payables` |
+| **Accounting** | `io.codat:accounting` |
+| **Banking** | `io.codat:banking` |
+
+After **April 2, 2026**:
+
+- We will **stop publishing new versions** of these packages.
+- We **won't** address bugs, security updates, or compatibility issues.
+- The [GitHub repository](https://github.com/codatio/client-sdk-java) will be **archived** (read-only).
+- Existing published versions will **remain available** on Maven Central and your current builds will not break.
+
+## Alternatives
+
+Codat's APIs remain fully available to Java applications. If you are currently using the Java SDK, you can:
+
+- **Call Codat's REST APIs directly** using any Java HTTP client, such as the built-in `java.net.http.HttpClient` or libraries like OkHttp and Retrofit. Our [API reference](https://docs.codat.io/using-the-api/overview) documents all available endpoints.
+- **Switch to a supported SDK** if your stack allows. 
+
+    Our [TypeScript](https://github.com/codatio/client-sdk-typescript), [Python](https://github.com/codatio/client-sdk-python), [C#](https://github.com/codatio/client-sdk-csharp), and [Go](https://github.com/codatio/client-sdk-go) SDKs are actively maintained and receive regular updates.
+
+## Action required
+
+If you don't use the Java SDK, no action is required on your part.
+
+If you use the Java SDK, migrate to direct API calls or a supported SDK before **April 2, 2026**. 
+
+If you have questions or need assistance, reach out to your dedicated Codat representative or contact our [support team](mailto:support@codat.io).
+
+## Expected impact if no action is taken
+
+Your existing builds will continue to work since published versions remain available on Maven Central. However, you will no longer receive bug fixes, security patches, or compatibility updates for these packages, and the SDK will fall increasingly out of date with Codat's APIs over time.

blog/authors.yml

@@ -134,4 +134,10 @@ psimpson:
   name: Peter Simpson
   title: Senior Support Engineer
   url: https://github.com/pj-simpson
-  image_url: https://github.com/pj-simpson.png
+  image_url: https://github.com/pj-simpson.png
+
+vpellcodat:
+  name: Veronica Pell
+  title: Engineering Manager
+  url: https://github.com/vpellcodat
+  image_url: https://github.com/vpellcodat.png

static/oas/Codat-Sync-Expenses.json

@@ -2507,7 +2507,7 @@
       "put": {
         "summary": "Update reimbursable expense transaction",
         "operationId": "update-reimbursable-expense-transaction",
-        "description": "The *Update reimbursable expense* endpoint updates an existing employee expense claim in the accounting platform for a given company's connection. \r\n\r\nUpdating an existing [reimbursable expense transaction](https://docs.codat.io/sync-for-expenses-api#/schemas/UpdateReimbursableExpenseTransactionRequest) will update the existing **bill** against an employee (who exists as a supplier in the accounting software).\r\n\r\n### Supported Integrations\r\n| Integration           | Supported |\r\n|-----------------------|-----------|\r\n| FreeAgent             | Yes       |\r\n| QuickBooks Online     | Yes       |\r\n| Oracle NetSuite       | Yes       |\r\n| Sage Intacct          | Yes       |\r\n| Zoho Books            | Yes       |",
+        "description": "The *Update reimbursable expense* endpoint updates an existing employee expense claim in the accounting platform for a given company's connection. \r\n\r\nUpdating an existing [reimbursable expense transaction](https://docs.codat.io/sync-for-expenses-api#/schemas/UpdateReimbursableExpenseTransactionRequest) will update the existing **bill** against an employee (who exists as a supplier in the accounting software).\r\n\r\n### Supported Integrations\r\n| Integration           | Supported |\r\n|-----------------------|-----------|\r\n| FreeAgent             | Yes       |\r\n| QuickBooks Online     | Yes       |\r\n| Oracle NetSuite       | Yes       |\r\n| Zoho Books            | Yes       |\r\n\r\n",
         "tags": [
           "Reimbursements"
         ],
@@ -13897,7 +13897,7 @@
             "$ref": "#/components/responses/Service-Unavailable"
           }
         },
-        "description": "The *List suppliers* endpoint returns a list of [suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) for a given company's connection.\n\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\n\nBefore using this endpoint, you must have [retrieved data for the company](https://docs.codat.io/sync-for-expenses-api#/operations/refresh-company-data).\n    ",
+        "description": "The *List suppliers* endpoint returns a list of [suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) for a given company's connection.\n\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\n\nBefore using this endpoint, you must have [retrieved data for the company](https://docs.codat.io/sync-for-expenses-api#/operations/refresh-all-data-types).\n\n### Supported Integrations\n\n| Integration                   | Supported |\n|-------------------------------|-----------|\n| Dynamics 365 Business Central | Yes       |\n| FreeAgent                     | Yes       |\n| Oracle NetSuite               | Yes       |\n| QuickBooks Desktop            | Yes       |\n| QuickBooks Online             | Yes       |\n| Sage Intacct                  | Yes       |\n| Xero                          | Yes       |\n| Zoho Books                    | Yes       |\n",
         "operationId": "list-suppliers"
       }
     },
@@ -14332,7 +14332,7 @@
             "$ref": "#/components/responses/Service-Unavailable"
           }
         },
-        "description": "The *Get supplier* endpoint returns a single supplier for a given supplierId.\n\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\n\nBefore using this endpoint, you must have [retrieved data for the company](https://docs.codat.io/sync-for-expenses-api#/operations/refresh-company-data).\n",
+        "description": "The *Get supplier* endpoint returns a single supplier for a given supplierId.\n\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\n\nBefore using this endpoint, you must have [retrieved data for the company](https://docs.codat.io/sync-for-expenses-api#/operations/refresh-all-data-types).\n\n### Supported Integrations\n\n| Integration                   | Supported |\n|-------------------------------|-----------|\n| Dynamics 365 Business Central | Yes       |\n| FreeAgent                     | Yes       |\n| Oracle NetSuite               | Yes       |\n| QuickBooks Desktop            | Yes       |\n| QuickBooks Online             | Yes       |\n| Sage Intacct                  | Yes       |\n| Xero                          | Yes       |\n| Zoho Books                    | Yes       |\n",
         "operationId": "get-supplier"
       }
     },
@@ -14414,7 +14414,7 @@
           }
         },
         "summary": "Create supplier",
-        "description": "The *Create supplier* endpoint creates a new [supplier](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) for a given company's connection.\r\n\r\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\r\n\r\n**Integration-specific behavior**\r\n\r\nRequired data may vary by integration. To see what data to post, first call [Get create/update supplier model](https://docs.codat.io/sync-for-expenses-api#/operations/get-create-update-suppliers-model).\r\n",
+        "description": "The *Create supplier* endpoint creates a new [supplier](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) for a given company's connection.\n\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\n\n**Integration-specific behavior**\n\nRequired data may vary by integration. To see what data to post, first call [Get create/update supplier model](https://docs.codat.io/sync-for-expenses-api#/operations/get-create-update-suppliers-model).\n\n### Supported Integrations\n\n| Integration                   | Supported |\n|-------------------------------|-----------|\n| Dynamics 365 Business Central | Yes       |\n| FreeAgent                     | Yes       |\n| Oracle NetSuite               | Yes       |\n| QuickBooks Desktop            | Yes       |\n| QuickBooks Online             | Yes       |\n| Sage Intacct                  | Yes       |\n| Xero                          | Yes       |\n| Zoho Books                    | Yes       |\n",
         "operationId": "create-supplier"
       }
     },
@@ -14492,7 +14492,7 @@
           }
         },
         "summary": "Update supplier",
-        "description": "The *Update supplier* endpoint updates an existing [supplier](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) for a given company's connection.\r\n\r\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\r\n\r\n**Integration-specific behavior**\r\n\r\nRequired data may vary by integration. To see what data to post, first call [Get create/update supplier model](https://docs.codat.io/sync-for-expenses-api#/operations/get-create-update-suppliers-model).",
+        "description": "The *Update supplier* endpoint updates an existing [supplier](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) for a given company's connection.\n\n[Suppliers](https://docs.codat.io/sync-for-expenses-api#/schemas/Supplier) are people or organizations that provide something, such as a product or service.\n\n**Integration-specific behavior**\n\nRequired data may vary by integration. To see what data to post, first call [Get create/update supplier model](https://docs.codat.io/sync-for-expenses-api#/operations/get-create-update-suppliers-model).\n\n### Supported Integrations\n\n| Integration       | Supported |\n|-------------------|-----------|\n| FreeAgent         | Yes       |\n| QuickBooks Online | Yes       |\n| Xero              | Yes       |\n",
         "operationId": "update-supplier"
       }
     }