> For the complete documentation index, see [llms.txt](https://docs.xyb.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xyb.co/credit/create-and-manage-contracts/manage-credit-contracts-and-terms.md).
# Manage Credit Contracts and Terms
Once a credit contract has been created, it may evolve throughout its lifecycle. Operations teams need the tools to **review, edit, and manage all contract elements** to keep the facility accurate, active, and aligned with the customer’s activity.
#### Contract Activation & Versioning
After a new contract is created, it is often in **Passive** status. Before it becomes usable, it must go through:
1. **Signing:** Confirming term dates and conditions.
2. **Activation:** Making the contract live.
Once a contract is edited (e.g., change in amount, schedule, or terms), a **new version** is created. This version needs to be:\
* Signed and approved
* Activated again
***
#### Financials
View a breakdown of principal, interest, penalty, fees, VAT, and total balance. Click **"View transactions"** to see all ledger movements and repayment activity tied to the contract.
***
#### Manage Contract Terms
The **Contract Terms** section displays all contractual parameters, such as product, amount, interest, and validity dates.
Click **New term** to apply changes like extra payout, early termination, or repayment. You can also select **View all** to see a complete history of terms applied to the contract.
Note that every change must be: Signed, approved, and activated again to come into effect.
Under **Edit Term**, you can also update existing terms by selecting a specific term change type such as termination, full repayment, partial payback, extra payout, or regular term adjustments. Once the necessary values are entered, the system recalculates the schedule, updates invoices where needed, and applies the appropriate new contract status.
#### **Schedule Parameters and Active Schedule**
The **Schedule parameters** section defines how the contract is structured over time, including schedule type (e.g. annuity), frequency, and duration. Below that, **Schedule active** lists each scheduled payment with a breakdown of principal, interest, and fees—plus current status and payment details.
#### Relations
The **Relations** section allows you to associate the contract with other entities, such as a guarantor, co-borrower, or a business. You can search for an existing entity by name, ID, or registration number, then specify the type of relationship and its valid duration. This ensures transparency and traceability of all related parties involved in the contract.
#### Documents
In the **Documents** section, you can upload any files tied to the contract, such as signed agreements, identification documents, or supporting materials. You can specify the document type and give it a name, and also choose whether it's visible to external users (such as the borrower) or kept internal. This helps centralize all relevant documentation in one place.
#### Related Tasks
If any pending actions are linked to the contract such as approvals or manual steps, they appear under **Related tasks**, helping you keep track of what’s needed next.
#### Write off
You also have the option to write off outstanding amounts if a customer is unable to repay their debt; this action is available from the top-right of the contract page.
When you open the write-off dialog, you can adjust the amounts for principal, loan balance, interest, accrued interest, penalties, fees, and tax/VAT to partially or fully reduce the receivables. After saving, the system automatically generates the necessary ledger write-off transactions, allocates the written-off amounts to invoices starting from the oldest, and updates the contract and invoice statuses accordingly.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.xyb.co/credit/create-and-manage-contracts/manage-credit-contracts-and-terms.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
