{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/pos.precheck_save.json","title":"pos.precheck_save","description":"Зберігає поточний продаж як попередній чек.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"pos.precheck_save"},"params":{"type":"object","additionalProperties":false,"properties":{"fil":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Номер філії","example":1,"description":"Поле «Номер філії» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"kasm":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Номер каси","example":1,"description":"Числовий номер каси, налаштований у Windows Касі.","x-api13-group":"Додаткові"},"mode":{"type":"string","enum":["slot","preorder"],"default":"slot","title":"Режим операції","example":"slot","description":"Вибирає один із підтримуваних сценаріїв операції. Значення та їх зміст наведено у списку варіантів.","x-api13-group":"Основні","x-enumDescriptions":["зберегти у вибрану комірку попереднього чека","зберегти як попереднє замовлення"],"x-api13-enum-labels":{"slot":"зберегти у вибрану комірку попереднього чека","preorder":"зберегти як попереднє замовлення"}},"noc":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Номер чека","example":1,"description":"Поле «Номер чека» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"pref_disc":{"type":"string","maxLength":4096,"default":"","title":"Префікс дисконтної картки","example":"","description":"Префікс, за яким відсканований код розпізнається як дисконтна картка.","x-api13-group":"Додаткові"},"rows":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":190,"minLength":1,"pattern":"^[^\\x00-\\x1F\\x7F]{1,190}$","title":"Код товару","example":"1001","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","x-api13-group":"Основні"},"nt":{"type":"string","maxLength":512,"pattern":"^[^\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]*$","title":"Назва товару","example":"Тестовий товар","description":"Поле «Назва товару» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Основні"},"quant":{"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,"x-api13-numeric-minimum":0,"x-api13-exclusive-minimum":true,"x-api13-numeric-maximum":1000000,"x-api13-exclusive-maximum":false,"description":"Кількість товару як десятковий рядок; для вагового товару дозволена дробова частина. Decimal encoded as a JSON string; at most 3 fractional digits. Value > 0. Value <= 1000000.","title":"Кількість","format":"decimal-string","example":"1.000","x-api13-group":"Суми та кількості","x-api13-unit":"product-unit"},"price":{"type":"string","maxLength":32,"minLength":1,"pattern":"^(?:(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,2})?|-(?:[1-9][0-9]*(?:\\.[0-9]{1,2})?|0\\.(?=[0-9]{0,1}[1-9])[0-9]{1,2}))$","x-api13-scale":2,"x-api13-numeric-minimum":0,"x-api13-exclusive-minimum":false,"x-api13-numeric-maximum":999999999999.99,"x-api13-exclusive-maximum":false,"description":"Ціна за одиницю товару як десятковий рядок без символу валюти. Decimal encoded as a JSON string; at most 2 fractional digits. Value >= 0. Value <= 999999999999.99.","title":"Ціна","format":"decimal-string","example":"100.00","x-api13-group":"Суми та кількості","x-api13-unit":"currency-of-operation"}},"required":["code","quant","price"]},"minItems":1,"maxItems":220,"title":"Рядки операції","example":[],"description":"Структурований масив рядків. Невідомі поля та порушення схеми відхиляються gateway.","x-api13-group":"Колекції"}},"required":["rows"]},"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.precheck_save"},"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","value"],"additionalProperties":false,"properties":{"code":{"const":"OK"},"operation":{"type":"string"},"value":{"type":"string"}}},"rows":{"type":"array","items":{"type":"object","required":["precheck_number","inserted"],"additionalProperties":false,"properties":{"precheck_number":{"type":"string","title":"Precheck number","description":"Повернене значення «Precheck number» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"inserted":{"type":"string","title":"Inserted","description":"Повернене значення «Inserted» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}}}}}},"id":{"type":["string","integer","null"]}}},"request_id":{"type":"string"}}}]}},"x-api13-operation":{"description":"Зберігає поточний продаж як попередній чек.","scope":"pos.write","params":{"fil":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Номер філії","description":"Поле «Номер філії» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"kasm":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Номер каси","description":"Числовий номер каси, налаштований у Windows Касі.","group":"Додаткові","example":1},"mode":{"type":"enum","values":["slot","preorder"],"default":"slot","title":"Режим операції","description":"Вибирає один із підтримуваних сценаріїв операції. Значення та їх зміст наведено у списку варіантів.","group":"Основні","example":"slot","enum_labels":{"slot":"зберегти у вибрану комірку попереднього чека","preorder":"зберегти як попереднє замовлення"}},"noc":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Номер чека","description":"Поле «Номер чека» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"pref_disc":{"type":"string","max":4096,"default":"","title":"Префікс дисконтної картки","description":"Префікс, за яким відсканований код розпізнається як дисконтна картка.","group":"Додаткові","example":""},"rows":{"type":"array","required":true,"min_items":1,"max_items":220,"items":{"type":"object","fields":{"code":{"type":"string","required":true,"max":190,"pattern":"/^[^\\x00-\\x1F\\x7F]{1,190}$/uD","title":"Код товару","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","group":"Основні","example":"1001"},"nt":{"type":"string","max":512,"pattern":"/^[^\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]*$/uD","title":"Назва товару","description":"Поле «Назва товару» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Основні","example":"Тестовий товар"},"quant":{"type":"decimal","required":true,"max":32,"scale":3,"numeric_min":0,"exclusive_min":true,"numeric_max":1000000,"title":"Кількість","description":"Кількість товару як десятковий рядок; для вагового товару дозволена дробова частина.","group":"Суми та кількості","format":"decimal-string","unit":"product-unit","example":"1.000"},"price":{"type":"decimal","required":true,"max":32,"scale":2,"numeric_min":0,"numeric_max":999999999999.99,"title":"Ціна","description":"Ціна за одиницю товару як десятковий рядок без символу валюти.","group":"Суми та кількості","format":"decimal-string","unit":"currency-of-operation","example":"100.00"}}},"title":"Рядки операції","description":"Структурований масив рядків. Невідомі поля та порушення схеми відхиляються gateway.","group":"Колекції","example":[]}},"result":{"mode":"rows","columns":["precheck_number","inserted"],"field_specs":{"precheck_number":{"title":"Precheck number","description":"Повернене значення «Precheck number» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"inserted":{"title":"Inserted","description":"Повернене значення «Inserted» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}}},"mutating":true,"idempotency_required":true,"since":"0.4.0","stability":"stable","deprecated":false,"aliases":["pos","precheck save","Зберігає поточний продаж як попередній чек.","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.precheck_delete","pos.precheck_kas_counts","pos.precheck_lines","pos.precheck_list"]}}