---
title: "Выставить счёт по заказу сделки"
method: POST
path: "/api/v1/crm/deals/{id}/invoice"
tags: ["CRM deals"]
---

# Выставить счёт по заказу сделки

`POST /api/v1/crm/deals/{id}/invoice`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/deals/{id}/invoice`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Выставляет счёт по заказу сделки (ERP-1615) той же командой «Документооборота», что кнопка карточки заказа, и кладёт его PDF в файлы сделки — в ленте появляется «Прикреплён файл». Срок оплаты due_date не передан — через 5 дней. Повтор с тем же Idempotency-Key отдаёт тот же счёт. Заказа ещё нет — 409 crm.order_missing, отказ документооборота — 422 crm.invoice_refused с причиной. Не удалась печать — счёт всё равно выставлен, поле file пустое. Нужны право изменять сделки, core.trade и docflow.flow на запись; модуль «Документооборот» не подключён — 404 module_disabled.

## Headers

- `Idempotency-Key` string

## Request body

- CRMDealInvoiceInput: Срок оплаты счёта по заказу сделки
  - `due_date` string, date: Оплатить до; пусто — через 5 дней

## Response `201`

Счёт выставлен

- CRMDealInvoice: Счёт документооборота по заказу сделки и его PDF в файлах карточки
  - `document_id` string, uuid, required
  - `number` string, required: Номер счёта
  - `order_id` string, uuid, required
  - `file` CRMCardFile: Файл, прикреплённый к лиду, сделке или клиенту
    - `id` string, uuid, required
    - `entity_type` 'lead' | 'deal' | 'customer', required
    - `entity_id` string, uuid, required
    - `name` string, required: Имя файла с расширением
    - `mime_type` string, required
    - `size_bytes` integer, required
    - `sha256` string: Контрольная сумма SHA-256, если её заявили при загрузке
    - `scan_status` 'clean' | 'skipped' | 'pending' | 'infected', required: Вердикт антивируса: clean и skipped скачиваются, pending - ещё проверяется, infected - заражён
    - `uploaded_by` integer, required
    - `uploaded_by_name` string
    - `created_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Запрос разобран, но бизнес-значение недопустимо
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)