kassza 1.0.1 → 1.0.2

package/README.md

@@ -750,8 +750,9 @@ export const POST = stripeWebhook({
 ```
 
 - Az újraküldött webhook nem állít ki második bizonylatot; a `dedupe: store` opcióval a már feldolgozott eseményt a Számla Agent hívása nélkül nyugtázza.
-- Teljes visszatérítéskor a kassza sztornózza a bizonylatot.
+- Teljes visszatérítéskor a kassza egyszer sztornózza a bizonylatot; több példány között ehhez a `lock` opció kell. A fizetés bizonylata előtt érkező visszatérítésre `in_progress` hibát ad, így a szolgáltató a fizetés után újraküldi.
 - Részleges visszatérítéskor számlánál visszatérítésenként egy helyesbítő számlát állít ki, a visszatérített összeget tételenként pontosan szétosztva; több áfakulcsnál és nyugtánál javaslatot ad.
+- A meghiúsult Stripe visszatérítés `refund-failed` eredményt ad, írás nélkül, kézi rendezésre.
 - Ugyanígy működik a `simplePayWebhook`, a `barionWebhook`, a `revolutWebhook` és a `payPalWebhook`.
 
 📖 **Dokumentáció:** [Fizetésből bizonylat](https://kasszajs.hu/docs/fizetesek)
@@ -1260,7 +1261,7 @@ A `doctor` ellenőrzi a Node.js-t, az Agent kulcsot, a gép óráját és a munk
 }
 ```
 
-Claude, Cursor és más MCP kliensek számára. Alapból csak olvas. Az `--allow-write` kapcsolóval kiállíthat és sztornózhat is, de minden íráshoz kell a megfelelő előnézeti eszköz megerősítő kódja.
+Claude, Cursor és más MCP kliensek számára. Alapból csak olvas. Az `--allow-write` kapcsolóval kiállíthat és sztornózhat is, de minden íráshoz kell a megfelelő előnézeti eszköz megerősítő kódja, 15 percig és csak az előnézet budapesti napján.
 
 📖 **Dokumentáció:** [MCP szerver](https://kasszajs.hu/docs/kiegeszitok/mcp-szerver)
 

package/agents/api.md

@@ -295,7 +295,7 @@ const journal = createJournal(kvJournal(store), { now? })
 createKassza({ hooks: { onDocument: (event) => journal.record(event), onDocumentError: 'throw' } })
 ```
 
-- `kvJournal(store, { prefix?, retentionDays? (400), reservationTtlDays? (30) })` needs a store with `increment`; `memoryJournal()` for tests; or implement `JournalStorage` for SQL.
+- `kvJournal(store, { prefix?, retentionDays? (400), reservationTtlDays? (30) })` needs a store with `increment`; it writes the day index with `setIfAbsent` (or `set` plus a read-back) and throws `store_unavailable` when that fails, so a `resilient` store cannot hide an entry; `reconcile()` re-indexes a stored entry that is missing from the index (`JournalStorage.indexEntry`, optional); `memoryJournal()` for tests; or implement `JournalStorage` for SQL.
 - `record(event)` stores created and reversed documents (payments are ignored); idempotent by document number.
 - `trackReceipt(orderNumber, run)` / `trackInvoice(orderNumber, run)` reserve before `run` and complete after it. Definite `SzamlazzError`s release the reservation; uncertain errors and crashes leave it pending. A failed journal write after success throws `JournalWriteError` with `result`.
 - `pending(range?)` lists reservations (last 30 days by default); `settle(kassza, { range?, releaseNotFound? })` looks them up by order number and records what it finds.
@@ -316,7 +316,7 @@ Webhook handlers are `(request: Request) => Promise<Response>`, usable directly
 
 - Common options: `onPayment(payment)`, `onError?(error)`, `method?` (the payment method written on the document), `maxBodyBytes?`, `fetch?`; `sandbox?` where the provider has one.
 - Responses: `400` for a bad signature or payload (never reaches `onPayment`), `200` on success (`204` for Revolut, a signed JSON for SimplePay), `500` when `onPayment` throws, so the provider redelivers.
-- `PaymentEvent` is `{ provider, kind: 'paid' | 'refunded' | 'partially-refunded' | 'failed' | 'other', id, eventId?, eventType?, orderRef?, amount?: { value, currency }, refundedAmount?, refunds?: { id, amount, refundedBefore?, createdAt? }[], paidAt?, method, customer?, items?, raw }`. Amounts are in major units (12700 HUF, not minor units). `refunds` lists the individual refunds the provider reported (Barion and SimplePay: all; Revolut and PayPal: the current one; Stripe: the delta of `charge.refunded` keyed by the event ID).
+- `PaymentEvent` is `{ provider, kind: 'paid' | 'refunded' | 'partially-refunded' | 'refund-failed' | 'failed' | 'other', id, eventId?, eventType?, orderRef?, amount?: { value, currency }, refundedAmount?, refunds?: { id, amount, refundedBefore?, createdAt? }[], paidAt?, method, customer?, items?, raw }`. Amounts are in major units (12700 HUF, not minor units). `refunds` lists the individual refunds the provider reported (Barion and SimplePay: all; Revolut and PayPal: the current one; Stripe: the delta of `charge.refunded` keyed by the event ID).
 - `dedupe?: KeyValueStore` and `dedupeTtlSeconds?` (7 days): an event that was already processed successfully is acknowledged without calling `onPayment` again. It is marked only after `onPayment` succeeds.
 
 ```ts
@@ -338,12 +338,12 @@ const result = await kassza.issueForPayment(payment, {
 })
 ```
 
-- `paid`: chooses receipt or invoice with `chooseDocument` (override with `document`) and issues it with `createOnce`. `refunded`: reverses that document exactly once. `failed` and `other`: skipped.
+- `paid`: chooses receipt or invoice with `chooseDocument` (override with `document`) and issues it with `createOnce`. `refunded`: reverses that document exactly once; concurrent calls in one process run one after the other, and `lock` (a store with `setIfAbsent`) keeps two processes from reversing at once (`in_progress` while another holds it). A refund that arrives before the payment's document throws `in_progress`, so the provider redelivers it after the paid event. `refund-failed` (Stripe `charge.refund.updated` / `refund.updated` / `refund.failed` with status `failed` or `canceled`): writes nothing and returns `{ kind: 'refund-failed', document, documentNumber, reason, orderNumber }` for a human; skipped without a document. `failed` and `other`: skipped.
 - `partially-refunded`: for an invoice, one corrective invoice per refund (external ID `{orderNumber}/R-{refund}`), with the refund allocated exactly over the original items (`allocateRefund`, house-monotone, never more than an item's original amount across refunds). If the invoice has several VAT rates and no `refundItems` is given, it returns `{ kind: 'refund-proposal', ... }` instead (or allocate proportionally with `partialRefund: 'proportional'`). For a receipt it always returns a `refund-proposal`. Without `payment.refunds` it is skipped with a reason.
 - The order number defaults to `{PROVIDER}-{payment id}`, for example `STRIPE-pi_123`, so the payment and its refund share it.
 - Items come from `items`, then the provider's line items, then one item with the paid amount (`fallbackItemName`). VAT comes from `vatFor`, the provider's per-item rate, then `vat`. Without any, it throws `validation`: kassza never guesses VAT.
 - The document total must equal the paid amount, unless `allowAmountMismatch: true`.
-- It returns `{ kind: 'receipt', number, created, receipt, decision, orderNumber }`, `{ kind: 'invoice', number, created, invoice, decision, orderNumber }`, `{ kind: 'reversal', document, reversedNumber, number?, created, orderNumber }`, `{ kind: 'correction', correctedNumber, created, corrections: { refundId, externalId, number, created, grossTotal, invoice }[], orderNumber }`, `{ kind: 'refund-proposal', document, documentNumber, refunds: { refundId, grossTotal, items }[], reason, orderNumber }` or `{ kind: 'skipped', reason, orderNumber }`.
+- It returns `{ kind: 'receipt', number, created, receipt, decision, orderNumber }`, `{ kind: 'invoice', number, created, invoice, decision, orderNumber }`, `{ kind: 'reversal', document, reversedNumber, number?, created, orderNumber }`, `{ kind: 'correction', correctedNumber, created, corrections: { refundId, externalId, number, created, grossTotal, invoice }[], orderNumber }`, `{ kind: 'refund-proposal', document, documentNumber, refunds: { refundId, grossTotal, items }[], reason, orderNumber }`, `{ kind: 'refund-failed', document, documentNumber, reason, orderNumber }` or `{ kind: 'skipped', reason, orderNumber }`.
 - `issueForPayment(api, payment, options)` from `kassza/payments` does the same with any object that has `invoices` and `receipts` (`createOnce`, `find`, `reverse`), for example a delegated client.
 
 ### `kassza/batch`

package/agents/pitfalls.md

@@ -48,6 +48,9 @@ Read this before writing any code that issues invoices or receipts. These rules
 | `maintenanceCooldownMs` | After error `1`, kassza sends nothing for the cooldown and throws `maintenance` at once | Switch to a fallback, for example a paper receipt pad |
 | `in_progress` error | Another process holds the `createOnce` lock for this order | Do not issue by hand; call `createOnce` again later (5xx in a webhook) |
 | `store_unavailable` error | The lock store (or a `fail-closed` attempt ledger) is down; nothing was sent | Restore the store, or choose `lockFailure: 'proceed'` / `attemptLedgerMode: 'fail-open'` deliberately |
+| Refund before the payment's document | `issueForPayment` throws `in_progress` on purpose: acknowledging the refund would let the paid redelivery issue a document for returned money | Let the webhook answer 500; acknowledge it only for payments that will never get a document |
+| Stripe refund fails after `charge.refunded` | `charge.refund.updated` gives `refund-failed`; the reversal or corrective invoice stays | Correct the books by hand |
+| Concurrent full refunds on several instances | Only one process at a time may reverse; in one process kassza serializes | Pass `lock` (a store with `setIfAbsent`) to `issueForPayment` |
 | Partial refund on a mixed-VAT invoice | `issueForPayment` returns `refund-proposal`, issues nothing | Pass `refundItems` (what was returned) or `partialRefund: 'proportional'` |
 | `registerPayment` twice | Two payments on the invoice (`additive` defaults to `true`) | Use `registerPaymentOnce({ key })` with a stable bank or payment ID |
 | `szamlaLetoltesPld` (PDF copies) | Obsolete in the XSD; Számlázz.hu ignores it, so kassza does not offer it | Nothing to do |

package/dist/batch/index.d.cts

@@ -1,8 +1,8 @@
 import { t as DateInput } from "../dates-nlGEokCf.cjs";
 import { M as CreateInvoiceInput } from "../context-zGthvNo2.cjs";
 import { t as CreateReceiptInput } from "../types-_HKTOCuQ.cjs";
-import { a as ReceiptsApi, t as InvoicesApi } from "../client-B00WZ3FK.cjs";
-import { n as Journal } from "../journal-D_ypAW50.cjs";
+import { a as ReceiptsApi, t as InvoicesApi } from "../client-CXjvVevB.cjs";
+import { n as Journal } from "../journal-Cp_OMWlI.cjs";
 type BillingInterval = "week" | "month" | "quarter" | "year";
 interface BillingPeriodOptions {
   readonly interval: BillingInterval;

package/dist/batch/index.d.ts

@@ -1,8 +1,8 @@
 import { t as DateInput } from "../dates-nlGEokCf.js";
 import { M as CreateInvoiceInput } from "../context-BROX7Krw.js";
 import { t as CreateReceiptInput } from "../types-Z6rQoqHn.js";
-import { a as ReceiptsApi, t as InvoicesApi } from "../client-BJfeFjCM.js";
-import { n as Journal } from "../journal-JwiYpBui.js";
+import { a as ReceiptsApi, t as InvoicesApi } from "../client-CvojBxd9.js";
+import { n as Journal } from "../journal-9pfg0if1.js";
 type BillingInterval = "week" | "month" | "quarter" | "year";
 interface BillingPeriodOptions {
   readonly interval: BillingInterval;

package/dist/cli.cjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 const require_errors = require("./errors-Bn6pe6yw.cjs");
-const require_client = require("./client-I_29IPMh.cjs");
+const require_client = require("./client-CYS1_Xaz.cjs");
 const require_serialize = require("./serialize-DEU7r6Bk.cjs");
 const require_create = require("./create-DH5jiZPA.cjs");
 const require_nav = require("./nav-VShZkjg8.cjs");
-const require_server = require("./server-BbR19Oj6.cjs");
+const require_server = require("./server-CrmxXPV-.cjs");
 let node_fs_promises = require("node:fs/promises");
 let node_readline = require("node:readline");
 // src/cli/args.ts

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { o as isSzamlazzError, r as SzamlazzError } from "./errors-CGGsW0Y5.js";
-import { s as buildCreateInvoiceXml, t as createKassza } from "./client-JZ1M1sZX.js";
+import { s as buildCreateInvoiceXml, t as createKassza } from "./client-8ElbVwSO.js";
 import { r as el } from "./serialize-CjymGkJj.js";
 import { t as buildCreateReceiptXml } from "./create-BwRslos0.js";
 import { i as navDailyReports, n as describeNavReport } from "./nav-NvNgaONz.js";
-import { n as KASSZA_VERSION, t as createKasszaMcpServer } from "./server-aSw0DUua.js";
+import { n as KASSZA_VERSION, t as createKasszaMcpServer } from "./server-CZTJ3562.js";
 import { readFile } from "node:fs/promises";
 import { createInterface } from "node:readline";
 // src/cli/args.ts

package/dist/{client-JZ1M1sZX.js → client-8ElbVwSO.js}

@@ -1,11 +1,11 @@
-import { a as registerPayment, c as resolveInvoice, d as TAXPAYER_TYPE_CODES, f as KASSZA_AGGREGATOR, g as AGENT_ACTIONS, i as clearPayments, m as emitDocumentEvent, o as optionalAgentDate, r as registerPaymentOnce, s as presentText, t as createReceiptOnce, u as INVOICE_TEMPLATES } from "./create-once-B6cAXyET.js";
+import { a as registerPayment, c as resolveInvoice, d as TAXPAYER_TYPE_CODES, f as KASSZA_AGGREGATOR, g as AGENT_ACTIONS, i as clearPayments, m as emitDocumentEvent, o as optionalAgentDate, r as registerPaymentOnce, s as presentText, t as createReceiptOnce, u as INVOICE_TEMPLATES } from "./create-once-DcEjO8QH.js";
 import { i as createAgentError, o as isSzamlazzError, r as SzamlazzError, s as parseErrorCode } from "./errors-CGGsW0Y5.js";
 import { t as base64ToBytes } from "./binary-DuKBSfH-.js";
 import { a as optionalEl, c as childNumber, d as findChildren, l as childText, n as buildXmlDocument, r as el, s as childBoolean, u as findChild } from "./serialize-CjymGkJj.js";
 import { a as looksLikeXml, c as readDocumentHeaders, d as throwIfHeaderError, f as throwIfHttpError, h as unexpectedResponse, m as throwIfXmlFailure, n as parseReceiptResponse, o as parseDoneText, p as throwIfTextError, r as createAgentResponse, s as parseResponseXml, u as throwIfAnyError } from "./parse-1RiSh4vY.js";
 import { i as sessionKeyFor, n as memoryCookieStore, r as mergeSetCookies, t as SESSION_TTL_SECONDS } from "./session-DZeE1ryt.js";
 import { t as emitWarning } from "./warnings-DJ0QvZOp.js";
-import { l as createInvoiceOnce, m as guardOnce, n as issueForPayment, o as convertReceiptToInvoice } from "./issue-Dy9zvRK1.js";
+import { l as createInvoiceOnce, m as guardOnce, n as issueForPayment, o as convertReceiptToInvoice } from "./issue-CUiDvJhQ.js";
 import { r as formatVatRate } from "./vat-B4J5Q0tu.js";
 import { a as summarizeItems } from "./money-f280VT77.js";
 import { a as optionalText, c as requireText, i as optionalAgentDate$1, l as resolveInvoiceReference, o as parseInvoiceResult, s as referenceValue, t as AGENT_XSD_BASE_URL, u as validationError } from "./reference-Cxz0m2zF.js";

package/dist/{client-B00WZ3FK.d.cts → client-CXjvVevB.d.cts}

@@ -5,7 +5,7 @@ import { S as VatRate, a as RefundAllocation, s as RefundableItem } from "./inde
 import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-_HKTOCuQ.cjs";
 import { n as InvoiceDetails, o as InvoiceDetailsPayment, t as GetInvoiceOptions } from "./get-BL4Fr8-P.cjs";
 import { n as InvoiceOnceResult, t as ReceiptOnceResult } from "./create-once-BA0KAHIB.cjs";
-import { i as PaymentEvent, l as PaymentRefund, r as PaymentCustomer, s as PaymentLineItem } from "./types-DeuUqIvU.cjs";
+import { i as PaymentEvent, l as PaymentRefund, r as PaymentCustomer, s as PaymentLineItem } from "./types-DGJiVNxr.cjs";
 declare const ONCE_LOCK_KEY_PREFIX = "szamlazz:once:";
 declare const DEFAULT_LOCK_TTL_SECONDS = 600;
 declare const DEFAULT_LOCK_WAIT_MS = 1e4;
@@ -147,6 +147,7 @@ interface IssueForPaymentOptions {
   readonly refundItems?: RefundItemsResolver | undefined;
   readonly receipt?: Partial<Omit<CreateReceiptInput, "items" | "orderNumber" | "callId" | "currency" | "exchangeRate" | "exchangeBank">> | undefined;
   readonly invoice?: Partial<Omit<StandardInvoiceInput, "items" | "buyer" | "type" | "orderNumber" | "paid" | "currency" | "exchangeRate" | "exchangeBank" | "externalId">> | undefined;
+  readonly lock?: KeyValueStore | undefined;
   readonly recoveryDelayMs?: number | undefined;
   readonly signal?: AbortSignal | undefined;
 }
@@ -174,12 +175,19 @@ interface IssuedReversal {
   readonly number?: string | undefined;
   readonly created: boolean;
 }
+interface IssuedRefundFailure {
+  readonly kind: "refund-failed";
+  readonly orderNumber: string;
+  readonly document: "receipt" | "invoice";
+  readonly documentNumber: string;
+  readonly reason: string;
+}
 interface SkippedPayment {
   readonly kind: "skipped";
   readonly orderNumber: string;
   readonly reason: string;
 }
-type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | IssuedCorrection | IssuedRefundProposal | SkippedPayment;
+type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | IssuedCorrection | IssuedRefundProposal | IssuedRefundFailure | SkippedPayment;
 interface PaymentDocumentsApi {
   readonly invoices: Pick<InvoicesApi, "createOnce" | "find" | "reverse">;
   readonly receipts: Pick<ReceiptsApi, "createOnce" | "find" | "reverse">;
@@ -310,4 +318,4 @@ interface Kassza {
   issueForPayment(payment: PaymentEvent, options?: IssueForPaymentOptions): Promise<IssuedDocument>;
 }
 declare function createKassza(options?: KasszaOptions): Kassza;
-export { ONCE_LOCK_KEY_PREFIX as $, IssuedRefundCorrection as A, DocumentDecision as B, PaymentDocumentItem as C, issueForPayment as D, buyerFromCustomer as E, RefundProposalLine as F, RegisterPaymentOnceInput as G, chooseDocument as H, correctionExternalId as I, InvoiceReference as J, RegisteredPaymentOnce as K, ChooseDocumentBuyer as L, PartialRefundMode as M, RefundItemsContext as N, paymentOrderNumber as O, RefundItemsResolver as P, LockFailureMode as Q, ChooseDocumentInput as R, IssuedReversal as S, SkippedPayment as T, ProformaReference as U, RECEIPT_MAX_GROSS_HUF as V, InvoicePdf as W, DEFAULT_LOCK_TTL_SECONDS as X, CreateOnceOptions as Y, DEFAULT_LOCK_WAIT_MS as Z, conversionExternalId as _, ReceiptsApi as a, IssuedInvoice as b, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS as c, TaxpayerCacheOptions as d, OnceLockOptions as et, TaxpayerInfo as f, ConvertedReceipt as g, ConvertReceiptInput as h, KasszaOptions as i, IssuedRefundProposal as j, IssuedCorrection as k, DEFAULT_TAXPAYER_TTL_SECONDS as l, TaxpayerAddress as m, Kassza as n, TaxpayerApi as o, TaxpayerTaxNumber as p, paymentMarker as q, KasszaDefaults as r, createKassza as s, InvoicesApi as t, TAXPAYER_CACHE_KEY_PREFIX as u, IssueForPaymentOptions as v, PaymentDocumentsApi as w, IssuedReceipt as x, IssuedDocument as y, DocumentChoice as z };
+export { LockFailureMode as $, IssuedCorrection as A, DocumentChoice as B, IssuedReversal as C, buyerFromCustomer as D, SkippedPayment as E, RefundItemsResolver as F, InvoicePdf as G, RECEIPT_MAX_GROSS_HUF as H, RefundProposalLine as I, paymentMarker as J, RegisterPaymentOnceInput as K, correctionExternalId as L, IssuedRefundProposal as M, PartialRefundMode as N, issueForPayment as O, RefundItemsContext as P, DEFAULT_LOCK_WAIT_MS as Q, ChooseDocumentBuyer as R, IssuedRefundFailure as S, PaymentDocumentsApi as T, chooseDocument as U, DocumentDecision as V, ProformaReference as W, CreateOnceOptions as X, InvoiceReference as Y, DEFAULT_LOCK_TTL_SECONDS as Z, conversionExternalId as _, ReceiptsApi as a, IssuedInvoice as b, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS as c, TaxpayerCacheOptions as d, ONCE_LOCK_KEY_PREFIX as et, TaxpayerInfo as f, ConvertedReceipt as g, ConvertReceiptInput as h, KasszaOptions as i, IssuedRefundCorrection as j, paymentOrderNumber as k, DEFAULT_TAXPAYER_TTL_SECONDS as l, TaxpayerAddress as m, Kassza as n, TaxpayerApi as o, TaxpayerTaxNumber as p, RegisteredPaymentOnce as q, KasszaDefaults as r, createKassza as s, InvoicesApi as t, OnceLockOptions as tt, TAXPAYER_CACHE_KEY_PREFIX as u, IssueForPaymentOptions as v, PaymentDocumentItem as w, IssuedReceipt as x, IssuedDocument as y, ChooseDocumentInput as z };

package/dist/{client-I_29IPMh.cjs → client-CYS1_Xaz.cjs}

@@ -1,11 +1,11 @@
-const require_create_once = require("./create-once-zeF7GVVP.cjs");
+const require_create_once = require("./create-once-BKUhF1Ov.cjs");
 const require_errors = require("./errors-Bn6pe6yw.cjs");
 const require_binary = require("./binary-CdpKlNNI.cjs");
 const require_serialize = require("./serialize-DEU7r6Bk.cjs");
 const require_parse = require("./parse-CmM5va-p.cjs");
 const require_session = require("./session-BYotpR_s.cjs");
 const require_warnings = require("./warnings-ciSzK6Jc.cjs");
-const require_issue = require("./issue-DReARZnF.cjs");
+const require_issue = require("./issue-bLLBTt9j.cjs");
 const require_vat = require("./vat-BkoiiKm4.cjs");
 const require_money = require("./money-NtVytaxG.cjs");
 const require_reference = require("./reference-DoY12fc1.cjs");

package/dist/{client-BJfeFjCM.d.ts → client-CvojBxd9.d.ts}

@@ -5,7 +5,7 @@ import { S as VatRate, a as RefundAllocation, s as RefundableItem } from "./inde
 import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-Z6rQoqHn.js";
 import { n as InvoiceDetails, o as InvoiceDetailsPayment, t as GetInvoiceOptions } from "./get-BL4Fr8-P.js";
 import { n as InvoiceOnceResult, t as ReceiptOnceResult } from "./create-once-CoybK69A.js";
-import { i as PaymentEvent, l as PaymentRefund, r as PaymentCustomer, s as PaymentLineItem } from "./types-oiDulesz.js";
+import { i as PaymentEvent, l as PaymentRefund, r as PaymentCustomer, s as PaymentLineItem } from "./types-DPnHIwQ_.js";
 declare const ONCE_LOCK_KEY_PREFIX = "szamlazz:once:";
 declare const DEFAULT_LOCK_TTL_SECONDS = 600;
 declare const DEFAULT_LOCK_WAIT_MS = 1e4;
@@ -147,6 +147,7 @@ interface IssueForPaymentOptions {
   readonly refundItems?: RefundItemsResolver | undefined;
   readonly receipt?: Partial<Omit<CreateReceiptInput, "items" | "orderNumber" | "callId" | "currency" | "exchangeRate" | "exchangeBank">> | undefined;
   readonly invoice?: Partial<Omit<StandardInvoiceInput, "items" | "buyer" | "type" | "orderNumber" | "paid" | "currency" | "exchangeRate" | "exchangeBank" | "externalId">> | undefined;
+  readonly lock?: KeyValueStore | undefined;
   readonly recoveryDelayMs?: number | undefined;
   readonly signal?: AbortSignal | undefined;
 }
@@ -174,12 +175,19 @@ interface IssuedReversal {
   readonly number?: string | undefined;
   readonly created: boolean;
 }
+interface IssuedRefundFailure {
+  readonly kind: "refund-failed";
+  readonly orderNumber: string;
+  readonly document: "receipt" | "invoice";
+  readonly documentNumber: string;
+  readonly reason: string;
+}
 interface SkippedPayment {
   readonly kind: "skipped";
   readonly orderNumber: string;
   readonly reason: string;
 }
-type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | IssuedCorrection | IssuedRefundProposal | SkippedPayment;
+type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | IssuedCorrection | IssuedRefundProposal | IssuedRefundFailure | SkippedPayment;
 interface PaymentDocumentsApi {
   readonly invoices: Pick<InvoicesApi, "createOnce" | "find" | "reverse">;
   readonly receipts: Pick<ReceiptsApi, "createOnce" | "find" | "reverse">;
@@ -310,4 +318,4 @@ interface Kassza {
   issueForPayment(payment: PaymentEvent, options?: IssueForPaymentOptions): Promise<IssuedDocument>;
 }
 declare function createKassza(options?: KasszaOptions): Kassza;
-export { ONCE_LOCK_KEY_PREFIX as $, IssuedRefundCorrection as A, DocumentDecision as B, PaymentDocumentItem as C, issueForPayment as D, buyerFromCustomer as E, RefundProposalLine as F, RegisterPaymentOnceInput as G, chooseDocument as H, correctionExternalId as I, InvoiceReference as J, RegisteredPaymentOnce as K, ChooseDocumentBuyer as L, PartialRefundMode as M, RefundItemsContext as N, paymentOrderNumber as O, RefundItemsResolver as P, LockFailureMode as Q, ChooseDocumentInput as R, IssuedReversal as S, SkippedPayment as T, ProformaReference as U, RECEIPT_MAX_GROSS_HUF as V, InvoicePdf as W, DEFAULT_LOCK_TTL_SECONDS as X, CreateOnceOptions as Y, DEFAULT_LOCK_WAIT_MS as Z, conversionExternalId as _, ReceiptsApi as a, IssuedInvoice as b, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS as c, TaxpayerCacheOptions as d, OnceLockOptions as et, TaxpayerInfo as f, ConvertedReceipt as g, ConvertReceiptInput as h, KasszaOptions as i, IssuedRefundProposal as j, IssuedCorrection as k, DEFAULT_TAXPAYER_TTL_SECONDS as l, TaxpayerAddress as m, Kassza as n, TaxpayerApi as o, TaxpayerTaxNumber as p, paymentMarker as q, KasszaDefaults as r, createKassza as s, InvoicesApi as t, TAXPAYER_CACHE_KEY_PREFIX as u, IssueForPaymentOptions as v, PaymentDocumentsApi as w, IssuedReceipt as x, IssuedDocument as y, DocumentChoice as z };
+export { LockFailureMode as $, IssuedCorrection as A, DocumentChoice as B, IssuedReversal as C, buyerFromCustomer as D, SkippedPayment as E, RefundItemsResolver as F, InvoicePdf as G, RECEIPT_MAX_GROSS_HUF as H, RefundProposalLine as I, paymentMarker as J, RegisterPaymentOnceInput as K, correctionExternalId as L, IssuedRefundProposal as M, PartialRefundMode as N, issueForPayment as O, RefundItemsContext as P, DEFAULT_LOCK_WAIT_MS as Q, ChooseDocumentBuyer as R, IssuedRefundFailure as S, PaymentDocumentsApi as T, chooseDocument as U, DocumentDecision as V, ProformaReference as W, CreateOnceOptions as X, InvoiceReference as Y, DEFAULT_LOCK_TTL_SECONDS as Z, conversionExternalId as _, ReceiptsApi as a, IssuedInvoice as b, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS as c, TaxpayerCacheOptions as d, ONCE_LOCK_KEY_PREFIX as et, TaxpayerInfo as f, ConvertedReceipt as g, ConvertReceiptInput as h, KasszaOptions as i, IssuedRefundCorrection as j, paymentOrderNumber as k, DEFAULT_TAXPAYER_TTL_SECONDS as l, TaxpayerAddress as m, Kassza as n, TaxpayerApi as o, TaxpayerTaxNumber as p, RegisteredPaymentOnce as q, KasszaDefaults as r, createKassza as s, InvoicesApi as t, OnceLockOptions as tt, TAXPAYER_CACHE_KEY_PREFIX as u, IssueForPaymentOptions as v, PaymentDocumentItem as w, IssuedReceipt as x, IssuedDocument as y, ChooseDocumentInput as z };

package/dist/{create-once-zeF7GVVP.cjs → create-once-BKUhF1Ov.cjs}

@@ -3,7 +3,7 @@ const require_binary = require("./binary-CdpKlNNI.cjs");
 const require_serialize = require("./serialize-DEU7r6Bk.cjs");
 const require_warnings = require("./warnings-ciSzK6Jc.cjs");
 const require_once = require("./once-BmXfrNbQ.cjs");
-const require_issue = require("./issue-DReARZnF.cjs");
+const require_issue = require("./issue-bLLBTt9j.cjs");
 const require_dates = require("./dates-oOp3ypPP.cjs");
 const require_vat = require("./vat-BkoiiKm4.cjs");
 const require_money = require("./money-NtVytaxG.cjs");

package/dist/{create-once-B6cAXyET.js → create-once-DcEjO8QH.js}

@@ -3,7 +3,7 @@ import { i as encodeUtf8 } from "./binary-DuKBSfH-.js";
 import { a as optionalEl, n as buildXmlDocument, r as el } from "./serialize-CjymGkJj.js";
 import { t as emitWarning } from "./warnings-DJ0QvZOp.js";
 import { a as unknownOutcomeError, i as resolveRecoveryDelay, n as isUncertainOutcome, r as recoverAfterFailure } from "./once-CMhDPrs7.js";
-import { m as guardOnce } from "./issue-Dy9zvRK1.js";
+import { m as guardOnce } from "./issue-CUiDvJhQ.js";
 import { a as todayInBudapest, n as toAgentDate, t as addBudapestDays } from "./dates-DWsZOdaO.js";
 import { i as isHuf } from "./vat-B4J5Q0tu.js";
 import { n as calculateInvoiceItem } from "./money-f280VT77.js";

package/dist/delegation/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("../errors-Bn6pe6yw.cjs");
-const require_client = require("../client-I_29IPMh.cjs");
+const require_client = require("../client-CYS1_Xaz.cjs");
 const require_serialize = require("../serialize-DEU7r6Bk.cjs");
 const require_parse = require("../parse-CmM5va-p.cjs");
 const require_dates = require("../dates-oOp3ypPP.cjs");

package/dist/delegation/index.d.cts

@@ -1,6 +1,6 @@
 import { t as DateInput } from "../dates-nlGEokCf.cjs";
 import { D as XmlNode, O as AgentResponse, dt as suggestedPrefix, l as SzamlazzOptions, r as AgentContext, s as RequestOptions, st as SzamlazzError } from "../context-zGthvNo2.cjs";
-import { i as KasszaOptions, n as Kassza, r as KasszaDefaults } from "../client-B00WZ3FK.cjs";
+import { i as KasszaOptions, n as Kassza, r as KasszaDefaults } from "../client-CXjvVevB.cjs";
 export declare const CONNECT_PRINCIPAL_NAMESPACE = "http://www.szamlazz.hu/xmlcegmb";
 export declare const CONNECT_PRINCIPAL_SCHEMA_LOCATION = "http://www.szamlazz.hu/docs/xsds/agentmb/xmlcegmb.xsd";
 export declare const DELEGATE_PREFIX_PATTERN: RegExp;

package/dist/delegation/index.d.ts

@@ -1,6 +1,6 @@
 import { t as DateInput } from "../dates-nlGEokCf.js";
 import { D as XmlNode, O as AgentResponse, dt as suggestedPrefix, l as SzamlazzOptions, r as AgentContext, s as RequestOptions, st as SzamlazzError } from "../context-BROX7Krw.js";
-import { i as KasszaOptions, n as Kassza, r as KasszaDefaults } from "../client-BJfeFjCM.js";
+import { i as KasszaOptions, n as Kassza, r as KasszaDefaults } from "../client-CvojBxd9.js";
 export declare const CONNECT_PRINCIPAL_NAMESPACE = "http://www.szamlazz.hu/xmlcegmb";
 export declare const CONNECT_PRINCIPAL_SCHEMA_LOCATION = "http://www.szamlazz.hu/docs/xsds/agentmb/xmlcegmb.xsd";
 export declare const DELEGATE_PREFIX_PATTERN: RegExp;

package/dist/delegation/index.js

@@ -1,5 +1,5 @@
 import { c as suggestedPrefix, o as isSzamlazzError, r as SzamlazzError } from "../errors-CGGsW0Y5.js";
-import { a as queryTaxpayer, c as createAgentContext, o as getInvoicePdf, t as createKassza } from "../client-JZ1M1sZX.js";
+import { a as queryTaxpayer, c as createAgentContext, o as getInvoicePdf, t as createKassza } from "../client-8ElbVwSO.js";
 import { a as optionalEl, n as buildXmlDocument, r as el } from "../serialize-CjymGkJj.js";
 import { h as unexpectedResponse, i as decodeHeaderValue, l as readHeader, u as throwIfAnyError } from "../parse-1RiSh4vY.js";
 import { n as toAgentDate } from "../dates-DWsZOdaO.js";

package/dist/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_once = require("./create-once-zeF7GVVP.cjs");
+const require_create_once = require("./create-once-BKUhF1Ov.cjs");
 const require_errors = require("./errors-Bn6pe6yw.cjs");
-const require_client = require("./client-I_29IPMh.cjs");
+const require_client = require("./client-CYS1_Xaz.cjs");
 const require_binary = require("./binary-CdpKlNNI.cjs");
 const require_session = require("./session-BYotpR_s.cjs");
-const require_issue = require("./issue-DReARZnF.cjs");
+const require_issue = require("./issue-bLLBTt9j.cjs");
 const require_dates = require("./dates-oOp3ypPP.cjs");
 exports.AGENT_ACTIONS = require_create_once.AGENT_ACTIONS;
 exports.AGENT_ERROR_CODES = require_errors.AGENT_ERROR_CODES;

package/dist/index.d.cts

@@ -5,9 +5,9 @@ import { a as storeCapabilities, i as memoryStore, n as KeyValueStore, r as Stor
 import { S as VatRate, d as ItemAmounts, f as ItemPriceInput } from "./index-CinpAhQM.cjs";
 import { a as ReceiptItem, c as ReceiptPayment, d as ReceiptTotals, f as ReceiptType, h as SendReceiptInput, i as ReceiptDefaults, l as ReceiptPaymentInput, m as ReverseReceiptInput, n as GetReceiptInput, o as ReceiptItemInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput, u as ReceiptPdfTemplate } from "./types-_HKTOCuQ.cjs";
 import { r as memoryCookieStore, t as CookieStore } from "./session-BBbSXlx3.cjs";
-import { $ as ONCE_LOCK_KEY_PREFIX, A as IssuedRefundCorrection, B as DocumentDecision, C as PaymentDocumentItem, D as issueForPayment, E as buyerFromCustomer, F as RefundProposalLine, G as RegisterPaymentOnceInput, H as chooseDocument, I as correctionExternalId, J as InvoiceReference, K as RegisteredPaymentOnce, L as ChooseDocumentBuyer, M as PartialRefundMode, N as RefundItemsContext, O as paymentOrderNumber, P as RefundItemsResolver, Q as LockFailureMode, R as ChooseDocumentInput, S as IssuedReversal, T as SkippedPayment, U as ProformaReference, V as RECEIPT_MAX_GROSS_HUF, W as InvoicePdf, X as DEFAULT_LOCK_TTL_SECONDS, Y as CreateOnceOptions, Z as DEFAULT_LOCK_WAIT_MS, _ as conversionExternalId, a as ReceiptsApi, b as IssuedInvoice, c as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, d as TaxpayerCacheOptions, et as OnceLockOptions, f as TaxpayerInfo, g as ConvertedReceipt, h as ConvertReceiptInput, i as KasszaOptions, j as IssuedRefundProposal, k as IssuedCorrection, l as DEFAULT_TAXPAYER_TTL_SECONDS, m as TaxpayerAddress, n as Kassza, o as TaxpayerApi, p as TaxpayerTaxNumber, q as paymentMarker, r as KasszaDefaults, s as createKassza, t as InvoicesApi, u as TAXPAYER_CACHE_KEY_PREFIX, v as IssueForPaymentOptions, w as PaymentDocumentsApi, x as IssuedReceipt, y as IssuedDocument, z as DocumentChoice } from "./client-B00WZ3FK.cjs";
+import { $ as LockFailureMode, A as IssuedCorrection, B as DocumentChoice, C as IssuedReversal, D as buyerFromCustomer, E as SkippedPayment, F as RefundItemsResolver, G as InvoicePdf, H as RECEIPT_MAX_GROSS_HUF, I as RefundProposalLine, J as paymentMarker, K as RegisterPaymentOnceInput, L as correctionExternalId, M as IssuedRefundProposal, N as PartialRefundMode, O as issueForPayment, P as RefundItemsContext, Q as DEFAULT_LOCK_WAIT_MS, R as ChooseDocumentBuyer, S as IssuedRefundFailure, T as PaymentDocumentsApi, U as chooseDocument, V as DocumentDecision, W as ProformaReference, X as CreateOnceOptions, Y as InvoiceReference, Z as DEFAULT_LOCK_TTL_SECONDS, _ as conversionExternalId, a as ReceiptsApi, b as IssuedInvoice, c as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, d as TaxpayerCacheOptions, et as ONCE_LOCK_KEY_PREFIX, f as TaxpayerInfo, g as ConvertedReceipt, h as ConvertReceiptInput, i as KasszaOptions, j as IssuedRefundCorrection, k as paymentOrderNumber, l as DEFAULT_TAXPAYER_TTL_SECONDS, m as TaxpayerAddress, n as Kassza, o as TaxpayerApi, p as TaxpayerTaxNumber, q as RegisteredPaymentOnce, r as KasszaDefaults, s as createKassza, t as InvoicesApi, tt as OnceLockOptions, u as TAXPAYER_CACHE_KEY_PREFIX, v as IssueForPaymentOptions, w as PaymentDocumentItem, x as IssuedReceipt, y as IssuedDocument, z as ChooseDocumentInput } from "./client-CXjvVevB.cjs";
 import { a as InvoiceDetailsItem, c as InvoiceDetailsTotals, i as InvoiceDetailsHeader, l as InvoiceDocumentType, n as InvoiceDetails, o as InvoiceDetailsPayment, r as InvoiceDetailsBuyer, s as InvoiceDetailsSeller, t as GetInvoiceOptions } from "./get-BL4Fr8-P.cjs";
 import { n as InvoiceOnceResult, r as invoiceOnceExternalId, t as ReceiptOnceResult } from "./create-once-BA0KAHIB.cjs";
-import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, l as PaymentRefund, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-DeuUqIvU.cjs";
+import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, l as PaymentRefund, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-DGJiVNxr.cjs";
 export declare function bytesToBase64(bytes: Uint8Array): string;
-export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, type AgentAction, type AgentAttachment, type AgentCompleteEvent, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type AttemptLedgerMode, type Awaitable, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentErrorHandler, type DocumentErrorMode, type DocumentEvent, type DocumentHook, DocumentHookError, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedCorrection, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedRefundCorrection, type IssuedRefundProposal, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, KASSZA_ERROR_DOCS_URL, type Kassza, type KasszaDefaults, type KasszaOptions, type KasszaWarning, type KasszaWarningKind, type KeyValueStore, type LockFailureMode, MAX_INVOICE_ATTACHMENTS, type MplWaybill, ONCE_LOCK_KEY_PREFIX, type OnceLockOptions, type PartialRefundMode, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PaymentRefund, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RefundItemsContext, type RefundItemsResolver, type RefundProposalLine, type RegisterPaymentInput, type RegisterPaymentOnceInput, type RegisteredPayment, type RegisteredPaymentOnce, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, type StoreCapabilities, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, TAXPAYER_CACHE_KEY_PREFIX, type TaxpayerAddress, type TaxpayerApi, type TaxpayerCacheOptions, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type WarningHook, type Waybill, addBudapestDays, attemptLedgerKey, buyerFromCustomer, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };
+export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, type AgentAction, type AgentAttachment, type AgentCompleteEvent, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type AttemptLedgerMode, type Awaitable, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentErrorHandler, type DocumentErrorMode, type DocumentEvent, type DocumentHook, DocumentHookError, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedCorrection, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedRefundCorrection, type IssuedRefundFailure, type IssuedRefundProposal, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, KASSZA_ERROR_DOCS_URL, type Kassza, type KasszaDefaults, type KasszaOptions, type KasszaWarning, type KasszaWarningKind, type KeyValueStore, type LockFailureMode, MAX_INVOICE_ATTACHMENTS, type MplWaybill, ONCE_LOCK_KEY_PREFIX, type OnceLockOptions, type PartialRefundMode, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PaymentRefund, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RefundItemsContext, type RefundItemsResolver, type RefundProposalLine, type RegisterPaymentInput, type RegisterPaymentOnceInput, type RegisteredPayment, type RegisteredPaymentOnce, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, type StoreCapabilities, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, TAXPAYER_CACHE_KEY_PREFIX, type TaxpayerAddress, type TaxpayerApi, type TaxpayerCacheOptions, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type WarningHook, type Waybill, addBudapestDays, attemptLedgerKey, buyerFromCustomer, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };

package/dist/index.d.ts

@@ -5,9 +5,9 @@ import { a as storeCapabilities, i as memoryStore, n as KeyValueStore, r as Stor
 import { S as VatRate, d as ItemAmounts, f as ItemPriceInput } from "./index-CinpAhQM.js";
 import { a as ReceiptItem, c as ReceiptPayment, d as ReceiptTotals, f as ReceiptType, h as SendReceiptInput, i as ReceiptDefaults, l as ReceiptPaymentInput, m as ReverseReceiptInput, n as GetReceiptInput, o as ReceiptItemInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput, u as ReceiptPdfTemplate } from "./types-Z6rQoqHn.js";
 import { r as memoryCookieStore, t as CookieStore } from "./session-mKtpAeUB.js";
-import { $ as ONCE_LOCK_KEY_PREFIX, A as IssuedRefundCorrection, B as DocumentDecision, C as PaymentDocumentItem, D as issueForPayment, E as buyerFromCustomer, F as RefundProposalLine, G as RegisterPaymentOnceInput, H as chooseDocument, I as correctionExternalId, J as InvoiceReference, K as RegisteredPaymentOnce, L as ChooseDocumentBuyer, M as PartialRefundMode, N as RefundItemsContext, O as paymentOrderNumber, P as RefundItemsResolver, Q as LockFailureMode, R as ChooseDocumentInput, S as IssuedReversal, T as SkippedPayment, U as ProformaReference, V as RECEIPT_MAX_GROSS_HUF, W as InvoicePdf, X as DEFAULT_LOCK_TTL_SECONDS, Y as CreateOnceOptions, Z as DEFAULT_LOCK_WAIT_MS, _ as conversionExternalId, a as ReceiptsApi, b as IssuedInvoice, c as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, d as TaxpayerCacheOptions, et as OnceLockOptions, f as TaxpayerInfo, g as ConvertedReceipt, h as ConvertReceiptInput, i as KasszaOptions, j as IssuedRefundProposal, k as IssuedCorrection, l as DEFAULT_TAXPAYER_TTL_SECONDS, m as TaxpayerAddress, n as Kassza, o as TaxpayerApi, p as TaxpayerTaxNumber, q as paymentMarker, r as KasszaDefaults, s as createKassza, t as InvoicesApi, u as TAXPAYER_CACHE_KEY_PREFIX, v as IssueForPaymentOptions, w as PaymentDocumentsApi, x as IssuedReceipt, y as IssuedDocument, z as DocumentChoice } from "./client-BJfeFjCM.js";
+import { $ as LockFailureMode, A as IssuedCorrection, B as DocumentChoice, C as IssuedReversal, D as buyerFromCustomer, E as SkippedPayment, F as RefundItemsResolver, G as InvoicePdf, H as RECEIPT_MAX_GROSS_HUF, I as RefundProposalLine, J as paymentMarker, K as RegisterPaymentOnceInput, L as correctionExternalId, M as IssuedRefundProposal, N as PartialRefundMode, O as issueForPayment, P as RefundItemsContext, Q as DEFAULT_LOCK_WAIT_MS, R as ChooseDocumentBuyer, S as IssuedRefundFailure, T as PaymentDocumentsApi, U as chooseDocument, V as DocumentDecision, W as ProformaReference, X as CreateOnceOptions, Y as InvoiceReference, Z as DEFAULT_LOCK_TTL_SECONDS, _ as conversionExternalId, a as ReceiptsApi, b as IssuedInvoice, c as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, d as TaxpayerCacheOptions, et as ONCE_LOCK_KEY_PREFIX, f as TaxpayerInfo, g as ConvertedReceipt, h as ConvertReceiptInput, i as KasszaOptions, j as IssuedRefundCorrection, k as paymentOrderNumber, l as DEFAULT_TAXPAYER_TTL_SECONDS, m as TaxpayerAddress, n as Kassza, o as TaxpayerApi, p as TaxpayerTaxNumber, q as RegisteredPaymentOnce, r as KasszaDefaults, s as createKassza, t as InvoicesApi, tt as OnceLockOptions, u as TAXPAYER_CACHE_KEY_PREFIX, v as IssueForPaymentOptions, w as PaymentDocumentItem, x as IssuedReceipt, y as IssuedDocument, z as ChooseDocumentInput } from "./client-CvojBxd9.js";
 import { a as InvoiceDetailsItem, c as InvoiceDetailsTotals, i as InvoiceDetailsHeader, l as InvoiceDocumentType, n as InvoiceDetails, o as InvoiceDetailsPayment, r as InvoiceDetailsBuyer, s as InvoiceDetailsSeller, t as GetInvoiceOptions } from "./get-BL4Fr8-P.js";
 import { n as InvoiceOnceResult, r as invoiceOnceExternalId, t as ReceiptOnceResult } from "./create-once-CoybK69A.js";
-import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, l as PaymentRefund, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-oiDulesz.js";
+import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, l as PaymentRefund, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-DPnHIwQ_.js";
 export declare function bytesToBase64(bytes: Uint8Array): string;
-export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, type AgentAction, type AgentAttachment, type AgentCompleteEvent, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type AttemptLedgerMode, type Awaitable, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentErrorHandler, type DocumentErrorMode, type DocumentEvent, type DocumentHook, DocumentHookError, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedCorrection, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedRefundCorrection, type IssuedRefundProposal, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, KASSZA_ERROR_DOCS_URL, type Kassza, type KasszaDefaults, type KasszaOptions, type KasszaWarning, type KasszaWarningKind, type KeyValueStore, type LockFailureMode, MAX_INVOICE_ATTACHMENTS, type MplWaybill, ONCE_LOCK_KEY_PREFIX, type OnceLockOptions, type PartialRefundMode, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PaymentRefund, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RefundItemsContext, type RefundItemsResolver, type RefundProposalLine, type RegisterPaymentInput, type RegisterPaymentOnceInput, type RegisteredPayment, type RegisteredPaymentOnce, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, type StoreCapabilities, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, TAXPAYER_CACHE_KEY_PREFIX, type TaxpayerAddress, type TaxpayerApi, type TaxpayerCacheOptions, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type WarningHook, type Waybill, addBudapestDays, attemptLedgerKey, buyerFromCustomer, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };
+export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, type AgentAction, type AgentAttachment, type AgentCompleteEvent, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type AttemptLedgerMode, type Awaitable, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentErrorHandler, type DocumentErrorMode, type DocumentEvent, type DocumentHook, DocumentHookError, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedCorrection, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedRefundCorrection, type IssuedRefundFailure, type IssuedRefundProposal, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, KASSZA_ERROR_DOCS_URL, type Kassza, type KasszaDefaults, type KasszaOptions, type KasszaWarning, type KasszaWarningKind, type KeyValueStore, type LockFailureMode, MAX_INVOICE_ATTACHMENTS, type MplWaybill, ONCE_LOCK_KEY_PREFIX, type OnceLockOptions, type PartialRefundMode, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PaymentRefund, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RefundItemsContext, type RefundItemsResolver, type RefundProposalLine, type RegisterPaymentInput, type RegisterPaymentOnceInput, type RegisteredPayment, type RegisteredPaymentOnce, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, type StoreCapabilities, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, TAXPAYER_CACHE_KEY_PREFIX, type TaxpayerAddress, type TaxpayerApi, type TaxpayerCacheOptions, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type WarningHook, type Waybill, addBudapestDays, attemptLedgerKey, buyerFromCustomer, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };

package/dist/index.js

@@ -1,8 +1,8 @@
-import { _ as MAX_INVOICE_ATTACHMENTS, g as AGENT_ACTIONS, h as isDocumentHookError, n as paymentMarker, p as DocumentHookError, v as SZAMLAZZ_AGENT_URL } from "./create-once-B6cAXyET.js";
+import { _ as MAX_INVOICE_ATTACHMENTS, g as AGENT_ACTIONS, h as isDocumentHookError, n as paymentMarker, p as DocumentHookError, v as SZAMLAZZ_AGENT_URL } from "./create-once-DcEjO8QH.js";
 import { a as errorCodeDocsUrl, c as suggestedPrefix, n as KASSZA_ERROR_DOCS_URL, o as isSzamlazzError, r as SzamlazzError, t as AGENT_ERROR_CODES } from "./errors-CGGsW0Y5.js";
-import { d as attemptLedgerKey, i as TAXPAYER_CACHE_KEY_PREFIX, l as ATTEMPT_LEDGER_KEY_PREFIX, n as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, r as DEFAULT_TAXPAYER_TTL_SECONDS, t as createKassza, u as ATTEMPT_LEDGER_TTL_SECONDS } from "./client-JZ1M1sZX.js";
+import { d as attemptLedgerKey, i as TAXPAYER_CACHE_KEY_PREFIX, l as ATTEMPT_LEDGER_KEY_PREFIX, n as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, r as DEFAULT_TAXPAYER_TTL_SECONDS, t as createKassza, u as ATTEMPT_LEDGER_TTL_SECONDS } from "./client-8ElbVwSO.js";
 import { n as bytesToBase64 } from "./binary-DuKBSfH-.js";
 import { a as memoryStore, n as memoryCookieStore, o as storeCapabilities } from "./session-DZeE1ryt.js";
-import { a as conversionExternalId, c as chooseDocument, d as DEFAULT_LOCK_TTL_SECONDS, f as DEFAULT_LOCK_WAIT_MS, i as correctionExternalId, n as issueForPayment, p as ONCE_LOCK_KEY_PREFIX, r as paymentOrderNumber, s as RECEIPT_MAX_GROSS_HUF, t as buyerFromCustomer, u as invoiceOnceExternalId } from "./issue-Dy9zvRK1.js";
+import { a as conversionExternalId, c as chooseDocument, d as DEFAULT_LOCK_TTL_SECONDS, f as DEFAULT_LOCK_WAIT_MS, i as correctionExternalId, n as issueForPayment, p as ONCE_LOCK_KEY_PREFIX, r as paymentOrderNumber, s as RECEIPT_MAX_GROSS_HUF, t as buyerFromCustomer, u as invoiceOnceExternalId } from "./issue-CUiDvJhQ.js";
 import { a as todayInBudapest, i as toBudapestTimestamp, r as toBudapestDate, t as addBudapestDays } from "./dates-DWsZOdaO.js";
 export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, DocumentHookError, KASSZA_ERROR_DOCS_URL, MAX_INVOICE_ATTACHMENTS, ONCE_LOCK_KEY_PREFIX, RECEIPT_MAX_GROSS_HUF, SZAMLAZZ_AGENT_URL, SzamlazzError, TAXPAYER_CACHE_KEY_PREFIX, addBudapestDays, attemptLedgerKey, buyerFromCustomer, bytesToBase64, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };

package/dist/{issue-Dy9zvRK1.js → issue-CUiDvJhQ.js}

@@ -376,6 +376,12 @@ function skipped$1(orderNumber, reason) {
 		reason
 	};
 }
+function refundBeforeDocumentError(payment, orderNumber) {
+	return new SzamlazzError(`A(z) ${payment.provider} visszatérítéshez (${payment.id}) még nincs kiállított bizonylat (rendelésszám: ${orderNumber}): a fizetés eseménye valószínűleg még nem futott le, például egy korábbi hiba után újraküldésre vár.`, {
+		category: "in_progress",
+		hint: "A webhook 500-at ad, így a szolgáltató később újraküldi a visszatérítést; addigra a fizetés bizonylata elkészül, és a visszatérítés sztornózza vagy helyesbíti. Ha ehhez a fizetéshez soha nem készül bizonylat (például a kassza bevezetése előtti fizetés), kezeld kézzel, és az onPayment-ben nyugtázd ezt az in_progress hibát."
+	});
+}
 async function refundKey(id) {
 	if (id.length <= MAX_PLAIN_REFUND_KEY && /^[A-Za-z0-9_.:-]+$/.test(id)) return id;
 	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(id));
@@ -572,7 +578,7 @@ async function issueForPartialRefund(api, payment, orderNumber, options) {
 		orderNumber,
 		downloadPdf: false
 	}, { signal: options.signal });
-	if (!receipt) return skipped$1(orderNumber, `A(z) ${payment.provider} részleges visszatérítéshez (${payment.id}) nem található kiállított bizonylat.`);
+	if (!receipt) throw refundBeforeDocumentError(payment, orderNumber);
 	const original = receipt.type === "reversal" ? receipt.reversedReceiptNumber ?? receipt.number : receipt.number;
 	if (receipt.type === "reversal" || receipt.isReversed) {
 		const converted = await find(conversionExternalId(original));
@@ -589,6 +595,8 @@ const DEFAULT_CURRENCY = "HUF";
 const DEFAULT_EXCHANGE_BANK = "MNB";
 const INVOICE_REVERSAL_SUFFIX = "/SS";
 const RECEIPT_REVERSAL_SUFFIX = "/SN";
+const REFUND_LOCK_KEY_PREFIX = "szamlazz:refund:";
+const refundsInFlight = /* @__PURE__ */ new WeakMap();
 function validation(message, hint) {
 	return new SzamlazzError(message, {
 		category: "validation",
@@ -839,7 +847,7 @@ async function reverseReceiptForRefund(api, payment, orderNumber, options) {
 		downloadPdf: false
 	}, { signal: options.signal });
 	const receipt = await lookup();
-	if (!receipt) return skipped(orderNumber, `A(z) ${payment.provider} visszatérítéshez (${payment.id}) nem található kiállított bizonylat.`);
+	if (!receipt) throw refundBeforeDocumentError(payment, orderNumber);
 	if (isReversedReceipt(receipt)) {
 		const originalNumber = receipt.type === "reversal" ? receipt.reversedReceiptNumber ?? receipt.number : receipt.number;
 		const converted = await reverseConvertedInvoice(api, orderNumber, originalNumber, options);
@@ -875,6 +883,86 @@ async function reverseForRefund(api, payment, orderNumber, options) {
 	if (invoice && invoice.header.type !== "reversal") return reverseInvoiceOnce(api, orderNumber, invoice.header.number, options);
 	return reverseReceiptForRefund(api, payment, orderNumber, options);
 }
+function refundIdsOf(payment) {
+	const ids = (payment.refunds ?? []).map((refund) => refund.id);
+	return ids.length > 0 ? ids.join(", ") : payment.id;
+}
+async function reportRefundFailure(api, payment, orderNumber, options) {
+	const which = refundIdsOf(payment);
+	const invoice = await api.invoices.find({ externalId: orderNumber }, { includePdf: false }, { signal: options.signal });
+	const receipt = invoice ? void 0 : await api.receipts.find({
+		orderNumber,
+		downloadPdf: false
+	}, { signal: options.signal });
+	const found = invoice ? {
+		document: "invoice",
+		number: invoice.header.number
+	} : receipt && {
+		document: "receipt",
+		number: receipt.type === "reversal" ? receipt.reversedReceiptNumber ?? receipt.number : receipt.number
+	};
+	if (!found) return skipped(orderNumber, `A(z) ${payment.provider} visszatérítés (${which}) meghiúsult, de ehhez a fizetéshez nincs kiállított bizonylat, így nincs mit rendezni.`);
+	return {
+		kind: "refund-failed",
+		orderNumber,
+		document: found.document,
+		documentNumber: found.number,
+		reason: `A(z) ${payment.provider} visszatérítés (${which}) meghiúsult vagy visszavonták, a pénz nem ment vissza a vevőnek. A kassza a visszatérítésre kiállított sztornót vagy helyesbítő számlát nem fordítja vissza magától: ellenőrizd a(z) ${found.number} bizonylatot és a hozzá tartozó javító bizonylatokat, és ha kell, kézzel állíts ki új bizonylatot a vevőnél maradt összegről.`
+	};
+}
+async function oneAtATime(scope, key, signal, run) {
+	let running = refundsInFlight.get(scope);
+	if (!running) {
+		running = /* @__PURE__ */ new Map();
+		refundsInFlight.set(scope, running);
+	}
+	for (;;) {
+		const pending = running.get(key);
+		if (!pending) break;
+		await pending.catch(() => void 0);
+		signal?.throwIfAborted();
+	}
+	const current = run();
+	running.set(key, current);
+	try {
+		return await current;
+	} finally {
+		if (running.get(key) === current) running.delete(key);
+	}
+}
+async function releaseRefundLock(lock, key, token) {
+	if (lock.deleteIfEquals) {
+		await lock.deleteIfEquals(key, token);
+		return;
+	}
+	if (await lock.get(key) === token) await lock.delete(key);
+}
+async function withRefundLock(lock, orderNumber, run) {
+	if (!lock) return run();
+	const setIfAbsent = lock.setIfAbsent?.bind(lock);
+	if (!setIfAbsent) throw new SzamlazzError("A visszatérítés zárához (lock) olyan tároló kell, amely támogatja a setIfAbsent műveletet (például a kassza/stores Redis adapterei vagy a Durable Object tároló). A Cloudflare KV erre nem alkalmas.", { category: "configuration" });
+	const key = `${REFUND_LOCK_KEY_PREFIX}${orderNumber}`;
+	const token = crypto.randomUUID();
+	let acquired;
+	try {
+		acquired = await setIfAbsent(key, token, 600);
+	} catch (error) {
+		throw new SzamlazzError(`A visszatérítés zárának tárolója nem érhető el, ezért a kassza nem sztornózott (${orderNumber}).`, {
+			category: "store_unavailable",
+			cause: error,
+			hint: "Állítsd helyre a tárolót, a webhook 500-at ad, és a szolgáltató újraküldi a visszatérítést."
+		});
+	}
+	if (!acquired) throw new SzamlazzError(`Egy másik folyamat éppen sztornózza a(z) ${orderNumber} rendelés bizonylatát.`, {
+		category: "in_progress",
+		hint: "Ne sztornózd kézzel. A webhook 500-at ad, a szolgáltató újraküldi a visszatérítést, és akkor a kassza a már elkészült sztornót adja vissza."
+	});
+	try {
+		return await run();
+	} finally {
+		await releaseRefundLock(lock, key, token).catch(() => void 0);
+	}
+}
 function assertPaidAmount(payment) {
 	const value = payment.amount?.value;
 	if (value !== void 0 && (!Number.isFinite(value) || value < 0)) throw validation(`A(z) ${payment.provider} fizetés összege érvénytelen: ${value}`);
@@ -882,8 +970,9 @@ function assertPaidAmount(payment) {
 async function issueForPayment(api, payment, options = {}) {
 	resolveRecoveryDelay(options.recoveryDelayMs);
 	const orderNumber = options.orderNumber?.trim() || paymentOrderNumber(payment);
-	if (payment.kind === "refunded") return reverseForRefund(api, payment, orderNumber, options);
+	if (payment.kind === "refunded") return oneAtATime(api.invoices, orderNumber, options.signal, () => withRefundLock(options.lock, orderNumber, () => reverseForRefund(api, payment, orderNumber, options)));
 	if (payment.kind === "partially-refunded") return issueForPartialRefund(api, payment, orderNumber, options);
+	if (payment.kind === "refund-failed") return reportRefundFailure(api, payment, orderNumber, options);
 	if (payment.kind !== "paid") return skipped(orderNumber, `A fizetés állapota (${payment.kind}) nem sikeres fizetés, ezért nem készül bizonylat.`);
 	assertPaidAmount(payment);
 	if (payment.amount?.value === 0) return skipped(orderNumber, "A fizetett összeg 0, ezért nem készül bizonylat.");