---
title: "Отнести расход на приёмки — доп. расходы на поступление"
method: POST
path: "/api/v1/stock/receipt-costs"
tags: ["Stock documents"]
---

# Отнести расход на приёмки — доп. расходы на поступление

`POST /api/v1/stock/receipt-costs`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/stock/receipt-costs`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Документ `stock_receipt_cost` («Доп. расходы на поступление», ERP-2597):
счёт перевозчика, таможни, брокера или фулфилмента за товар выбранных
проведённых приёмок. Строки приёмок — партии; снятые строки
перечисляют в `excluded_lines`. Сумма без налога делится по базе
`allocation_method` (количество, стоимость, вес и объём из карточки
товара, ручные доли), доля строки — по остатку на дату: лежащее
дорожает (Дт 41), ушедшее — себестоимость продаж (Дт 90.02); налог к
вычету — Дт 19, если юрлицо его принимает. Долг — перед `contact_id`
(Кт 60.01), обязательство — сам документ. `post: true` заводит и
проводит одним действием; повтор с тем же `source` возвращает прежний
живой документ.

Читает `Idempotency-Key` так же, как `stockCreateDocument`.

## Headers

- `X-Tenant` string, required
- `Idempotency-Key` string

## Request body

- StockReceiptCostCreate: Доп. расходы на поступление — счёт перевозчика, таможни или фулфилмента на выбранные приёмки или на закупку, товар которой ещё в пути.
  - `contact_id` string, uuid
  - `company_id` string, uuid
  - `date` string, date: Пусто — рабочая дата кабинета; при источнике дата раньше приёмки поднимается до даты последней приёмки
  - `receipts` UUID[]: Проведённые приёмки одного бизнеса и юрлица; пусто — расход на закупки из orders
  - `orders` UUID[]: Подтверждённые закупки, когда товар ещё в пути: расход ждёт черновиком и проводится на приёмку закупки при её проведении; принятая закупка — сразу на её приёмки
  - `kind` 'delivery' | 'customs' | 'services' | 'other': Вид затраты; подставляет базу деления
  - `allocation_method` 'quantity' | 'cost' | 'weight' | 'volume' | 'manual': База деления; пусто — по виду затраты
  - `amount` string, required: Сумма с налогом в валюте счёта
  - `vat` string: Налог в сумме
  - `currency` string: Валюта счёта, код ISO; пусто — валюта учёта
  - `rate` string: Ручной курс; пусто — из справочника курсов на дату
  - `supplier_document` object
    - `number` string: Номер счёта-фактуры или акта
    - `date` string, date: Дата счёта-фактуры
  - `excluded_lines` UUID[]: Строки приёмок, которых расход не касается
  - `shares` object: Ручные доли строк приёмок для базы manual
  - `source` object
    - `kind` 'bank_operation' | 'cash_operation' | 'incoming_document' | 'payment_request', required
    - `id` string, uuid, required
    - `line` string
  - `comment` string
  - `post` boolean: Завести и сразу провести

## Response `201`

Созданный документ

- CoreDocument
  - `id` string, uuid, required
  - `type_id` string, uuid, required
  - `type_key` string, required
  - `type_name` string, required
  - `number` string, required
  - `date` string, date, required
  - `status` 'draft' | 'posted' | 'cancelled', required
  - `basis_type` string, uuid, required
  - `basis_id` string, uuid, required
  - `basis_number` string, required
  - `entity_refs` object, required
  - `payload` object, required
  - `comment` string, required
  - `is_marked_deleted` boolean, required
  - `created_by` integer, nullable, required
  - `created_by_name` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `posted_at` string, required
  - `cancelled_at` string, required
  - `custom` object: Значения своих полей кабинета (графы вида core.document.<ключ вида>). Отдаёт карточка документа; списки поле не несут

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Idempotency-Key уже использован для другого запроса: другое тело, другой адрес или другая операция. Код `idempotency.key_mismatch`; сохранённый ответ не раскрывается. Для новой команды берут новый ключ.
- `503`: Хранилище ключей идемпотентности недоступно, команда с заголовком Idempotency-Key не выполнялась. Код `idempotency.unavailable`; Retry-After говорит, когда повторить.

---

[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)