Сайт Gliver.
Через командную строку.

./bin/gliver catalog search диван --limit 10
./bin/gliver catalog get 1380
./bin/gliver content list --q доставка
./bin/gliver content get static delivery

ID товара и код страницы приведены для примера. Для других товаров и страниц используйте значения из ответа поиска.

./bin/gliver pages roots
./bin/gliver pages block-types
./bin/gliver pages block-type title
printf '%s\n' '{"parent_id":238,"name":"Новая страница","code":"new-page","noindex":true}' | ./bin/gliver pages create
printf '%s\n' '{"if_version":"VERSION_ИЗ_PAGES_GET","type":"title","name":"Заголовок","properties":{"TITLE_TEXT":"Новая страница"}}' | ./bin/gliver pages add-block PAGE_ID
./bin/gliver pages get PAGE_ID
printf '%s\n' '{"if_version":"НОВАЯ_VERSION","active":true}' | ./bin/gliver pages update PAGE_ID

pages create создаёт черновик внутри действующего маршрута, например /blog/. Получайте свежий version после каждой записи. Варианты оформления задавайте XML_ID из pages block-type; файл для блока загрузите через pages upload-file и передайте его file_id. Публикация открывает страницу на текущем сайте. Для главной используйте pages get 410, pages block-types --template 2023 и команды работы с блоками для страницы 410.

./bin/gliver pages get 410
./bin/gliver pages block-types --template 2023
./bin/gliver pages block-type title --template 2023
printf '%s\n' '{"if_version":"VERSION_ИЗ_PAGES_GET","properties":{"TITLE_TEXT":"Новый заголовок"}}' | ./bin/gliver pages update-block 410 BLOCK_ID
./bin/gliver pages get 410

Главная имеет ID 410 и шаблон 2023. Перед изменением получите свежую version и проверьте тип выбранного блока. Для слайдера catsli описания заголовков и изображений передаются вместе со значениями; у множественного свойства передавайте весь массив, чтобы сохранить остальные слайды. Новый блок можно подготовить с active:false, затем включить через pages update-block. Настройки и удаление самой главной страницы закрыты.

printf '%s\n' '{"client":"Иван Иванов","phone":"+7 999 000-00-00"}' | ./bin/gliver projects create

CLI добавляет ключ идемпотентности и возвращает его вместе с результатом. Если запрос оборвался и вы не знаете, был ли создан проект, повторите с тем же --idempotency-key <ключ>. При совпадении телефона API предупредит о возможном дубле; осознанное повторное создание требует "allow_duplicate": true.

./bin/gliver projects get 123
printf '%s\n' '{"client":"Иван Иванов","phone":"+7 999 000-00-00","if_version":"ВЕРСИЯ_ИЗ_КАРТОЧКИ"}' | ./bin/gliver projects update 123

Возьмите version из свежей карточки проекта. Если её уже изменили, вернётся HTTP 409: прочитайте карточку заново и повторите изменение.

./bin/gliver calc modules
./bin/gliver calc module backrest --type free
./bin/gliver calc fabrics Вертикаль --module backrest --type free
./bin/gliver calc quote < quote.json
./bin/gliver projects add-calculated 123 < item.json

{"code":"backrest","fields":{"type":"free","width":1200,"height":1050,"weight_correction":5,"fabric_id":20138,"color":"выбранный цвет"}}

Для модулей Фри и Драм передайте fields.type со значением free или drum и используйте тот же тип при поиске ткани и добавлении расчёта в проект. Поправка на вес задаётся процентом: 0 — до 80 кг, 5 — 80–100 кг, 10 — 100–120 кг, 15 — 120–140 кг. Найдите ткань и возьмите её id из поиска: сервер сам подставит название и текущую цену. Для альтернативной ткани вместо ID укажите cloth_price и cloth_title — объекты с одинаковыми ключами. Для заказа добавьте fields.color и передайте те же поля при сохранении. В item.json также нужны item_index (по умолчанию 0) и массив configurations с ключами из price_table ответа расчёта. Повторяйте прерванный запрос с исходным ключом идемпотентности.

