---
title: "Update many"
method: PATCH
path: "/v1/erp/payouts/payables/update_many"
tags: ["Payable"]
---

# Update many

`PATCH /v1/erp/payouts/payables/update_many`

Updates many payable

## Parameters

- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/0` — unresolved $ref
- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/1` — unresolved $ref
- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/2` — unresolved $ref
- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/3` — unresolved $ref
- `#/paths/~1v1~1erp~1payouts~1rules/get/parameters/4` — unresolved $ref
- `#/paths/~1v1~1erp~1payouts~1reviews/get/parameters/5` — unresolved $ref

## Request body

- object
  - `company_id` string, uuid, required — Required. If missing, the request fails with 412 Precondition Failed.
  - `scope` 'all' | 'partial', required — Required. If missing, the request fails with 412 Precondition Failed. The scope of the update. If the scope is `all`, all the payables of the company (filtered by the query parameters) will be updated. Otherwise, only the payables with the ids provided in `ids` will be updated.
  - `ids` string[] — The ids of the payables to update when the scope is not `all`.
  - `due_date` string, date-time
  - `description` string
  - `payment_date` string, date-time — The scheduled/expected payment date to apply to the selected payables.
  - `payment_status` 'paid' | 'partially_paid' | 'non_paid' — Only applied for callers with the `erp_tradables_manage` permission on every selected payable's company; ignored otherwise.
  - `discarded` boolean — Whether the payable has been discarded or not. A discarded payable will not be obtained in the index.
  - `partially_paid_amount` integer — The amount that has been paid for this payable. This amount is not necessarily the same as the total paid amount of the payable.
  - `review_status` 'pending' | 'approved' | 'declined' — Approval state to apply to the selected payables.
  - `reviewers` object[] — Reviewers to assign to the selected payables.
    - `user_id` string, uuid
  - `custom_column_values` object[] — Custom column values to set on the selected payables.
    - `custom_column_id` string, uuid
    - `value` string

## Response `200`

Body of the updated payable.

- Payable[]
  - `id` string, uuid, required
  - `source_type` string
  - `source_id` string
  - `amount` integer, required
  - `status` 'uninitiated' | 'in_review' | 'approved', required
  - `due_date` string, date-time — The date in which the payable is due.
  - `payment_status` 'paid' | 'partially_paid' | 'non_paid'
  - `company_id` string, uuid, required
  - `issue_date` string, date-time — The date in which the payable was issued.
  - `currency` string, required
  - `document_type` integer, required — An integer representing the type of document. Refer to the `document_types` mapping for possible values and their corresponding document types.
  - `sender_id` string, uuid
  - `recipient_id` string, uuid
  - `counterpart_company_id` string, uuid, required — The id of the counterpart company. This is the company that will receive the payment.
  - `description` string
  - `discarded` boolean — Whether the payable has been discarded or not. A discarded payable will not be obtained in the index.
  - `partially_paid_amount` integer
  - `paid_amount` integer — The amount that has been paid for this payable. This amount is calculated using the partially_paid_amount param, the amount of the bank transactions related to the payable and the amount of the credit notes related.
  - `counterpart_company` object
    - `id` string
    - `name` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `reviewers` Reviewer[]
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `user_id` string, uuid, required — The id of the user that is the reviewer.
    - `source_id` string, uuid, required — The id of the object being reviewed (payable or purchase order).
    - `source_type` string, required — The polymorphic type of the object being reviewed, e.g. `Erp::Payouts::Payable` or `Erp::Payouts::PurchaseOrder`.
    - `level` integer — The approval level of this reviewer in the review chain.
    - `enabled` boolean — Whether this reviewer is currently active in the review chain.
    - `approved` boolean — Whether this reviewer has approved. Derived server-side; not modifiable through the endpoints.
    - `current_status` 'comment' | 'file' | 'approval' | 'change_request' — The current status of the review. This is not modifiable using the endpoints.
    - `user` User — unresolved $ref
    - `role` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `412` — Precondition Failed — a required parameter is missing. Both `company_id` and `scope` are required; omitting either returns 412 with a body like `{"message": "param is missing or the value is empty or invalid: scope"}`.
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)