@catalogicus-international/n8n-nodes-invoice-parser 0.2.0 → 0.2.2
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 +51 -23
- package/dist/nodes/InvoicePdfParser/parse.d.ts +3 -1
- package/dist/nodes/InvoicePdfParser/parse.js +1236 -71
- package/dist/nodes/InvoicePdfParser/parse.js.map +1 -1
- package/dist/nodes/InvoicePdfParser/profiles.d.ts +26 -5
- package/dist/nodes/InvoicePdfParser/profiles.js +899 -3
- package/dist/nodes/InvoicePdfParser/profiles.js.map +1 -1
- package/dist/package.json +2 -2
- package/package.json +70 -72
package/README.md
CHANGED
|
@@ -63,13 +63,13 @@ pnpm test
|
|
|
63
63
|
|
|
64
64
|
## Параметры
|
|
65
65
|
|
|
66
|
-
| Параметр
|
|
67
|
-
|
|
68
|
-
| Input Binary Field
|
|
69
|
-
| Supplier Profile
|
|
70
|
-
| Output
|
|
71
|
-
| Options → Y Tolerance
|
|
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,45 @@ pnpm test
|
|
|
82
82
|
|
|
83
83
|
```json
|
|
84
84
|
{
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
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
|
-
|
|
|
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 профилей по ИНН (корпус `stabs/СЧЕТА`): формы «Счёт на оплату» (1С и её варианты), счёт-договор, счёт-оферта, таблицы ИП, счёт с колонкой скидки. Итого 47 счетов от 30 поставщиков — все 47 сошлись с итогом документа до копейки |
|
|
119
|
+
| ООО «МЕГАПОЛИС» (аренда) | профиль `megapolis`: форма «Счёт на оплату» 1С без кода, количество в сутках. Границы колонок вычисляются по шапке таблицы (проверено только на этом поставщике), при нераспознанной шапке берутся запасные константы профиля; счёт № 1106-0010 сошёлся с итогом до копейки |
|
|
120
|
+
| Darklum (счёт-оферта 9426) | нужен отдельный профиль (блочная вёрстка, не таблица) |
|
|
121
|
+
| ВсеИнструменты (кассовые чеки) | нужен отдельный профиль (позиции блоками) |
|
|
122
|
+
|
|
123
|
+
Всего в пакете 43 профиля; `pnpm run regress` проверяет 48 эталонных PDF из `fixtures`.
|
|
105
124
|
|
|
106
125
|
## Регресс
|
|
107
126
|
|
|
@@ -120,7 +139,16 @@ pnpm run build && pnpm run regress -- /путь/к/pdf [эталон.json]
|
|
|
120
139
|
(`S` — складской, `Z`/`N` — заказной, в счетах шаблона «Дриада» встречается `R`), `unit` — уже
|
|
121
140
|
чистая единица (`м`, `шт`, `упак`). В версиях до 0.2.0 буква шла в составе `unit` («S м»).
|
|
122
141
|
- Для профилей с `pricesIncludeVat` (например `leman`, Леруа Мерлен) нода сама считает `sum` без
|
|
123
|
-
|
|
142
|
+
НДС, а `total` оставляет как в счёте. Ставка берётся из напечатанных итогов документа
|
|
143
|
+
(`Сумма НДС / Итого без НДС`), поэтому 20 % в счетах 2025 года и 22 % в счетах 2026-го читаются
|
|
144
|
+
одной и той же формой; `vatRate` профиля — только запасной вариант.
|
|
145
|
+
- Сумма позиций сверяется с напечатанным итогом документа. Расхождение попадает в `warnings`
|
|
146
|
+
(с учётом допуска на построчное округление), а не проходит молча.
|
|
147
|
+
- Позиция, повторённая на стыке страниц (тот же номер, количество, цена и сумма), считается
|
|
148
|
+
один раз.
|
|
149
|
+
- У профилей с `descriptionAbove` (СТД «Петрович») наименование и код нарисованы строкой выше
|
|
150
|
+
числовой строки: такие строки придерживаются в буфере и приклеиваются к следующей позиции.
|
|
151
|
+
- `rowPattern.code` необязателен: у профилей без колонки кода позиция распознаётся по номеру.
|
|
124
152
|
|
|
125
153
|
## Релиз
|
|
126
154
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type ColumnKey, type SupplierProfile } from './profiles';
|
|
1
|
+
import { type Column, type ColumnKey, type HeaderColumns, type SupplierProfile } from './profiles';
|
|
2
2
|
export interface TextItem {
|
|
3
3
|
str: string;
|
|
4
4
|
x: number;
|
|
@@ -52,6 +52,8 @@ export declare function rowCells(row: PdfRow, profile: SupplierProfile, gap?: nu
|
|
|
52
52
|
export declare function layoutScore(rows: PdfRow[], profile: SupplierProfile): number;
|
|
53
53
|
export declare function detectProfile(text: string): SupplierProfile;
|
|
54
54
|
export declare function detectCandidates(text: string): SupplierProfile[];
|
|
55
|
+
export declare function headerColumns(rows: PdfRow[], spec: HeaderColumns): Column[] | undefined;
|
|
56
|
+
export declare function resolveProfileColumns(rows: PdfRow[], profile: SupplierProfile): SupplierProfile;
|
|
55
57
|
export declare function parseRows(rows: PdfRow[], profile: SupplierProfile, layoutScoreValue?: number, isUniversal?: boolean): ParseResult;
|
|
56
58
|
export declare function parseInvoicePdf(data: Uint8Array, profileId?: string, yTolerance?: number): Promise<ParseResult & {
|
|
57
59
|
text: string;
|