{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/pos.fifo_choice_append.json","title":"pos.fifo_choice_append","description":"Додає вибрану партію FIFO до позиції касового чека.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"pos.fifo_choice_append"},"params":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":512,"default":"","title":"Код товару","example":"1001","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","x-api13-group":"Основні"},"items":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"document_number":{"type":"string","maxLength":512,"minLength":1,"pattern":"^[^\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]{1,512}$","title":"Номер документа","example":"ПН-1001","description":"Поле «Номер документа» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"quantity":{"type":"string","maxLength":32,"minLength":1,"pattern":"^(?:(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,3})?|-(?:[1-9][0-9]*(?:\\.[0-9]{1,3})?|0\\.(?=[0-9]{0,2}[1-9])[0-9]{1,3}))$","x-api13-scale":3,"description":"Кількість товару як десятковий рядок; одиниця залежить від картки товару. Decimal encoded as a JSON string; at most 3 fractional digits.","title":"Кількість","format":"decimal-string","example":"1.000","x-api13-group":"Суми та кількості","x-api13-unit":"product-unit"}},"required":["document_number","quantity"]},"minItems":1,"maxItems":250,"title":"Елементи","example":[],"description":"Список «Елементи». Структуру одного елемента, обов’язкові поля та межі кількості наведено нижче.","x-api13-group":"Колекції"}},"required":["items"]},"id":{"type":["string","integer","null"]}}}]},"response":{"oneOf":[{"type":"object","required":["ok","data","request_id"],"additionalProperties":false,"properties":{"ok":{"const":true},"data":{"type":"object","required":["method","result","id"],"additionalProperties":false,"properties":{"method":{"const":"pos.fifo_choice_append"},"result":{"type":"object","required":["upstream","status","rows"],"additionalProperties":false,"properties":{"upstream":{"type":"object","required":["name","version","resource"],"additionalProperties":false,"properties":{"name":{"const":"UPMAPI"},"version":{"type":"string"},"resource":{"type":"string"}}},"status":{"type":"object","required":["code","operation","affected"],"additionalProperties":false,"properties":{"code":{"const":"OK"},"operation":{"type":"string"},"affected":{"type":"string","title":"Змінено записів","description":"Кількість записів, які upstream фактично змінив.","example":"Приклад"}}},"rows":{"type":"array","items":{},"maxItems":0}}},"id":{"type":["string","integer","null"]}}},"request_id":{"type":"string"}}}]}},"x-api13-operation":{"description":"Додає вибрану партію FIFO до позиції касового чека.","scope":"pos.write","params":{"code":{"type":"string","max":512,"default":"","title":"Код товару","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","group":"Основні","example":"1001"},"items":{"type":"array","required":true,"min_items":1,"max_items":250,"items":{"type":"object","fields":{"document_number":{"type":"string","required":true,"max":512,"pattern":"/^[^\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]{1,512}$/uD","title":"Номер документа","description":"Поле «Номер документа» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":"ПН-1001"},"quantity":{"type":"decimal","required":true,"max":32,"scale":3,"title":"Кількість","description":"Кількість товару як десятковий рядок; одиниця залежить від картки товару.","group":"Суми та кількості","format":"decimal-string","unit":"product-unit","example":"1.000"}}},"title":"Елементи","description":"Список «Елементи». Структуру одного елемента, обов’язкові поля та межі кількості наведено нижче.","group":"Колекції","example":[]}},"result":{"mode":"status","fields":["affected"],"field_specs":{"affected":{"title":"Змінено записів","description":"Кількість записів, які upstream фактично змінив.","type":"string","example":"Приклад"}}},"mutating":true,"idempotency_required":true,"since":"0.4.0","stability":"stable","deprecated":false,"aliases":["pos","fifo choice append","Додає вибрану партію FIFO до позиції касового чека.","Windows Каса"],"errors":[{"code":"INVALID_PARAMETER","http":422,"description":"Один із параметрів має неправильний тип, формат або значення.","retry":"Виправити запит; автоматично не повторювати."},{"code":"UPSTREAM_FAILURE","http":502,"description":"Сервер бізнес-операції недоступний або відхилив безпечний контракт.","retry":"Не створювати новий Idempotency-Key; перевірити журнал і бізнес-об’єкт."},{"code":"IDEMPOTENCY_KEY_REQUIRED","http":422,"description":"Для виконання запису не передано Idempotency-Key.","retry":"Створити ключ для цієї бізнес-операції та повторити."},{"code":"IDEMPOTENCY_RESULT_UNKNOWN","http":409,"description":"Результат попередньої спроби невідомий; gateway не виконав запис повторно.","retry":"Звірити документ, чек або платіж; не створювати новий ключ автоматично."}],"related_methods":["pos.fifo_choice_rows","pos.fifo_invoice_rows","pos.fifo_summary"]}}