---
title: "PATCH /v1/business/{business_id}/settlement/{settlement_id}/"
method: PATCH
path: "/v1/business/{business_id}/settlement/{settlement_id}/"
tags: ["settlement"]
---

# PATCH /v1/business/{business_id}/settlement/{settlement_id}/

`PATCH /v1/business/{business_id}/settlement/{settlement_id}/`

## Path parameters

- `business_id` integer, required
- `settlement_id` integer, required

## Request body

- PatchedSettlementRetrieveUpdate
  - `id` integer
  - `title` string
  - `amount` integer
  - `status` 'C' | 'D' | 'S' | 'P' — * `C` - 정산 예정 * `D` - 정산 지연 * `S` - 정산 완료 * `P` - 정산 중단
  - `type` 'I' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | 'B' — * `I` - 착수금 * `1` - 1차 중도금 * `2` - 2차 중도금 * `3` - 3차 중도금 * `4` - 4차 중도금 * `5` - 5차 중도금 * `6` - 6차 중도금 * `7` - 7차 중도금 * `8` - 8차 중도금 * `9` - 9차 중도금 * `10` - 10차 중도금 * `11` - 11차 중도금 * `12` - 12차 중도금 * `13` - 13차 중도금 * `14` - 14차 중도금 * `15` - 15차 중도금 * `16` - 16차 중도금 * `17` - 17차 중도금 * `18` - 18차 중도금 * `19` - 19차 중도금 * `20` - 20차 중도금 * `B` - 잔금
  - `dueDate` string, date, nullable
  - `settledDate` string, date, nullable
  - `order` integer
  - `updated` string, date-time
  - `isTaxInvoiceIssued` boolean
  - `isTaxInvoiceNeeded` boolean
  - `isHidden` boolean
  - `contract` SettlementContractForRetrieve
    - `id` integer, required
    - `title` string, required
    - `amount` integer, required
    - `startDate` string, date, required
    - `endDate` string, date, required
    - `status` 'P' | 'I' | 'C' | 'T', required — * `P` - 계약 준비 중 * `I` - 정산 진행 중 * `C` - 계약 종료 * `T` - 계약 중단
    - `isInitialPayment` boolean, required
    - `isInstallmentPayment` boolean, required
    - `isBalancePayment` boolean, required
    - `installmentPaymentCount` integer, required
  - `historySet` SettlementHistoryListCreate[]
    - `id` integer, required
    - `member` SettlementHistoryMember, required
      - `memberId` integer, required
      - `email` string, required
      - `profileImage` string, uri, required
      - `nickname` string, required
    - `content` string, required
    - `created` string, date-time, required
    - `isOwn` boolean, required

## Response `200`

- SettlementRetrieveUpdate
  - `id` integer, required
  - `title` string, required
  - `amount` integer, required
  - `status` 'C' | 'D' | 'S' | 'P', required — * `C` - 정산 예정 * `D` - 정산 지연 * `S` - 정산 완료 * `P` - 정산 중단
  - `type` 'I' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18' | '19' | '20' | 'B', required — * `I` - 착수금 * `1` - 1차 중도금 * `2` - 2차 중도금 * `3` - 3차 중도금 * `4` - 4차 중도금 * `5` - 5차 중도금 * `6` - 6차 중도금 * `7` - 7차 중도금 * `8` - 8차 중도금 * `9` - 9차 중도금 * `10` - 10차 중도금 * `11` - 11차 중도금 * `12` - 12차 중도금 * `13` - 13차 중도금 * `14` - 14차 중도금 * `15` - 15차 중도금 * `16` - 16차 중도금 * `17` - 17차 중도금 * `18` - 18차 중도금 * `19` - 19차 중도금 * `20` - 20차 중도금 * `B` - 잔금
  - `dueDate` string, date, nullable, required
  - `settledDate` string, date, nullable, required
  - `order` integer, required
  - `updated` string, date-time, required
  - `isTaxInvoiceIssued` boolean, required
  - `isTaxInvoiceNeeded` boolean, required
  - `isHidden` boolean, required
  - `contract` SettlementContractForRetrieve, required
    - `id` integer, required
    - `title` string, required
    - `amount` integer, required
    - `startDate` string, date, required
    - `endDate` string, date, required
    - `status` 'P' | 'I' | 'C' | 'T', required — * `P` - 계약 준비 중 * `I` - 정산 진행 중 * `C` - 계약 종료 * `T` - 계약 중단
    - `isInitialPayment` boolean, required
    - `isInstallmentPayment` boolean, required
    - `isBalancePayment` boolean, required
    - `installmentPaymentCount` integer, required
  - `historySet` SettlementHistoryListCreate[], required
    - `id` integer, required
    - `member` SettlementHistoryMember, required
      - `memberId` integer, required
      - `email` string, required
      - `profileImage` string, uri, required
      - `nickname` string, required
    - `content` string, required
    - `created` string, date-time, required
    - `isOwn` boolean, required

## Other responses

- `400`

---

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