@catalogicus-international/n8n-nodes-invoice-parser 0.1.2 → 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 +52 -26
- package/dist/nodes/InvoicePdfParser/InvoicePdfParser.node.js +9 -3
- package/dist/nodes/InvoicePdfParser/InvoicePdfParser.node.js.map +1 -1
- package/dist/nodes/InvoicePdfParser/parse.d.ts +9 -1
- package/dist/nodes/InvoicePdfParser/parse.js +1165 -20
- package/dist/nodes/InvoicePdfParser/parse.js.map +1 -1
- package/dist/nodes/InvoicePdfParser/profiles.d.ts +28 -2
- package/dist/nodes/InvoicePdfParser/profiles.js +895 -2
- package/dist/nodes/InvoicePdfParser/profiles.js.map +1 -1
- package/dist/package.json +1 -1
- package/package.json +1 -1
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,42 @@ 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 профилей по ИНН: формы «Счёт на оплату» (1С и её варианты), счёт-договор, счёт-оферта, таблицы ИП, счёт с колонкой скидки. Итого 47 счетов от 30 поставщиков — все 47 сошлись с итогом документа до копейки |
|
|
119
|
+
| Darklum (счёт-оферта 9426) | нужен отдельный профиль (блочная вёрстка, не таблица) |
|
|
120
|
+
| ВсеИнструменты (кассовые чеки) | нужен отдельный профиль (позиции блоками) |
|
|
105
121
|
|
|
106
122
|
## Регресс
|
|
107
123
|
|
|
@@ -116,10 +132,20 @@ pnpm run build && pnpm run regress -- /путь/к/pdf [эталон.json]
|
|
|
116
132
|
- Профиль `etm` привязан к текущему шаблону счетов: границы колонок в пунктах
|
|
117
133
|
(`33.5 · 47.2 · 95.3 · 229.3 · 267.1 · 274 · 291.2 · 325.5 · 366.8 · 383.9 · 425.2 · 442.3 · 456.1 · 500.8 · 548.9`).
|
|
118
134
|
Если поставщик поменяет шаблон — правится `nodes/InvoicePdfParser/profiles.ts`.
|
|
119
|
-
-
|
|
120
|
-
(
|
|
121
|
-
|
|
122
|
-
|
|
135
|
+
- Тип товара и единица измерения приходят раздельно: `productType` — буква из колонки «У»
|
|
136
|
+
(`S` — складской, `Z`/`N` — заказной, в счетах шаблона «Дриада» встречается `R`), `unit` — уже
|
|
137
|
+
чистая единица (`м`, `шт`, `упак`). В версиях до 0.2.0 буква шла в составе `unit` («S м»).
|
|
138
|
+
- Для профилей с `pricesIncludeVat` (например `leman`, Леруа Мерлен) нода сама считает `sum` без
|
|
139
|
+
НДС, а `total` оставляет как в счёте. Ставка берётся из напечатанных итогов документа
|
|
140
|
+
(`Сумма НДС / Итого без НДС`), поэтому 20 % в счетах 2025 года и 22 % в счетах 2026-го читаются
|
|
141
|
+
одной и той же формой; `vatRate` профиля — только запасной вариант.
|
|
142
|
+
- Сумма позиций сверяется с напечатанным итогом документа. Расхождение попадает в `warnings`
|
|
143
|
+
(с учётом допуска на построчное округление), а не проходит молча.
|
|
144
|
+
- Позиция, повторённая на стыке страниц (тот же номер, количество, цена и сумма), считается
|
|
145
|
+
один раз.
|
|
146
|
+
- У профилей с `descriptionAbove` (СТД «Петрович») наименование и код нарисованы строкой выше
|
|
147
|
+
числовой строки: такие строки придерживаются в буфере и приклеиваются к следующей позиции.
|
|
148
|
+
- `rowPattern.code` необязателен: у профилей без колонки кода позиция распознаётся по номеру.
|
|
123
149
|
|
|
124
150
|
## Релиз
|
|
125
151
|
|
|
@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.InvoicePdfParser = void 0;
|
|
4
4
|
const n8n_workflow_1 = require("n8n-workflow");
|
|
5
5
|
const parse_1 = require("./parse");
|
|
6
|
+
const profiles_1 = require("./profiles");
|
|
6
7
|
class InvoicePdfParser {
|
|
7
8
|
constructor() {
|
|
8
9
|
this.description = {
|
|
@@ -32,15 +33,19 @@ class InvoicePdfParser {
|
|
|
32
33
|
default: 'auto',
|
|
33
34
|
options: [
|
|
34
35
|
{
|
|
35
|
-
name: 'Auto-Detect',
|
|
36
|
+
name: 'Auto-Detect (Recommended)',
|
|
36
37
|
value: 'auto',
|
|
37
38
|
description: 'Detect the supplier from the document text',
|
|
38
39
|
},
|
|
39
|
-
|
|
40
|
+
...profiles_1.PROFILES.map((profile) => ({
|
|
41
|
+
name: profile.title,
|
|
42
|
+
value: profile.id,
|
|
43
|
+
description: `Column layout of ${profile.title}`,
|
|
44
|
+
})),
|
|
40
45
|
{
|
|
41
46
|
name: 'Universal',
|
|
42
47
|
value: 'universal',
|
|
43
|
-
description: '
|
|
48
|
+
description: 'Only text rows are returned, no line items',
|
|
44
49
|
},
|
|
45
50
|
],
|
|
46
51
|
},
|
|
@@ -133,6 +138,7 @@ class InvoicePdfParser {
|
|
|
133
138
|
mimeType: binary.mimeType,
|
|
134
139
|
pages: result.pages,
|
|
135
140
|
supplier: result.supplier,
|
|
141
|
+
layout: result.layout,
|
|
136
142
|
lines: result.lines,
|
|
137
143
|
totals: result.totals,
|
|
138
144
|
warnings: result.warnings,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"InvoicePdfParser.node.js","sourceRoot":"","sources":["../../../nodes/InvoicePdfParser/InvoicePdfParser.node.ts"],"names":[],"mappings":";;;AAOA,+CAAuE;AACvE,mCAA0C;
|
|
1
|
+
{"version":3,"file":"InvoicePdfParser.node.js","sourceRoot":"","sources":["../../../nodes/InvoicePdfParser/InvoicePdfParser.node.ts"],"names":[],"mappings":"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"}
|
|
@@ -17,7 +17,9 @@ export interface InvoiceLine {
|
|
|
17
17
|
code: string;
|
|
18
18
|
name: string;
|
|
19
19
|
article: string;
|
|
20
|
+
productType: string;
|
|
20
21
|
unit: string;
|
|
22
|
+
vat: number;
|
|
21
23
|
qty: number;
|
|
22
24
|
price: number;
|
|
23
25
|
sum: number;
|
|
@@ -29,6 +31,10 @@ export interface ParseResult {
|
|
|
29
31
|
id: string;
|
|
30
32
|
title: string;
|
|
31
33
|
};
|
|
34
|
+
layout: {
|
|
35
|
+
id: string;
|
|
36
|
+
score: number;
|
|
37
|
+
};
|
|
32
38
|
pages: number;
|
|
33
39
|
lines: InvoiceLine[];
|
|
34
40
|
totals: {
|
|
@@ -43,8 +49,10 @@ export interface ParseResult {
|
|
|
43
49
|
export declare function buildRows(items: TextItem[], yTolerance?: number, page?: number): PdfRow[];
|
|
44
50
|
export declare function rowText(row: PdfRow, gap?: number): string;
|
|
45
51
|
export declare function rowCells(row: PdfRow, profile: SupplierProfile, gap?: number): RowCells;
|
|
52
|
+
export declare function layoutScore(rows: PdfRow[], profile: SupplierProfile): number;
|
|
46
53
|
export declare function detectProfile(text: string): SupplierProfile;
|
|
47
|
-
export declare function
|
|
54
|
+
export declare function detectCandidates(text: string): SupplierProfile[];
|
|
55
|
+
export declare function parseRows(rows: PdfRow[], profile: SupplierProfile, layoutScoreValue?: number, isUniversal?: boolean): ParseResult;
|
|
48
56
|
export declare function parseInvoicePdf(data: Uint8Array, profileId?: string, yTolerance?: number): Promise<ParseResult & {
|
|
49
57
|
text: string;
|
|
50
58
|
}>;
|