@halftome/szamlazz-client 1.0.8 → 2.0.2

package/dist/index.d.ts

@@ -1,14 +1,16 @@
-import type { InvoiceOptions, LineItem, ReverseInvoiceOptions, KeyAuth, CredentialAuth, InvoiceCreationResponse } from './types';
+import type { InvoiceOptions, LineItem, ReverseInvoiceOptions, KeyAuth, CredentialAuth, InvoiceItemResponse } from './types.js';
 export declare class Client {
     readonly key?: string;
     readonly username?: string;
     readonly password?: string;
     readonly apiUrl = "https://www.szamlazz.hu/szamla/";
     constructor(auth: KeyAuth | CredentialAuth);
+    private decodeResponse;
     private sendRequest;
     private authAttributes;
-    generateInvoice(options: InvoiceOptions, items?: Array<LineItem>): Promise<InvoiceCreationResponse>;
-    reverseInvoice(invoice: string, options: ReverseInvoiceOptions): Promise<InvoiceCreationResponse>;
+    generateInvoice(options: InvoiceOptions, items?: Array<LineItem>): Promise<InvoiceItemResponse>;
+    reverseInvoice(invoice: string, options: ReverseInvoiceOptions): Promise<InvoiceItemResponse>;
+    testConnection(): Promise<boolean>;
 }
 export default Client;
-export * from './types';
+export * from './types.js';

package/dist/index.js

