> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.noyax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Finance

> Bank definitions, bank accounts and bank vouchers (transfers, openings, internal transfers, credit card collections).

The Finance module covers the bank and cash records the company uses for money movements. Right now the **Bank** sub-module's definitions, repayment plans, and transfer/opening/internal transfer/credit card collection vouchers are available; other bank voucher types and the **Cash** sub-module are coming soon.

## Bank

| Operation                            | Endpoint                                                                                               |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------ |
| List banks                           | [`GET /finance/banks`](/en/v1/finance/banks/list)                                                      |
| Create/update/delete a bank          | [`/finance/banks`](/en/v1/finance/banks/create)                                                        |
| List bank accounts                   | [`GET /finance/bank-accounts`](/en/v1/finance/bank-accounts/list)                                      |
| Create/update/delete a bank account  | [`/finance/bank-accounts`](/en/v1/finance/bank-accounts/create)                                        |
| List a POS account's repayment plans | [`GET /finance/bank-accounts/{id}/repayment-plans`](/en/v1/finance/bank-accounts/repayment-plans/list) |
| List bank transfer vouchers          | [`GET /finance/bank-transfers`](/en/v1/finance/bank-transfers/list)                                    |
| List bank opening vouchers           | [`GET /finance/bank-openings`](/en/v1/finance/bank-openings/list)                                      |
| List bank internal transfer vouchers | [`GET /finance/bank-internal-transfers`](/en/v1/finance/bank-internal-transfers/list)                  |
| List credit card collection vouchers | [`GET /finance/credit-card-collections`](/en/v1/finance/credit-card-collections/list)                  |

A **Bank** is a simple definition referenced by `BankName` when creating a record (see [matching by text](/en/v1/definitions/overview)). A **bank account** is the company's own operational bank account — do not confuse it with a customer's own bank account info (`/customers/{customerId}/bank-accounts`), which is reference information the customer gave you and creates no money movement.

Accounts with `AccountType` 3 (POS account) can also carry [repayment plan and commission rate](/en/v1/finance/bank-accounts/repayment-plans/list) records.

Four voucher types are available:

* [Bank transfers](/en/v1/finance/bank-transfers/overview) and [credit card collections](/en/v1/finance/credit-card-collections/overview): record money coming into or going out of a bank account against one or more customers (a single account chosen at the header, shared by every line; each line also writes a customer movement). A credit card collection has the same shape as an incoming bank transfer, plus a POS charge date and an optional repayment plan (with an API-calculated value date).
* [Bank openings](/en/v1/finance/bank-openings/overview) and [bank internal transfers](/en/v1/finance/bank-internal-transfers/overview): produce no customer movement — each line picks its own bank account and carries a `Debit`/`Credit` amount; an internal transfer requires the lines' total debit to equal their total credit, an opening does not.

All four share the same `"BANKAFİŞNO"` number series and voucher number uniqueness (across all bank voucher types).

## Permissions

Both reading and writing are protected by `ApiPolicies.FinanceRead`/`FinanceWrite` (the 8th digit of the `P` claim). Unlike the Definition module, Finance has its own dedicated permission; reading also requires a valid Finance read permission.