@orvello/sdk 0.7.4 → 0.7.5

package/CONTRACT_SHA256

@@ -1 +1 @@
-a43f5ee82135a27003853cb05b2cea0f57c63b4fe23795f7b838ef0cb2deb5d9
+29bbbf64365d404e54e1596605e4d1c7fe1b86ed99797a52f04d40053b721a0e

package/dist/contract.cjs

@@ -2244,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 }
     },