kassza 0.10.0 → 0.12.0

package/dist/{client-zv4enyq7.d.ts → client-CickRRFr.d.ts}

@@ -1,6 +1,8 @@
 import { t as CookieStore } from "./session-Dm_45x8K.js";
-import { t as DateInput } from "./dates-DtHzwNU6.js";
+import { t as DateInput } from "./dates-9zvESP0i.js";
 import { _ as VatRate, o as ItemAmounts, s as ItemPriceInput } from "./index-CYAGCdKJ.js";
+import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-k--zHf4l.js";
+import { i as PaymentEvent, r as PaymentCustomer, s as PaymentLineItem } from "./types-COf1LAD-.js";
 //#region src/core/actions.d.ts
 declare const SZAMLAZZ_AGENT_URL = "https://www.szamlazz.hu/szamla/";
 declare const AGENT_ACTIONS: {
@@ -15,12 +17,13 @@ declare const AGENT_ACTIONS: {
   readonly getReceipt: "action-szamla_agent_nyugta_get";
   readonly sendReceipt: "action-szamla_agent_nyugta_send";
   readonly queryTaxpayer: "action-szamla_agent_taxpayer";
+  readonly connectPrincipal: "action-agent_ceg_mb";
 };
 type AgentAction = keyof typeof AGENT_ACTIONS;
 declare const MAX_INVOICE_ATTACHMENTS = 5;
 //#endregion
 //#region src/core/errors.d.ts
-type SzamlazzErrorCategory = "auth" | "account" | "validation" | "duplicate" | "partial_success" | "not_found" | "maintenance" | "network" | "timeout" | "configuration" | "unexpected_response" | "unknown";
+type SzamlazzErrorCategory = "auth" | "account" | "validation" | "duplicate" | "partial_success" | "not_found" | "maintenance" | "rate_limit" | "attempt_limit" | "network" | "timeout" | "configuration" | "unexpected_response" | "unknown";
 interface AgentErrorCodeInfo {
   readonly message: string;
   readonly category: SzamlazzErrorCategory;
@@ -34,6 +37,7 @@ interface SzamlazzErrorOptions {
   readonly action?: AgentAction | undefined;
   readonly httpStatus?: number | undefined;
   readonly rawResponse?: string | undefined;
+  readonly details?: Readonly<Record<string, string>> | undefined;
   readonly cause?: unknown;
 }
 declare class SzamlazzError extends Error {
@@ -45,50 +49,13 @@ declare class SzamlazzError extends Error {
   readonly action: AgentAction | undefined;
   readonly httpStatus: number | undefined;
   readonly rawResponse: string | undefined;
+  readonly details: Readonly<Record<string, string>> | undefined;
   constructor(message: string, options: SzamlazzErrorOptions);
   get isDuplicate(): boolean;
   get isNotFound(): boolean;
 }
 declare function isSzamlazzError(error: unknown): error is SzamlazzError;
-//#endregion
-//#region src/core/context.d.ts
-interface AgentAttachment {
-  readonly filename: string;
-  readonly content: Uint8Array | ArrayBuffer | Blob | string;
-  readonly contentType?: string;
-}
-interface AgentRequestEvent {
-  readonly action: AgentAction;
-  readonly attempt: number;
-}
-interface AgentResponseEvent extends AgentRequestEvent {
-  readonly status: number;
-  readonly durationMs: number;
-}
-interface AgentErrorEvent extends AgentRequestEvent {
-  readonly error: SzamlazzError;
-  readonly willRetry: boolean;
-}
-interface SzamlazzHooks {
-  readonly onRequest?: (event: AgentRequestEvent) => void;
-  readonly onResponse?: (event: AgentResponseEvent) => void;
-  readonly onError?: (event: AgentErrorEvent) => void;
-}
-interface SzamlazzOptions {
-  readonly agentKey?: string;
-  readonly username?: string;
-  readonly password?: string;
-  readonly endpoint?: string;
-  readonly fetch?: typeof globalThis.fetch;
-  readonly timeoutMs?: number;
-  readonly maxAttempts?: number;
-  readonly retryDelayMs?: number;
-  readonly cookieStore?: CookieStore | false;
-  readonly hooks?: SzamlazzHooks;
-}
-interface RequestOptions {
-  readonly signal?: AbortSignal | undefined;
-}
+declare function suggestedPrefix(error: unknown): string | undefined;
 //#endregion
 //#region src/invoices/create-types.d.ts
 type InvoiceType = "invoice" | "proforma" | "advance" | "final" | "corrective" | "deliveryNote";
@@ -278,6 +245,191 @@ interface InvoicePreview {
   readonly items: readonly CreatedInvoiceItem[];
 }
 //#endregion
+//#region src/core/response.d.ts
+interface AgentResponse {
+  readonly action: AgentAction;
+  readonly status: number;
+  readonly headers: Headers;
+  readonly body: Uint8Array;
+  readonly isPdf: boolean;
+  text(): string;
+}
+//#endregion
+//#region src/core/xml/serialize.d.ts
+type XmlScalar = string | number | boolean;
+type XmlContent = XmlScalar | null | undefined | readonly XmlChild[];
+type XmlChild = XmlNode | false | null | undefined;
+type XmlAttributes = Readonly<Record<string, string>>;
+interface XmlNode {
+  readonly name: string;
+  readonly content: XmlContent;
+  readonly attributes?: XmlAttributes | undefined;
+}
+//#endregion
+//#region src/invoices/payment.d.ts
+interface PaymentEntry {
+  readonly date?: DateInput | undefined;
+  readonly method: string;
+  readonly amount: number;
+  readonly description?: string | undefined;
+}
+interface PaymentTarget {
+  readonly invoiceNumber: string;
+  readonly taxNumber?: string | undefined;
+}
+interface RegisterPaymentsInput extends PaymentTarget {
+  readonly additive?: boolean | undefined;
+  readonly payments: readonly PaymentEntry[];
+}
+interface RegisterSinglePaymentInput extends PaymentTarget {
+  readonly additive?: boolean | undefined;
+  readonly amount: number;
+  readonly method?: string | undefined;
+  readonly date?: DateInput | undefined;
+  readonly description?: string | undefined;
+}
+type RegisterPaymentInput = RegisterPaymentsInput | RegisterSinglePaymentInput;
+type ClearPaymentsInput = string | PaymentTarget;
+interface RegisteredPayment {
+  readonly invoiceNumber: string;
+  readonly netTotal?: number | undefined;
+  readonly grossTotal?: number | undefined;
+  readonly outstanding?: number | undefined;
+  readonly buyerAccountUrl?: string | undefined;
+}
+//#endregion
+//#region src/invoices/reverse.d.ts
+interface ReverseInvoiceEmail {
+  readonly replyTo?: string | undefined;
+  readonly subject?: string | undefined;
+  readonly text?: string | undefined;
+}
+interface ReverseInvoiceBuyer {
+  readonly email?: string | undefined;
+  readonly taxNumber?: string | undefined;
+  readonly euTaxNumber?: string | undefined;
+}
+interface ReverseInvoiceOptions {
+  readonly invoiceNumber: string;
+  readonly issueDate?: DateInput | undefined;
+  readonly fulfillmentDate?: DateInput | undefined;
+  readonly comment?: string | undefined;
+  readonly template?: InvoiceTemplate | undefined;
+  readonly eInvoice?: boolean | undefined;
+  readonly downloadPdf?: boolean | undefined;
+  readonly externalId?: string | undefined;
+  readonly email?: ReverseInvoiceEmail | undefined;
+  readonly buyer?: ReverseInvoiceBuyer | undefined;
+}
+type ReverseInvoiceInput = string | ReverseInvoiceOptions;
+interface ReversedInvoice {
+  readonly number: string;
+  readonly netTotal?: number | undefined;
+  readonly grossTotal?: number | undefined;
+  readonly outstanding?: number | undefined;
+  readonly buyerAccountUrl?: string | undefined;
+  readonly pdf?: Uint8Array | undefined;
+}
+//#endregion
+//#region src/core/document-events.d.ts
+interface InvoiceCreatedEvent {
+  readonly kind: "invoice";
+  readonly action: "created";
+  readonly number: string;
+  readonly document: CreatedInvoice;
+  readonly input: CreateInvoiceInput;
+}
+interface InvoiceReversedEvent {
+  readonly kind: "invoice";
+  readonly action: "reversed";
+  readonly number: string;
+  readonly reversedNumber: string;
+  readonly document: ReversedInvoice;
+}
+interface InvoicePaymentEvent {
+  readonly kind: "invoice";
+  readonly action: "payment";
+  readonly number: string;
+  readonly document: RegisteredPayment;
+}
+interface ReceiptCreatedEvent {
+  readonly kind: "receipt";
+  readonly action: "created";
+  readonly number: string;
+  readonly document: Receipt;
+}
+interface ReceiptReversedEvent {
+  readonly kind: "receipt";
+  readonly action: "reversed";
+  readonly number: string;
+  readonly reversedNumber: string;
+  readonly document: Receipt;
+}
+type DocumentEvent = InvoiceCreatedEvent | InvoiceReversedEvent | InvoicePaymentEvent | ReceiptCreatedEvent | ReceiptReversedEvent;
+type DocumentHook = (event: DocumentEvent) => void | Promise<void>;
+//#endregion
+//#region src/core/context.d.ts
+interface AgentAttachment {
+  readonly filename: string;
+  readonly content: Uint8Array | ArrayBuffer | Blob | string;
+  readonly contentType?: string;
+}
+interface AgentRequestEvent {
+  readonly action: AgentAction;
+  readonly attempt: number;
+}
+interface AgentResponseEvent extends AgentRequestEvent {
+  readonly status: number;
+  readonly durationMs: number;
+}
+interface AgentErrorEvent extends AgentRequestEvent {
+  readonly error: SzamlazzError;
+  readonly willRetry: boolean;
+}
+interface SzamlazzHooks {
+  readonly onRequest?: (event: AgentRequestEvent) => void;
+  readonly onResponse?: (event: AgentResponseEvent) => void;
+  readonly onError?: (event: AgentErrorEvent) => void;
+  readonly onDocument?: DocumentHook;
+}
+interface SzamlazzOptions {
+  readonly agentKey?: string;
+  readonly username?: string;
+  readonly password?: string;
+  readonly endpoint?: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly timeoutMs?: number;
+  readonly maxAttempts?: number;
+  readonly retryDelayMs?: number;
+  readonly cookieStore?: CookieStore | false;
+  readonly attemptLedger?: CookieStore | undefined;
+  readonly maintenanceCooldownMs?: number | undefined;
+  readonly hooks?: SzamlazzHooks;
+}
+interface RequestOptions {
+  readonly signal?: AbortSignal | undefined;
+}
+interface AgentRequest {
+  readonly action: AgentAction;
+  readonly xml: string;
+  readonly attachments?: readonly AgentAttachment[];
+  readonly signal?: AbortSignal | undefined;
+  readonly safeToRetry?: boolean;
+}
+interface AgentContext {
+  readonly credentials: readonly XmlNode[];
+  execute<T>(request: AgentRequest, parse: (response: AgentResponse) => T | Promise<T>): Promise<T>;
+  resetSession(): Promise<void>;
+  resetAttempts(key: string): Promise<void>;
+}
+//#endregion
+//#region src/core/once.d.ts
+interface CreateOnceOptions extends RequestOptions {
+  readonly lookupFirst?: boolean | undefined;
+  readonly matchOrderNumber?: boolean | undefined;
+  readonly recoveryDelayMs?: number | undefined;
+}
+//#endregion
 //#region src/invoices/reference.d.ts
 type InvoiceReference = string | {
   readonly invoiceNumber: string;
@@ -437,37 +589,15 @@ interface InvoiceDetails {
   readonly pdf?: Uint8Array | undefined;
 }
 //#endregion
-//#region src/invoices/payment.d.ts
-interface PaymentEntry {
-  readonly date?: DateInput | undefined;
-  readonly method: string;
-  readonly amount: number;
-  readonly description?: string | undefined;
-}
-interface PaymentTarget {
-  readonly invoiceNumber: string;
-  readonly taxNumber?: string | undefined;
-}
-interface RegisterPaymentsInput extends PaymentTarget {
-  readonly additive?: boolean | undefined;
-  readonly payments: readonly PaymentEntry[];
-}
-interface RegisterSinglePaymentInput extends PaymentTarget {
-  readonly additive?: boolean | undefined;
-  readonly amount: number;
-  readonly method?: string | undefined;
-  readonly date?: DateInput | undefined;
-  readonly description?: string | undefined;
-}
-type RegisterPaymentInput = RegisterPaymentsInput | RegisterSinglePaymentInput;
-type ClearPaymentsInput = string | PaymentTarget;
-interface RegisteredPayment {
-  readonly invoiceNumber: string;
-  readonly netTotal?: number | undefined;
-  readonly grossTotal?: number | undefined;
-  readonly outstanding?: number | undefined;
-  readonly buyerAccountUrl?: string | undefined;
+//#region src/invoices/create-once.d.ts
+interface InvoiceOnceResult {
+  readonly number: string;
+  readonly created: boolean;
+  readonly externalId: string;
+  readonly invoice?: CreatedInvoice | undefined;
+  readonly details?: InvoiceDetails | undefined;
 }
+declare function invoiceOnceExternalId(type: InvoiceType, orderNumber: string): string;
 //#endregion
 //#region src/invoices/pdf.d.ts
 interface InvoicePdf {
@@ -486,170 +616,125 @@ type ProformaReference = string | {
   readonly orderNumber: string;
 };
 //#endregion
-//#region src/invoices/reverse.d.ts
-interface ReverseInvoiceEmail {
-  readonly replyTo?: string | undefined;
-  readonly subject?: string | undefined;
-  readonly text?: string | undefined;
-}
-interface ReverseInvoiceBuyer {
-  readonly email?: string | undefined;
+//#region src/documents/choose.d.ts
+declare const RECEIPT_MAX_GROSS_HUF = 9e5;
+interface ChooseDocumentBuyer {
   readonly taxNumber?: string | undefined;
   readonly euTaxNumber?: string | undefined;
+  readonly isBusiness?: boolean | undefined;
 }
-interface ReverseInvoiceOptions {
-  readonly invoiceNumber: string;
-  readonly issueDate?: DateInput | undefined;
-  readonly fulfillmentDate?: DateInput | undefined;
-  readonly comment?: string | undefined;
-  readonly template?: InvoiceTemplate | undefined;
-  readonly eInvoice?: boolean | undefined;
-  readonly downloadPdf?: boolean | undefined;
-  readonly externalId?: string | undefined;
-  readonly email?: ReverseInvoiceEmail | undefined;
-  readonly buyer?: ReverseInvoiceBuyer | undefined;
-}
-type ReverseInvoiceInput = string | ReverseInvoiceOptions;
-interface ReversedInvoice {
-  readonly number: string;
-  readonly netTotal?: number | undefined;
-  readonly grossTotal?: number | undefined;
-  readonly outstanding?: number | undefined;
-  readonly buyerAccountUrl?: string | undefined;
-  readonly pdf?: Uint8Array | undefined;
-}
+interface ChooseDocumentInput {
+  readonly grossTotal: number;
+  readonly currency?: string | undefined;
+  readonly exchangeRate?: number | undefined;
+  readonly buyer?: ChooseDocumentBuyer | undefined;
+  readonly paidByFulfillment?: boolean | undefined;
+  readonly invoiceRequested?: boolean | undefined;
+  readonly cashRegisterRequired?: boolean | undefined;
+}
+type DocumentChoice = "receipt" | "invoice" | "cash-register";
+interface DocumentDecision {
+  readonly type: DocumentChoice;
+  readonly reasons: readonly string[];
+  readonly grossTotalHuf: number;
+}
+declare function chooseDocument(input: ChooseDocumentInput): DocumentDecision;
 //#endregion
-//#region src/receipts/types.d.ts
-declare const RECEIPT_ONLY_VAT_CODES: readonly ["ÁKK", "MAA", "EU", "EUK"];
-type ReceiptOnlyVatCode = (typeof RECEIPT_ONLY_VAT_CODES)[number];
-type ReceiptVatRate = VatRate | ReceiptOnlyVatCode;
-declare const RECEIPT_PDF_TEMPLATES: readonly ["A", "N", "J", "L"];
-type ReceiptPdfTemplate = (typeof RECEIPT_PDF_TEMPLATES)[number];
-interface ReceiptLedgerInput {
-  readonly revenue?: string | undefined;
-  readonly vat?: string | undefined;
-}
-type ReceiptItemInput = Omit<ItemPriceInput, "vat"> & {
-  readonly vat: ReceiptVatRate;
+//#region src/payments/issue.d.ts
+interface PaymentDocumentItem {
   readonly name: string;
-  readonly identifier?: string | undefined;
+  readonly quantity?: number;
   readonly unit?: string | undefined;
+  readonly identifier?: string | undefined;
   readonly comment?: string | undefined;
-  readonly ledger?: ReceiptLedgerInput | undefined;
-  readonly dataDeletionCode?: number | undefined;
-};
-interface ReceiptPaymentInput {
-  readonly method: string;
-  readonly amount: number;
-  readonly description?: string | undefined;
-}
-interface ReceiptDefaults {
-  readonly prefix?: string | undefined;
-  readonly paymentMethod?: string | undefined;
-  readonly currency?: string | undefined;
-  readonly exchangeRate?: number | undefined;
-  readonly exchangeBank?: string | undefined;
-  readonly downloadPdf?: boolean | undefined;
-  readonly template?: ReceiptPdfTemplate | undefined;
-  readonly unit?: string | undefined;
-  readonly customerLedgerId?: string | undefined;
-}
-interface CreateReceiptInput {
-  readonly prefix?: string | undefined;
-  readonly paymentMethod?: string | undefined;
+  readonly grossUnitPrice?: number;
+  readonly netUnitPrice?: number;
+  readonly vat: VatRate;
+}
+interface IssueForPaymentOptions {
+  readonly vat?: VatRate | undefined;
+  readonly vatFor?: ((item: PaymentLineItem) => VatRate) | undefined;
+  readonly items?: readonly PaymentDocumentItem[] | undefined;
+  readonly fallbackItemName?: string | undefined;
+  readonly document?: "auto" | "receipt" | "invoice" | undefined;
+  readonly buyer?: InvoiceBuyer | undefined;
+  readonly buyerIsBusiness?: boolean | undefined;
+  readonly invoiceRequested?: boolean | undefined;
+  readonly cashRegisterRequired?: boolean | undefined;
+  readonly orderNumber?: string | undefined;
   readonly currency?: string | undefined;
   readonly exchangeRate?: number | undefined;
   readonly exchangeBank?: string | undefined;
-  readonly callId?: string | undefined;
-  readonly comment?: string | undefined;
-  readonly template?: ReceiptPdfTemplate | undefined;
-  readonly customerLedgerId?: string | undefined;
-  readonly orderNumber?: string | undefined;
-  readonly downloadPdf?: boolean | undefined;
-  readonly items: readonly ReceiptItemInput[];
-  readonly payments?: readonly ReceiptPaymentInput[] | undefined;
-}
-interface ReverseReceiptInput {
-  readonly receiptNumber: string;
-  readonly callId?: string | undefined;
-  readonly template?: ReceiptPdfTemplate | undefined;
-  readonly downloadPdf?: boolean | undefined;
+  readonly allowAmountMismatch?: boolean | 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 recoveryDelayMs?: number | undefined;
+  readonly signal?: AbortSignal | undefined;
 }
-interface GetReceiptOptions {
-  readonly callId?: string | undefined;
-  readonly template?: ReceiptPdfTemplate | undefined;
-  readonly downloadPdf?: boolean | undefined;
+interface IssuedReceipt {
+  readonly kind: "receipt";
+  readonly orderNumber: string;
+  readonly number: string;
+  readonly created: boolean;
+  readonly receipt: Receipt;
+  readonly decision: DocumentDecision;
 }
-type GetReceiptInput = GetReceiptOptions & ({
-  readonly receiptNumber: string;
-  readonly orderNumber?: undefined;
-} | {
+interface IssuedInvoice {
+  readonly kind: "invoice";
   readonly orderNumber: string;
-  readonly receiptNumber?: undefined;
-});
-interface SendReceiptInput {
-  readonly receiptNumber: string;
-  readonly emails: string | readonly string[];
-  readonly replyTo?: string | undefined;
-  readonly subject?: string | undefined;
-  readonly text?: string | undefined;
+  readonly number: string;
+  readonly created: boolean;
+  readonly invoice: InvoiceOnceResult;
+  readonly decision: DocumentDecision;
 }
-type ReceiptType = "receipt" | "reversal";
-interface ReceiptLedger {
-  readonly revenue?: string | undefined;
-  readonly vat?: string | undefined;
+interface IssuedReversal {
+  readonly kind: "reversal";
+  readonly orderNumber: string;
+  readonly document: "receipt" | "invoice";
+  readonly reversedNumber: string;
+  readonly number?: string | undefined;
+  readonly created: boolean;
 }
-interface ReceiptItem {
-  readonly name: string;
-  readonly identifier?: string | undefined;
-  readonly quantity: number;
-  readonly unit: string;
-  readonly netUnitPrice: number;
-  readonly vat: ReceiptVatRate;
-  readonly vatPercentage: number;
-  readonly netAmount: number;
-  readonly vatAmount: number;
-  readonly grossAmount: number;
-  readonly ledger?: ReceiptLedger | undefined;
+interface SkippedPayment {
+  readonly kind: "skipped";
+  readonly orderNumber: string;
+  readonly reason: string;
 }
-interface ReceiptPayment {
-  readonly method: string;
-  readonly amount: number;
-  readonly description?: string | undefined;
+type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | SkippedPayment;
+interface PaymentDocumentsApi {
+  readonly invoices: Pick<InvoicesApi, "createOnce" | "find" | "reverse">;
+  readonly receipts: Pick<ReceiptsApi, "createOnce" | "find" | "reverse">;
 }
-interface ReceiptVatTotal {
-  readonly vat: ReceiptVatRate;
-  readonly vatPercentage: number;
-  readonly netAmount: number;
-  readonly vatAmount: number;
-  readonly grossAmount: number;
+declare function paymentOrderNumber(payment: PaymentEvent): string;
+declare function buyerFromCustomer(customer: PaymentCustomer | undefined): InvoiceBuyer | undefined;
+declare function issueForPayment(api: PaymentDocumentsApi, payment: PaymentEvent, options?: IssueForPaymentOptions): Promise<IssuedDocument>;
+//#endregion
+//#region src/receipts/convert.d.ts
+interface ConvertReceiptInput {
+  readonly receiptNumber: string;
+  readonly buyer: InvoiceBuyer;
+  readonly orderNumber?: string | undefined;
+  readonly prefix?: string | undefined;
+  readonly comment?: string | undefined;
+  readonly language?: InvoiceLanguage | undefined;
+  readonly template?: InvoiceTemplate | undefined;
+  readonly seller?: InvoiceSeller | undefined;
+  readonly eInvoice?: boolean | undefined;
+  readonly downloadPdf?: boolean | undefined;
+  readonly vatMapping?: Readonly<Partial<Record<ReceiptOnlyVatCode, VatRate>>> | undefined;
+  readonly allowAlreadyReversed?: boolean | undefined;
 }
-interface ReceiptTotals {
-  readonly netAmount: number;
-  readonly vatAmount: number;
-  readonly grossAmount: number;
-  readonly byVat: readonly ReceiptVatTotal[];
+interface ConvertedReceipt {
+  readonly receipt: Receipt;
+  readonly reversal?: Receipt | undefined;
+  readonly invoice: InvoiceOnceResult;
 }
-interface Receipt {
-  readonly id: number;
-  readonly number: string;
-  readonly callId?: string | undefined;
-  readonly type: ReceiptType;
-  readonly isReversed: boolean;
-  readonly reversedReceiptNumber?: string | undefined;
-  readonly issueDate: string;
-  readonly paymentMethod: string;
-  readonly currency: string;
-  readonly exchangeBank?: string | undefined;
-  readonly exchangeRate?: number | undefined;
-  readonly comment?: string | undefined;
-  readonly customerLedgerId?: string | undefined;
-  readonly isTest: boolean;
-  readonly orderNumber?: string | undefined;
-  readonly items: readonly ReceiptItem[];
-  readonly payments: readonly ReceiptPayment[];
-  readonly totals: ReceiptTotals;
-  readonly pdf?: Uint8Array | undefined;
+declare function conversionExternalId(receiptNumber: string): string;
+//#endregion
+//#region src/receipts/create-once.d.ts
+interface ReceiptOnceResult {
+  readonly receipt: Receipt;
+  readonly created: boolean;
 }
 //#endregion
 //#region src/taxpayer/address.d.ts
@@ -717,6 +802,7 @@ interface KasszaOptions extends SzamlazzOptions {
 }
 interface InvoicesApi {
   create(input: CreateInvoiceInput, options?: RequestOptions): Promise<CreatedInvoice>;
+  createOnce(input: CreateInvoiceInput, options?: CreateOnceOptions): Promise<InvoiceOnceResult>;
   preview(input: CreateInvoiceInput, options?: RequestOptions): Promise<InvoicePreview>;
   reverse(input: ReverseInvoiceInput, options?: RequestOptions): Promise<ReversedInvoice>;
   registerPayment(input: RegisterPaymentInput, options?: RequestOptions): Promise<RegisteredPayment>;
@@ -728,10 +814,12 @@ interface InvoicesApi {
 }
 interface ReceiptsApi {
   create(input: CreateReceiptInput, options?: RequestOptions): Promise<Receipt>;
+  createOnce(input: CreateReceiptInput, options?: CreateOnceOptions): Promise<ReceiptOnceResult>;
   reverse(input: ReverseReceiptInput | string, options?: RequestOptions): Promise<Receipt>;
   get(input: GetReceiptInput | string, options?: RequestOptions): Promise<Receipt>;
   find(input: GetReceiptInput | string, options?: RequestOptions): Promise<Receipt | null>;
   send(input: SendReceiptInput, options?: RequestOptions): Promise<void>;
+  convertToInvoice(input: ConvertReceiptInput, options?: CreateOnceOptions): Promise<ConvertedReceipt>;
 }
 interface TaxpayerApi {
   query(taxNumber: string, options?: RequestOptions): Promise<TaxpayerInfo>;
@@ -742,7 +830,9 @@ interface Kassza {
   readonly taxpayer: TaxpayerApi;
   verifyCredentials(options?: RequestOptions): Promise<boolean>;
   resetSession(): Promise<void>;
+  resetAttempts(target: SzamlazzError | string): Promise<void>;
+  issueForPayment(payment: PaymentEvent, options?: IssueForPaymentOptions): Promise<IssuedDocument>;
 }
 declare function createKassza(options?: KasszaOptions): Kassza;
 //#endregion
-export { InvoiceItemInput as $, PaymentEntry as A, InvoiceDetailsTotals as B, ReverseReceiptInput as C, SzamlazzError as Ct, ProformaReference as D, AgentAction as Dt, ReversedInvoice as E, AGENT_ACTIONS as Et, InvoiceDetailsBuyer as F, CourierService as G, InvoiceReference as H, InvoiceDetailsHeader as I, CreatedInvoiceItem as J, CreateInvoiceInput as K, InvoiceDetailsItem as L, RegisteredPayment as M, GetInvoiceOptions as N, InvoicePdf as O, MAX_INVOICE_ATTACHMENTS as Ot, InvoiceDetails as P, InvoiceDefaults as Q, InvoiceDetailsPayment as R, ReceiptVatRate as S, AgentErrorCodeInfo as St, ReverseInvoiceInput as T, isSzamlazzError as Tt, BuyerLedger as U, InvoiceDocumentType as V, CorrectiveInvoiceInput as W, FinalInvoiceInput as X, Currency as Y, InvoiceBuyer as Z, ReceiptPayment as _, AgentResponseEvent as _t, ReceiptsApi as a, InvoiceType as at, ReceiptTotals as b, SzamlazzOptions as bt, TaxpayerInfo as c, PickPackPointWaybill as ct, CreateReceiptInput as d, TaxpayerType as dt, InvoiceLanguage as et, GetReceiptInput as f, TransOFlexWaybill as ft, ReceiptItemInput as g, AgentRequestEvent as gt, ReceiptItem as h, AgentErrorEvent as ht, KasszaOptions as i, InvoiceTemplate as it, RegisterPaymentInput as j, ClearPaymentsInput as k, SZAMLAZZ_AGENT_URL as kt, TaxpayerTaxNumber as l, SprinterWaybill as lt, ReceiptDefaults as m, AgentAttachment as mt, Kassza as n, InvoicePreview as nt, TaxpayerApi as o, ItemLedger as ot, Receipt as p, Waybill as pt, CreatedInvoice as q, KasszaDefaults as r, InvoiceSeller as rt, createKassza as s, MplWaybill as st, InvoicesApi as t, InvoicePostalAddress as tt, TaxpayerAddress as u, StandardInvoiceInput as ut, ReceiptPaymentInput as v, RequestOptions as vt, SendReceiptInput as w, SzamlazzErrorCategory as wt, ReceiptType as x, AGENT_ERROR_CODES as xt, ReceiptPdfTemplate as y, SzamlazzHooks as yt, InvoiceDetailsSeller as z };
+export { SzamlazzHooks as $, RECEIPT_MAX_GROSS_HUF as A, InvoiceSeller as At, InvoiceDetailsItem as B, Waybill as Bt, buyerFromCustomer as C, FinalInvoiceInput as Ct, ChooseDocumentInput as D, InvoiceLanguage as Dt, ChooseDocumentBuyer as E, InvoiceItemInput as Et, invoiceOnceExternalId as F, PickPackPointWaybill as Ft, InvoiceReference as G, isSzamlazzError as Gt, InvoiceDetailsSeller as H, AgentErrorCodeInfo as Ht, GetInvoiceOptions as I, SprinterWaybill as It, AgentContext as J, AgentAction as Jt, CreateOnceOptions as K, suggestedPrefix as Kt, InvoiceDetails as L, StandardInvoiceInput as Lt, ProformaReference as M, InvoiceType as Mt, InvoicePdf as N, ItemLedger as Nt, DocumentChoice as O, InvoicePostalAddress as Ot, InvoiceOnceResult as P, MplWaybill as Pt, RequestOptions as Q, InvoiceDetailsBuyer as R, TaxpayerType as Rt, SkippedPayment as S, Currency as St, paymentOrderNumber as T, InvoiceDefaults as Tt, InvoiceDetailsTotals as U, SzamlazzError as Ut, InvoiceDetailsPayment as V, AGENT_ERROR_CODES as Vt, InvoiceDocumentType as W, SzamlazzErrorCategory as Wt, AgentRequestEvent as X, SZAMLAZZ_AGENT_URL as Xt, AgentErrorEvent as Y, MAX_INVOICE_ATTACHMENTS as Yt, AgentResponseEvent as Z, IssuedInvoice as _, CorrectiveInvoiceInput as _t, ReceiptsApi as a, InvoiceReversedEvent as at, PaymentDocumentItem as b, CreatedInvoice as bt, TaxpayerInfo as c, ReverseInvoiceInput as ct, ReceiptOnceResult as d, PaymentEntry as dt, SzamlazzOptions as et, ConvertReceiptInput as f, RegisterPaymentInput as ft, IssuedDocument as g, BuyerLedger as gt, IssueForPaymentOptions as h, AgentResponse as ht, KasszaOptions as i, InvoicePaymentEvent as it, chooseDocument as j, InvoiceTemplate as jt, DocumentDecision as k, InvoicePreview as kt, TaxpayerTaxNumber as l, ReversedInvoice as lt, conversionExternalId as m, XmlNode as mt, Kassza as n, DocumentHook as nt, TaxpayerApi as o, ReceiptCreatedEvent as ot, ConvertedReceipt as p, RegisteredPayment as pt, AgentAttachment as q, AGENT_ACTIONS as qt, KasszaDefaults as r, InvoiceCreatedEvent as rt, createKassza as s, ReceiptReversedEvent as st, InvoicesApi as t, DocumentEvent as tt, TaxpayerAddress as u, ClearPaymentsInput as ut, IssuedReceipt as v, CourierService as vt, issueForPayment as w, InvoiceBuyer as wt, PaymentDocumentsApi as x, CreatedInvoiceItem as xt, IssuedReversal as y, CreateInvoiceInput as yt, InvoiceDetailsHeader as z, TransOFlexWaybill as zt };