Core trade

Продать сразу — продажа и акт одной командой

«Продажа сразу исполненным» для внешней системы, программы или модуля: продажа заводится или узнаётся по стороне и внешнему номеру, подтверждается, и по нему выпускается акт на всю сумму — одной транзакцией кабинета. Акт выпускает владелец исполнения: при включённом документообороте после отсечки этапа 4 бизнеса (и в кабинете без финансов) — «Сделать акт» документооборота, бумага и исполнение одной командой, бумага с исполнением сразу зарегистрирована; иначе — акт финансов по продаже. Кроме core.trade:write нужно право двери владельца: docflow.flow:write или finance.operations:write (403 core.trade.execution_forbidden). Повтор с тем же external_id той же стороны отвечает 200 с replayed: true и тем, что сделано в первый раз: второй продажи, бумаги и акта нет; ключ идемпотентности не нужен. Отказ любого шага откатывает всё — продажа не остаётся. Акт закрывает работы и услуги; товар при включённом складе исполняет отгрузка (409 core.trade.goods_by_shipment), товар без склада при документообороте — УПД, выпуск которого по продаже ещё не сделан (409 core.trade.goods_need_upd). Закупка при документообороте после отсечки — бумагой поставщика (409 core.trade.purchase_needs_paper). Без финансов и документооборота — 409 core.trade.no_executor.

post/api/v1/core/sales/execute-now

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/core/sales/execute-now
  • 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

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

side'sale' | 'purchase' required
numberstring

Свой номер; пусто — номер выдаёт счётчик вида

datestring date required
business_idstring uuid
company_idstring uuid
contact_idstring uuid
contract_idstring uuid
project_idstring uuid
department_idstring uuid
cfo_idstring uuid
pnl_item_idstring uuid
warehouse_idstring uuid
basis_idstring uuid
titlestring
currencystring required
prices_include_vatboolean

Цены с НДС («в том числе»); по умолчанию true

discountstring
delivery_datestring date
due_datestring date
scenario'one_off_sale' | 'contract_sale' | 'self_service'
manager_notestring
warehouse_notestring
commentstring
cabinet_status_idstring uuid
external_idstring required

Номер продажи или закупки у источника; по стороне и нему узнаётся повтор

source_systemstring

Имя источника: сайт, CRM, маркетплейс

Response

Повтор — продажа уже исполнена этой командой

replayedboolean required

true — продажа или закупка уже был исполнен этой командой; ничего не записано

Changes

No recorded changes to this operation across all 1 revision of this API.