delete_sweepWriteoff. Списания

Методы для работы с документами «Списание»: получение документов со строками, создание документа и его строк, проведение (списание товара со склада) и аннулирование, удаление.

Статус меняется параметром status метода update: done проводит документ и списывает товар, draft у проведённого документа аннулирует списание и возвращает остатки.

GET https://[компания].myvirtualpos.ru/api/writeoff?apikey=MySecret&days=90&warehouse_id=6&withitems=1

Условия объединяются по «и». Даты передаются строго в формате ГГГГММДД, иначе метод вернёт ошибку Incorrect date format. Документы возвращаются по убыванию id: новые первыми.

Пустые значения в JSON приходят как null, в XML — как пустой элемент.

{
  "success": 1,
  "type": "writeoff",
  "days_limit": 90,
  "count": 1,
  "writeoffs": [
    {
      "writeoff": {
        "id": 15125,
        "external_id": "WO-2026-08",
        "guid": "5A07A106-A1A8-ECBC-2BA7-113B8662F9AF",
        "warehouse_id": 8,
        "docnum": "15125",
        "docdate": "2026-08-31 00:00:00",
        "amount": "225.00",
        "status": "done",
        "status_name": "Списан",
        "comment": "Просрочка",
        "warehouse_external_id": "WH-8",
        "type": "G",
        "reason": "Истёк срок годности",
        "created_date": "2026-08-31 18:10:00",
        "created_by": 6,
        "last_update_date": "2026-08-31 18:15:00",
        "last_update_by": 6,
        "items": [
          {
            "item": {
              "line_id": 24900,
              "guid": "3A148213-7184-B497-9C31-566F439CED63",
              "item_id": 795,
              "item_ext_id": "SKU-795",
              "item_name": "Форма для наращивания",
              "quantity": "3.000",
              "barcode": null,
              "price": "75.0000",
              "amount": "225.00",
              "manuf_date": null,
              "expir_date": null,
              "lot_number": null
            }
          }
        ]
      }
    }
  ]
}

Тот же ответ при format=xml (сокращённо):

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <success>1</success>
  <type>writeoff</type>
  <days_limit>90</days_limit>
  <count>1</count>
  <writeoffs>
    <writeoff>
      <id>15125</id>
      <status>done</status>
      <!-- остальные поля шапки -->
      <items>
        <item>
          <line_id>24900</line_id>
          <item_id>795</item_id>
          <quantity>3.000</quantity>
          <!-- остальные поля строки -->
        </item>
      </items>
    </writeoff>
  </writeoffs>
</root>

POST https://[компания].myvirtualpos.ru/api/writeoff/update?apikey=MySecret&external_id=WO-2026-09&create_if_not_exist=1
warehouse_id=6&docnum=WO-1&docdate=2026-09-01&type=G&reason_id=2&comment=Просрочка

Документ ищется по id, а если он не указан — по external_id. Если документ не найден, а передан create_if_not_exist=1, создаётся новый. Изменяются только переданные параметры.

{"success":1,"id":"15127","isnew":"1"}

GET https://[компания].myvirtualpos.ru/api/writeoff/delete?apikey=MySecret&id=15127

Удалить можно только документ в статусе draft. Чтобы удалить проведённый документ, сначала аннулируйте его (status=draft). Ответ: {«success»:1,«id»:15127}.

Строки создаются и изменяются только у черновика: строки проведённого документа менять и удалять нельзя, иначе остатки на складе разошлись бы с документом.

POST https://[компания].myvirtualpos.ru/api/writeoff/updateItems?apikey=MySecret&create_if_not_exist=1
writeoff_id=15127&item_id=795&quantity=2&cogs=11.24

Ответ: {«success»:1,«id»:«24900»,«isnew»:«1»}.

GET https://[компания].myvirtualpos.ru/api/writeoff/deleteItems?apikey=MySecret&id=24900

Ответ: {«success»:1,«id»:24900}.

Ошибка авторизации и общие ошибки описаны в статье Общие сведения. Ошибки методов приходят с кодом HTTP 200 и success равным 0:

Если по условиям ничего не найдено, метод получения возвращает успешный ответ с count равным 0 и пустым списком writeoffs.