@@ -1,46 +1,23 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = void 0;
-const xmlbuilder2_1 = require("xmlbuilder2");
-const node_fetch_1 = __importDefault(require("node-fetch"));
-const form_data_1 = __importDefault(require("form-data"));
-const url_1 = require("url");
-class Client {
+import { create, convert } from 'xmlbuilder2';
+import { URL } from 'url';
+const toDateStr = (date) => date.toLocaleDateString('sv-SE', { timeZone: 'Europe/Budapest' });
+export class Client {
+    key;
+    username;
+    password;
+    apiUrl = 'https://www.szamlazz.hu/szamla/';
     constructor(auth) {
-        this.apiUrl = 'https://www.szamlazz.hu/szamla/';
         this.key = auth.key;
         this.username = auth.username;
         this.password = auth.password;
     }
-    async sendRequest(type, content) {
-        // Build XML
-        const doc = (0, xmlbuilder2_1.create)({ encoding: 'UTF-8' }, content);
-        const xml = doc.end({ prettyPrint: false });
-        // Build Request
-        const form = new form_data_1.default();
-        form.append(type, xml, type);
-        // Send Request
-        const response = await (0, node_fetch_1.default)(this.apiUrl, { method: 'POST', body: form });
-        const result = await response.text();
+    decodeResponse(response) {
         // Decode Response
         try {
-            const obj = (0, xmlbuilder2_1.convert)(result, { format: 'object' });
+            const obj = convert(response, { format: 'object' });
             // Decode hosted url params:
-            const url = new url_1.URL(obj.xmlszamlavalasz?.vevoifiokurl?.$);
-            const pdfUrl = new url_1.URL(obj.xmlszamlavalasz?.vevoifiokurl?.$);
+            const url = new URL(obj.xmlszamlavalasz?.vevoifiokurl?.$);
+            const pdfUrl = new URL(obj.xmlszamlavalasz?.vevoifiokurl?.$);
             pdfUrl.searchParams.append('action', 'szamlapdf');
             pdfUrl.searchParams.delete('page');
             const decoded = {
@@ -61,9 +38,20 @@ class Client {
             return decoded;
         }
         catch (e) {
-            throw new Error(result);
+            throw new Error(response);
         }
     }
+    async sendRequest(type, content) {
+        // Build XML
+        const doc = create({ encoding: 'UTF-8' }, content);
+        const xml = doc.end({ prettyPrint: false });
+        // Build Request
+        const form = new FormData();
+        form.append(type, new Blob([xml], { type: 'application/xml' }), type);
+        // Send Request
+        const response = await fetch(this.apiUrl, { method: 'POST', body: form });
+        return await response.text();
+    }
     authAttributes() {
         return {
             szamlaagentkulcs: this.key,
@@ -82,11 +70,12 @@ class Client {
                     eszamla: options.eInvoice,
                     szamlaLetoltes: options.downloadPDF ?? false,
                     valaszVerzio: 2,
+                    szamlaKulsoAzon: options.externalId,
                 },
                 fejlec: {
-                    keltDatum: options.issueDate,
-                    teljesitesDatum: options.completionDate,
-                    fizetesiHataridoDatum: options.dueDate,
+                    keltDatum: toDateStr(options.issueDate),
+                    teljesitesDatum: toDateStr(options.completionDate),
+                    fizetesiHataridoDatum: toDateStr(options.dueDate),
                     fizmod: options.paymentMethod,
                     penznem: options.currency,
                     szamlaNyelve: options.language,
@@ -100,7 +89,7 @@ class Client {
                 elado: {
                     bank: options.payee?.bankName,
                     bankszamlaszam: options.payee?.bankAccountNumber,
-                    emailReplyTo: options.email?.replyTo,
+                    emailReplyto: options.email?.replyTo,
                     emailTargy: options.email?.subject,
                     emailSzoveg: options.email?.content,
                 },
@@ -133,7 +122,7 @@ class Client {
                 },
             },
         };
-        return await this.sendRequest('action-xmlagentxmlfile', doc);
+        return this.decodeResponse(await this.sendRequest('action-xmlagentxmlfile', doc));
     }
     async reverseInvoice(invoice, options) {
         const doc = {
@@ -149,51 +138,27 @@ class Client {
                 },
                 fejlec: {
                     szamlaszam: invoice,
-                    keltDatum: options.issueDate,
-                    teljesitesDatum: options.completionDate,
+                    keltDatum: toDateStr(options.issueDate),
+                    teljesitesDatum: toDateStr(options.completionDate),
                 },
             },
         };
-        return await this.sendRequest('action-szamla_agent_st', doc);
+        return this.decodeResponse(await this.sendRequest('action-szamla_agent_st', doc));
+    }
+    async testConnection() {
+        const doc = {
+            xmlszamlaxml: {
+                '@xmlns': 'http://www.szamlazz.hu/xmlszamlaxml',
+                '@xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',
+                '@xsi:schemaLocation': 'http://www.szamlazz.hu/xmlszamlaxml https://www.szamlazz.hu/szamla/docs/xsds/agentxml/xmlszamlaxml.xsd',
+                ...this.authAttributes(),
+                szamlaszam: 'NEMLETEZIKSOHANEMISFOG',
+            },
+        };
+        const r = await this.sendRequest('action-szamla_agent_xml', doc);
+        const obj = convert(r, { format: 'object' });
+        return obj.xmlszamlavalasz?.hibakod.$ == 7;
     }
 }
-exports.Client = Client;
-exports.default = Client;
-__exportStar(require("./types"), exports);
-/*
-const c = new Client({ username: 'demo', password: 'demo' })
-const now = new Date().toISOString().split('T')[0]
-
-c.generateInvoice(
-  {
-    eInvoice: true,
-    completionDate: now,
-    dueDate: now,
-    issueDate: now,
-    currency: Currency.HUF,
-    sendEmail: false,
-    language: Language.HU,
-    paymentMethod: PaymentMethod.Card,
-    settled: true,
-    comment: 'some random comment',
-    customer: {
-      name: 'Test',
-      address: 'Test',
-      city: 'Test',
-      zip: 'TST111',
-    },
-  },
-  [
-    {
-      amount: 1,
-      amountName: 'db',
-      grossAmount: 1000,
-      netAmount: 1000,
-      name: 'Test',
-      netUnitPrice: 1000,
-      taxAmount: 0,
-      vatRate: NamedVATRate.AAM,
-    },
-  ],
-).then(console.log)
-*/
+export default Client;
+export * from './types.js';

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect } from 'vitest';
+import { Client, NamedVATRate, PaymentMethod } from './index.js';
+describe('Client', () => {
+    const client = new Client({ username: 'demo', password: 'demo' });
+    it('should generate and reverse an invoice', { timeout: 30000 }, async () => {
+        const result = await client.generateInvoice({
+            eInvoice: true,
+            currency: 'HUF',
+            sendEmail: false,
+            language: 'hu',
+            paymentMethod: PaymentMethod.Card,
+            settled: true,
+            comment: 'some random comment',
+            issueDate: new Date(),
+            completionDate: new Date(),
+            dueDate: new Date(),
+            customer: {
+                name: 'Test',
+                address: 'Test',
+                city: 'Test',
+                zip: 'TST111',
+            },
+        }, [
+            {
+                amount: 1,
+                amountName: 'db',
+                grossAmount: 1000,
+                netAmount: 1000,
+                name: 'Test',
+                netUnitPrice: 1000,
+                taxAmount: 0,
+                vatRate: NamedVATRate.AAM,
+            },
+        ]);
+        expect(result.invoice.number).toBeDefined();
+        expect(result.net).toBe(1000);
+        expect(result.gross).toBe(1000);
+        const reverseResult = await client.reverseInvoice(result.invoice.number, {
+            eInvoice: true,
+            issueDate: new Date(),
+            completionDate: new Date(),
+        });
+        expect(reverseResult.invoice.number).toBeDefined();
+    });
+    it('should validate credentials with testConnection', async () => {
+        const isValid = await client.testConnection();
+        expect(isValid).toBe(true);
+    });
+    it('should reject invalid credentials', async () => {
+        const badClient = new Client({ username: 'invalid', password: 'invalid' });
+        const isValid = await badClient.testConnection();
+        expect(isValid).toBe(false);
+    });
+});

package/dist/types.d.ts

@@ -1,46 +1,31 @@
-/// <reference types="node" />
 export declare enum NamedVATRate {
-    TEHK = "TEHK",
-    TAHK = "TAHK",
-    TAM = "TAM",
-    AAM = "AAM",
-    EUT = "EUT",
-    EUKT = "EUKT",
-    MAA = "MAA",
-    F_AFA = "F.AFA",
-    K_AFA = "K.AFA",
-    HO = "HO",
-    EUE = "EUE",
-    EUFADE = "EUFADE",
-    EUFAD37 = "EUFAD37",
-    ATK = "ATK",
-    NAM = "NAM",
-    EAM = "EAM",
-    KBAUK = "KBAUK",
+    TEHK = "TEHK",// Outside the scope of Hungarian VAT
+    TAHK = "TAHK",// Not subject to VAT
+    TAM = "TAM",// supply exempt from VAT / exempt supply
+    AAM = "AAM",// person exempt from VAT / exempt person
+    EUT = "EUT",// Within EU (former 'EU')
+    EUKT = "EUKT",// Outside EU (former 'EUK')
+    MAA = "MAA",// exempt from tax
+    F_AFA = "F.AFA",// reverse VAT
+    K_AFA = "K.AFA",// differential VAT
+    HO = "HO",// Harmadik országban teljesített ügylet (TEHK)
+    EUE = "EUE",// Másik tagállamban teljesített, nem fordítottan adózó ügylet
+    EUFADE = "EUFADE",// Másik tagállamban teljesített, nem az Áfa tv. 37. §-a alá tartozó, fordítottan adózó ügylet
+    EUFAD37 = "EUFAD37",// -Áfa tv. 37. §-a alapján másik tagállamban teljesített, fordítottan adózó ügylet
+    ATK = "ATK",// ÁFA tárgyi hatályán kívüli
+    NAM = "NAM",// adómentesség egyéb nemzetközi ügyletekhez
+    EAM = "EAM",// adómentes termékexport harmadik országba
+    KBAUK = "KBAUK",// Közösségen belüli termékértékesítés UK
     KBAET = "KBAET"
 }
-export declare type VATRate = 0 | 5 | 7 | 18 | 19 | 20 | 25 | 27 | NamedVATRate;
+export type VATRate = 0 | 5 | 7 | 18 | 19 | 20 | 25 | 27 | NamedVATRate;
 export declare enum PaymentMethod {
     Transfer = "\u00E1tutal\u00E1s",
     Cash = "k\u00E9szp\u00E9nz",
     Card = "bankk\u00E1rtya"
 }
-export declare enum Currency {
-    HUF = "HUF"
-}
-export declare enum Language {
-    HU = "hu",
-    EN = "en",
-    DE = "de",
-    IT = "it",
-    RO = "ro",
-    SK = "sk",
-    HR = "hr",
-    FR = "fr",
-    ES = "es",
-    CZ = "cz",
-    PL = "pl"
-}
+export type Currency = 'HUF' | 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'CNY' | 'CZK' | 'PLN' | 'RON';
+export type LanguageCode = 'hu' | 'en' | 'de' | 'it' | 'ro' | 'sk' | 'hr' | 'fr' | 'es' | 'cz' | 'pl' | 'bg' | 'nl' | 'ru' | 'si';
 export declare enum InvoiceTemplate {
     SzlaMost = "SzlaMost",
     SzlaAlap = "SzlaAlap",
@@ -52,12 +37,12 @@ export interface InvoiceOptions {
     payee?: PayeeDetails;
     customer: CustomerDetails;
     eInvoice: boolean;
-    issueDate: string;
-    completionDate: string;
-    dueDate: string;
+    issueDate: Date;
+    completionDate: Date;
+    dueDate: Date;
     paymentMethod: PaymentMethod | string;
     currency: Currency;
-    language: Language;
+    language: LanguageCode;
     sendEmail: boolean;
     comment?: string;
     orderNumber?: string;
@@ -67,8 +52,9 @@ export interface InvoiceOptions {
     template?: InvoiceTemplate;
     settled?: boolean;
     downloadPDF?: boolean;
+    externalId?: string;
 }
-export declare type ReverseInvoiceOptions = Pick<InvoiceOptions, 'eInvoice' | 'issueDate' | 'completionDate' | 'downloadPDF'>;
+export type ReverseInvoiceOptions = Pick<InvoiceOptions, 'eInvoice' | 'issueDate' | 'completionDate' | 'downloadPDF'>;
 export interface EmailDetails {
     replyTo?: string;
     subject: string;
@@ -93,12 +79,12 @@ export interface CustomerDetails {
 export interface LineItem {
     id?: string;
     name: string;
-    amount: Number;
+    amount: number;
     amountName: string;
-    netAmount: Number;
-    taxAmount: Number;
-    grossAmount: Number;
-    netUnitPrice: Number;
+    netAmount: number;
+    taxAmount: number;
+    grossAmount: number;
+    netUnitPrice: number;
     vatRate: VATRate;
     comment?: string;
 }
@@ -109,7 +95,7 @@ export interface CredentialAuth {
     username: string;
     password: string;
 }
-export interface InvoiceCreationResponse {
+export interface InvoiceItemResponse {
     invoice: HostedInvoice;
     net: number;
     gross: number;

package/dist/types.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvoiceTemplate = exports.Language = exports.Currency = exports.PaymentMethod = exports.NamedVATRate = void 0;
-var NamedVATRate;
+export var NamedVATRate;
 (function (NamedVATRate) {
     NamedVATRate["TEHK"] = "TEHK";
     NamedVATRate["TAHK"] = "TAHK";
@@ -21,36 +18,18 @@ var NamedVATRate;
     NamedVATRate["EAM"] = "EAM";
     NamedVATRate["KBAUK"] = "KBAUK";
     NamedVATRate["KBAET"] = "KBAET";
-})(NamedVATRate = exports.NamedVATRate || (exports.NamedVATRate = {}));
-var PaymentMethod;
+})(NamedVATRate || (NamedVATRate = {}));
+export var PaymentMethod;
 (function (PaymentMethod) {
     PaymentMethod["Transfer"] = "\u00E1tutal\u00E1s";
     PaymentMethod["Cash"] = "k\u00E9szp\u00E9nz";
     PaymentMethod["Card"] = "bankk\u00E1rtya";
-})(PaymentMethod = exports.PaymentMethod || (exports.PaymentMethod = {}));
-var Currency;
-(function (Currency) {
-    Currency["HUF"] = "HUF";
-})(Currency = exports.Currency || (exports.Currency = {}));
-var Language;
-(function (Language) {
-    Language["HU"] = "hu";
-    Language["EN"] = "en";
-    Language["DE"] = "de";
-    Language["IT"] = "it";
-    Language["RO"] = "ro";
-    Language["SK"] = "sk";
-    Language["HR"] = "hr";
-    Language["FR"] = "fr";
-    Language["ES"] = "es";
-    Language["CZ"] = "cz";
-    Language["PL"] = "pl";
-})(Language = exports.Language || (exports.Language = {}));
-var InvoiceTemplate;
+})(PaymentMethod || (PaymentMethod = {}));
+export var InvoiceTemplate;
 (function (InvoiceTemplate) {
     InvoiceTemplate["SzlaMost"] = "SzlaMost";
     InvoiceTemplate["SzlaAlap"] = "SzlaAlap";
     InvoiceTemplate["SzlaNoEnv"] = "SzlaNoEnv";
     InvoiceTemplate["Szla8cm"] = "Szla8cm";
     InvoiceTemplate["SzlaTomb"] = "SzlaTomb";
-})(InvoiceTemplate = exports.InvoiceTemplate || (exports.InvoiceTemplate = {}));
+})(InvoiceTemplate || (InvoiceTemplate = {}));

package/package.json

@@ -1,41 +1,47 @@
 {
   "name": "@halftome/szamlazz-client",
-  "version": "1.0.8",
-  "description": "Node.js client for using szamlazz.hu API",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc -w",
-    "test": "echo \"No test yet\" && exit 0"
-  },
+  "version": "2.0.2",
+  "type": "module",
+  "description": "Javascript client for using szamlazz.hu API",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/half2me/szamlazz-client.git"
   },
   "author": "halftome@gmail.com",
   "types": "./dist/index.d.ts",
-  "license": "SEE LICENSE IN LICENCE",
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
   "files": [
     "dist/**"
   ],
   "main": "./dist/index.js",
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
   "bugs": {
     "url": "https://github.com/half2me/szamlazz-client/issues"
   },
   "homepage": "https://github.com/half2me/szamlazz-client#readme",
   "devDependencies": {
-    "@tsconfig/node14": "^1.0.1",
-    "@types/node": "^16.3.3",
-    "@types/node-fetch": "^2.5.11",
-    "prettier": "^2.3.2",
-    "tslib": "^2.3.0",
-    "typescript": "^4.3.5"
+    "@tsconfig/node24": "^24.0.4",
+    "@types/node": "^25.0.10",
+    "prettier": "^3.8.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "dependencies": {
-    "form-data": "^4.0.0",
-    "node-fetch": "^2.6.1",
-    "xmlbuilder2": "^3.0.2"
+    "xmlbuilder2": "^4.0.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "test": "vitest run"
   }
-}
+}

package/LICENCE

@@ -1 +0,0 @@
-(c) Copyright 2021 Benjamin Tamasi, all rights reserved.