n8n Integration

1// POST /api/v1/invoice/{countryCode}/{format}/generate
2{
3  "invoice": {
4    "invoiceNumber": "INV-2025-001",
5    "type": "invoice",
6    "issueDate": "2025-01-15",
7    "dueDate": "2025-02-14",
8    "seller": {
9      "name": "ACME GmbH",
10      "vatId": "DE123456789",
11      "street": "Hauptstraße 1",
12      "city": "Berlin",
13      "postalCode": "10115",
14      "countryCode": "DE"
15    },
16    "buyer": {
17      "name": "Customer AG",
18      "vatId": "DE987654321",
19      "street": "Musterweg 5",
20      "city": "München",
21      "postalCode": "80331",
22      "countryCode": "DE"
23    },
24    "countrySpecific": { "buyerReference": "BUYER-REF-001" },
25    "items": [{
26      "position": 1,
27      "description": "Beratung",
28      "quantity": 10,
29      "unit": "HUR",
30      "unitPrice": 150.00,
31      "taxRate": 19,
32      "netAmount": 1500.00,
33      "taxAmount": 285.00,
34      "grossAmount": 1785.00
35    }],
36    "currency": "EUR",
37    "subtotal": 1500.00,
38    "total": 1785.00,
39    "taxSummary": [{ "taxRate": 19, "netAmount": 1500.00, "taxAmount": 285.00 }],
40    "paymentTerms": { "dueDays": 30 }
41  }
42}
43 
44// Response:
45{
46  "success": true,
47  "format": "xrechnung",
48  "filename": "INV-2025-001.xml",
49  "mimeType": "application/xml",
50  "hash": "sha256:...",
51  "data": "PD94bWwgdmVyc2lvbj0i..."
52}

1// POST /api/v1/invoice/de/xrechnung/parse
2// Request: application/json
3{
4  "data": "<base64-encoded XML or PDF>",
5  "filename": "rechnung.xml"
6}
7 
8// Response:
9{
10  "success": true,
11  "format": "XRECHNUNG_UBL",
12  "hash": "sha256:...",
13  "invoice": {
14    "invoiceNumber": "INV-2025-001",
15    "type": "invoice",
16    "issueDate": "2025-01-15",
17    "dueDate": "2025-02-14",
18    "seller": { "name": "ACME GmbH", ... },
19    "buyer": { "name": "Customer AG", ... },
20    "items": [{ "position": 1, "description": "Beratung", ... }],
21    "currency": "EUR",
22    "subtotal": 1500.00,
23    "total": 1785.00
24  }
25}

1// POST /api/v1/invoice/parse
2// Request: application/json
3{
4  "data": "<base64-encoded XML or PDF>",
5  "filename": "rechnung.xml"
6}
7 
8// Response:
9{
10  "success": true,
11  "hash": "sha256:...",
12  "invoice": {
13    "invoiceNumber": "INV-2025-001",
14    "issueDate": "2025-01-15",
15    ...
16  },
17  "detection": {
18    "format": "XRECHNUNG_UBL",
19    "formatVersion": "3.0.2",
20    "countryCode": "DE",
21    "confidence": 98,
22    "formatMethod": "CUSTOMIZATION_ID",
23    "countrySource": "DOCUMENT",
24    "isAmbiguous": false,
25    "alternativeCountries": []
26  }
27}

1// POST /api/v1/invoice/{countryCode}/validate
2{
3  "invoice": {
4    "invoiceNumber": "INV-2025-001",
5    "type": "invoice",
6    "issueDate": "2025-01-15",
7    ...
8  }
9}
10 
11// Response:
12{
13  "valid": true,
14  "errors": [],
15  "warnings": []
16}

1// GET /api/v1/invoice/formats (scope: all)
2// GET /api/v1/invoice/{countryCode}/formats (scope: country)
3 
4// Response (scope: all):
5{
6  "countries": [
7    { "code": "DE", "name": "Germany", "formats": [
8        { "name": "XRechnung", "id": "xrechnung", "mimeType": "application/xml" },
9        { "name": "ZUGFeRD", "id": "zugferd", "mimeType": "application/pdf" },
10        { "name": "PDF", "id": "pdf", "mimeType": "application/pdf" }
11      ]
12    },
13    { "code": "AT", "name": "Austria", "formats": [
14        { "name": "ebInterface", "id": "ebinterface", "mimeType": "application/xml" },
15        { "name": "PDF", "id": "pdf", "mimeType": "application/pdf" }
16      ]
17    },
18    ...
19  ],
20}