./bin/gliver calc module quad_backrest
./bin/gliver calc fabrics Velutto --module quad_backrest
./bin/gliver calc quote < quote-quad.json

{"code":"quad_backrest","fields":{"width":1400,"height":1400,"fabric_id":104831}}

Для Квадро есть коды quad_backrest, quad_angular и quad_puff. Тип уже задан кодом; ширину и глубину выбирайте из calc module. Высоты и поправка на вес фиксированы, как на сайте. configurations в описании модуля — все возможные комплектации, а не обещание цены для каждого размера. После расчёта смотрите items[].available_configurations: там только комплектации с ценой для выбранных параметров. При сохранении в проект передайте нужный price_key в массиве configurations, добавьте fields.color и используйте те же поля.

./bin/gliver projects get 123
./bin/gliver projects custom-classifiers диван
./bin/gliver orders catalog-colors 43662
./bin/gliver projects catalog-create 123 < catalog.json
./bin/gliver projects copy-with-fabric 123 < copy.json
./bin/gliver projects scheme-save 123 ./scheme.png --if-version HASH
./bin/gliver projects pdf 123 --type client
./bin/gliver projects history 123

{"if_version":"ВЕРСИЯ_ИЗ_PROJECTS_GET","positions":[1],"fabric_id":20138}

Перед каждым изменением используйте свежий version проекта как if_version. Копирование заново считает цену по текущей формуле и очищает цвет: выберите цвет новой ткани командой projects color. Для старой позиции без calculator_fields укажите исходные параметры в fields_by_position, например {"1":{"width":"1700","height":"1200"}}. При замене каталожной позиции сайт выдаёт новый id; последующие изменения делайте по нему. Для изменения цвета в уже созданных заказах передайте update_linked_orders: true: сайт обновит их через 1С.

./bin/gliver projects checkout-options 123
./bin/gliver orders locations Москва
./bin/gliver orders checkout-contractors 456
./bin/gliver orders agent-requests 789
./bin/gliver projects checkout-preview 123 < checkout.json
./bin/gliver projects create-order 123 < checkout.json

{"if_project_version":"ВЕРСИЯ_ИЗ_CHECKOUT_OPTIONS","items":[{"kind":"calculated","position":1,"configuration":"result-val-1-1"}],"checkout":{"payment_system_id":10,"delivery_id":3,"payer_type":"person","scheme":"retail","order_city_id":118,"order_source":"ИСТОЧНИК_ИЗ_CHECKOUT_OPTIONS","delivery_term":"УСЛОВИЕ_ИЗ_CHECKOUT_OPTIONS","properties":{"name":"Иван","phone":"+7 999 000-00-00","address":"Москва, улица Примерная, дом 1","city":"Москва","index":"101000","street":"Примерная","house":"1"}}}

Версию, позиции, способы оплаты, доставки, источник заказа и условия доставки берите из checkout-options; город — из orders locations. Для опта с дилером укажите scheme: wholesale, payer: dealer и dealer_id; контрагента выбирайте командой orders checkout-contractors. Для опта по агентской заявке укажите payer: agent, agent_id и agent_request_id из orders agent-requests. checkout-preview возвращает предварительную сумму позиций без создания заказа; окончательная сумма появится после оформления. После создания проверьте сумму, проект и documents в карточке заказа.

./bin/gliver orders get 456
printf '%s\n' '{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","properties":{"name":"Иван Петров"}}' | ./bin/gliver orders update 456
./bin/gliver orders get 456
printf '%s\n' '{"if_version":"НОВАЯ_ВЕРСИЯ","quantity":2}' | ./bin/gliver orders update-item 456 789

Получателя, адрес и комментарий меняйте разными запросами. Комментарий передаётся как "comment":"Текст"; для очистки используйте пустую строку. Перед каждым изменением получайте свежий version. Количество пересчитывает стоимость по правилам сайта.

./bin/gliver orders get 456
./bin/gliver orders operations 456
./bin/gliver orders references 456
printf '%s\n' '{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","value":"anytime"}' | ./bin/gliver orders run 456 priority
./bin/gliver orders get 456

