Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(Unicode C++) Hungary NAV Manage Invoice RequestDemonstrates the manageInvoice request for the Hungarian NAV Online Invoicing System REST API v2.0. Note: This example requires Chilkat v9.5.0.83 or greater. For more information, see https://onlineszamla.nav.gov.hu/api/files/container/download/Online%20Szamla_Interfesz%20specifik%C3%A1ci%C3%B3_EN_v2.0.pdf
#include <CkBinDataW.h> #include <CkCrypt2W.h> #include <CkDateTimeW.h> #include <CkPrngW.h> #include <CkStringBuilderW.h> #include <CkXmlW.h> #include <CkHttpW.h> #include <CkHttpResponseW.h> void ChilkatSample(void) { // 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"?> // <ManageInvoiceRequest xmlns="http://schemas.nav.gov.hu/OSA/2.0/api"> // <header> // <requestId>RID181837288942</requestId> // <timestamp>2019-09-11T12:44:55.442Z</timestamp> // <requestVersion>2.0</requestVersion> // <headerVersion>1.0</headerVersion> // </header> // <user> // <login>lwilsmn0uqdxe6u</login> // <passwordHash>2F43840A882CFDB7DB0FEC07D419D030D864B47B6B541DC280EF81B937B7A176E33C052B0D26638CC18A7A2C08D8D311733078A774BF43F6CA57FE8CD74DC28E</passwordHash> // <taxNumber>11111111</taxNumber> // <requestSignature>E4D191A48EE8828A1E84C1F841A2B4E1699ECB49C4CDA1DC7A057765FD935872219644CC2B5A93B8A344404E4FD8ECA4902B5DBCF993E768DC558B0F0281E775</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> // <exchangeToken>b1aca173-d9e8-4561-9237-0511eed99eaa2P0ZHLXBRI2U</exchangeToken> // <invoiceOperations> // <compressedContent>false</compressedContent> // <invoiceOperation> // <index>1</index> // <invoiceOperation>CREATE</invoiceOperation> // <invoiceData>base64 contents of invoiceData1 XML file</invoiceData> // </invoiceOperation> // <invoiceOperation> // <index>2</index> // <invoiceOperation>CREATE</invoiceOperation> // <invoiceData>base64 contents of invoiceData2 XML file</invoiceData> // </invoiceOperation> // <invoiceOperation> // <index>3</index> // <invoiceOperation>CREATE</invoiceOperation> // <invoiceData>base64 contents of invoiceData3 XML file</invoiceData> // </invoiceOperation> // </invoiceOperations> // </ManageInvoiceRequest> // bool success; // First load the invoiceData for the 3 XML invoice files we'll be sending. CkBinDataW bdInvoiceData1; CkBinDataW bdInvoiceData2; CkBinDataW bdInvoiceData3; success = bdInvoiceData1.LoadFile(L"qa_data/nav_invoicing/invoiceData1.xml"); success = bdInvoiceData2.LoadFile(L"qa_data/nav_invoicing/invoiceData2.xml"); success = bdInvoiceData3.LoadFile(L"qa_data/nav_invoicing/invoiceData3.xml"); if (success == false) { wprintf(L"Failed to load invoice data.\n"); return; } CkCrypt2W crypt; CkDateTimeW dtNow; dtNow.SetFromCurrentSystemTime(); wprintf(L"%s\n",dtNow.getAsTimestamp(false)); // The hash algorithm for the password is SHA512 (not SHA3-512). crypt.put_HashAlgorithm(L"sha512"); crypt.put_EncodingMode(L"hex"); const wchar_t *myPassword = L"my-password"; const wchar_t *passwordHash = crypt.hashStringENC(myPassword); // Generate a random request ID like "RID215118906689" CkPrngW prng; CkStringBuilderW sbRequestId; sbRequestId.Append(L"RID"); sbRequestId.Append(prng.randomString(12,true,false,false)); wprintf(L"generated requestId = %s\n",sbRequestId.getAsString()); // Calculate the requestSignature crypt.put_HashAlgorithm(L"sha3-512"); const wchar_t *signatureKey = L"ce-8f5e-215119fa7dd621DLMRHRLH2S"; CkStringBuilderW sbFinalHashBase; // First append the timestamp because we are going to remove certain chars/parts. sbFinalHashBase.Append(dtNow.getAsTimestamp(false)); int numReplaced = sbFinalHashBase.Replace(L"Z",L""); numReplaced = sbFinalHashBase.Replace(L"-",L""); numReplaced = sbFinalHashBase.Replace(L":",L""); numReplaced = sbFinalHashBase.Replace(L"T",L""); // Prepend the requestId and append the signatureKey sbFinalHashBase.Prepend(sbRequestId.getAsString()); sbFinalHashBase.Append(signatureKey); // Calculate each index hash and add it to the sbFinalHashBase CkStringBuilderW sbHashBase; sbHashBase.Append(L"CREATE"); sbHashBase.Append(bdInvoiceData1.getEncoded(L"base64")); const wchar_t *indexHash = crypt.hashStringENC(sbHashBase.getAsString()); sbFinalHashBase.Append(indexHash); sbHashBase.Clear(); sbHashBase.Append(L"CREATE"); sbHashBase.Append(bdInvoiceData2.getEncoded(L"base64")); indexHash = crypt.hashStringENC(sbHashBase.getAsString()); sbFinalHashBase.Append(indexHash); sbHashBase.Clear(); sbHashBase.Append(L"CREATE"); sbHashBase.Append(bdInvoiceData3.getEncoded(L"base64")); indexHash = crypt.hashStringENC(sbHashBase.getAsString()); sbFinalHashBase.Append(indexHash); // Get our request signature (using sha3-512 because our HashAlgorithm was set to "sha3-512" up above...) const wchar_t *requestSignature = crypt.hashStringENC(sbFinalHashBase.getAsString()); // Load our recently obtained exchange token. // See Hungary NAV Invoicing Token Exchange Sample Code CkXmlW xmlExchangeToken; success = xmlExchangeToken.LoadXmlFile(L"qa_data/tokens/nav_exchange_token.xml"); if (success == false) { wprintf(L"%s\n",xmlExchangeToken.lastErrorText()); return; } // Get the base64 encoded/encrypted exchange token. // IMPORTANT: Make sure to use the exchange token before it expires. // If it expired, then get a new one.. const wchar_t *encodedEncryptedExchangeToken = xmlExchangeToken.getChildContent(L"encodedExchangeToken"); // Decode to binary. CkBinDataW bdExchangeToken; bdExchangeToken.AppendEncoded(encodedEncryptedExchangeToken,L"base64"); // Decrypt using your 16-digit replacement key: crypt.put_CryptAlgorithm(L"aes"); crypt.put_CipherMode(L"ecb"); crypt.put_KeyLength(128); crypt.put_EncodingMode(L"base64"); // Pass your 16-digit replacement key here: crypt.SetEncodedKey(L"99952BBAAAAA8XYZ",L"ascii"); crypt.DecryptBd(bdExchangeToken); const wchar_t *exchangeToken = bdExchangeToken.getString(L"utf-8"); wprintf(L"exchange token = %s\n",exchangeToken); // Now build the XML.. CkXmlW xml; xml.put_Tag(L"ManageInvoiceRequest"); xml.AddAttribute(L"xmlns",L"http://schemas.nav.gov.hu/OSA/2.0/api"); xml.UpdateChildContent(L"header|requestId",sbRequestId.getAsString()); xml.UpdateChildContent(L"header|timestamp",dtNow.getAsTimestamp(false)); xml.UpdateChildContent(L"header|requestVersion",L"2.0"); xml.UpdateChildContent(L"header|headerVersion",L"1.0"); xml.UpdateChildContent(L"user|login",L"lwilsmn0uqdxe6u"); xml.UpdateChildContent(L"user|passwordHash",passwordHash); xml.UpdateChildContent(L"user|taxNumber",L"11111111"); xml.UpdateChildContent(L"user|requestSignature",requestSignature); xml.UpdateChildContent(L"software|softwareId",L"123456789123456789"); xml.UpdateChildContent(L"software|softwareName",L"string"); xml.UpdateChildContent(L"software|softwareOperation",L"LOCAL_SOFTWARE"); xml.UpdateChildContent(L"software|softwareMainVersion",L"string"); xml.UpdateChildContent(L"software|softwareDevName",L"string"); xml.UpdateChildContent(L"software|softwareDevContact",L"string"); xml.UpdateChildContent(L"software|softwareDevCountryCode",L"HU"); xml.UpdateChildContent(L"software|softwareDevTaxNumber",L"string"); xml.UpdateChildContent(L"exchangeToken",exchangeToken); xml.UpdateChildContent(L"invoiceOperations|compressedContent",L"false"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation|index",L"1"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation|invoiceOperation",L"CREATE"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation|invoiceData",bdInvoiceData1.getEncoded(L"base64")); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation[1]|index",L"2"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation[1]|invoiceOperation",L"CREATE"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation[1]|invoiceData",bdInvoiceData2.getEncoded(L"base64")); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation[2]|index",L"3"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation[2]|invoiceOperation",L"CREATE"); xml.UpdateChildContent(L"invoiceOperations|invoiceOperation[2]|invoiceData",bdInvoiceData3.getEncoded(L"base64")); // POST the XML to https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/manageInvoice CkHttpW http; http.put_Accept(L"application/xml"); http.SetRequestHeader(L"Content-Type",L"application/xml"); const wchar_t *endpoint = L"https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/manageInvoice"; CkHttpResponseW *resp = http.PostXml(endpoint,xml.getXml(),L"utf-8"); if (http.get_LastMethodSuccess() == false) { wprintf(L"%s\n",http.lastErrorText()); return; } wprintf(L"Response status code = %d\n",resp->get_StatusCode()); CkXmlW respXml; respXml.LoadXml(resp->bodyStr()); wprintf(L"Response body:\n"); wprintf(L"%s\n",respXml.getXml()); delete resp; // The result looks like this: // <?xml version="1.0" encoding="UTF-8" standalone="yes"?> // <ManageInvoiceResponse xmlns="http://schemas.nav.gov.hu/OSA/2.0/api" xmlns:ns2="http://schemas.nav.gov.hu/OSA/2.0/data"> // <header> // <requestId>RID871830318143</requestId> // <timestamp>2020-03-25T15:51:25Z</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> // <transactionId>2WT9GFSKFUU1V4XP</transactionId> // </ManageInvoiceResponse> // Use this online tool to generate parsing code from sample XML: // Generate Parsing Code from XML // Chilkat functions returning "const char *" return a pointer to temporary internal memory owned and managed by Chilkat. // See this example explaining how this memory should be used: const char * functions. const wchar_t *ManageInvoiceResponse_xmlns = respXml.getAttrValue(L"xmlns"); const wchar_t *ManageInvoiceResponse_xmlns_ns2 = respXml.getAttrValue(L"xmlns:ns2"); const wchar_t *requestId = respXml.getChildContent(L"header|requestId"); const wchar_t *timestamp = respXml.getChildContent(L"header|timestamp"); const wchar_t *requestVersion = respXml.getChildContent(L"header|requestVersion"); const wchar_t *headerVersion = respXml.getChildContent(L"header|headerVersion"); const wchar_t *funcCode = respXml.getChildContent(L"result|funcCode"); const wchar_t *softwareId = respXml.getChildContent(L"software|softwareId"); const wchar_t *softwareName = respXml.getChildContent(L"software|softwareName"); const wchar_t *softwareOperation = respXml.getChildContent(L"software|softwareOperation"); const wchar_t *softwareMainVersion = respXml.getChildContent(L"software|softwareMainVersion"); const wchar_t *softwareDevName = respXml.getChildContent(L"software|softwareDevName"); const wchar_t *softwareDevContact = respXml.getChildContent(L"software|softwareDevContact"); const wchar_t *softwareDevCountryCode = respXml.getChildContent(L"software|softwareDevCountryCode"); const wchar_t *softwareDevTaxNumber = respXml.getChildContent(L"software|softwareDevTaxNumber"); const wchar_t *transactionId = respXml.getChildContent(L"transactionId"); } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.