Перейти к основному содержимому

Карта полей: выгрузка ИС → 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С обычно не соберёт документы. Минимальный набор на каждый затронутый документ:

  1. Организация (по маппингу кода)
  2. Контрагент (ИНН/КПП)
  3. Договор (если требуем)
  4. Номенклатура всех строк
  5. Единицы измерения
  6. Валюта
  7. Банк + р/с (если заполняем на реализации / счёте)
  8. Сами документы в порядке: справочники → реализации → счета на оплату → счета-фактуры (с основанием)

Дедупликация объектов в 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.