---
title: "Record Gl Payment"
method: POST
path: "/companies/{company_id}/gl/payments"
tags: ["gl-actions"]
---

# Record Gl Payment

`POST /companies/{company_id}/gl/payments`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/gl/payments`
- Auth: none declared

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- GlPaymentCreate
  - `direction` 'incoming' | 'outgoing', required
  - `counterparty_id` string, nullable
  - `bank_gl_account_id` string, required
  - `gl_period_id` string, required
  - `posting_date` string, date, required
  - `currency` string
  - `amount` union, required
    - number
    - string
  - `allocations` GlAllocationIn[], required
    - `open_item_id` string, required
    - `control_account_id` string, required
    - `allocated_amount` union, required
      - number
      - string
    - `writeoff_amount` union
      - number
      - string
  - `bank_account_id` string, nullable
  - `bank_entry_id` string, nullable

## Response `201`

Successful Response

- GlPaymentOut
  - `id` string, required
  - `company_id` string, required
  - `direction` string, required
  - `counterparty_id` string, nullable
  - `bank_account_id` string, nullable
  - `bank_entry_id` string, nullable
  - `amount` string, required
  - `currency` string, required
  - `status` string, required
  - `payment_date` string, date, required
  - `journal_entry_id` string, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)