Add

[POST] .../v1/docinout/add

Creates a warehouse goods receipt or write-off document. Create a manual stock receipt or stock write-off document before adding item rows with InOutOperation/Add. The request requires the warehouse goods receipt/write-off document add permission and the stock receipt/expense tariff option; date, stock_id and inout_type are required, description is optional and limited and attached_user_id defaults to the current request user when omitted or 0. The document date must not fall into a closed period, the stock must be visible to the current request user and the method creates only the document header, not item operations. The response returns new_id for the created document and sends the added webhook after success; business errors such as missing body, invalid required fields, denied access, disabled tariff option, closed period, stock access denial, excessive description length, storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Request Example

{
  "date": 1714550400,
  "stock_id": 3,
  "inout_type": "outcome",
  "description": "Write-off of damaged goods"
}

Response Parameters

Response Example

{
  "ok": true,
  "result": {
    "new_id": 42
  }
}