@orvello/sdk 0.7.3 → 0.7.5

package/CONTRACT_SHA256

@@ -1 +1 @@
-b414bb56aaac36ef5eae18b77139b36fed7ca09c638a70472b00acb2650aedd9
+29bbbf64365d404e54e1596605e4d1c7fe1b86ed99797a52f04d40053b721a0e

package/dist/contract.cjs

@@ -34,7 +34,8 @@ var apiMountPrefixes = {
     "/exports",
     "/invoices",
     "/managing-companies",
-    "/oauth"
+    "/oauth",
+    "/tax-years"
   ]
 };
 var apiGroups = {
@@ -161,6 +162,10 @@ var apiGroups = {
       "key": "managing_company_logos",
       "module": "./features/routes.managing_company_logos"
     },
+    {
+      "key": "tax_years",
+      "module": "./features/routes.tax_years"
+    },
     {
       "key": "work_tracking",
       "module": "./features/routes.work_tracking"
@@ -275,6 +280,10 @@ var apiGroups = {
       "key": "settings",
       "module": "./base/routes.settings"
     },
+    {
+      "key": "tax_years",
+      "module": "./features/routes.tax_years"
+    },
     {
       "key": "user_activity",
       "module": "./base/routes.user_activity"
@@ -2235,7 +2244,21 @@ var apiRoutes_bookkeeping = {
     meta: {
       tags: ["bookkeeping", "payments-external"],
       summary: "Settle invoice via external API",
-      description: "One-shot settlement for shop/payment-provider flows: creates payment, allocates it to the invoice, and can auto-close shortfall as discount so no manual allocation step remains.",
+      description: "One-shot settlement for shop/payment-provider flows. Preferred contract: grossAmount (customer payment, settles the invoice), feeAmount + feeProvider + feeReference (provider fee, booked as expense, never as customer discount), paidAt (actual payment time) and, for a payment currency other than the invoice currency, originalAmount/originalCurrency (documented gross in invoice currency; realized FX difference is recorded). Legacy contract (payoutAmount + bookedAt, optional closeGapStrategy=discount) keeps working unchanged; existing discounts are not reinterpreted. A changed fee for an already used reference is rejected with 409: use /settle-invoice/fee-correction.",
+      bodyContentType: "application/json",
+      validated: { "params": false, "query": false, "body": true }
+    },
+    types: null
+  },
+  // Contract source: explicit
+  "bookkeeping_payments_settlement_fee_correction_external": {
+    method: "POST",
+    path: "/bookkeeping/payments/external/settle-invoice/fee-correction",
+    auth: { "type": "unified_bearer", "allowUserSession": false, "allowOAuth2": true, "allowApiKey": true, "requireRole": "editor", "scopes": ["payments:write", "invoices:write"] },
+    meta: {
+      tags: ["bookkeeping", "payments-external"],
+      summary: "Correct the provider fee of an external settlement",
+      description: "Later provider fee change (e.g. fee refund) on a settlement made with grossAmount/feeAmount. The original payment stays unchanged; the difference is booked on correctedAt as its own account movement with a signed fee receipt. Idempotent per correctionRef. Legacy net-payout settlements are refused (422): their fee was never documented.",
       bodyContentType: "application/json",
       validated: { "params": false, "query": false, "body": true }
     },
@@ -5809,6 +5832,75 @@ var apiRoutes_settings = {
   }
 };
 
+// src/generated/api/features/routes.tax_years.ts
+var apiRoutes_tax_years = {
+  // Contract source: explicit
+  "tax_years_get": {
+    method: "GET",
+    path: "/tax-years/:year",
+    auth: { "type": "frontend_bearer_http" },
+    meta: {
+      tags: ["tax-years"],
+      summary: "Pers\xF6nlichen Steuerjahr-Arbeitsbereich lesen",
+      description: "Lesend, legt keine Daten an. Nur der angemeldete Nutzer, unabh\xE4ngig von der ausgew\xE4hlten Firma. Liefert Aufgaben, Blocker, Quellen und aktuelle betriebliche Vorschauen mit erneut gepr\xFCften Zugriffsrechten. Fehlerhafte Daten sind unbekannt, niemals Null. Kein Steuerbescheid und keine Abgabe.",
+      validated: { "params": true, "query": false, "body": false }
+    },
+    types: null
+  },
+  // Contract source: explicit
+  "tax_years_configure": {
+    method: "PUT",
+    path: "/tax-years/:year/configuration",
+    auth: { "type": "frontend_bearer_http" },
+    meta: {
+      tags: ["tax-years"],
+      summary: "Pers\xF6nliche Situation und eigene Betriebe zuordnen",
+      description: "Ersetzt die vollst\xE4ndige Konfiguration eines Jahres. expectedRevision aus GET, neue requestId pro \xC4nderung; bei Transportfehler dieselbe Anfrage wiederholen. 409 bei konkurrierender \xC4nderung. Betriebe erfordern unbeschr\xE4nkten Verwaltungszugriff und die ausdr\xFCckliche Zuordnung als eigener Einzelbetrieb. Alte Pr\xFCfungen und Abgabereferenzen bleiben nachvollziehbar.",
+      validated: { "params": true, "query": false, "body": false }
+    },
+    types: null
+  },
+  // Contract source: explicit
+  "tax_years_review": {
+    method: "POST",
+    path: "/tax-years/:year/reviews",
+    auth: { "type": "frontend_bearer_http" },
+    meta: {
+      tags: ["tax-years"],
+      summary: "Pr\xFCfung eines Vorbereitungsschritts dokumentieren oder wieder \xF6ffnen",
+      description: "taskKey und basisFingerprint kommen aus GET. Nur ausdr\xFCcklich gepr\xFCfte Schritte best\xE4tigen; note benennt gepr\xFCfte Nachweise oder offene Punkte. Bei business:<id>:tax_checks ist corrections zwingend, auch als leere Liste; ersetzt die Korrekturen dieses Betriebs. Jede Korrektur verlangt betriebliche Zuordnung, Begr\xFCndung und Belegreferenz. euer-Pr\xFCfung archiviert die Berechnung. reopen einer Abgabe erh\xE4lt die Referenz und markiert erneuten Pr\xFCfbedarf. 409 bei ge\xE4nderter Grundlage, 422 bei offenen Voraussetzungen. Kein automatisches Abschlie\xDFen aufgrund vorhandener Zahlen.",
+      validated: { "params": true, "query": false, "body": false }
+    },
+    types: null
+  },
+  // Contract source: explicit
+  "tax_years_record_submission": {
+    method: "POST",
+    path: "/tax-years/:year/submissions",
+    auth: { "type": "frontend_bearer_http" },
+    meta: {
+      tags: ["tax-years"],
+      summary: "Bereits erfolgte externe Abgabe dokumentieren",
+      description: "Speichert Datum und \xDCbermittlungsreferenz. Sendet nichts an ELSTER. Auch eine Abgabe mit offenen Punkten kann ehrlich erfasst werden; sie wird als pr\xFCfbed\xFCrftig angezeigt. Wiederholte Korrekturen erzeugen eine Revision. Abgabe ist kein Nachweis steuerlicher Vollst\xE4ndigkeit.",
+      validated: { "params": true, "query": false, "body": false }
+    },
+    types: null
+  },
+  // Contract source: explicit
+  "tax_years_history": {
+    method: "GET",
+    path: "/tax-years/:year/history",
+    auth: { "type": "frontend_bearer_http" },
+    meta: {
+      tags: ["tax-years"],
+      summary: "Pers\xF6nlichen \xC4nderungsverlauf lesen",
+      description: "H\xF6chstens 50 Revisionen, absteigend. nextBeforeRevision als beforeRevision f\xFCr die n\xE4chste Seite. Ausschlie\xDFlich der eigene Verlauf.",
+      validated: { "params": true, "query": true, "body": false }
+    },
+    types: null
+  }
+};
+
 // src/generated/api/base/routes.user_activity.ts
 var apiRoutes_user_activity = {
   // Contract source: explicit
@@ -6207,6 +6299,7 @@ var apiRoutes = {
   ...apiRoutes_roles,
   ...apiRoutes_security,
   ...apiRoutes_settings,
+  ...apiRoutes_tax_years,
   ...apiRoutes_user_activity,
   ...apiRoutes_users,
   ...apiRoutes_webhooks,
@@ -6243,6 +6336,7 @@ exports.apiRoutes_permissions = apiRoutes_permissions;
 exports.apiRoutes_roles = apiRoutes_roles;
 exports.apiRoutes_security = apiRoutes_security;
 exports.apiRoutes_settings = apiRoutes_settings;
+exports.apiRoutes_tax_years = apiRoutes_tax_years;
 exports.apiRoutes_user_activity = apiRoutes_user_activity;
 exports.apiRoutes_users = apiRoutes_users;
 exports.apiRoutes_webhooks = apiRoutes_webhooks;