@orvello/sdk 0.7.4 → 0.7.6

package/dist/contract.js

@@ -2242,7 +2242,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 }
     },
@@ -4415,7 +4429,7 @@ var apiRoutes_invoices_external = {
     meta: {
       tags: ["invoices-external"],
       summary: "Update invoice status (external API)",
-      description: "Changes invoice status (e.g., mark as paid). State machine rules are enforced server-side. GoBD-safe: issued invoices cannot be cancelled directly; use credit note/cancellation endpoints instead.",
+      description: 'Changes invoice status (e.g., mark as paid). State machine rules are enforced server-side. GoBD-safe: issued invoices cannot be cancelled directly; use credit note/cancellation endpoints instead. A paid status set here is stored with paidSource "external"; the optional source (api, sync, webhook) is kept in the audit log only.',
       validated: { "params": true, "query": false, "body": true }
     },
     types: null
@@ -4441,7 +4455,7 @@ var apiRoutes_invoices_external = {
     meta: {
       tags: ["invoices-external"],
       summary: "Issue credit note (external API)",
-      description: "Issues a GoBD-compliant credit note or cancellation invoice. Generates PDF and creates an immutable document. Returns the new correction invoice.",
+      description: "Issues a GoBD-compliant credit note or cancellation invoice. Generates PDF and creates an immutable document. Returns the new correction invoice. Optional idempotencyKey (max 200, e.g. the refund id): a retry with the same key on the same invoice returns the correction already issued (201, replayed: true) instead of booking a second one; the same key with a different body returns 409 IDEMPOTENCY_CONFLICT. Keys do not expire.",
       validated: { "params": true, "query": false, "body": true }
     },
     types: null
@@ -5282,6 +5296,19 @@ var apiRoutes_managing_companies = {
     types: null
   },
   // Contract source: explicit
+  "managing_companies_transfer_owner": {
+    method: "PUT",
+    path: "/managing-companies/:id/owner",
+    auth: { "type": "frontend_permission_http", "permission": "bookkeeping_access" },
+    meta: {
+      tags: ["managing-companies"],
+      summary: "Besitz einer Firma uebergeben",
+      description: "Uebergibt den Besitz einer Managing Company an einen anderen Admin. Die Firma zaehlt nur gegen den Plan ihres Besitzers (Firmenzahl, Rechnungen je Monat, Speicher). Nur der jetzige Besitzer (oder ein Plattform-Admin) darf uebergeben; der neue Besitzer muss unbefristeter Admin sein und Platz in seinem Plan haben (sonst 403 PLAN_LIMIT_REACHED). Fehler: 403 COMPANY_OWNERSHIP_FORBIDDEN, 404 COMPANY_NOT_FOUND, 422 COMPANY_OWNER_MUST_BE_ADMIN. Erfordert `bookkeeping_access`.",
+      validated: { "params": true, "query": false, "body": true }
+    },
+    types: null
+  },
+  // Contract source: explicit
   "managing_companies_delete": {
     method: "DELETE",
     path: "/managing-companies/:id",