@catalogicus-international/n8n-nodes-invoice-parser 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -63,13 +63,13 @@ pnpm test
63
63
 
64
64
  ## Параметры
65
65
 
66
- | Параметр | Описание |
67
- |---|---|
68
- | Input Binary Field | поле с PDF (по умолчанию `data`) |
69
- | Supplier Profile | `Auto-Detect (Recommended)` (определить по тексту), профили поставщиков из пакета (`Электротехмонтаж`, `Леруа Мерлен (ЛЕ МОНЛИД)`, …), `Universal` |
70
- | Output | `One Item per Document` или `One Item per Line` |
71
- | Options → Y Tolerance | допуск по вертикали для склейки строки (по умолчанию 2 pt) |
72
- | Options → Fail on Arithmetic Mismatch | падать, если `кол-во × цена ≠ сумма` |
66
+ | Параметр | Описание |
67
+ | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
68
+ | Input Binary Field | поле с PDF (по умолчанию `data`) |
69
+ | Supplier Profile | `Auto-Detect (Recommended)` (определить по тексту), профили поставщиков из пакета (`Электротехмонтаж`, `Леруа Мерлен (ЛЕ МОНЛИД)`, `Лунда`, `Нормал-Вент`, `ТЕРЕМ`, `СТД «Петрович»` и его макеты), `Universal` |
70
+ | Output | `One Item per Document` или `One Item per Line` |
71
+ | Options → Y Tolerance | допуск по вертикали для склейки строки (по умолчанию 2 pt) |
72
+ | Options → Fail on Arithmetic Mismatch | падать, если `кол-во × цена ≠ сумма` |
73
73
 
74
74
  Нода поддерживает Continue On Fail: ошибка конкретного файла попадает в `json.error`
75
75
  этого item, остальные файлы обрабатываются. Каждый выходной item связан с входным через
@@ -82,26 +82,42 @@ pnpm test
82
82
 
83
83
  ```json
84
84
  {
85
- "fileName": "277_02_13114.pdf",
86
- "pages": 3,
87
- "supplier": { "id": "etm", "title": "Электротехмонтаж" },
88
- "lines": [
89
- { "num": 1, "code": "ETM9943043", "name": "Кабель силовой ВВГ-Пнг(А)-LS 3Х2.5ок(N,PE)-0.660 100м ТРТС",
90
- "article": "МОНЭЛ", "productType": "S", "unit": "м", "qty": 1000, "price": 102.98, "sum": 102980, "total": 125635.6 }
91
- ],
92
- "totals": { "qty": 2535, "sum": 199671.33, "vat": 43927.71, "total": 243599.04 },
93
- "warnings": [],
94
- "unparsedRows": []
85
+ "fileName": "277_02_13114.pdf",
86
+ "pages": 3,
87
+ "supplier": { "id": "etm", "title": "Электротехмонтаж" },
88
+ "lines": [
89
+ {
90
+ "num": 1,
91
+ "code": "ETM9943043",
92
+ "name": "Кабель силовой ВВГ-Пнг(А)-LS 3Х2.5ок(N,PE)-0.660 100м ТРТС",
93
+ "article": "МОНЭЛ",
94
+ "productType": "S",
95
+ "unit": "м",
96
+ "qty": 1000,
97
+ "price": 102.98,
98
+ "sum": 102980,
99
+ "total": 125635.6
100
+ }
101
+ ],
102
+ "totals": { "qty": 2535, "sum": 199671.33, "vat": 43927.71, "total": 243599.04 },
103
+ "warnings": [],
104
+ "unparsedRows": []
95
105
  }
96
106
  ```
97
107
 
98
108
  ## Покрытие
99
109
 
100
- | Поставщик | Статус |
101
- |---|---|
102
- | Электротехмонтаж (счета 277/...) | профиль `etm`, проверено 19 из 19 счетов: число строк и суммы совпали до копейки |
103
- | Darklum (счёт-оферта 9426) | нужен отдельный профиль (блочная вёрстка, не таблица) |
104
- | ВсеИнструменты (кассовые чеки) | нужен отдельный профиль (позиции блоками) |
110
+ | Поставщик | Статус |
111
+ | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
112
+ | Электротехмонтаж (счета 277/...) | профиль `etm`, проверено 19 из 19 счетов: число строк и суммы совпали до копейки |
113
+ | Леруа Мерлен / ЛЕ МОНЛИД | три макета: `leman`, `leman-offer` (счёт-оферта со скидкой на документ), `leman-shift`; 45 счетов из 46 сошлись с итогом, ещё 1 — счёт без таблицы (только сумма к оплате) |
114
+ | Лунда | профиль `lunda`, 52 счёта: 51 сошёлся с «Итого без НДС» до копейки, 1 — с отличающимся шаблоном (расхождение видно в `warnings`) |
115
+ | Нормал-Вент | профиль `normalvent`, 29 из 29 счетов |
116
+ | ТЕРЕМ | профили `terem` и `terem-narrow` (сдвинутый макет), 10 из 10 счетов |
117
+ | СТД «Петрович» | пять макетов: `petrovich/wide`, `petrovich/main`, `petrovich/discount`, `petrovich/compact`, `petrovich/narrow`; 17 счетов из 18 (выгрузка «Заказ в Excel» не счёт) |
118
+ | Прочие поставщики корпуса | 29 профилей по ИНН: формы «Счёт на оплату» (1С и её варианты), счёт-договор, счёт-оферта, таблицы ИП, счёт с колонкой скидки. Итого 47 счетов от 30 поставщиков — все 47 сошлись с итогом документа до копейки |
119
+ | Darklum (счёт-оферта 9426) | нужен отдельный профиль (блочная вёрстка, не таблица) |
120
+ | ВсеИнструменты (кассовые чеки) | нужен отдельный профиль (позиции блоками) |
105
121
 
106
122
  ## Регресс
107
123
 
@@ -120,7 +136,16 @@ pnpm run build && pnpm run regress -- /путь/к/pdf [эталон.json]
120
136
  (`S` — складской, `Z`/`N` — заказной, в счетах шаблона «Дриада» встречается `R`), `unit` — уже
121
137
  чистая единица (`м`, `шт`, `упак`). В версиях до 0.2.0 буква шла в составе `unit` («S м»).
122
138
  - Для профилей с `pricesIncludeVat` (например `leman`, Леруа Мерлен) нода сама считает `sum` без
123
- НДС по ставке из документа, а `total` оставляет как в счёте; итоги берутся из строк документа.
139
+ НДС, а `total` оставляет как в счёте. Ставка берётся из напечатанных итогов документа
140
+ (`Сумма НДС / Итого без НДС`), поэтому 20 % в счетах 2025 года и 22 % в счетах 2026-го читаются
141
+ одной и той же формой; `vatRate` профиля — только запасной вариант.
142
+ - Сумма позиций сверяется с напечатанным итогом документа. Расхождение попадает в `warnings`
143
+ (с учётом допуска на построчное округление), а не проходит молча.
144
+ - Позиция, повторённая на стыке страниц (тот же номер, количество, цена и сумма), считается
145
+ один раз.
146
+ - У профилей с `descriptionAbove` (СТД «Петрович») наименование и код нарисованы строкой выше
147
+ числовой строки: такие строки придерживаются в буфере и приклеиваются к следующей позиции.
148
+ - `rowPattern.code` необязателен: у профилей без колонки кода позиция распознаётся по номеру.
124
149
 
125
150
  ## Релиз
126
151