{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/goods.card_main.json","title":"goods.card_main","description":"Повертає основні реквізити, ціни та залишок із картки товару.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"goods.card_main"},"params":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":128,"minLength":1,"title":"Код товару","example":"1001","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","x-api13-group":"Основні"}},"required":["code"]},"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":"goods.card_main"},"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":["code","name","cost","markup","price","unit_type","quantity","date_added","no_discount","critical_quantity","supplier","category","parent_category","shelf_life_days","c2","additional_info","in_cloud"],"additionalProperties":false,"properties":{"code":{"type":"string","title":"Код товару","description":"Повернене значення «Код товару» відповідного запису, документа або підсумку ARM20.","example":"1001"},"name":{"type":"string","title":"Назва","description":"Повернене значення «Назва» відповідного запису, документа або підсумку ARM20.","example":"Тестовий товар"},"cost":{"type":"string","title":"Собівартість","description":"Точне повернене значення «Собівартість» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},"markup":{"type":"string","title":"Націнка","description":"Точне повернене значення «Націнка» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"percent"},"price":{"type":"string","title":"Ціна","description":"Точне повернене значення «Ціна» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},"unit_type":{"type":"string","title":"Одиниця виміру","description":"Повернене значення «Одиниця виміру» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"quantity":{"type":"string","title":"Кількість","description":"Точне повернене значення «Кількість» як десятковий рядок із крапкою.","format":"decimal-string","example":"1.000","x-api13-unit":"product-unit"},"date_added":{"type":"string","title":"Дата додавання","description":"Повернена дата «Дата додавання» у форматі YYYY-MM-DD.","format":"date","example":"2026-07-23"},"no_discount":{"type":"string","title":"Заборонити знижку","description":"Повернене значення «Заборонити знижку» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"critical_quantity":{"type":"string","title":"Критичний залишок","description":"Точне повернене значення «Критичний залишок» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"product-unit"},"supplier":{"type":"string","title":"Постачальник","description":"Повернене значення «Постачальник» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"category":{"type":"string","title":"Категорія товару","description":"Повернене значення «Категорія товару» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"parent_category":{"type":"string","title":"Батьківська категорія","description":"Повернене значення «Батьківська категорія» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"shelf_life_days":{"type":"string","title":"Строк придатності, днів","description":"Повернене значення «Строк придатності, днів» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"c2":{"type":"string","title":"C2","description":"Повернене значення «C2» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"additional_info":{"type":"string","title":"Додаткова інформація","description":"Повернене значення «Додаткова інформація» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},"in_cloud":{"type":"string","title":"In cloud","description":"Повернене значення «In cloud» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}}}}}},"id":{"type":["string","integer","null"]}}},"request_id":{"type":"string"}}}]}},"x-api13-operation":{"description":"Повертає основні реквізити, ціни та залишок із картки товару.","scope":"inventory.cost.read","params":{"code":{"type":"string","required":true,"max":128,"title":"Код товару","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","group":"Основні","example":"1001"}},"result":{"mode":"rows","columns":["code","name","cost","markup","price","unit_type","quantity","date_added","no_discount","critical_quantity","supplier","category","parent_category","shelf_life_days","c2","additional_info","in_cloud"],"field_specs":{"code":{"title":"Код товару","description":"Повернене значення «Код товару» відповідного запису, документа або підсумку ARM20.","type":"string","example":"1001"},"name":{"title":"Назва","description":"Повернене значення «Назва» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Тестовий товар"},"cost":{"title":"Собівартість","description":"Точне повернене значення «Собівартість» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"markup":{"title":"Націнка","description":"Точне повернене значення «Націнка» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"percent","example":"100.00"},"price":{"title":"Ціна","description":"Точне повернене значення «Ціна» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"unit_type":{"title":"Одиниця виміру","description":"Повернене значення «Одиниця виміру» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"quantity":{"title":"Кількість","description":"Точне повернене значення «Кількість» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"product-unit","example":"1.000"},"date_added":{"title":"Дата додавання","description":"Повернена дата «Дата додавання» у форматі YYYY-MM-DD.","type":"string","format":"date","example":"2026-07-23"},"no_discount":{"title":"Заборонити знижку","description":"Повернене значення «Заборонити знижку» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"critical_quantity":{"title":"Критичний залишок","description":"Точне повернене значення «Критичний залишок» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"product-unit","example":"100.00"},"supplier":{"title":"Постачальник","description":"Повернене значення «Постачальник» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"category":{"title":"Категорія товару","description":"Повернене значення «Категорія товару» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"parent_category":{"title":"Батьківська категорія","description":"Повернене значення «Батьківська категорія» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"shelf_life_days":{"title":"Строк придатності, днів","description":"Повернене значення «Строк придатності, днів» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"c2":{"title":"C2","description":"Повернене значення «C2» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"additional_info":{"title":"Додаткова інформація","description":"Повернене значення «Додаткова інформація» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"in_cloud":{"title":"In cloud","description":"Повернене значення «In cloud» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}}},"mutating":false,"idempotency_required":false,"since":"0.4.0","stability":"stable","deprecated":false,"aliases":["goods","card main","Повертає основні реквізити, ціни та залишок із картки товару."],"errors":[{"code":"INVALID_PARAMETER","http":422,"description":"Один із параметрів має неправильний тип, формат або значення.","retry":"Виправити запит; автоматично не повторювати."},{"code":"UPSTREAM_FAILURE","http":502,"description":"Сервер бізнес-операції недоступний або відхилив безпечний контракт.","retry":"Дозволений повтор із backoff."}],"related_methods":["goods.card_desc","goods.card_open","goods.card_refs"]}}