Карта полей: выгрузка ИС → XML 1С (Бухгалтерия)
Эпик: ITR-3083. ТЗ: export-1c.md.
Эталон данных: XML ФайлОбмена (выгрузка с объектами).
Полные правила обмена: файл ПКОлмаг_ПравилаОбмена_УНФ2БП_20260909 (Ид cd80efca-36f7-4428-9d07-9627d8b8f390, УНФ 1.6 → Бухгалтерия 3.0). В нём заданы свойства с Поиск="true" и скрипты ПослеЗагрузки / фильтр организации при выгрузке из УНФ.
Статус: актуально для реализованного эпика ITR-3083 (v1). Имена в ИС — ориентир для разработки; в ТЗ для заказчика их не копировать.
v1 и организации: полноценный маппинг кода организации 1С в первой поставке — для ПК ОлМаг. Остальные наши org: коды в 1С будут заведены / прописаны в ИС после тестирования загрузки на боевой 1С.
1. Типы объектов в эталоне
| Объект в XML | Правило (ИмяПравила) | Сколько в эталоне (порядок) | Смысл |
|---|---|---|---|
| Реализация товаров и услуг | РеализацияТоваровУслуг_Накладные | есть | Товарная отгрузка → в 1С реализация (товары) |
| Реализация товаров и услуг | РеализацияТоваровУслуг_Акты | в правилах есть, в теле эталона не встретилось | Услуги / акт |
| Счёт на оплату покупателю | СчетНаОплатуПокупателю | есть | Счёт покупателю |
| Счёт-фактура выданный | СчетФактураВыданный | есть | СФ, связан с реализацией |
| Номенклатура | Номенклатура | есть | Справочник |
| Контрагенты | Контрагенты | есть | Покупатель |
| Договоры контрагентов | ДоговорыКонтрагентов | есть | Договор с покупателем |
| Организации | Организации | есть | Наша организация (часто НеЗамещать / не создавать) |
| Банки / банковские счета | Банки, БанковскиеСчета | есть | Р/с нашей организации |
| Валюты | Валюты | есть | Обычно рубль (код 643, ISO 4217; не путать с литералом RUB) |
| Классификатор единиц | КлассификаторЕдиницИзмерения | есть | ОКИ (напр. 796 = шт) |
| Страны мира | СтраныМира | редко | Для банков и пр. |
В шапке файла: НачалоПериодаВыгрузки / ОкончаниеПериодаВыгрузки, ДатаВыгрузки, блок ПравилаОбмена (копировать/адаптировать из эталона, не выдумывать второй формат).
2. Соответствие документов заказчика → XML → ИС
| Заказчик | В ИС (факт) | В XML (предложение) | Статус |
|---|---|---|---|
| УПД | Отгрузка: документ УПД (UTD) | Одна реализация, правило накладных или актов по составу строк; признак УПД через правила загрузки (ЭтоУниверсальныйДокумент) + вид ЭДО (уточнить значение у 1С) | Открыто (вариант А vs Б в ТЗ) |
| ТН = ТОРГ-12 | Отгрузка: товарная накладная (PackingList) | Реализация …_Накладные, в эталоне у строк: ВидЭлектронногоДокумента = ТоварнаяНакладная | Принято направление |
| Акт выполненных работ | Отгрузка: акт (WorkCompletionAct) | Реализация …_Акты, табличная часть услуг, вид ЭДО «акт» | Принято направление |
| Счёт-фактура | TaxInvoice / ActTaxInvoice на отгрузке (номер вида С-N) | СчетФактураВыданный, основание — реализация | Принято |
| Счёт на оплату | PaymentInvoice | СчетНаОплатуПокупателю | Принято |
| Номенклатура | SKU (+ изделие как SKU) в строках отгрузки / счёта | Номенклатура | Принято |
| 1-Т / ТТН | ConsignmentNote | — | Вне scope эпика |
УПД + ТОРГ-12 на одной отгрузке
В ИС на одной отгрузке могут быть и УПД, и ТОРГ-12. В 1С на одну отгрузку обычно нужна одна реализация.
Рекомендация (черновик, нужно ОКО бухгалтерии):
| Ситуация на отгрузке | Что писать в XML |
|---|---|
| Только ТОРГ-12 | Одна реализация-накладная |
| Только УПД | Одна реализация с признаком УПД (вариант А) |
| Только акт | Одна реализация-акт |
| УПД и ТОРГ-12 | Одна реализация (предпочтительно по УПД); ТОРГ-12 в XML не дублировать |
| УПД/ТОРГ-12 и отдельный акт | Две реализации (товары + услуги), если в ИС разделены товарные и услуговые документы — уточнить |
Вариант Б (отдельный тип «УПД» в XML) — только если правила в их Бухгалтерии это умеют; в эталоне такого типа нет.
3. Правило периода (для задач 2–3)
В штатном коде при генерации УПД / ТОРГ-12 / 1-Т / счёта-фактуры / акта сначала создаётся сущность счёт-фактуры (TaxInvoice или для акта ActTaxInvoice), если её ещё нет: номер С-n и дата нужны шаблонам. Поэтому у сформированных отгрузочных документов дата СФ есть; ветка «СФ нет» — не штатный сценарий (пустая отгрузка до генерации, ручные данные), такие в выгрузку не берём.
| Документ | Дата «попадания в месяц» | Источник в ИС |
|---|---|---|
| Реализация (из УПД / ТОРГ-12) | Дата счёт-фактуры отгрузки | TaxInvoice.Date |
| Реализация (из акта) | Дата счёт-фактуры для акта | ActTaxInvoice.Date |
| Счёт-фактура | Дата СФ | TaxInvoice.Date / ActTaxInvoice.Date |
| Счёт на оплату | Дата выставления | PaymentInvoice.InvoiceDate |
| Номенклатура и справочники | Не фильтруются отдельно: всё, на что ссылаются документы периода | — |
Границы: [начало месяца 00:00; конец месяца 23:59:59] в таймзоне, принятой на беке для дат «date». В выборку периода — только отгрузки с уже сформированными документами и соответствующей сущностью СФ с датой.
4. Карта полей по объектам
Обозначения статуса: есть / частично / нет / константа / уточнить.
4.1. Контрагент
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| ИНН | строка | Реквизиты партнёра: ИНН | есть |
| КПП | строка / пусто | Реквизиты: КПП | есть |
| Наименование | строка | Партнёр: наименование | есть |
| ЭтоГруппа | false | — | константа false |
Ключ поиска в 1С (предложение): ИНН + КПП (если КПП пуст — только ИНН). Согласовать с бухгалтерией.
4.2. Организация (наша)
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| Наименование | «ПК ОлМаг» | Партнёр с признаком нашей организации | есть |
| Код | 01-000001 / в правилах поиск БП-000001 | Код организации 1С в ИС | v1: для ПК ОлМаг — по правилам/эталону; для остальных наших org — после теста на боевой 1С |
В эталоне организация часто с НеСоздаватьЕслиНеНайден / НеЗамещать — выгрузка не должна плодить вторую организацию в Бухгалтерии.
4.3. Договор контрагента
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| ВидДоговора | СПокупателем | — | константа |
| Наименование | «№ … от … (RUB)» | Собрать из номера + даты договора; суффикс (RUB) — только текст | частично |
| ВалютаВзаиморасчетов | 643 | рубль (обязательно; иначе в 1С валюта договора пустая → ошибка при проведении реализации) | есть |
| Организация | ссылка | Наша организация заказа / счёта | есть |
| Владелец | контрагент | Покупатель | есть |
Ключ (предложение): владелец (ИНН/КПП) + наименование или номер+дата. Уточнить.
Договор в ИС на счёте опционален (ContractId) — если пуст, нужна политика: не выгружать счёт / подставлять типовой / ошибка строки.
4.4. Номенклатура
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| Наименование | строка | SKU: имя / номенклатура | есть |
| НаименованиеПолное | в правилах для актов | SKU: имя или полное | частично |
| Код | в объекте справочника 1С | SKU: числовой Code | не ключ: коды ИС и уже заведённые в 1С не совпадают — в XML не опираться на Code ИС для поиска в 1С |
| ЕдиницаИзмерения | классификатор (Код ОКИ) | Единица SKU → Code (ОКЕИ) | в счетах на оплату и услугах не пишется (withUnit: false); в товарных реализациях — если Code заполнен |
| ВидСтавкиНДС | Общая и т.п. | Ставка НДС у реквизитов / заказа | уточнить |
| ЭтоГруппа | false | — | константа |
Ключ поиска в 1С (подтверждено правилами): в полном файле правил у номенклатуры свойства с Поиск="true": Наименование, ЭтоГруппа. Код номенклатуры ИС ↔ код в 1С не совпадают и в поиск не идут. В XML отдаём наименование (как в эталоне данных); поле «Код» ИС не использовать как идентификатор 1С.
Риск: два разных SKU с одинаковым именем → коллизия в 1С; дубли имён в ИС — заранее проверить / правило ошибки.
4.5. Реализация (накладная / акт)
Шапка:
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| Дата | дата-время | Дата СФ отгрузки (TaxInvoice.Date / для акта — ActTaxInvoice.Date) | есть |
| Номер | ОМФР-000024 | Номер СФ С-N (другой формат!) | уточнить правило номера для 1С |
| Контрагент | ссылка | Покупатель заказа | есть |
| ДоговорКонтрагента | ссылка | Договор заказа / счёта | частично |
| Организация | ссылка | Наша организация | есть |
| СуммаДокумента | число | Сумма строк отгрузки (цена×кол-во) | есть (из товаров заказа) |
| ВидОперации | Товары / Услуги | По правилу накладная vs акт | константа по типу документа ИС |
| ВалютаДокумента | 643 | рубль | константа / справочник (Currency.Number) |
| Кратность / Курс | 1 / 1 | — | константа |
| ВидЭлектронногоДокумента | ТоварнаяНакладная / Акт… | Тип документа отгрузки | есть соответствие |
| БанковскийСчетОрганизации | р/с | Банковские реквизиты: AccountNumber, BIC, CorrespondentAccount | есть |
| ПометкаУдаления | false | — | константа |
Табличная часть Товары (накладная):
| XML | ИС | Статус |
|---|---|---|
| Номенклатура | SKU строки отгрузки (ShipmentGood → Good → SKU) | есть |
| Количество | ShipmentGood.Count | есть |
| Цена | Good.Price / FinalPrice | есть |
| Сумма | цена × количество | есть |
| СуммаНДС | из ставки / реквизитов | частично |
| СтавкаНДС | перечисление (НДС0, …) | уточнить маппинг % → enum 1С |
| ЕдиницаИзмерения | ОКИ единицы SKU | для актов/услуг и счетов — не передаём; иначе есть / уточнить пустые Code |
Для актов — табличная часть Услуги (в правилах эталона); в ИС строки отгрузки те же ShipmentGood — отличать услугу от товара по типу SKU / категории (уточнить).
4.6. Счёт-фактура выданный
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| Номер | строка | TaxInvoice.Number → отображение С-{n} | частично (формат) |
| Дата / ДатаВыставления | дата | TaxInvoice.Date | есть |
| Контрагент / Организация / Договор | ссылки | как у реализации | есть |
| ДокументОснование | реализация | Связь с выгруженной реализацией той же отгрузки | есть (логика генератора) |
| СуммаДокумента / СуммаНДСДокумента | числа | из строк / Total+VAT заказа | частично |
| ВидСчетаФактуры | перечисление | — | константа / уточнить |
| ВалютаДокумента | 643 | из реализации (Reason.CurrencyNumber) | есть |
| КодВидаОперации | в правилах «01» | — | константа из эталона |
| Прочие поля исправлений | пусто / false | в ИС нет | константы / пусто |
Не писать в XML: СчетФактураВыданныйВЭлектронномВиде, СчетФактураНеВыставляется — в Бухгалтерии / правилах обмена нет → загрузка СФ падает с «Поле объекта не обнаружено».
На отгрузке возможны два СФ: обычный и для акта (ActTaxInvoice) — выгружать оба, каждый к своей реализации.
4.7. Счёт на оплату покупателю
| XML | Эталон | ИС | Статус |
|---|---|---|---|
| Номер | строка | PaymentInvoice.Number | есть |
| Дата | дата | InvoiceDate | есть |
| Контрагент | ссылка | Buyer | есть |
| Организация | ссылка | OurOrganization | есть |
| ДоговорКонтрагента | ссылка | Contract (nullable) | частично |
| СуммаДокумента | число | Total | есть |
| СуммаНДС (в строках) | ValueAddedTax | есть | |
| Валюта / курс / кратность | RUB | константа | |
| Банковский счёт / структурная единица | в эталоне | OurBankingDetail | частично |
| Табличная часть Товары | строки | Строк счёта как отдельных позиций в ИС нет — брать товары заказа / этапа плана (уточнить алгоритм строк) | дыра |
4.8. Банк и р/с
| XML | ИС | Статус |
|---|---|---|
| Банк.Код | BIC | есть |
| Банк.КоррСчет | BankingDetail.CorrespondentAccount (кор. счёт) | есть (nullable — если пусто, в XML пусто / как в эталоне) |
| НомерСчета | AccountNumber | есть |
| Владелец счёта | наша организация | есть |
| Банк.Наименование (если нужно) | BankName | частично |
5. Обязательный «хвост» справочников в файле
Без них загрузка в 1С обычно не соберёт документы. Минимальный набор на каждый затронутый документ:
- Организация (по маппингу кода)
- Контрагент (ИНН/КПП)
- Договор (если требуем)
- Номенклатура всех строк
- Единицы измерения
- Валюта
- Банк + р/с (если заполняем на реализации / счёте)
- Сами документы в порядке: справочники → реализации → счета на оплату → счета-фактуры (с основанием)
Дедупликация объектов в XML по ключу поиска (один контрагент — один Нпп), как в эталоне.
6. Чего в ИС нет / риски для генератора
| Тема | Риск | Что делать |
|---|---|---|
| Код организации 1С | Без кода организация не найдётся / создастся лишняя | v1: ПК ОлМаг; остальные org — коды после теста на боевой 1С |
| Коды номенклатуры ИС ≠ 1С | Поиск по Code даст чужую позицию или дубль | Ключ — наименование; Code ИС в поиск 1С не использовать |
| Формат номера реализации | В ИС С-n, в эталоне ОМФР-… | Правило от бухгалтерии |
| Строки счёта на оплату | Нет табличной части счёта | Алгоритм: товары заказа / доля % предоплаты — согласовать |
| Ставка НДС → enum 1С | Разные шкалы | Таблица маппинга |
| УПД+ТОРГ-12 | Две реализации | Политика §2 |
| Повтор выгрузки месяца | Нужна полная перезапись | В правилах у документов Поиск="true" на Дату (+ контрагент / договор / …); Номер не в полях — риск коллизии двух документов в один день у одного контрагента; для стабильной перезаписи желательно добавить поиск по Номеру (уточнить у 1С) |
| Несколько наших org | Смешение в одном файле | UI: выбор org; фильтр выборки строго по org (в правилах УНФ уже был параметр ОрганизацияДляВыгрузки) |
7. Решения (чеклист задачи 1 → итог v1)
- УПД: вариант А (реализация + флаг), не Б
- УПД+ТОРГ-12 → одна реализация
- Ключ номенклатуры: наименование (коды ИС≠1С)
- Ключ контрагента: ИНН+КПП
- Коды org в 1С: v1 — ПК ОлМаг; остальные — после теста на боевой 1С
- Дата реализации в XML = дата СФ (§3)
- Один файл = одна выбранная наша организация
- Повтор месяца: полная перезапись (финальная проверка — на боевой 1С)
- Номер реализации/СФ и строки счёта — при необходимости донастроить по обратной связи бухгалтерии после боевого теста
8. Выводы из файла правил ПКОлмаг_ПравилаОбмена_УНФ2БП_20260909
| Тема | Что в правилах |
|---|---|
| Номенклатура | Поиск="true" на Наименование и ЭтоГруппа; после загрузки — вид «Продукция» |
| Контрагенты | Поиск ИНН+КПП / ИНН / наименование |
| Организации | Поиск запросом по коду (в эталоне жёстко БП-000001) |
| Реализация, счёт, СФ | Поиск по Дате (+ контрагент, договор, иногда сумма); Номер без Поиск="true" |
| Фильтр org при выгрузке из УНФ | Параметр ОрганизацияДляВыгрузки; отказ, если org не та / ИНН не 7719797099 |
| УПД | В ПослеЗагрузки реализаций: ЭтоУниверсальныйДокумент = Истина (вариант А) |
9. Связь с реализацией (задачи 2–4)
Выборка и XML: фильтр по выбранной нашей org + период по дате СФ / дате счёта; отгрузки со сформированными документами; правила обмена заказчика в файле; номенклатура по наименованию. UI: превью + скачивание для бухгалтера. ТЗ: export-1c.md.