operations показывает доступные действия, references — актуальные ID услуг, организаций, менеджеров и значения справочников сайта. Для записи передайте if_version из свежего orders get. Изменение оплат и отправка ссылки также требуют ключа идемпотентности; CLI создаёт его автоматически и показывает для повторной попытки.

./bin/gliver orders get 456
./bin/gliver orders contractors 456 Название
./bin/gliver orders buyer 456 < buyer.json

{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","person_type":"organization","contractor_id":"new","recipient":{"name":"Иван","phone":"+7 999 000-00-00","email":"client@example.com"},"company":{"company_name":"Тестовая компания","inn":"7700000000","phone":"+7 999 000-00-00","email":"office@example.com"}}

Для существующего контрагента возьмите числовой ID из orders contractors. Для нового укажите contractor_id: "new". Дополнительные поля компании: kpp, bik, bank_name, correspondent_account, checking_account, legal_address. Для физического лица передайте person_type: "person" и recipient, без company. После выгрузки в 1С сайт запрещает смену юридического лица обратно на физическое. При повторе после сбоя используйте тот же ключ идемпотентности.

./bin/gliver orders custom-classifiers 456 диван
./bin/gliver orders custom-context 456 789
./bin/gliver orders get 456
./bin/gliver orders upload-file 456 ./photo.png --if-version HASH
./bin/gliver orders upload-file 456 ./drawing.pdf --if-version НОВЫЙ_HASH
./bin/gliver orders custom-create 456 < custom.json
./bin/gliver orders custom-update 456 789 < custom.json

{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","classificator_id":45511,"name":"Диван по индивидуальному заказу","quantity":1,"price":10000,"size":"2000 мм","cloth":"Выбранная ткань","color":"Синий","image_file_ids":[101],"pdf_file_ids":[102]}

Передайте ID уже загруженных файлов заказа: до 10 изображений JPEG, PNG или GIF и до 10 PDF. После каждого действия получите свежий version. При редактировании опущенное поле вложений сохраняет их, пустой массив удаляет. Компонент сайта заменяет позицию и возвращает новый basket_id; общая сумма пересчитывается.

./bin/gliver orders project-items 456
./bin/gliver orders add-project-item 456 < project-item.json
./bin/gliver orders catalog-colors 43662
./bin/gliver orders catalog-add 456 < catalog-item.json
./bin/gliver orders catalog-update 456 789 < catalog-item.json
./bin/gliver orders fabric-colors 43161
./bin/gliver orders fabric-add 456 < fabric-item.json
./bin/gliver orders stock-search кресло
./bin/gliver orders stock-add 456 < stock-item.json
./bin/gliver orders module-context 456 789
./bin/gliver orders module-update 456 789 < module.json

{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","kind":"calculated","position":1,"configuration":"result-val-1-2"}

Для модуля используйте готовую конфигурацию из project-items. Для товара каталога передайте offer_id, color_id и целое quantity. Для ткани из справочника: kind: catalog, color_id, quantity; для альтернативной: kind: alternative, name, color, price, quantity. Для товара из наличия передайте product_id и quantity. Для изменения каталожной позиции используйте catalog-update с ID позиции; для перерасчёта модуля сначала вызовите module-context, затем передайте в module-update параметры fields как в calc quote и выбранную configuration. Калькулятор обновит и проект, и заказ. Каждый запрос требует свежий if_version; CLI показывает ключ для безопасного повтора.

./bin/gliver orders bill 456
./bin/gliver orders download-bill 456 --output ./bill.pdf
printf '%s\n' '{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","amount":1000,"description":"Аванс по заказу"}' | ./bin/gliver orders create-payment-link 456
printf '%s\n' '{"if_version":"ВЕРСИЯ_ИЗ_ЗАКАЗА","amount":1000,"description":"Аванс по заказу","email":"client@example.com","message":"Ссылка на оплату заказа"}' | ./bin/gliver orders send-payment-link 456

Создание ссылки возвращает адрес без письма. Отправка создаёт новую ссылку и ставит письмо в очередь сайта; она доступна для заказа физического лица. Сумма не может превышать неоплаченный остаток. Ссылка использует адрес текущего сайта.