Sample code for 30+ languages & platforms
Zig Requires Chilkat v11.0.0+

Hungary NAV Query Taxpayer

See more Hungary NAV Invoicing Examples

Demonstrates the queryTaxpayer request for the Hungarian NAV Online Invoicing System REST API v2.0.

Chilkat Zig Downloads

Zig
const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // Build the following XML:

    // <?xml version="1.0" encoding="UTF-8"?>
    // <QueryTaxpayerRequest xmlns="http://schemas.nav.gov.hu/OSA/2.0/api">
    //     <header>
    //         <requestId>RID215118906689</requestId>
    //         <timestamp>2019-09-11T11:11:08.579Z</timestamp>
    //         <requestVersion>2.0</requestVersion>
    //         <headerVersion>1.0</headerVersion>
    //     </header>
    //     <user>
    //         <login>lwilsmn0uqdxe6u</login>
    //         <passwordHash>2F43840A882CFDB7DB0FEC07D419D030D864B47B6B541DC280EF81B937B7A176E33C052B0D26638CC18A7A2C08D8D311733078A774BF43F6CA57FE8CD74DC28E</passwordHash>
    //         <taxNumber>11111111</taxNumber>
    //         <requestSignature>C5ADE8A2231C509D2887E6C2C4406CC5F72CA25B070AD3E94FADFA3F91A8A3667AF882DEDC7D67E9086E3D34A95886E929ACD8C924CD1E8357C89BEF43BA9126</requestSignature>
    //     </user>
    //     <software>
    //         <softwareId>123456789123456789</softwareId>
    //         <softwareName>string</softwareName>
    //         <softwareOperation>LOCAL_SOFTWARE</softwareOperation>
    //         <softwareMainVersion>string</softwareMainVersion>
    //         <softwareDevName>string</softwareDevName>
    //         <softwareDevContact>string</softwareDevContact>
    //         <softwareDevCountryCode>HU</softwareDevCountryCode>
    //         <softwareDevTaxNumber>string</softwareDevTaxNumber>
    //     </software>
    //     <taxNumber>22222222</taxNumber>
    // </QueryTaxpayerRequest>

    const crypt = try chilkat.Crypt2.init();
    defer crypt.deinit();

    const dt_now = try chilkat.DateTime.init();
    defer dt_now.deinit();
    dt_now.setFromCurrentSystemTime() catch {};
    std.debug.print("{s}\n", .{try dt_now.getAsTimestamp(alloc, false)});

    // The hash algorithm for the password is SHA512 (not SHA3-512).
    crypt.setHashAlgorithm("sha512");
    crypt.setEncodingMode("hex");
    const my_password = "my-password";
    const password_hash = try crypt.hashStringENC(alloc, my_password);

    // Generate a random request ID like "RID215118906689"
    const prng = try chilkat.Prng.init();
    defer prng.deinit();
    const sb_request_id = try chilkat.StringBuilder.init();
    defer sb_request_id.deinit();
    sb_request_id.append("RID") catch {};
    sb_request_id.append(try prng.randomString(alloc, 12, true, false, false)) catch {};
    std.debug.print("generated requestId = {s}\n", .{try sb_request_id.getAsString(alloc)});

    // Calculate the requestSignature
    crypt.setHashAlgorithm("sha3-512");
    const signature_key = "ce-8f5e-215119fa7dd621DLMRHRLH2S";

    const sb_final_hash_base = try chilkat.StringBuilder.init();
    defer sb_final_hash_base.deinit();

    // First append the timestamp because we are going to remove certain chars/parts.
    sb_final_hash_base.append(try dt_now.getAsTimestamp(alloc, false)) catch {};
    var num_replaced: i32 = sb_final_hash_base.replace("Z", "");
    num_replaced = sb_final_hash_base.replace("-", "");
    num_replaced = sb_final_hash_base.replace(":", "");
    num_replaced = sb_final_hash_base.replace("T", "");

    // Prepend the requestId and append the signatureKey
    sb_final_hash_base.prepend(try sb_request_id.getAsString(alloc)) catch {};
    sb_final_hash_base.append(signature_key) catch {};

    const request_signature = try crypt.hashStringENC(alloc, try sb_final_hash_base.getAsString(alloc));

    const xml = try chilkat.Xml.init();
    defer xml.deinit();
    xml.setTag("QueryTaxpayerRequest");
    xml.addAttribute("xmlns", "http://schemas.nav.gov.hu/OSA/2.0/api") catch {};
    xml.updateChildContent("header|requestId", try sb_request_id.getAsString(alloc));
    xml.updateChildContent("header|timestamp", try dt_now.getAsTimestamp(alloc, false));
    xml.updateChildContent("header|requestVersion", "2.0");
    xml.updateChildContent("header|headerVersion", "1.0");
    xml.updateChildContent("user|login", "lwilsmn0uqdxe6u");
    xml.updateChildContent("user|passwordHash", password_hash);
    xml.updateChildContent("user|taxNumber", "11111111");
    xml.updateChildContent("user|requestSignature", request_signature);
    xml.updateChildContent("software|softwareId", "123456789123456789");
    xml.updateChildContent("software|softwareName", "string");
    xml.updateChildContent("software|softwareOperation", "LOCAL_SOFTWARE");
    xml.updateChildContent("software|softwareMainVersion", "string");
    xml.updateChildContent("software|softwareDevName", "string");
    xml.updateChildContent("software|softwareDevContact", "string");
    xml.updateChildContent("software|softwareDevCountryCode", "HU");
    xml.updateChildContent("software|softwareDevTaxNumber", "string");
    xml.updateChildContent("taxNumber", "22222222");

    // POST the XML to https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/queryTaxpayer
    const http = try chilkat.Http.init();
    defer http.deinit();
    http.setAccept("application/xml");
    const endpoint = "https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/queryTaxpayer";
    const resp = try chilkat.HttpResponse.init();
    defer resp.deinit();
    http.httpStr("POST", endpoint, try xml.getXml(alloc), "utf-8", "application/xml", resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Response status code = {d}\n", .{resp.getStatusCode()});

    const resp_xml = try chilkat.Xml.init();
    defer resp_xml.deinit();
    resp_xml.loadXml(try resp.getBodyStr(alloc)) catch {};
    std.debug.print("Response body:\n", .{});
    std.debug.print("{s}\n", .{try resp_xml.getXml(alloc)});

    // The result looks like this:

    // <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    // <QueryTaxpayerResponse xmlns="http://schemas.nav.gov.hu/OSA/2.0/api" xmlns:ns2="http://schemas.nav.gov.hu/OSA/2.0/data">
    //     <header>
    //         <requestId>RID847153193061</requestId>
    //         <timestamp>2020-03-24T16:00:34Z</timestamp>
    //         <requestVersion>2.0</requestVersion>
    //         <headerVersion>1.0</headerVersion>
    //     </header>
    //     <result>
    //         <funcCode>OK</funcCode>
    //     </result>
    //     <software>
    //         <softwareId>123456789123456789</softwareId>
    //         <softwareName>string</softwareName>
    //         <softwareOperation>LOCAL_SOFTWARE</softwareOperation>
    //         <softwareMainVersion>string</softwareMainVersion>
    //         <softwareDevName>string</softwareDevName>
    //         <softwareDevContact>string</softwareDevContact>
    //         <softwareDevCountryCode>HU</softwareDevCountryCode>
    //         <softwareDevTaxNumber>string</softwareDevTaxNumber>
    //     </software>
    //     <infoDate>1993-01-01T00:00:00.000+01:00</infoDate>
    //     <taxpayerValidity>true</taxpayerValidity>
    //     <taxpayerData>
    //         <taxpayerName>some taxpayer name</taxpayerName>
    //         <taxNumberDetail>
    //             <ns2:taxpayerId>22222222</ns2:taxpayerId>
    //             <ns2:vatCode>2</ns2:vatCode>
    //         </taxNumberDetail>
    //         <taxpayerAddressList>
    //             <taxpayerAddressItem>
    //                 <taxpayerAddressType>HQ</taxpayerAddressType>
    //                 <taxpayerAddress>
    //                     <ns2:countryCode>HU</ns2:countryCode>
    //                     <ns2:postalCode>1121</ns2:postalCode>
    //                     <ns2:city>BUDAPEST 12</ns2:city>
    //                     <ns2:streetName>ABCD</ns2:streetName>
    //                     <ns2:publicPlaceCategory>UTCA</ns2:publicPlaceCategory>
    //                     <ns2:number>20</ns2:number>
    //                 </taxpayerAddress>
    //             </taxpayerAddressItem>
    //         </taxpayerAddressList>
    //     </taxpayerData>
    // </QueryTaxpayerResponse>

    // Use this online tool to generate parsing code from sample XML:
    // Generate Parsing Code from XML

    _ = try resp_xml.getAttrValue(alloc, "xmlns");
    _ = try resp_xml.getAttrValue(alloc, "xmlns:ns2");
    _ = try resp_xml.getChildContent(alloc, "header|requestId");
    _ = try resp_xml.getChildContent(alloc, "header|timestamp");
    _ = try resp_xml.getChildContent(alloc, "header|requestVersion");
    _ = try resp_xml.getChildContent(alloc, "header|headerVersion");
    _ = try resp_xml.getChildContent(alloc, "result|funcCode");
    _ = try resp_xml.getChildContent(alloc, "software|softwareId");
    _ = try resp_xml.getChildContent(alloc, "software|softwareName");
    _ = try resp_xml.getChildContent(alloc, "software|softwareOperation");
    _ = try resp_xml.getChildContent(alloc, "software|softwareMainVersion");
    _ = try resp_xml.getChildContent(alloc, "software|softwareDevName");
    _ = try resp_xml.getChildContent(alloc, "software|softwareDevContact");
    _ = try resp_xml.getChildContent(alloc, "software|softwareDevCountryCode");
    _ = try resp_xml.getChildContent(alloc, "software|softwareDevTaxNumber");
    _ = try resp_xml.getChildContent(alloc, "infoDate");
    _ = try resp_xml.getChildContent(alloc, "taxpayerValidity");
    _ = try resp_xml.getChildContent(alloc, "taxpayerData|taxpayerName");
    _ = resp_xml.getChildIntValue("taxpayerData|taxNumberDetail|ns2:taxpayerId");
    _ = resp_xml.getChildIntValue("taxpayerData|taxNumberDetail|ns2:vatCode");
    _ = try resp_xml.getChildContent(alloc, "taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddressType");
    _ = try resp_xml.getChildContent(alloc, "taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:countryCode");
    _ = resp_xml.getChildIntValue("taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:postalCode");
    _ = try resp_xml.getChildContent(alloc, "taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:city");
    _ = try resp_xml.getChildContent(alloc, "taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:streetName");
    _ = try resp_xml.getChildContent(alloc, "taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:publicPlaceCategory");
    _ = resp_xml.getChildIntValue("taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:number");
}