---
title: "Оновити дані угоди"
method: PATCH
path: "/agreements/{id}"
tags: ["Agreements"]
---

# Оновити дані угоди

`PATCH /agreements/{id}`

**Метод оновлює дані угоди.** <br/>Якщо в `jobs_attributes` є записи без `id`, то вони будуть додані як нові товарні позиції. Якщо `id` є, то буде оновлено кількість `amount`. <br/>Якщо передати `_destroy`, то товарну позицію буде видалено.

## Path parameters

- `id` integer, required

## Request body

- object
  - `stage_id` number — Ідентифікатор етапу угоди
  - `funnel_id` number — Ідентифікатор воронки продажів
  - `main_responsible_id` integer — Ідентифікатор відповідального працівника
  - `client_id` number — Ідентифікатор клієнта
  - `comment` string — Коментар
  - `result` 'archived' | 'successful' | 'failed' — Результат угоди (тільки для архівних угод)
  - `archive_status_id` integer — Ідентифікатор причини виграшу/програшу угоди
  - `total` number — Загальна сума угоди
  - `products_total_as_total` boolean — Сума товарів дорівнює сумі угоди
  - `jobs_attributes` JobAttributes[]
    - `product_attributes` Product — Дані товару в прайс-листі
      - `id` number — Ідентифікатор
      - `sku` string, required — Артикул
      - `title` string, required — Назва
      - `unit` string — Одиниця виміру
      - `price` number, required — Ціна
      - `price_amount` number — Ціна форматована (з валютою)
      - `currency` string — ISO валюти (`UAH`, `USD`, `EUR`...). При цьому вказана валюта має бути додана в налаштуваннях. За замовчуванням основна валюта
      - `asset_url` string — Посилання на фото
      - `category_id` number — Ідентифікатор категорії (папки)
      - `category` object — Категорія (папка)
        - `id` integer — Ідентифікатор
        - `name` string — Назва
      - `custom_fields` object[] — Користувацькі поля ("Назва": "Значення")
      - `attachments` object[] — Додаткові фото
        - `title` string — Назва
        - `original_url` string — Посилання на фото
    - `id` integer — Ідентифікатор (тільки при оновленні)
    - `_destroy` boolean — Видалити товар (тільки при оновленні)
    - `title` string, required — Назва
    - `amount` number, required — Кількість
    - `discount` number — Знижка
    - `cost` string — Собівартість товару з валютою (якщо включена мультивалютність "123.12", "$123.12")
    - `price` string — Ціна товару з валютою (якщо включена мультивалютність "123.12", "$123.12")
    - `discount_kind` 'percent_discount' | 'absolute_discount' — Тип знижки (відсоток чи сума)
    - `custom_fields` CustomField[]
      - `name` string, required — Назва поля
      - `value` string, required — Значення поля
  - `custom_fields` CustomField[]
    - `name` string, required — Назва поля
    - `value` string, required — Значення поля

## Response `200`

Успішно оновлено

- CreatedResponse
  - `id` integer — Ідентифікатор сутності
  - `created_at` string — Дата та час створення
  - `updated_at` string — Дата та час оновлення

## Other responses

- `401` — Невірний APIKey
- `422` — Помилка валідації

---

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