{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/pos.checkout_client_bonus_delta.json","title":"pos.checkout_client_bonus_delta","description":"Нараховує або списує бонуси клієнта під час продажу.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"pos.checkout_client_bonus_delta"},"params":{"type":"object","additionalProperties":false,"properties":{"card":{"type":"string","maxLength":512,"minLength":1,"title":"Номер дисконтної картки","example":"990000001","description":"Поле «Номер дисконтної картки» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"com1":{"type":"string","maxLength":512,"default":"","title":"Основний коментар","example":"","description":"Основний текстовий коментар, який буде збережено разом з операцією.","x-api13-group":"Додаткові"},"com2":{"type":"string","maxLength":512,"default":"","title":"Додатковий коментар","example":"","description":"Додатковий коментар операції; використовуйте лише коли він потрібний відповідному сценарію Windows.","x-api13-group":"Додаткові"},"delta":{"type":"string","maxLength":4096,"title":"Зміна значення","format":"decimal-string","example":"100.00","description":"Точне числове значення «Зміна значення» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","x-api13-group":"Суми та кількості","x-api13-unit":"currency-of-operation"},"forbid_minus":{"type":"boolean","default":true,"title":"Forbid minus","example":false,"description":"Визначає, чи застосовувати параметр «Forbid minus». Передавайте JSON true або false.","x-api13-group":"Додаткові"},"ifrom":{"type":"string","maxLength":4096,"default":"","title":"Початковий індекс","example":"","description":"Поле «Початковий індекс» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","x-api13-group":"Додаткові"},"ndoc":{"type":"string","maxLength":4096,"default":"","title":"Номер документа","example":"","description":"Номер службового, касового або фіскального документа у відповідному журналі.","x-api13-group":"Додаткові"}},"required":["card"]},"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_client_bonus_delta"},"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":["old_balance","new_balance"],"additionalProperties":false,"properties":{"old_balance":{"type":"string","title":"Old balance","description":"Точне повернене значення «Old balance» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},"new_balance":{"type":"string","title":"New balance","description":"Точне повернене значення «New balance» як десятковий рядок із крапкою.","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":{"card":{"type":"string","max":512,"required":true,"title":"Номер дисконтної картки","description":"Поле «Номер дисконтної картки» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":"990000001"},"com1":{"type":"string","max":512,"default":"","title":"Основний коментар","description":"Основний текстовий коментар, який буде збережено разом з операцією.","group":"Додаткові","example":""},"com2":{"type":"string","max":512,"default":"","title":"Додатковий коментар","description":"Додатковий коментар операції; використовуйте лише коли він потрібний відповідному сценарію Windows.","group":"Додаткові","example":""},"delta":{"type":"string","max":4096,"title":"Зміна значення","description":"Точне числове значення «Зміна значення» у JSON-рядку; десятковий роздільник — крапка, символ одиниці не додається.","group":"Суми та кількості","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"forbid_minus":{"type":"bool","default":true,"title":"Forbid minus","description":"Визначає, чи застосовувати параметр «Forbid minus». Передавайте JSON true або false.","group":"Додаткові","example":false},"ifrom":{"type":"string","max":4096,"default":"","title":"Початковий індекс","description":"Поле «Початковий індекс» відповідного документа або довідника ARM20. Передавайте значення так, як воно зберігається у Windows.","group":"Додаткові","example":""},"ndoc":{"type":"string","max":4096,"default":"","title":"Номер документа","description":"Номер службового, касового або фіскального документа у відповідному журналі.","group":"Додаткові","example":""}},"result":{"mode":"rows","columns":["old_balance","new_balance"],"field_specs":{"old_balance":{"title":"Old balance","description":"Точне повернене значення «Old balance» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"new_balance":{"title":"New balance","description":"Точне повернене значення «New balance» як десятковий рядок із крапкою.","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 client bonus delta","Нараховує або списує бонуси клієнта під час продажу.","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_apply_sale_line","pos.checkout_bonus_multiplier","pos.checkout_bonus_totals","pos.checkout_cancel_position"]}}