e-arveldaja-mcp 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.
@@ -71,6 +71,21 @@ If no past invoices exist, call `list_purchase_articles` and choose the most app
71
71
  - 49 (Consultation/Konsultatsioon, acct 5340)
72
72
  - 62 (Other operating/Muud tegevuskulud, acct 5990)
73
73
 
74
+ ### Step 5b: Determine reverse charge VAT (pöördkäibemaks)
75
+
76
+ ALWAYS check if reverse charge applies. Set `reversed_vat_id: 1` on items when:
77
+ - Supplier is **outside Estonia** (EU or non-EU) AND provides services
78
+ - Invoice mentions "reverse charge", "Article 196", "pöördkäibemaks", or has 0% VAT with a foreign supplier
79
+ - Supplier country is NOT Estonia (check cl_code_country, VAT number prefix, or address)
80
+
81
+ When reverse charge applies:
82
+ - `vat_rate_dropdown`: "0"
83
+ - `reversed_vat_id`: 1
84
+
85
+ When supplier is Estonian with regular VAT:
86
+ - `vat_rate_dropdown`: the VAT rate (e.g. "24")
87
+ - `reversed_vat_id`: null (don't set)
88
+
74
89
  ### Step 6: Create the purchase invoice
75
90
 
76
91
  Call `create_purchase_invoice_from_pdf`:
@@ -84,7 +99,8 @@ Call `create_purchase_invoice_from_pdf`:
84
99
  - cl_purchase_articles_id: from step 5
85
100
  - purchase_accounts_id: from step 5
86
101
  - total_net_price: net amount
87
- - vat_rate_dropdown: VAT rate as string (e.g. "24")
102
+ - vat_rate_dropdown: VAT rate as string (e.g. "24", or "0" for reverse charge)
103
+ - reversed_vat_id: 1 if reverse charge applies (see step 5b)
88
104
  - amount: quantity
89
105
  - vat_price: EXACT total VAT from the original invoice
90
106
  - gross_price: EXACT total gross from the original invoice
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "e-arveldaja-mcp",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "MCP server for Estonian e-arveldaja (e-Financials) API",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -77,6 +77,21 @@ If no past invoices exist, call `list_purchase_articles` and choose the most app
77
77
  | 49 | Konsultatsioon / Consultation | 5340 | Consulting fees |
78
78
  | 62 | Muud tegevuskulud / Other operating | 5990 | Catch-all |
79
79
 
80
+ ## Step 5b: Determine reverse charge VAT (pöördkäibemaks)
81
+
82
+ ALWAYS check if reverse charge applies. Set `reversed_vat_id: 1` on items when:
83
+ - Supplier is **outside Estonia** (EU or non-EU) AND provides services
84
+ - Invoice mentions "reverse charge", "Article 196", "pöördkäibemaks", or has 0% VAT with a foreign supplier
85
+ - Supplier country is NOT Estonia (check `cl_code_country`, VAT number prefix, or address)
86
+
87
+ When reverse charge applies:
88
+ - `vat_rate_dropdown`: `"0"`
89
+ - `reversed_vat_id`: `1`
90
+
91
+ When supplier is Estonian with regular VAT:
92
+ - `vat_rate_dropdown`: the VAT rate (e.g. `"24"`)
93
+ - `reversed_vat_id`: do not set
94
+
80
95
  ## Step 6: Create the purchase invoice
81
96
 
82
97
  Call `create_purchase_invoice_from_pdf`:
@@ -90,7 +105,8 @@ Call `create_purchase_invoice_from_pdf`:
90
105
  - `cl_purchase_articles_id`: from step 5
91
106
  - `purchase_accounts_id`: from step 5
92
107
  - `total_net_price`: net amount
93
- - `vat_rate_dropdown`: VAT rate as string (e.g. `"24"`)
108
+ - `vat_rate_dropdown`: VAT rate as string (e.g. `"24"`, or `"0"` for reverse charge)
109
+ - `reversed_vat_id`: `1` if reverse charge applies (see step 5b)
94
110
  - `amount`: quantity
95
111
  - `vat_price`: **EXACT** total VAT from the original invoice
96
112
  - `gross_price`: **EXACT** total gross from the original invoice