[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79N9733RW775ZRY0WGRG4VC":3,"skill-same:01M79N9733RW775ZRY0WGRG4VC":57},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":17,"linkOnly":18,"markdownContent":19,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M79N9733RW775ZRY0WGRG4VC","1c-integration",null,"Roman-repo\u002F1c-dev-rules","Roman-repo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F223091541?v=4","01M79N7MPDH8T9WBV54EWT5R5A","01M79N7MQ135R33FQA04CS8P9V",4,"MIT","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-integration\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: 1c-integration\ndescription: Интеграция 1С: HTTP, обмен данными, файлы, аутентификация в API. Use when: пишу\u002Fревьюлю интеграцию. Триггеры: HTTPСоединение, HTTPЗапрос, ИнтернетПочта, COM, ODBC, веб-сервис, OAuth, access_token, EnterpriseData, план обмена. №748\u002F№794\u002F№771.\nwhen_to_use: >\n  При работе с внешними сервисами, HTTP-запросами, обменом данными, файлами.\n  Триггеры: \"HTTPСоединение\", \"HTTPЗапрос\", \"ИнтернетПочта\", \"COM\", \"ODBC\",\n  \"ЗначениеВФайл\", \"КаталогВременныхФайлов\", \"интеграция\", \"обмен\", \"веб-сервис\".\nlicense: MIT\n---\n\n# 1c-integration — интеграция, обмен, файлы\n\n> Любое обращение к внешнему ресурсу — с таймаутом и вне транзакции. Зависший сервис не должен заморозить сеанс 1С.\n\n## 🔴 №748 — Таймауты при работе с внешними ресурсами\n\nЛюбое обращение к внешнему ресурсу (HTTP, COM, файловая система, БД через ODBC) **обязательно** с таймаутом.\n\n❌ `HTTPСоединение = Новый HTTPСоединение(\"api.example.com\", 80);` — нет таймаута, зависнет навсегда\n✅ `HTTPСоединение = Новый HTTPСоединение(\"api.example.com\", 80, , , , 30);` — таймаут 30 сек (6-й параметр; 5-й — прокси)\n\n## 🔴 №794 — Повторные попытки\n\nСетевые операции могут кратковременно отказать. Реализуйте повторные попытки с экспоненциальной задержкой. Не более 3–5 попыток.\n\n## 🔴 Внешние вызовы — ВНЕ транзакции\n\n`HTTPСоединение` \u002F `ОтправитьПочту` \u002F внешние вызовы в `ОбработкаПроведения` — вынести за транзакцию. Транзакция с внешним вызовом держит блокировки всё время ожидания сети (№783).\n\n## 🔴 Файловые операции — только в спецкаталоге\n\n`ЗначениеВФайл(...)`, чтение\u002Fзапись файлов — только через `КаталогВременныхФайлов()` или `НайтиФайлы(...)`. Не пишите в произвольные пути — Linux-сервера это не поддержат. Временные файлы — удаляйте после использования.\n\n❌ `Путь = \"C:\\Temp\\data.xml\";` — абсолютный путь, не переносимо\n✅ `Путь = КаталогВременныхФайлов() + \"data.xml\";`\n\n## 🟡 Логирование интеграции\n\nКаждый внешний запрос и ответ логируйте (уровень `Информация` или `Отладка`). При ошибке — уровень `Ошибка` с контекстом (URL, код ответа, тело).\n\n## 🟡 Идемпотентность обмена\n\nПовторный обмен теми же данными не должен ломать результат (дубли\u002Fперезапись). Используйте уникальные идентификаторы сообщений и проверяйте «уже обработано».\n\n## 🔴 Аутентификация и секреты в API\n\nСекреты — НЕ в коде, НЕ в открытых константах, НЕ в URL. Хранить в безопасном хранилище БСП, читать только на сервере, в логах маскировать. OAuth 2.0 client credentials: токен кэшировать до `expires_in`, 401 → обновить → один повтор. Подробно: `references\u002Fintegration-auth.md`.\n\n## 🟡 Обмен между конфигурациями\n\nМежду 1С — EnterpriseData (№771), не самописная сериализация; различие моделей — правила конвертации КД 3.1; планы обмена — с учётом отборов узлов (№701). Грабли: дубли при сопоставлении, GUID-рассинхрон, обмен в транзакции пользователя. Подробно: `references\u002Fexchange-edm.md`.\n\n---\n\n## Шаблон HTTP-запроса с таймаутом и логированием\n\n```bsl\nПопытка\n    Соединение = Новый HTTPСоединение(\"api.example.com\", 443, , , , 30, Новый ЗащищенноеСоединениеOpenSSL);\n    Запрос = Новый HTTPЗапрос(\"\u002Fendpoint\");\n    Ответ = Соединение.Получить(Запрос);\n\n    Если Ответ.КодСостояния >= 400 Тогда\n        ЗаписьЖурналаРегистрации(...Ошибка..., \"HTTP \" + Ответ.КодСостояния);\n        ВызватьИсключение НСтр(\"ru = 'Сервис вернул ошибку.'\");\n    КонецЕсли;\nИсключение\n    ЗаписьЖурналаРегистрации(...Ошибка..., ОписаниеОшибки());\n    ВызватьИсключение;\nКонецПопытки;\n```\n\n---\n\n## Мини-чек-лист по интеграции\n\n- [ ] Внешние вызовы — с таймаутом (№748)\n- [ ] Сетевые операции — с повторными попытками (№794)\n- [ ] Внешние вызовы вынесены за транзакцию (№783)\n- [ ] Файловые операции — в `КаталогВременныхФайлов()` (Linux-совместимость)\n- [ ] Временные файлы удаляются\n- [ ] Запросы и ответы логируются (без секретов в логах)\n- [ ] Обмен идемпотентный\n- [ ] Секреты — в безопасном хранилище, не в коде\u002FURL; токен кэшируется, 401 обработан\n- [ ] Между конфигурациями 1С — EnterpriseData (№771), не самописная сериализация\n\n---\n\n## Детали (читать по необходимости)\n\n- `references\u002Fintegration-full.md` — полная карточка: №748, №794 + практика\n- `references\u002Fintegration-auth.md` — аутентификация в API: Basic\u002FAPI-ключ\u002FOAuth 2.0\u002FJWT, хранение секретов в безопасном хранилище БСП, кэш токена и обработка 401, маскирование секретов в логах\n- `references\u002Fexchange-edm.md` — обмен между конфигурациями: выбор механизма (EnterpriseData \u002F КД 3.1 \u002F планы обмена \u002F REST), сопоставление объектов, типовые грабли (дубли, GUID-рассинхрон, отборы узлов №701)\n","# 1c-integration — интеграция, обмен, файлы\n\n> Любое обращение к внешнему ресурсу — с таймаутом и вне транзакции. Зависший сервис не должен заморозить сеанс 1С.\n\n## 🔴 №748 — Таймауты при работе с внешними ресурсами\n\nЛюбое обращение к внешнему ресурсу (HTTP, COM, файловая система, БД через ODBC) **обязательно** с таймаутом.\n\n❌ `HTTPСоединение = Новый HTTPСоединение(\"api.example.com\", 80);` — нет таймаута, зависнет навсегда\n✅ `HTTPСоединение = Новый HTTPСоединение(\"api.example.com\", 80, , , , 30);` — таймаут 30 сек (6-й параметр; 5-й — прокси)\n\n## 🔴 №794 — Повторные попытки\n\nСетевые операции могут кратковременно отказать. Реализуйте повторные попытки с экспоненциальной задержкой. Не более 3–5 попыток.\n\n## 🔴 Внешние вызовы — ВНЕ транзакции\n\n`HTTPСоединение` \u002F `ОтправитьПочту` \u002F внешние вызовы в `ОбработкаПроведения` — вынести за транзакцию. Транзакция с внешним вызовом держит блокировки всё время ожидания сети (№783).\n\n## 🔴 Файловые операции — только в спецкаталоге\n\n`ЗначениеВФайл(...)`, чтение\u002Fзапись файлов — только через `КаталогВременныхФайлов()` или `НайтиФайлы(...)`. Не пишите в произвольные пути — Linux-сервера это не поддержат. Временные файлы — удаляйте после использования.\n\n❌ `Путь = \"C:\\Temp\\data.xml\";` — абсолютный путь, не переносимо\n✅ `Путь = КаталогВременныхФайлов() + \"data.xml\";`\n\n## 🟡 Логирование интеграции\n\nКаждый внешний запрос и ответ логируйте (уровень `Информация` или `Отладка`). При ошибке — уровень `Ошибка` с контекстом (URL, код ответа, тело).\n\n## 🟡 Идемпотентность обмена\n\nПовторный обмен теми же данными не должен ломать результат (дубли\u002Fперезапись). Используйте уникальные идентификаторы сообщений и проверяйте «уже обработано».\n\n## 🔴 Аутентификация и секреты в API\n\nСекреты — НЕ в коде, НЕ в открытых константах, НЕ в URL. Хранить в безопасном хранилище БСП, читать только на сервере, в логах маскировать. OAuth 2.0 client credentials: токен кэшировать до `expires_in`, 401 → обновить → один повтор. Подробно: `references\u002Fintegration-auth.md`.\n\n## 🟡 Обмен между конфигурациями\n\nМежду 1С — EnterpriseData (№771), не самописная сериализация; различие моделей — правила конвертации КД 3.1; планы обмена — с учётом отборов узлов (№701). Грабли: дубли при сопоставлении, GUID-рассинхрон, обмен в транзакции пользователя. Подробно: `references\u002Fexchange-edm.md`.\n\n---\n\n## Шаблон HTTP-запроса с таймаутом и логированием\n\n```bsl\nПопытка\n    Соединение = Новый HTTPСоединение(\"api.example.com\", 443, , , , 30, Новый ЗащищенноеСоединениеOpenSSL);\n    Запрос = Новый HTTPЗапрос(\"\u002Fendpoint\");\n    Ответ = Соединение.Получить(Запрос);\n\n    Если Ответ.КодСостояния >= 400 Тогда\n        ЗаписьЖурналаРегистрации(...Ошибка..., \"HTTP \" + Ответ.КодСостояния);\n        ВызватьИсключение НСтр(\"ru = 'Сервис вернул ошибку.'\");\n    КонецЕсли;\nИсключение\n    ЗаписьЖурналаРегистрации(...Ошибка..., ОписаниеОшибки());\n    ВызватьИсключение;\nКонецПопытки;\n```\n\n---\n\n## Мини-чек-лист по интеграции\n\n- [ ] Внешние вызовы — с таймаутом (№748)\n- [ ] Сетевые операции — с повторными попытками (№794)\n- [ ] Внешние вызовы вынесены за транзакцию (№783)\n- [ ] Файловые операции — в `КаталогВременныхФайлов()` (Linux-совместимость)\n- [ ] Временные файлы удаляются\n- [ ] Запросы и ответы логируются (без секретов в логах)\n- [ ] Обмен идемпотентный\n- [ ] Секреты — в безопасном хранилище, не в коде\u002FURL; токен кэшируется, 401 обработан\n- [ ] Между конфигурациями 1С — EnterpriseData (№771), не самописная сериализация\n\n---\n\n## Детали (читать по необходимости)\n\n- `references\u002Fintegration-full.md` — полная карточка: №748, №794 + практика\n- `references\u002Fintegration-auth.md` — аутентификация в API: Basic\u002FAPI-ключ\u002FOAuth 2.0\u002FJWT, хранение секретов в безопасном хранилище БСП, кэш токена и обработка 401, маскирование секретов в логах\n- `references\u002Fexchange-edm.md` — обмен между конфигурациями: выбор механизма (EnterpriseData \u002F КД 3.1 \u002F планы обмена \u002F REST), сопоставление объектов, типовые грабли (дубли, GUID-рассинхрон, отборы узлов №701)\n",{},"main","bd66a558eacfeeacbac20902d53604f265859f9e","skills\u002F1c-integration",0,"https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules","https:\u002F\u002Fgithub.com\u002FRoman-repo","2026-11-14 20:47:01",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add Roman-repo\u002F1c-dev-rules --skill 1c-integration",{"tool":35,"command":36},"bunx","bunx skills add Roman-repo\u002F1c-dev-rules --skill 1c-integration",{"tool":38,"command":39},"pnpm","pnpm dlx skills add Roman-repo\u002F1c-dev-rules --skill 1c-integration","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-integration\u002FSKILL.md",true,[43,49,53],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"references\u002Fexchange-edm.md","REFERENCE","参考文档",9132,"https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-integration\u002Freferences\u002Fexchange-edm.md",{"path":50,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fintegration-auth.md",9423,"https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-integration\u002Freferences\u002Fintegration-auth.md",{"path":54,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fintegration-full.md",4496,"https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-integration\u002Freferences\u002Fintegration-full.md",[58,65,72,78,84,90],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":17},"01M79NBGJPTKF7Q4J7E29BTTMA","1c-valid","Эталонный валидный скил для тестов. Use when testing validator — все правила соблюдены, ошибок быть не должно.","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002F1c-valid\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":17},"01M79NBDWA3HAB81R95MN4H0CG","1c-no-license","Скил без поля license — должен дать ошибку об обязательном поле.","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002F1c-no-license\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":17},"01M79NBBEMWK960VAGWT7FDPCK","1c-broken","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002F1c-broken\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":17},"01M79NB82XPGYB3TWWXQVPA4FD","1c-ui-ux","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-ui-ux\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":17},"01M79NB521T8725YMHW2KTBA11","1c-thin-triggers","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-thin-triggers\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":17},"01M79NB0J316K8CW04PT50VH5D","1c-testing","https:\u002F\u002Fgithub.com\u002FRoman-repo\u002F1c-dev-rules\u002Fblob\u002Fmain\u002Fskills\u002F1c-testing\u002FSKILL.md",[],[]]