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

Hungary NAV Token Exchange

See more Hungary NAV Invoicing Examples

Demonstrates the tokenExchange 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:

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

    // <?xml version="1.0" encoding="UTF-8"?>
    // <TokenExchangeRequest xmlns="http://schemas.nav.gov.hu/OSA/2.0/api">
    //     <header>
    //         <requestId>RID896801578348</requestId>
    //         <timestamp>2019-09-11T10:55:31.440Z</timestamp>
    //         <requestVersion>2.0</requestVersion>
    //         <headerVersion>1.0</headerVersion>
    //     </header>
    //     <user>
    //         <login>lwilsmn0uqdxe6u</login>
    //         <passwordHash>2F43840A882CFDB7DB0FEC07D419D030D864B47B6B541DC280EF81B937B7A176E33C052B0D26638CC18A7A2C08D8D311733078A774BF43F6CA57FE8CD74DC28E</passwordHash>
    //         <taxNumber>11111111</taxNumber>
    //         <requestSignature>B4B5E0F197BFFD3DF69BCC98D3BE775F65FD5445EEF95C9D6B6C59425F2B81C4F6DA1FD563B0C7E7D98AF1E1725E5C63C2803B5D3A93D1C02ED354AC92F2CC94</requestSignature>
    //         <!--<signKey>ac-ac3a-7f661bff7d342N43CYX4U9FG</signKey>-->
    //     </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>
    // </TokenExchangeRequest>

    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("TokenExchangeRequest");
    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");

    // POST the XML to https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/tokenExchange
    const http = try chilkat.Http.init();
    defer http.deinit();
    http.setAccept("application/xml");
    const endpoint = "https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/tokenExchange";
    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)});

    // Save our exchange token to a file to be used for subsequent requests.
    resp_xml.saveXml("qa_data/tokens/nav_exchange_token.xml") catch {};

    // The result looks like this:

    // <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    // <TokenExchangeResponse xmlns="http://schemas.nav.gov.hu/OSA/2.0/api" xmlns:ns2="http://schemas.nav.gov.hu/OSA/2.0/data">
    //     <header>
    //         <requestId>RID789246611489</requestId>
    //         <timestamp>2020-03-25T14:14:36Z</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>
    //     <encodedExchangeToken>2lR5v57Tl ... 9n4tIWCYgjKQ==</encodedExchangeToken>
    //     <tokenValidityFrom>2020-03-25T15:14:36.987+01:00</tokenValidityFrom>
    //     <tokenValidityTo>2020-03-25T15:19:36.987+01:00</tokenValidityTo>
    // </TokenExchangeResponse>

    // 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, "encodedExchangeToken");
    _ = try resp_xml.getChildContent(alloc, "tokenValidityFrom");
    _ = try resp_xml.getChildContent(alloc, "tokenValidityTo");
}