kassza 0.1.0

package/dist/create-DDZaNlOz.js

@@ -0,0 +1,939 @@
+import { a as parseErrorCode, n as SzamlazzError, r as createAgentError } from "./errors-DapdV5DK.js";
+import { a as isPdf, i as encodeUtf8, r as decodeUtf8, t as base64ToBytes } from "./binary-D0M9U2MD.js";
+import { n as toAgentDate, t as addBudapestDays } from "./dates-D2XebOIg.js";
+import { c as isHuf, f as decimalPlaces, p as roundMoney, r as calculateReceiptItem, t as calculateInvoiceItem, u as vatPercentage } from "./money-C9j7nBNP.js";
+//#region src/core/actions.ts
+const SZAMLAZZ_AGENT_URL = "https://www.szamlazz.hu/szamla/";
+const AGENT_ACTIONS = {
+	createInvoice: "action-xmlagentxmlfile",
+	reverseInvoice: "action-szamla_agent_st",
+	registerPayment: "action-szamla_agent_kifiz",
+	getInvoicePdf: "action-szamla_agent_pdf",
+	getInvoiceXml: "action-szamla_agent_xml",
+	deleteProforma: "action-szamla_agent_dijbekero_torlese",
+	createReceipt: "action-szamla_agent_nyugta_create",
+	reverseReceipt: "action-szamla_agent_nyugta_storno",
+	getReceipt: "action-szamla_agent_nyugta_get",
+	sendReceipt: "action-szamla_agent_nyugta_send",
+	queryTaxpayer: "action-szamla_agent_taxpayer"
+};
+const MAX_INVOICE_ATTACHMENTS = 5;
+//#endregion
+//#region src/core/xml/parse.ts
+var XmlParseError = class extends Error {
+	name = "XmlParseError";
+};
+const NAMED_ENTITIES = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'"
+};
+function decodeEntities(value) {
+	return value.replace(/&(#x[0-9a-fA-F]+|#\d+|[a-zA-Z]+);/g, (match, entity) => {
+		if (entity.startsWith("#x")) return String.fromCodePoint(Number.parseInt(entity.slice(2), 16));
+		if (entity.startsWith("#")) return String.fromCodePoint(Number.parseInt(entity.slice(1), 10));
+		return NAMED_ENTITIES[entity] ?? match;
+	});
+}
+function localName(qualifiedName) {
+	const colon = qualifiedName.indexOf(":");
+	return colon === -1 ? qualifiedName : qualifiedName.slice(colon + 1);
+}
+const ATTRIBUTE_PATTERN = /([^\s=/>]+)\s*=\s*("([^"]*)"|'([^']*)')/g;
+function parseAttributes(source) {
+	const attributes = {};
+	for (const match of source.matchAll(ATTRIBUTE_PATTERN)) {
+		const [, name, , doubleQuoted, singleQuoted] = match;
+		if (name === void 0) continue;
+		attributes[name] = decodeEntities(doubleQuoted ?? singleQuoted ?? "");
+	}
+	return attributes;
+}
+function skipUntil(xml, from, terminator) {
+	const end = xml.indexOf(terminator, from);
+	if (end === -1) throw new XmlParseError(`Lezáratlan szerkezet, hiányzik: ${terminator}`);
+	return end + terminator.length;
+}
+function parseXml(xml) {
+	const stack = [];
+	let root;
+	let position = xml.charCodeAt(0) === 65279 ? 1 : 0;
+	const appendText = (value) => {
+		const current = stack.at(-1);
+		if (current) current.text += value;
+	};
+	while (position < xml.length) {
+		const tagStart = xml.indexOf("<", position);
+		if (tagStart === -1) {
+			appendText(decodeEntities(xml.slice(position)));
+			break;
+		}
+		if (tagStart > position) appendText(decodeEntities(xml.slice(position, tagStart)));
+		if (xml.startsWith("<!--", tagStart)) {
+			position = skipUntil(xml, tagStart + 4, "-->");
+			continue;
+		}
+		if (xml.startsWith("<![CDATA[", tagStart)) {
+			const end = xml.indexOf("]]>", tagStart + 9);
+			if (end === -1) throw new XmlParseError("Lezáratlan CDATA szakasz");
+			appendText(xml.slice(tagStart + 9, end));
+			position = end + 3;
+			continue;
+		}
+		if (xml.startsWith("<?", tagStart)) {
+			position = skipUntil(xml, tagStart + 2, "?>");
+			continue;
+		}
+		if (xml.startsWith("<!", tagStart)) {
+			position = skipUntil(xml, tagStart + 2, ">");
+			continue;
+		}
+		const tagEnd = xml.indexOf(">", tagStart);
+		if (tagEnd === -1) throw new XmlParseError("Lezáratlan XML tag");
+		const rawTag = xml.slice(tagStart + 1, tagEnd);
+		position = tagEnd + 1;
+		if (rawTag.startsWith("/")) {
+			const closingName = localName(rawTag.slice(1).trim());
+			const current = stack.pop();
+			if (!current || current.name !== closingName) throw new XmlParseError(`Váratlan záró tag: ${closingName}`);
+			continue;
+		}
+		const selfClosing = rawTag.endsWith("/");
+		const tagBody = selfClosing ? rawTag.slice(0, -1) : rawTag;
+		const nameMatch = /^\s*([^\s/>]+)/.exec(tagBody);
+		if (!nameMatch?.[1]) throw new XmlParseError("Érvénytelen XML tag");
+		const element = {
+			name: localName(nameMatch[1]),
+			attributes: parseAttributes(tagBody.slice(nameMatch[0].length)),
+			children: [],
+			text: ""
+		};
+		const parent = stack.at(-1);
+		if (parent) parent.children.push(element);
+		else if (root) throw new XmlParseError("Az XML-nek csak egy gyökéreleme lehet");
+		else root = element;
+		if (!selfClosing) stack.push(element);
+	}
+	if (stack.length > 0) throw new XmlParseError(`Lezáratlan elem: ${stack.at(-1)?.name}`);
+	if (!root) throw new XmlParseError("Üres XML dokumentum");
+	return root;
+}
+function findChild(element, name) {
+	return element?.children.find((child) => child.name === name);
+}
+function findChildren(element, name) {
+	return element?.children.filter((child) => child.name === name) ?? [];
+}
+function childText(element, name) {
+	const child = findChild(element, name);
+	if (!child) return void 0;
+	const value = child.text.trim();
+	return value === "" ? void 0 : value;
+}
+function childNumber(element, name) {
+	const value = childText(element, name);
+	if (value === void 0) return void 0;
+	const parsed = Number(value.replace(",", "."));
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function childBoolean(element, name) {
+	const value = childText(element, name)?.toLowerCase();
+	if (value === "true" || value === "1") return true;
+	if (value === "false" || value === "0") return false;
+}
+//#endregion
+//#region src/core/response.ts
+function createAgentResponse(action, status, headers, body) {
+	let cachedText;
+	return {
+		action,
+		status,
+		headers,
+		body,
+		isPdf: isPdf(body),
+		text() {
+			cachedText ??= decodeUtf8(body);
+			return cachedText;
+		}
+	};
+}
+function decodeHeaderValue(value) {
+	try {
+		return decodeURIComponent(value.replace(/\+/g, " "));
+	} catch {
+		return value;
+	}
+}
+function readHeader(headers, name, encoded = false) {
+	const raw = headers.get(name);
+	if (raw === null) return void 0;
+	const value = (encoded ? decodeHeaderValue(raw) : raw).trim();
+	return value === "" ? void 0 : value;
+}
+function readNumberHeader(headers, name) {
+	const value = readHeader(headers, name);
+	if (value === void 0) return void 0;
+	const parsed = Number(value.replace(",", "."));
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function readDocumentHeaders(headers) {
+	return {
+		number: readHeader(headers, "szlahu_szamlaszam", true),
+		netTotal: readNumberHeader(headers, "szlahu_nettovegosszeg"),
+		grossTotal: readNumberHeader(headers, "szlahu_bruttovegosszeg"),
+		paymentMethod: readHeader(headers, "szlahu_fizetesmod", true),
+		buyerAccountUrl: readHeader(headers, "szlahu_vevoifiokurl", true)
+	};
+}
+const RAW_RESPONSE_PREVIEW_LENGTH = 2e3;
+function rawPreview(response) {
+	if (response.isPdf) return void 0;
+	return response.text().slice(0, RAW_RESPONSE_PREVIEW_LENGTH);
+}
+function throwIfHeaderError(response) {
+	const message = readHeader(response.headers, "szlahu_error", true);
+	const code = parseErrorCode(response.headers.get("szlahu_error_code"));
+	if (message === void 0 && code === void 0) return;
+	throw createAgentError({
+		code,
+		message,
+		action: response.action,
+		httpStatus: response.status,
+		rawResponse: rawPreview(response)
+	});
+}
+function extractTextError(text) {
+	const start = text.indexOf("[ERR]");
+	if (start === -1) return void 0;
+	const afterMarker = text.slice(start + 5);
+	const separator = afterMarker.search(/-{5,}/);
+	const message = (separator === -1 ? afterMarker.split("\n")[0] ?? "" : afterMarker.slice(0, separator)).replace(/\s+/g, " ").trim();
+	const codeMatch = /^\[?(\d{1,4})\]?\s+/.exec(message);
+	if (codeMatch?.[1]) return {
+		code: Number(codeMatch[1]),
+		message: message.slice(codeMatch[0].length)
+	};
+	return {
+		code: void 0,
+		message
+	};
+}
+function throwIfTextError(response) {
+	if (response.isPdf) return;
+	const text = response.text().trimStart();
+	if (!text.startsWith("[ERR]")) return;
+	const error = extractTextError(text);
+	if (!error) return;
+	throw createAgentError({
+		code: error.code,
+		message: error.message,
+		action: response.action,
+		httpStatus: response.status,
+		rawResponse: rawPreview(response)
+	});
+}
+function parseDoneText(text) {
+	const match = /xmlagentresponse\s*=\s*DONE(?:;([^\r\n]*))?/i.exec(text);
+	if (!match) return void 0;
+	const number = match[1]?.trim();
+	return { number: number ? decodeHeaderValue(number) : void 0 };
+}
+function unexpectedResponse(response, detail) {
+	const suffix = detail ? ` ${detail}` : "";
+	return new SzamlazzError(`Váratlan válasz a Számlázz.hu-tól (HTTP ${response.status}).${suffix}`, {
+		category: "unexpected_response",
+		action: response.action,
+		httpStatus: response.status,
+		rawResponse: rawPreview(response)
+	});
+}
+function looksLikeXml(response) {
+	if (response.isPdf) return false;
+	const text = response.text();
+	return /^\s*</.test(text.charCodeAt(0) === 65279 ? text.slice(1) : text);
+}
+function parseResponseXml(response) {
+	if (!looksLikeXml(response)) throw unexpectedResponse(response, "XML választ vártunk.");
+	try {
+		return parseXml(response.text());
+	} catch (error) {
+		throw new SzamlazzError(`A Számlázz.hu XML válasza nem értelmezhető (HTTP ${response.status}).`, {
+			category: "unexpected_response",
+			action: response.action,
+			httpStatus: response.status,
+			rawResponse: rawPreview(response),
+			cause: error
+		});
+	}
+}
+function throwIfXmlFailure(root, response) {
+	const success = childText(root, "sikeres")?.toLowerCase();
+	const code = childNumber(root, "hibakod");
+	const message = childText(root, "hibauzenet");
+	if (success === "true" && code === void 0) return;
+	if (success === void 0 && code === void 0 && message === void 0) return;
+	throw createAgentError({
+		code,
+		message,
+		action: response.action,
+		httpStatus: response.status,
+		rawResponse: rawPreview(response)
+	});
+}
+function throwIfHttpError(response) {
+	if (response.status >= 200 && response.status < 400) return;
+	const error = unexpectedResponse(response);
+	if (response.status >= 500) throw new SzamlazzError(error.message, {
+		category: "network",
+		action: response.action,
+		httpStatus: response.status,
+		rawResponse: error.rawResponse
+	});
+	throw error;
+}
+function throwIfAnyError(response) {
+	throwIfHeaderError(response);
+	throwIfTextError(response);
+	throwIfHttpError(response);
+}
+//#endregion
+//#region src/core/xml/serialize.ts
+function el(name, content) {
+	return {
+		name,
+		content
+	};
+}
+function optionalEl(name, content) {
+	if (content === void 0 || content === null) return void 0;
+	if (Array.isArray(content) && !content.some(Boolean)) return void 0;
+	return {
+		name,
+		content
+	};
+}
+function isAllowedXmlChar(codePoint) {
+	if (codePoint === 9 || codePoint === 10 || codePoint === 13) return true;
+	if (codePoint < 32) return false;
+	return codePoint !== 65534 && codePoint !== 65535;
+}
+function stripInvalidXmlChars(value) {
+	let result = "";
+	for (const char of value) if (isAllowedXmlChar(char.codePointAt(0) ?? 0)) result += char;
+	return result;
+}
+function escapeXml(value) {
+	return stripInvalidXmlChars(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function formatXmlNumber(value) {
+	if (!Number.isFinite(value)) throw new RangeError(`Az XML-be csak véges szám írható, kapott: ${value}`);
+	if (Number.isInteger(value)) return value.toString();
+	const fixed = value.toFixed(10).replace(/0+$/, "").replace(/\.$/, "");
+	return fixed === "-0" ? "0" : fixed;
+}
+function formatScalar(value) {
+	if (typeof value === "boolean") return value ? "true" : "false";
+	if (typeof value === "number") return formatXmlNumber(value);
+	return escapeXml(value);
+}
+function isPresent(child) {
+	return Boolean(child);
+}
+function renderNode(node, depth) {
+	const indent = "  ".repeat(depth);
+	const { name, content } = node;
+	if (content === void 0 || content === null) return `${indent}<${name}></${name}>`;
+	if (!Array.isArray(content)) return `${indent}<${name}>${formatScalar(content)}</${name}>`;
+	const children = content.filter(isPresent);
+	if (children.length === 0) return `${indent}<${name}></${name}>`;
+	return `${indent}<${name}>\n${children.map((child) => renderNode(child, depth + 1)).join("\n")}\n${indent}</${name}>`;
+}
+function buildXmlDocument(options) {
+	const attributes = [`xmlns="${options.namespace}"`];
+	if (options.schemaLocation !== void 0) attributes.push("xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"", `xsi:schemaLocation="${options.namespace} ${options.schemaLocation}"`);
+	const body = options.children.filter(isPresent).map((child) => renderNode(child, 1)).join("\n");
+	return `<?xml version="1.0" encoding="UTF-8"?>\n<${options.root} ${attributes.join(" ")}>\n${body}\n</${options.root}>\n`;
+}
+//#endregion
+//#region src/invoices/create-types.ts
+const INVOICE_TYPES = [
+	"invoice",
+	"proforma",
+	"advance",
+	"final",
+	"corrective",
+	"deliveryNote"
+];
+const INVOICE_LANGUAGES = [
+	"hu",
+	"en",
+	"de",
+	"it",
+	"ro",
+	"sk",
+	"hr",
+	"fr",
+	"es",
+	"cz",
+	"pl",
+	"bg",
+	"nl",
+	"ru",
+	"si"
+];
+const INVOICE_TEMPLATES = [
+	"SzlaMost",
+	"SzlaAlap",
+	"SzlaNoEnv",
+	"Szla8cm",
+	"SzlaTomb",
+	"SzlaFuvarlevelesAlap"
+];
+const TAXPAYER_TYPE_CODES = {
+	nonEuBusiness: 7,
+	euBusiness: 6,
+	hungarianTaxNumber: 1,
+	unknown: 0,
+	noTaxNumber: -1
+};
+const SIMPLE_ITEMS_MAX = 2;
+const SIMPLE_ITEMS_FINAL_MAX = 4;
+const SIMPLE_ITEMS_VAT_RATES = /* @__PURE__ */ new Set([
+	0,
+	5,
+	18,
+	27,
+	"TAM",
+	"AAM",
+	"K.AFA",
+	"F.AFA"
+]);
+const LANGUAGES = new Set(INVOICE_LANGUAGES);
+const TEMPLATES = new Set(INVOICE_TEMPLATES);
+const TYPES = new Set(INVOICE_TYPES);
+function invalid(message, cause) {
+	return new SzamlazzError(message, {
+		category: "validation",
+		cause
+	});
+}
+function presentText(value) {
+	return value === void 0 || value.trim() === "" ? void 0 : value;
+}
+function agentDate(value, field) {
+	try {
+		return toAgentDate(value);
+	} catch (error) {
+		throw invalid(`A(z) ${field} mező nem érvényes dátum: ${String(value)}`, error);
+	}
+}
+function optionalAgentDate(value, field) {
+	return value === void 0 ? void 0 : agentDate(value, field);
+}
+function requireText$1(value, message) {
+	if (typeof value !== "string" || value.trim() === "") throw invalid(message);
+}
+function assertNonNegativeInteger(value, field) {
+	if (value === void 0) return;
+	if (!Number.isInteger(value) || value < 0) throw invalid(`A(z) ${field} mező nemnegatív egész szám legyen, kapott: ${value}`);
+}
+function assertFinite(value, field) {
+	if (value !== void 0 && !Number.isFinite(value)) throw invalid(`A(z) ${field} mező nem érvényes szám: ${value}`);
+}
+function mergeSeller(defaults = {}, input = {}) {
+	return {
+		bank: input.bank ?? defaults.bank,
+		bankAccount: input.bankAccount ?? defaults.bankAccount,
+		emailReplyTo: input.emailReplyTo ?? defaults.emailReplyTo,
+		emailSubject: input.emailSubject ?? defaults.emailSubject,
+		emailText: input.emailText ?? defaults.emailText,
+		signatoryName: input.signatoryName ?? defaults.signatoryName
+	};
+}
+function resolveType(input) {
+	const type = input.type ?? "invoice";
+	if (!TYPES.has(type)) throw invalid(`Ismeretlen bizonylattípus: ${String(type)}`);
+	if (input.type === "corrective") requireText$1(input.correctedInvoiceNumber, "Helyesbítő számlához add meg a helyesbített számla számát (correctedInvoiceNumber).");
+	if (input.type === "final" && !presentText(input.advanceInvoiceNumber)) requireText$1(input.orderNumber, "Végszámlához add meg az előlegszámla számát (advanceInvoiceNumber) vagy az előlegszámla rendelésszámát (orderNumber).");
+	return type;
+}
+function resolveDates(defaults, input, now) {
+	if (input.dueDate !== void 0 && input.paymentDueInDays !== void 0) throw invalid("A dueDate és a paymentDueInDays közül csak az egyiket add meg.");
+	const issueDate = optionalAgentDate(input.issueDate, "issueDate") ?? agentDate(now, "now");
+	const fulfillmentDate = optionalAgentDate(input.fulfillmentDate, "fulfillmentDate") ?? issueDate;
+	const explicitDue = optionalAgentDate(input.dueDate, "dueDate");
+	if (explicitDue !== void 0) return {
+		issueDate,
+		fulfillmentDate,
+		dueDate: explicitDue
+	};
+	const days = input.paymentDueInDays ?? defaults.paymentDueInDays ?? 0;
+	assertNonNegativeInteger(days, "paymentDueInDays");
+	return {
+		issueDate,
+		fulfillmentDate,
+		dueDate: addBudapestDays(/* @__PURE__ */ new Date(`${issueDate}T12:00:00Z`), days)
+	};
+}
+function resolveCurrency(defaults, input) {
+	const currency = presentText(input.currency) ?? presentText(defaults.currency) ?? "HUF";
+	const exchangeRate = input.exchangeRate;
+	if (isHuf(currency)) {
+		if (exchangeRate !== void 0 || presentText(input.exchangeBank) !== void 0) throw invalid("Forintos számlán nem adható meg árfolyam (exchangeRate, exchangeBank).");
+		return {
+			currency,
+			exchangeBank: void 0,
+			exchangeRate: void 0
+		};
+	}
+	if (exchangeRate !== void 0 && !(Number.isFinite(exchangeRate) && exchangeRate > 0)) throw invalid(`Az árfolyam (exchangeRate) pozitív szám legyen, kapott: ${exchangeRate}`);
+	const exchangeBank = presentText(input.exchangeBank) ?? presentText(defaults.exchangeBank) ?? "MNB";
+	if (exchangeRate === void 0 && exchangeBank.trim().toUpperCase() !== "MNB") throw invalid(`Devizás számlához (${currency}) add meg az árfolyamot (exchangeRate). Árfolyam nélkül csak az MNB automatikus árfolyama használható.`);
+	return {
+		currency,
+		exchangeBank,
+		exchangeRate
+	};
+}
+function resolveItems(items, currency) {
+	if (!Array.isArray(items) || items.length === 0) throw invalid("A számlán legalább egy tételnek szerepelnie kell.");
+	return items.map((item, index) => {
+		const label = `${index + 1}. tétel`;
+		requireText$1(item.name, `A(z) ${label} megnevezése (name) nem lehet üres.`);
+		const unit = item.unit ?? "db";
+		requireText$1(unit, `A(z) ${label} mennyiségi egysége (unit) nem lehet üres.`);
+		assertNonNegativeInteger(item.dataDeletionCode, `${label} dataDeletionCode`);
+		assertFinite(item.marginVatBase, `${label} marginVatBase`);
+		let amounts;
+		try {
+			amounts = calculateInvoiceItem(item, currency);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw invalid(`${label} (${item.name}): ${message}`, error);
+		}
+		return {
+			input: item,
+			unit,
+			amounts: {
+				name: item.name,
+				...amounts
+			}
+		};
+	});
+}
+function validateSimpleItems(type, items) {
+	if (type === "corrective" || type === "deliveryNote") throw invalid("Egyszerűsített számlakép (simpleItems) helyesbítő számlán és szállítólevélen nem használható.");
+	const max = type === "final" ? SIMPLE_ITEMS_FINAL_MAX : SIMPLE_ITEMS_MAX;
+	if (items.length > max) throw invalid(`Egyszerűsített számlaképen (simpleItems) legfeljebb ${max} tétel adható meg.`);
+	const invalidItem = items.find((item) => !SIMPLE_ITEMS_VAT_RATES.has(item.amounts.vat));
+	if (invalidItem) throw invalid(`Egyszerűsített számlaképen (simpleItems) csak 0, 5, 18, 27, TAM, AAM, K.AFA vagy F.AFA áfakulcs használható, kapott: ${String(invalidItem.amounts.vat)}`);
+}
+function attachmentSize(content) {
+	if (typeof content === "string") return encodeUtf8(content).byteLength;
+	if (content instanceof Blob) return content.size;
+	return content.byteLength;
+}
+function validateAttachments(attachments, sendEmail) {
+	if (attachments.length === 0) return attachments;
+	if (attachments.length > 5) throw invalid(`Legfeljebb 5 melléklet csatolható, kapott: ${attachments.length}`);
+	if (!sendEmail) throw invalid("Mellékletet csak e-mail értesítővel lehet küldeni: add meg a vevő e-mail címét, és ne kapcsold ki a sendEmail beállítást.");
+	for (const attachment of attachments) {
+		requireText$1(attachment.filename, "A melléklet fájlneve (filename) nem lehet üres.");
+		if (attachmentSize(attachment.content) > 2097152) throw invalid(`A(z) ${attachment.filename} melléklet nagyobb 2 MB-nál.`);
+	}
+	return attachments;
+}
+function validateWaybill(waybill) {
+	if (!waybill) return;
+	assertNonNegativeInteger(waybill.transOFlex?.packageCount, "waybill.transOFlex.packageCount");
+	assertNonNegativeInteger(waybill.sprinter?.packageCount, "waybill.sprinter.packageCount");
+	const mpl = waybill.mpl;
+	if (!mpl) return;
+	requireText$1(mpl.customerCode, "Az MPL fuvarlevélhez add meg a vevőkódot (customerCode).");
+	requireText$1(mpl.barcode, "Az MPL fuvarlevélhez add meg a vonalkódot (barcode).");
+	requireText$1(String(mpl.weight ?? ""), "Az MPL fuvarlevélhez add meg a tömeget (weight).");
+	assertFinite(mpl.declaredValue, "waybill.mpl.declaredValue");
+}
+function resolveSendEmail(defaults, input) {
+	const hasEmail = presentText(input.buyer.email) !== void 0;
+	if (input.buyer.sendEmail === true && !hasEmail) throw invalid("A sendEmail be van kapcsolva, de a vevőnek nincs e-mail címe (buyer.email).");
+	if (!hasEmail) return false;
+	return input.buyer.sendEmail ?? defaults.sendEmail ?? true;
+}
+function validateBuyer(input) {
+	const buyer = input.buyer;
+	if (!buyer || typeof buyer !== "object") throw invalid("A vevő adatai (buyer) kötelezők.");
+	requireText$1(buyer.name, "A vevő neve (buyer.name) nem lehet üres.");
+	requireText$1(buyer.zip, "A vevő irányítószáma (buyer.zip) nem lehet üres.");
+	requireText$1(buyer.city, "A vevő települése (buyer.city) nem lehet üres.");
+	requireText$1(buyer.address, "A vevő címe (buyer.address) nem lehet üres.");
+}
+function resolveInvoice(defaults, input, now) {
+	validateBuyer(input);
+	const type = resolveType(input);
+	const language = input.language ?? defaults.language ?? "hu";
+	if (!LANGUAGES.has(language)) throw invalid(`Ismeretlen számlanyelv: ${String(language)}`);
+	const template = input.template ?? defaults.template;
+	if (template !== void 0 && !TEMPLATES.has(template)) throw invalid(`Ismeretlen számlasablon: ${String(template)}`);
+	assertFinite(input.paymentCorrection, "paymentCorrection");
+	const currency = resolveCurrency(defaults, input);
+	const dates = resolveDates(defaults, input, now);
+	const items = resolveItems(input.items, currency.currency);
+	const simpleItems = input.simpleItems ?? defaults.simpleItems;
+	if (simpleItems) validateSimpleItems(type, items);
+	validateWaybill(input.waybill);
+	const sendEmail = resolveSendEmail(defaults, input);
+	const attachments = validateAttachments(input.attachments ?? [], sendEmail);
+	return {
+		input,
+		type,
+		...dates,
+		...currency,
+		paymentMethod: presentText(input.paymentMethod) ?? presentText(defaults.paymentMethod) ?? "Átutalás",
+		language,
+		prefix: presentText(input.prefix) ?? presentText(defaults.prefix),
+		eInvoice: input.eInvoice ?? defaults.eInvoice ?? false,
+		downloadPdf: input.downloadPdf ?? defaults.downloadPdf ?? true,
+		template,
+		simpleItems,
+		euVat: input.euVat ?? defaults.euVat,
+		logoExtra: presentText(input.logoExtra) ?? presentText(defaults.logoExtra),
+		aggregator: presentText(input.aggregator) ?? presentText(defaults.aggregator),
+		guardian: input.guardian ?? defaults.guardian,
+		articleIdentifierInvoice: input.articleIdentifierInvoice ?? defaults.articleIdentifierInvoice,
+		seller: mergeSeller(defaults.seller, input.seller),
+		sendEmail,
+		items,
+		attachments
+	};
+}
+//#endregion
+//#region src/receipts/types.ts
+const RECEIPT_ONLY_VAT_CODES = [
+	"ÁKK",
+	"MAA",
+	"EU",
+	"EUK"
+];
+const RECEIPT_PDF_TEMPLATES = [
+	"A",
+	"N",
+	"J",
+	"L"
+];
+//#endregion
+//#region src/receipts/common.ts
+const RECEIPT_XSD_BASE_URL = "https://www.szamlazz.hu/szamla/docs/xsds/";
+function receiptValidationError(message) {
+	return new SzamlazzError(message, { category: "validation" });
+}
+function requireText(value, message) {
+	const trimmed = value?.trim();
+	if (!trimmed) throw receiptValidationError(message);
+	return trimmed;
+}
+function optionalText(value) {
+	const trimmed = value?.trim();
+	return trimmed ? trimmed : void 0;
+}
+const templates = new Set(RECEIPT_PDF_TEMPLATES);
+function validateTemplate(template) {
+	if (template === void 0) return void 0;
+	if (!templates.has(template)) throw receiptValidationError(`Ismeretlen nyugta PDF sablon: ${String(template)}. Lehetséges értékek: A (normál A4), N (80 mm), J (jegy), L (jegy logóval).`);
+	return template;
+}
+function requireReceiptNumber(value) {
+	return requireText(value, "Add meg a nyugtaszámot (receiptNumber).");
+}
+//#endregion
+//#region src/receipts/parse.ts
+function requiredText(element, name, response) {
+	const value = childText(element, name);
+	if (value === void 0) throw unexpectedResponse(response, `Hiányzik a(z) <${name}> elem a nyugta válaszból.`);
+	return value;
+}
+function amount(element, names) {
+	for (const name of names) {
+		const value = childNumber(element, name);
+		if (value !== void 0) return value;
+	}
+	return 0;
+}
+function vatOf(element) {
+	const vatPercentage = childNumber(element, "afakulcs") ?? 0;
+	return {
+		vat: childText(element, "afatipus") ?? vatPercentage,
+		vatPercentage
+	};
+}
+function parseLedger(element) {
+	const ledger = findChild(element, "fokonyv");
+	const revenue = childText(ledger, "arbevetel");
+	const vat = childText(ledger, "afa");
+	if (revenue === void 0 && vat === void 0) return void 0;
+	return {
+		revenue,
+		vat
+	};
+}
+function parseItem(element) {
+	return {
+		name: childText(element, "megnevezes") ?? "",
+		identifier: childText(element, "azonosito"),
+		quantity: childNumber(element, "mennyiseg") ?? 0,
+		unit: childText(element, "mennyisegiEgyseg") ?? "",
+		netUnitPrice: childNumber(element, "nettoEgysegar") ?? 0,
+		...vatOf(element),
+		netAmount: amount(element, ["netto", "nettoErtek"]),
+		vatAmount: amount(element, ["afa", "afaErtek"]),
+		grossAmount: amount(element, ["brutto", "bruttoErtek"]),
+		ledger: parseLedger(element)
+	};
+}
+function parsePayment(element) {
+	return {
+		method: childText(element, "fizetoeszkoz") ?? "",
+		amount: childNumber(element, "osszeg") ?? 0,
+		description: childText(element, "leiras")
+	};
+}
+function parseVatTotal(element) {
+	return {
+		...vatOf(element),
+		netAmount: amount(element, ["netto"]),
+		vatAmount: amount(element, ["afa"]),
+		grossAmount: amount(element, ["brutto"])
+	};
+}
+function parseTotals(receipt, items) {
+	const totals = findChild(receipt, "osszegek");
+	const byVat = findChildren(totals, "afakulcsossz").map(parseVatTotal);
+	const total = findChild(totals, "totalossz");
+	if (total) return {
+		netAmount: amount(total, ["netto"]),
+		vatAmount: amount(total, ["afa"]),
+		grossAmount: amount(total, ["brutto"]),
+		byVat
+	};
+	const sum = (pick) => Number(items.reduce((acc, item) => acc + pick(item), 0).toFixed(2));
+	return {
+		netAmount: sum((item) => item.netAmount),
+		vatAmount: sum((item) => item.vatAmount),
+		grossAmount: sum((item) => item.grossAmount),
+		byVat
+	};
+}
+function parsePdf(root) {
+	const encoded = childText(root, "nyugtaPdf");
+	if (encoded === void 0) return void 0;
+	const bytes = base64ToBytes(encoded);
+	return bytes.length > 0 ? bytes : void 0;
+}
+function parseReceiptXml(root, response) {
+	const receipt = findChild(root, "nyugta");
+	const base = findChild(receipt, "alap");
+	if (!receipt || !base) throw unexpectedResponse(response, "A nyugta válaszból hiányzik a <nyugta> blokk.");
+	const items = findChildren(findChild(receipt, "tetelek"), "tetel").map(parseItem);
+	const pdf = parsePdf(root);
+	return {
+		id: childNumber(base, "id") ?? 0,
+		number: requiredText(base, "nyugtaszam", response),
+		callId: childText(base, "hivasAzonosito"),
+		type: childText(base, "tipus")?.toUpperCase() === "SN" ? "reversal" : "receipt",
+		isReversed: childBoolean(base, "stornozott") ?? false,
+		reversedReceiptNumber: childText(base, "stornozottNyugtaszam"),
+		issueDate: childText(base, "kelt") ?? "",
+		paymentMethod: childText(base, "fizmod") ?? "",
+		currency: childText(base, "penznem") ?? "HUF",
+		exchangeBank: childText(base, "devizabank"),
+		exchangeRate: childNumber(base, "devizaarf"),
+		comment: childText(base, "megjegyzes"),
+		customerLedgerId: childText(base, "fokonyvVevo"),
+		isTest: childBoolean(base, "teszt") ?? false,
+		orderNumber: childText(base, "rendelesSzam"),
+		items,
+		payments: findChildren(findChild(receipt, "kifizetesek"), "kifizetes").map(parsePayment),
+		totals: parseTotals(receipt, items),
+		...pdf ? { pdf } : {}
+	};
+}
+function throwIfNotXml(response) {
+	throwIfHeaderError(response);
+	throwIfTextError(response);
+	if (looksLikeXml(response)) return;
+	throwIfHttpError(response);
+	throw unexpectedResponse(response, "XML választ vártunk.");
+}
+function parseReceiptResponse(response) {
+	throwIfNotXml(response);
+	const root = parseResponseXml(response);
+	throwIfXmlFailure(root, response);
+	if (childBoolean(root, "sikeres") !== true) {
+		throwIfHttpError(response);
+		throw unexpectedResponse(response, "A válasz nem jelez sikeres műveletet.");
+	}
+	return parseReceiptXml(root, response);
+}
+//#endregion
+//#region src/receipts/create.ts
+const CREATE_RECEIPT_NAMESPACE = "http://www.szamlazz.hu/xmlnyugtacreate";
+const DEFAULT_CURRENCY = "HUF";
+const DEFAULT_UNIT = "db";
+const PREFIX_PATTERN = /^[A-Z0-9]+$/;
+const AMOUNT_TOLERANCE = 2;
+const MONEY_DECIMALS = 2;
+const receiptOnlyVatCodes = new Set(RECEIPT_ONLY_VAT_CODES);
+function calculateItem(item, currency, index) {
+	const vat = typeof item.vat === "string" && receiptOnlyVatCodes.has(item.vat) ? 0 : item.vat;
+	try {
+		return calculateReceiptItem({
+			...item,
+			vat
+		}, currency);
+	} catch (error) {
+		if (!(error instanceof SzamlazzError)) throw error;
+		throw receiptValidationError(`${index + 1}. tétel (${item.name}): ${error.message}`);
+	}
+}
+function assertHufAmounts(amounts, label, vat) {
+	if (!Number.isInteger(amounts.grossAmount)) throw receiptValidationError(`${label}: forintos nyugtán a bruttó összegnek egész számnak kell lennie (363).`);
+	if (decimalPlaces(amounts.netAmount) > MONEY_DECIMALS) throw receiptValidationError(`${label}: forintos nyugtán a nettó összeg legfeljebb 2 tizedesjegyet tartalmazhat (364).`);
+	if (decimalPlaces(amounts.vatAmount) > MONEY_DECIMALS) throw receiptValidationError(`${label}: forintos nyugtán az áfa összeg legfeljebb 2 tizedesjegyet tartalmazhat (365).`);
+	if (roundMoney(amounts.netAmount + amounts.vatAmount, MONEY_DECIMALS) !== amounts.grossAmount) throw receiptValidationError(`${label}: a nettó és az áfa összegének pontosan ki kell adnia a bruttót (261).`);
+	if (Math.abs(amounts.netUnitPrice * amounts.quantity - amounts.netAmount) > AMOUNT_TOLERANCE) throw receiptValidationError(`${label}: a nettó egységár és a mennyiség szorzata nem egyezik a nettó összeggel (259).`);
+	const expectedVat = amounts.netAmount * vatPercentage(vat) / 100;
+	if (Math.abs(expectedVat - amounts.vatAmount) > AMOUNT_TOLERANCE) throw receiptValidationError(`${label}: az áfa összeg nem egyezik a nettó összeg és az áfakulcs szorzatával (260).`);
+}
+function calculateReceiptItems(items, currency) {
+	if (items.length === 0) throw receiptValidationError("A nyugtán legalább egy tételnek szerepelnie kell.");
+	return items.map((input, index) => {
+		requireText(input.name, `A(z) ${index + 1}. tétel megnevezése (name) kötelező.`);
+		const amounts = calculateItem(input, currency, index);
+		if (isHuf(currency)) assertHufAmounts(amounts, `${index + 1}. tétel (${input.name})`, input.vat);
+		if (input.dataDeletionCode !== void 0) {
+			if (!Number.isInteger(input.dataDeletionCode) || input.dataDeletionCode < 0) throw receiptValidationError(`A(z) ${index + 1}. tétel adattörlő kódja (dataDeletionCode) nemnegatív egész szám legyen.`);
+		}
+		return {
+			input,
+			amounts,
+			vat: input.vat
+		};
+	});
+}
+function formatAmount(value, currency, decimals) {
+	return isHuf(currency) ? value.toFixed(decimals) : value;
+}
+function itemNode(item, currency, unit) {
+	const { input, amounts } = item;
+	const ledger = input.ledger;
+	return el("tetel", [
+		el("megnevezes", input.name.trim()),
+		optionalEl("azonosito", optionalText(input.identifier)),
+		el("mennyiseg", amounts.quantity),
+		el("mennyisegiEgyseg", optionalText(input.unit) ?? unit),
+		el("nettoEgysegar", amounts.netUnitPrice),
+		el("afakulcs", String(item.vat)),
+		el("netto", formatAmount(amounts.netAmount, currency, MONEY_DECIMALS)),
+		el("afa", formatAmount(amounts.vatAmount, currency, MONEY_DECIMALS)),
+		el("brutto", formatAmount(amounts.grossAmount, currency, 0)),
+		ledger && optionalEl("fokonyv", [optionalEl("arbevetel", optionalText(ledger.revenue)), optionalEl("afa", optionalText(ledger.vat))]),
+		optionalEl("megjegyzes", optionalText(input.comment)),
+		optionalEl("torloKod", input.dataDeletionCode)
+	]);
+}
+function paymentNodes(payments, items) {
+	if (payments === void 0 || payments.length === 0) return void 0;
+	const nodes = payments.map((payment, index) => {
+		const method = requireText(payment.method, `A(z) ${index + 1}. kifizetés fizetési eszköze (method) kötelező.`);
+		if (!Number.isFinite(payment.amount)) throw receiptValidationError(`A(z) ${index + 1}. kifizetés összege nem érvényes szám.`);
+		return el("kifizetes", [
+			el("fizetoeszkoz", method),
+			el("osszeg", payment.amount),
+			optionalEl("leiras", optionalText(payment.description))
+		]);
+	});
+	const paid = roundMoney(payments.reduce((sum, payment) => sum + payment.amount, 0), MONEY_DECIMALS);
+	const gross = roundMoney(items.reduce((sum, item) => sum + item.amounts.grossAmount, 0), MONEY_DECIMALS);
+	if (paid !== gross) throw receiptValidationError(`A kifizetések összege (${paid}) eltér a nyugta bruttó végösszegétől (${gross}) (340).`);
+	return el("kifizetesek", nodes);
+}
+function resolvePrefix(value) {
+	const prefix = requireText(value, "Add meg a nyugta előtagját (prefix) a hívásban vagy a receipts alapbeállításaiban.");
+	if (!PREFIX_PATTERN.test(prefix)) throw receiptValidationError(`A nyugta előtag csak nagybetűt és számot tartalmazhat, kapott: ${prefix} (337).`);
+	return prefix;
+}
+function resolveExchange(currency, rate, bank) {
+	if (isHuf(currency)) return {
+		rate: void 0,
+		bank: void 0
+	};
+	if (rate === void 0 || !Number.isFinite(rate) || rate <= 0) throw receiptValidationError(`Devizás nyugtánál (${currency}) add meg az árfolyamot (exchangeRate) pozitív számként.`);
+	return {
+		rate,
+		bank: requireText(bank, `Devizás nyugtánál (${currency}) add meg az árfolyamot jegyző bankot (exchangeBank).`)
+	};
+}
+function buildCreateReceiptXml(credentials, defaults, input) {
+	const prefix = resolvePrefix(input.prefix ?? defaults.prefix);
+	const paymentMethod = requireText(input.paymentMethod ?? defaults.paymentMethod, "Add meg a fizetési módot (paymentMethod) a hívásban vagy a receipts alapbeállításaiban.");
+	const currency = optionalText(input.currency ?? defaults.currency) ?? DEFAULT_CURRENCY;
+	const exchange = resolveExchange(currency, input.exchangeRate ?? defaults.exchangeRate, input.exchangeBank ?? defaults.exchangeBank);
+	const template = validateTemplate(input.template ?? defaults.template);
+	const items = calculateReceiptItems(input.items ?? [], currency);
+	const unit = optionalText(defaults.unit) ?? DEFAULT_UNIT;
+	const payments = paymentNodes(input.payments, items);
+	const downloadPdf = input.downloadPdf ?? defaults.downloadPdf ?? true;
+	return buildXmlDocument({
+		root: "xmlnyugtacreate",
+		namespace: CREATE_RECEIPT_NAMESPACE,
+		schemaLocation: `${RECEIPT_XSD_BASE_URL}nyugtacreate/xmlnyugtacreate.xsd`,
+		children: [
+			el("beallitasok", [...credentials, el("pdfLetoltes", downloadPdf)]),
+			el("fejlec", [
+				optionalEl("hivasAzonosito", optionalText(input.callId)),
+				el("elotag", prefix),
+				el("fizmod", paymentMethod),
+				el("penznem", currency),
+				optionalEl("devizaarf", exchange.rate),
+				optionalEl("devizabank", exchange.bank),
+				optionalEl("megjegyzes", optionalText(input.comment)),
+				optionalEl("pdfSablon", template),
+				optionalEl("fokonyvVevo", optionalText(input.customerLedgerId ?? defaults.customerLedgerId)),
+				optionalEl("rendelesSzam", optionalText(input.orderNumber))
+			]),
+			el("tetelek", items.map((item) => itemNode(item, currency, unit))),
+			payments
+		]
+	});
+}
+const DUPLICATE_CALL_ID_CODE = 338;
+function enrichDuplicateError(error, input) {
+	if (!(error instanceof SzamlazzError) || error.code !== DUPLICATE_CALL_ID_CODE) return error;
+	const lookup = input.orderNumber ? ` A meglévő nyugtát a getReceipt({ orderNumber: '${input.orderNumber}' }) hívással kérdezheted le, ha a fiókban tiltva van a rendelésszám ismétlődése.` : " A Számla Agent hívásazonosító alapján nem ad lekérdezési lehetőséget, ezért a meglévő nyugtát a Számlázz.hu felületén keresd meg, vagy adj meg rendelésszámot (orderNumber) is.";
+	return new SzamlazzError(error.message, {
+		category: "duplicate",
+		code: error.code,
+		hint: `Ezzel a hívásazonosítóval (callId: ${input.callId ?? ""}) már készült nyugta, a nyugta nem jött létre újra.${lookup}`,
+		action: error.action,
+		httpStatus: error.httpStatus,
+		rawResponse: error.rawResponse,
+		cause: error
+	});
+}
+async function createReceipt(ctx, defaults, input, options = {}) {
+	const xml = buildCreateReceiptXml(ctx.credentials, defaults, input);
+	try {
+		return await ctx.execute({
+			action: "createReceipt",
+			xml,
+			signal: options.signal,
+			safeToRetry: optionalText(input.callId) !== void 0
+		}, parseReceiptResponse);
+	} catch (error) {
+		throw enrichDuplicateError(error, input);
+	}
+}
+//#endregion
+export { childBoolean as A, readHeader as C, throwIfTextError as D, throwIfHttpError as E, AGENT_ACTIONS as F, MAX_INVOICE_ATTACHMENTS as I, SZAMLAZZ_AGENT_URL as L, childText as M, findChild as N, throwIfXmlFailure as O, findChildren as P, readDocumentHeaders as S, throwIfHeaderError as T, optionalEl as _, RECEIPT_XSD_BASE_URL as a, parseDoneText as b, requireReceiptNumber as c, presentText as d, resolveInvoice as f, el as g, buildXmlDocument as h, parseReceiptResponse as i, childNumber as j, unexpectedResponse as k, validateTemplate as l, TAXPAYER_TYPE_CODES as m, calculateReceiptItems as n, optionalText as o, INVOICE_TEMPLATES as p, createReceipt as r, receiptValidationError as s, buildCreateReceiptXml as t, optionalAgentDate as u, createAgentResponse as v, throwIfAnyError as w, parseResponseXml as x, looksLikeXml as y };