{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/pos.checkout_apply_sale_line.json","title":"pos.checkout_apply_sale_line","description":"Записує одну товарну позицію під час оформлення продажу.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"pos.checkout_apply_sale_line"},"params":{"type":"object","additionalProperties":false,"properties":{"bind_excise":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Bind excise","example":1,"description":"Поле «Bind excise» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"bonus_kf":{"type":"string","maxLength":4096,"default":"1","title":"Коефіцієнт бонусів","format":"decimal-string","example":"100.00","description":"Точне числове значення «Коефіцієнт бонусів» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","x-api13-group":"Суми та кількості","x-api13-unit":"currency-of-operation"},"code":{"type":"string","maxLength":512,"minLength":1,"title":"Код товару","example":"1001","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","x-api13-group":"Основні"},"curcert":{"type":"string","maxLength":4096,"default":"","title":"Валюта сертифіката","example":"","description":"Поле «Валюта сертифіката» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"current_discount":{"type":"string","maxLength":512,"default":"","title":"Current discount","format":"decimal-string","example":"100.00","description":"Точне числове значення «Current discount» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","x-api13-group":"Суми та кількості","x-api13-unit":"currency-of-operation"},"disc_card":{"type":"string","maxLength":512,"default":"","title":"Дисконтна картка","example":"990000001","description":"Поле «Дисконтна картка» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Знижки, бонуси та борг"},"disc_percent":{"type":"string","maxLength":512,"default":"","title":"Відсоток знижки","format":"decimal-string","example":"100.00","description":"Точне числове значення «Відсоток знижки» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","x-api13-group":"Суми та кількості","x-api13-unit":"percent"},"disc_price":{"type":"string","maxLength":4096,"default":"","title":"Ціна зі знижкою","format":"decimal-string","example":"100.00","description":"Точне числове значення «Ціна зі знижкою» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","x-api13-group":"Суми та кількості","x-api13-unit":"currency-of-operation"},"disc_sprice":{"type":"string","maxLength":4096,"default":"","title":"Базова ціна для знижки","format":"decimal-string","example":"100.00","description":"Точне числове значення «Базова ціна для знижки» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","x-api13-group":"Суми та кількості","x-api13-unit":"currency-of-operation"},"disc_type":{"type":"string","maxLength":512,"default":"","title":"Тип знижки","example":"","description":"Поле «Тип знижки» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Знижки, бонуси та борг"},"dolg_code":{"type":"string","maxLength":512,"default":"","title":"Dolg code","example":"990000001","description":"Поле «Dolg code» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"ei":{"type":"string","maxLength":4096,"default":"","title":"Ознака вагового товару","example":"","description":"Поле «Ознака вагового товару» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"fil":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Номер філії","example":1,"description":"Поле «Номер філії» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"from_sost":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"From sost","example":1,"description":"Поле «From sost» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"irestr":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Обмеження знижки","example":1,"description":"Поле «Обмеження знижки» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"is_nakl":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Пов’язано з накладною","example":1,"description":"Поле «Пов’язано з накладною» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"isbonus":{"type":"string","maxLength":4096,"default":"0","title":"Використовувати бонуси","example":"0","description":"Поле «Використовувати бонуси» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Знижки, бонуси та борг"},"kasm":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Номер каси","example":1,"description":"Числовий номер каси, налаштований у Windows Касі.","x-api13-group":"Додаткові"},"ndoc":{"type":"string","maxLength":4096,"minLength":1,"title":"Номер документа","example":"Приклад","description":"Номер службового, касового або фіскального документа у відповідному журналі.","x-api13-group":"Додаткові"},"parent_history_id":{"type":"string","maxLength":512,"default":"","title":"Батьківський запис історії","example":"","description":"Ідентифікатор «Батьківський запис історії», отриманий із результату відповідного методу читання цієї бази.","x-api13-group":"Додаткові"},"pref_disc":{"type":"string","maxLength":4096,"default":"","title":"Префікс дисконтної картки","example":"","description":"Префікс, за яким відсканований код розпізнається як дисконтна картка.","x-api13-group":"Додаткові"},"quant":{"type":"string","maxLength":512,"title":"Кількість","format":"decimal-string","example":"1.000","description":"Кількість товару як десятковий рядок; для вагового товару дозволена дробова частина.","x-api13-group":"Суми та кількості","x-api13-unit":"product-unit"},"sk":{"type":"integer","minimum":-2147483648,"maximum":2147483647,"default":0,"title":"Номер складу або філії","example":1,"description":"Номер складу/філії відповідно до налаштувань бази; 0 зазвичай означає основний склад.","x-api13-group":"Додаткові"},"storage":{"type":"string","enum":["main","branch"],"default":"main","title":"Склад","example":"main","description":"Логічний склад: main — основний, branch — філіальний.","x-api13-group":"Основні","x-enumDescriptions":["основний склад","філіальний склад"],"x-api13-enum-labels":{"main":"основний склад","branch":"філіальний склад"}}},"required":["code","ndoc"]},"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.checkout_apply_sale_line"},"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":["skip_discount","bonus_after"],"additionalProperties":false,"properties":{"skip_discount":{"type":"string","title":"Skip discount","description":"Повернене значення «Skip discount» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"bonus_after":{"type":"string","title":"Бонуси після операції","description":"Точне повернене значення «Бонуси після операції» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"}}}}}},"id":{"type":["string","integer","null"]}}},"request_id":{"type":"string"}}}]}},"x-api13-operation":{"description":"Записує одну товарну позицію під час оформлення продажу.","scope":"pos.write","params":{"bind_excise":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Bind excise","description":"Поле «Bind excise» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"bonus_kf":{"type":"string","max":4096,"default":"1","title":"Коефіцієнт бонусів","description":"Точне числове значення «Коефіцієнт бонусів» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","group":"Суми та кількості","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"code":{"type":"string","max":512,"required":true,"title":"Код товару","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","group":"Основні","example":"1001"},"curcert":{"type":"string","max":4096,"default":"","title":"Валюта сертифіката","description":"Поле «Валюта сертифіката» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"current_discount":{"type":"string","max":512,"default":"","title":"Current discount","description":"Точне числове значення «Current discount» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","group":"Суми та кількості","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"disc_card":{"type":"string","max":512,"default":"","title":"Дисконтна картка","description":"Поле «Дисконтна картка» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Знижки, бонуси та борг","example":"990000001"},"disc_percent":{"type":"string","max":512,"default":"","title":"Відсоток знижки","description":"Точне числове значення «Відсоток знижки» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","group":"Суми та кількості","format":"decimal-string","unit":"percent","example":"100.00"},"disc_price":{"type":"string","max":4096,"default":"","title":"Ціна зі знижкою","description":"Точне числове значення «Ціна зі знижкою» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","group":"Суми та кількості","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"disc_sprice":{"type":"string","max":4096,"default":"","title":"Базова ціна для знижки","description":"Точне числове значення «Базова ціна для знижки» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","group":"Суми та кількості","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"disc_type":{"type":"string","max":512,"default":"","title":"Тип знижки","description":"Поле «Тип знижки» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Знижки, бонуси та борг","example":""},"dolg_code":{"type":"string","max":512,"default":"","title":"Dolg code","description":"Поле «Dolg code» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":"990000001"},"ei":{"type":"string","max":4096,"default":"","title":"Ознака вагового товару","description":"Поле «Ознака вагового товару» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"fil":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Номер філії","description":"Поле «Номер філії» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"from_sost":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"From sost","description":"Поле «From sost» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"irestr":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Обмеження знижки","description":"Поле «Обмеження знижки» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"is_nakl":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Пов’язано з накладною","description":"Поле «Пов’язано з накладною» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":1},"isbonus":{"type":"string","max":4096,"default":"0","title":"Використовувати бонуси","description":"Поле «Використовувати бонуси» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Знижки, бонуси та борг","example":"0"},"kasm":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Номер каси","description":"Числовий номер каси, налаштований у Windows Касі.","group":"Додаткові","example":1},"ndoc":{"type":"string","max":4096,"required":true,"title":"Номер документа","description":"Номер службового, касового або фіскального документа у відповідному журналі.","group":"Додаткові","example":"Приклад"},"parent_history_id":{"type":"string","max":512,"default":"","title":"Батьківський запис історії","description":"Ідентифікатор «Батьківський запис історії», отриманий із результату відповідного методу читання цієї бази.","group":"Додаткові","example":""},"pref_disc":{"type":"string","max":4096,"default":"","title":"Префікс дисконтної картки","description":"Префікс, за яким відсканований код розпізнається як дисконтна картка.","group":"Додаткові","example":""},"quant":{"type":"string","max":512,"title":"Кількість","description":"Кількість товару як десятковий рядок; для вагового товару дозволена дробова частина.","group":"Суми та кількості","format":"decimal-string","unit":"product-unit","example":"1.000"},"sk":{"type":"int","min":-2147483648,"max":2147483647,"default":0,"title":"Номер складу або філії","description":"Номер складу/філії відповідно до налаштувань бази; 0 зазвичай означає основний склад.","group":"Додаткові","example":1},"storage":{"type":"enum","values":["main","branch"],"default":"main","title":"Склад","description":"Логічний склад: main — основний, branch — філіальний.","group":"Основні","example":"main","enum_labels":{"main":"основний склад","branch":"філіальний склад"}}},"result":{"mode":"rows","columns":["skip_discount","bonus_after"],"field_specs":{"skip_discount":{"title":"Skip discount","description":"Повернене значення «Skip discount» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"bonus_after":{"title":"Бонуси після операції","description":"Точне повернене значення «Бонуси після операції» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"currency-of-operation","example":"100.00"}}},"mutating":true,"idempotency_required":true,"since":"0.4.0","stability":"stable","deprecated":false,"aliases":["pos","checkout apply sale line","Записує одну товарну позицію під час оформлення продажу.","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.checkout_create_check","pos.checkout_close_sale","pos.checkout_discount_actions"]}}