{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://api13.arm20.com/v1/schemas/goods.card_open.json","title":"goods.card_open","description":"Повертає повну картку товару одним запитом.","type":"object","required":["request","response"],"additionalProperties":false,"properties":{"request":{"oneOf":[{"type":"object","required":["method","params"],"additionalProperties":false,"properties":{"method":{"const":"goods.card_open"},"params":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","maxLength":128,"minLength":1,"title":"Код товару","example":"1001","description":"Публічний код товару, картки або іншого запису, як він відображається у програмі.","x-api13-group":"Основні"},"sk":{"type":"integer","minimum":0,"maximum":2,"default":0,"title":"Номер складу або філії","example":1,"description":"Номер складу/філії відповідно до налаштувань бази; 0 зазвичай означає основний склад.","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_open"},"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":{"oneOf":[{"type":"array","prefixItems":[{"const":"STATE","title":"tag"},{"type":"string","title":"Found","description":"Повернене значення «Found» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":2,"maxItems":2},{"type":"array","prefixItems":[{"const":"MAIN","title":"tag"},{"type":"string","title":"Код товару","description":"Повернене значення «Код товару» відповідного запису, документа або підсумку ARM20.","example":"1001"},{"type":"string","title":"Назва","description":"Повернене значення «Назва» відповідного запису, документа або підсумку ARM20.","example":"Тестовий товар"},{"type":"string","title":"Собівартість","description":"Точне повернене значення «Собівартість» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},{"type":"string","title":"Націнка","description":"Точне повернене значення «Націнка» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"percent"},{"type":"string","title":"Ціна","description":"Точне повернене значення «Ціна» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},{"type":"string","title":"Одиниця виміру","description":"Повернене значення «Одиниця виміру» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Кількість","description":"Точне повернене значення «Кількість» як десятковий рядок із крапкою.","format":"decimal-string","example":"1.000","x-api13-unit":"product-unit"},{"type":"string","title":"Дата додавання","description":"Повернена дата «Дата додавання» у форматі YYYY-MM-DD.","format":"date","example":"2026-07-23"},{"type":"string","title":"Заборонити знижку","description":"Повернене значення «Заборонити знижку» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Критичний залишок","description":"Точне повернене значення «Критичний залишок» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"product-unit"},{"type":"string","title":"Постачальник","description":"Повернене значення «Постачальник» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Категорія товару","description":"Повернене значення «Категорія товару» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Батьківська категорія","description":"Повернене значення «Батьківська категорія» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Строк придатності, днів","description":"Повернене значення «Строк придатності, днів» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"C2","description":"Повернене значення «C2» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Додаткова інформація","description":"Повернене значення «Додаткова інформація» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"In cloud","description":"Повернене значення «In cloud» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":18,"maxItems":18},{"type":"array","prefixItems":[{"const":"DESC","title":"tag"},{"type":"string","title":"Опис","description":"Повернене значення «Опис» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Kitchen printer","description":"Повернене значення «Kitchen printer» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":3,"maxItems":3},{"type":"array","prefixItems":[{"const":"UKT","title":"tag"},{"type":"string","title":"Код УКТ ЗЕД","description":"Повернене значення «Код УКТ ЗЕД» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Excise input","description":"Повернене значення «Excise input» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":3,"maxItems":3},{"type":"array","prefixItems":[{"const":"EXTRA_CODE","title":"tag"},{"type":"string","title":"Код товару","description":"Повернене значення «Код товару» відповідного запису, документа або підсумку ARM20.","example":"1001"}],"items":false,"minItems":2,"maxItems":2},{"type":"array","prefixItems":[{"const":"EXTRA_VALUE","title":"tag"},{"type":"string","title":"Назва поля","description":"Повернене значення «Назва поля» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Значення","description":"Повернене значення «Значення» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":3,"maxItems":3},{"type":"array","prefixItems":[{"const":"FIFO","title":"tag"},{"type":"string","title":"Номер документа","description":"Номер документа у базі поточного клієнта.","example":"ПН-1001"},{"type":"string","title":"Собівартість","description":"Точне повернене значення «Собівартість» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},{"type":"string","title":"Кількість","description":"Точне повернене значення «Кількість» як десятковий рядок із крапкою.","format":"decimal-string","example":"1.000","x-api13-unit":"product-unit"},{"type":"string","title":"Дата","description":"Повернена дата «Дата» у форматі YYYY-MM-DD.","format":"date","example":"2026-07-23"},{"type":"string","title":"Фіскальна ознака","description":"Повернене значення «Фіскальна ознака» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":6,"maxItems":6},{"type":"array","prefixItems":[{"const":"SOSTAV","title":"tag"},{"type":"string","title":"Код товару","description":"Повернене значення «Код товару» відповідного запису, документа або підсумку ARM20.","example":"1001"},{"type":"string","title":"Назва","description":"Повернене значення «Назва» відповідного запису, документа або підсумку ARM20.","example":"Тестовий товар"},{"type":"string","title":"Собівартість","description":"Точне повернене значення «Собівартість» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},{"type":"string","title":"Ціна","description":"Точне повернене значення «Ціна» як десятковий рядок із крапкою.","format":"decimal-string","example":"100.00","x-api13-unit":"currency-of-operation"},{"type":"string","title":"Одиниця виміру","description":"Повернене значення «Одиниця виміру» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Кількість","description":"Точне повернене значення «Кількість» як десятковий рядок із крапкою.","format":"decimal-string","example":"1.000","x-api13-unit":"product-unit"}],"items":false,"minItems":7,"maxItems":7},{"type":"array","prefixItems":[{"const":"PICTURE","title":"tag"},{"type":"string","title":"Folder","description":"Повернене значення «Folder» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Picture","description":"Повернене значення «Picture» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":3,"maxItems":3},{"type":"array","prefixItems":[{"const":"SIZE_SUMMARY","title":"tag"},{"type":"string","title":"Summary","description":"Повернене значення «Summary» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":2,"maxItems":2},{"type":"array","prefixItems":[{"const":"DUP_OWNER","title":"tag"},{"type":"string","title":"Owner code","description":"Повернене значення «Owner code» відповідного запису, документа або підсумку ARM20.","example":"Приклад"},{"type":"string","title":"Owner name","description":"Повернене значення «Owner name» відповідного запису, документа або підсумку ARM20.","example":"Приклад"}],"items":false,"minItems":3,"maxItems":3}]}}}},"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"},"sk":{"type":"int","min":0,"max":2,"default":0,"title":"Номер складу або філії","description":"Номер складу/філії відповідно до налаштувань бази; 0 зазвичай означає основний склад.","group":"Додаткові","example":1}},"result":{"mode":"tagged_rows","row_shapes":{"STATE":["tag","found"],"MAIN":["tag","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"],"DESC":["tag","description","kitchen_printer"],"UKT":["tag","uktzed","excise_input"],"EXTRA_CODE":["tag","code"],"EXTRA_VALUE":["tag","field_name","value"],"FIFO":["tag","document_number","cost","quantity","date","fiscal"],"SOSTAV":["tag","code","name","cost","price","unit_type","quantity"],"PICTURE":["tag","folder","picture"],"SIZE_SUMMARY":["tag","summary"],"DUP_OWNER":["tag","owner_code","owner_name"]},"shape_field_specs":{"STATE":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"found":{"title":"Found","description":"Повернене значення «Found» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"MAIN":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"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":"Приклад"}},"DESC":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"description":{"title":"Опис","description":"Повернене значення «Опис» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"kitchen_printer":{"title":"Kitchen printer","description":"Повернене значення «Kitchen printer» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"UKT":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"uktzed":{"title":"Код УКТ ЗЕД","description":"Повернене значення «Код УКТ ЗЕД» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"excise_input":{"title":"Excise input","description":"Повернене значення «Excise input» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"EXTRA_CODE":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"code":{"title":"Код товару","description":"Повернене значення «Код товару» відповідного запису, документа або підсумку ARM20.","type":"string","example":"1001"}},"EXTRA_VALUE":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"field_name":{"title":"Назва поля","description":"Повернене значення «Назва поля» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"value":{"title":"Значення","description":"Повернене значення «Значення» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"FIFO":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"document_number":{"title":"Номер документа","description":"Номер документа у базі поточного клієнта.","type":"string","example":"ПН-1001"},"cost":{"title":"Собівартість","description":"Точне повернене значення «Собівартість» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"currency-of-operation","example":"100.00"},"quantity":{"title":"Кількість","description":"Точне повернене значення «Кількість» як десятковий рядок із крапкою.","type":"string","format":"decimal-string","unit":"product-unit","example":"1.000"},"date":{"title":"Дата","description":"Повернена дата «Дата» у форматі YYYY-MM-DD.","type":"string","format":"date","example":"2026-07-23"},"fiscal":{"title":"Фіскальна ознака","description":"Повернене значення «Фіскальна ознака» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"SOSTAV":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"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"},"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"}},"PICTURE":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"folder":{"title":"Folder","description":"Повернене значення «Folder» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"picture":{"title":"Picture","description":"Повернене значення «Picture» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"SIZE_SUMMARY":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"summary":{"title":"Summary","description":"Повернене значення «Summary» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}},"DUP_OWNER":{"tag":{"title":"Tag","description":"Повернене значення «Tag» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"owner_code":{"title":"Owner code","description":"Повернене значення «Owner code» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"},"owner_name":{"title":"Owner name","description":"Повернене значення «Owner name» відповідного запису, документа або підсумку ARM20.","type":"string","example":"Приклад"}}}},"mutating":false,"idempotency_required":false,"since":"0.4.0","stability":"stable","deprecated":false,"aliases":["goods","card open","Повертає повну картку товару одним запитом."],"errors":[{"code":"INVALID_PARAMETER","http":422,"description":"Один із параметрів має неправильний тип, формат або значення.","retry":"Виправити запит; автоматично не повторювати."},{"code":"UPSTREAM_FAILURE","http":502,"description":"Сервер бізнес-операції недоступний або відхилив безпечний контракт.","retry":"Дозволений повтор із backoff."}],"related_methods":["goods.card_desc","goods.card_refs","goods.card_main"]}}