---
title: "Create bank transactions"
method: POST
path: "/consumers/{consumer_id}/accounting/bank-transactions"
tags: ["Accounting", "Bank transactions"]
---

# Create bank transactions

`POST /consumers/{consumer_id}/accounting/bank-transactions`

Create new bank transactions

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `folder_id` string, nullable

## Request body

- BankStatementItemIn
  - `bank_statement_date` string, date, required — Date of the bank statement
  - `bank_account_id` string, required — Unique ID of the bank account in the accounting system
  - `currency` string, required — Currency of the bank statement. This must be the same as the currency of the bank account.
  - `external_bank_statement_id` string, required — External bank statement ID. To be compatible with all software, we recommend to use only digits with a maximum length of 10.
  - `opening_balance` number, nullable — Opening balance of the bank account before the statement
  - `pdf` string, nullable — Base64 PDF attachment of the bank statement.
  - `pdf_name` string, nullable — A name for the PDF file to be created for accounting software that support it.
  - `items` BankTransactionItemIn[], required — List of transaction items
    - `general_ledger_account` string, nullable — Number of the general ledger account to book the transaction against.
    - `description` string, nullable — Transaction description
    - `external_transaction_id` string, nullable — External transaction ID
    - `amount` number, required — Total amount including fee and tax
    - `fee_amount` number, nullable — Fee amount
    - `tax_amount` number, nullable — Tax amount
    - `currency_exchange_rate` number, nullable — Exchange rate applicable at the transaction date
    - `counterpart` BankTransactionCounterpartItem
      - `counterpart_type` 'customer' | 'supplier' | 'employee'
      - `id` string, nullable — ID of the counterpart in the accounting system
      - `name` string, nullable — Name of the counterpart
      - `iban` string, nullable — IBAN of the counterpart
      - `bank_account` string, nullable — Bank account number of the counterpart

## Response `200`

Successful Response

- BankStatementItemOut
  - `bank_statement_date` string, date, required — Date of the bank statement
  - `bank_account_id` string, required — Unique ID of the bank account in the accounting system
  - `currency` string, required — Currency of the bank statement. This must be the same as the currency of the bank account.
  - `id` string, nullable — Internal bank statement ID generated by the accounting system
  - `external_bank_statement_id` string, nullable — External bank statement ID
  - `items` BankTransactionItemOut[], required — List of transaction items with their IDs
    - `general_ledger_account` string, nullable — Number of the general ledger account to book the transaction against.
    - `description` string, nullable — Transaction description
    - `external_transaction_id` string, nullable — External transaction ID
    - `amount` number, required — Total amount including fee and tax
    - `fee_amount` number, nullable — Fee amount
    - `tax_amount` number, nullable — Tax amount
    - `currency_exchange_rate` number, nullable — Exchange rate applicable at the transaction date
    - `counterpart` BankTransactionCounterpartItem
      - `counterpart_type` 'customer' | 'supplier' | 'employee'
      - `id` string, nullable — ID of the counterpart in the accounting system
      - `name` string, nullable — Name of the counterpart
      - `iban` string, nullable — IBAN of the counterpart
      - `bank_account` string, nullable — Bank account number of the counterpart
    - `id` string, nullable — Internal transaction ID generated by the accounting system

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/versions/b5f1214a482a/schema)