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
(Swift 2) 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
func chilkatTest() { // 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> // var success: Bool // First load the invoiceData for the 3 XML invoice files we'll be sending. let bdInvoiceData1 = CkoBinData() let bdInvoiceData2 = CkoBinData() let bdInvoiceData3 = CkoBinData() success = bdInvoiceData1.LoadFile("qa_data/nav_invoicing/invoiceData1.xml") success = bdInvoiceData2.LoadFile("qa_data/nav_invoicing/invoiceData2.xml") success = bdInvoiceData3.LoadFile("qa_data/nav_invoicing/invoiceData3.xml") if success == false { print("Failed to load invoice data.") return } let crypt = CkoCrypt2() let dtNow = CkoDateTime() dtNow.SetFromCurrentSystemTime() print("\(dtNow.GetAsTimestamp(false))") // The hash algorithm for the password is SHA512 (not SHA3-512). crypt.HashAlgorithm = "sha512" crypt.EncodingMode = "hex" var myPassword: String? = "my-password" var passwordHash: String? = crypt.HashStringENC(myPassword) // Generate a random request ID like "RID215118906689" let prng = CkoPrng() let sbRequestId = CkoStringBuilder() sbRequestId.Append("RID") sbRequestId.Append(prng.RandomString(12, bDigits: true, bLower: false, bUpper: false)) print("generated requestId = \(sbRequestId.GetAsString())") // Calculate the requestSignature crypt.HashAlgorithm = "sha3-512" var signatureKey: String? = "ce-8f5e-215119fa7dd621DLMRHRLH2S" let sbFinalHashBase = CkoStringBuilder() // First append the timestamp because we are going to remove certain chars/parts. sbFinalHashBase.Append(dtNow.GetAsTimestamp(false)) var numReplaced: Int = sbFinalHashBase.Replace("Z", replacement: "").intValue numReplaced = sbFinalHashBase.Replace("-", replacement: "").intValue numReplaced = sbFinalHashBase.Replace(":", replacement: "").intValue numReplaced = sbFinalHashBase.Replace("T", replacement: "").intValue // Prepend the requestId and append the signatureKey sbFinalHashBase.Prepend(sbRequestId.GetAsString()) sbFinalHashBase.Append(signatureKey) // Calculate each index hash and add it to the sbFinalHashBase let sbHashBase = CkoStringBuilder() sbHashBase.Append("CREATE") sbHashBase.Append(bdInvoiceData1.GetEncoded("base64")) var indexHash: String? = crypt.HashStringENC(sbHashBase.GetAsString()) sbFinalHashBase.Append(indexHash) sbHashBase.Clear() sbHashBase.Append("CREATE") sbHashBase.Append(bdInvoiceData2.GetEncoded("base64")) indexHash = crypt.HashStringENC(sbHashBase.GetAsString()) sbFinalHashBase.Append(indexHash) sbHashBase.Clear() sbHashBase.Append("CREATE") sbHashBase.Append(bdInvoiceData3.GetEncoded("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...) var requestSignature: String? = crypt.HashStringENC(sbFinalHashBase.GetAsString()) // Load our recently obtained exchange token. // See Hungary NAV Invoicing Token Exchange Sample Code let xmlExchangeToken = CkoXml() success = xmlExchangeToken.LoadXmlFile("qa_data/tokens/nav_exchange_token.xml") if success == false { print("\(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.. var encodedEncryptedExchangeToken: String? = xmlExchangeToken.GetChildContent("encodedExchangeToken") // Decode to binary. let bdExchangeToken = CkoBinData() bdExchangeToken.AppendEncoded(encodedEncryptedExchangeToken, encoding: "base64") // Decrypt using your 16-digit replacement key: crypt.CryptAlgorithm = "aes" crypt.CipherMode = "ecb" crypt.KeyLength = 128 crypt.EncodingMode = "base64" // Pass your 16-digit replacement key here: crypt.SetEncodedKey("99952BBAAAAA8XYZ", encoding: "ascii") crypt.DecryptBd(bdExchangeToken) var exchangeToken: String? = bdExchangeToken.GetString("utf-8") print("exchange token = \(exchangeToken!)") // Now build the XML.. let xml = CkoXml() xml.Tag = "ManageInvoiceRequest" xml.AddAttribute("xmlns", value: "http://schemas.nav.gov.hu/OSA/2.0/api") xml.UpdateChildContent("header|requestId", value: sbRequestId.GetAsString()) xml.UpdateChildContent("header|timestamp", value: dtNow.GetAsTimestamp(false)) xml.UpdateChildContent("header|requestVersion", value: "2.0") xml.UpdateChildContent("header|headerVersion", value: "1.0") xml.UpdateChildContent("user|login", value: "lwilsmn0uqdxe6u") xml.UpdateChildContent("user|passwordHash", value: passwordHash) xml.UpdateChildContent("user|taxNumber", value: "11111111") xml.UpdateChildContent("user|requestSignature", value: requestSignature) xml.UpdateChildContent("software|softwareId", value: "123456789123456789") xml.UpdateChildContent("software|softwareName", value: "string") xml.UpdateChildContent("software|softwareOperation", value: "LOCAL_SOFTWARE") xml.UpdateChildContent("software|softwareMainVersion", value: "string") xml.UpdateChildContent("software|softwareDevName", value: "string") xml.UpdateChildContent("software|softwareDevContact", value: "string") xml.UpdateChildContent("software|softwareDevCountryCode", value: "HU") xml.UpdateChildContent("software|softwareDevTaxNumber", value: "string") xml.UpdateChildContent("exchangeToken", value: exchangeToken) xml.UpdateChildContent("invoiceOperations|compressedContent", value: "false") xml.UpdateChildContent("invoiceOperations|invoiceOperation|index", value: "1") xml.UpdateChildContent("invoiceOperations|invoiceOperation|invoiceOperation", value: "CREATE") xml.UpdateChildContent("invoiceOperations|invoiceOperation|invoiceData", value: bdInvoiceData1.GetEncoded("base64")) xml.UpdateChildContent("invoiceOperations|invoiceOperation[1]|index", value: "2") xml.UpdateChildContent("invoiceOperations|invoiceOperation[1]|invoiceOperation", value: "CREATE") xml.UpdateChildContent("invoiceOperations|invoiceOperation[1]|invoiceData", value: bdInvoiceData2.GetEncoded("base64")) xml.UpdateChildContent("invoiceOperations|invoiceOperation[2]|index", value: "3") xml.UpdateChildContent("invoiceOperations|invoiceOperation[2]|invoiceOperation", value: "CREATE") xml.UpdateChildContent("invoiceOperations|invoiceOperation[2]|invoiceData", value: bdInvoiceData3.GetEncoded("base64")) // POST the XML to https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/manageInvoice let http = CkoHttp() http.Accept = "application/xml" http.SetRequestHeader("Content-Type", value: "application/xml") var endpoint: String? = "https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/manageInvoice" var resp: CkoHttpResponse? = http.PostXml(endpoint, xmlDoc: xml.GetXml(), charset: "utf-8") if http.LastMethodSuccess == false { print("\(http.LastErrorText)") return } print("Response status code = \(resp!.StatusCode.intValue)") let respXml = CkoXml() respXml.LoadXml(resp!.BodyStr) print("Response body:") print("\(respXml.GetXml())") resp = nil // 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 var ManageInvoiceResponse_xmlns: String? = respXml.GetAttrValue("xmlns") var ManageInvoiceResponse_xmlns_ns2: String? = respXml.GetAttrValue("xmlns:ns2") var requestId: String? = respXml.GetChildContent("header|requestId") var timestamp: String? = respXml.GetChildContent("header|timestamp") var requestVersion: String? = respXml.GetChildContent("header|requestVersion") var headerVersion: String? = respXml.GetChildContent("header|headerVersion") var funcCode: String? = respXml.GetChildContent("result|funcCode") var softwareId: String? = respXml.GetChildContent("software|softwareId") var softwareName: String? = respXml.GetChildContent("software|softwareName") var softwareOperation: String? = respXml.GetChildContent("software|softwareOperation") var softwareMainVersion: String? = respXml.GetChildContent("software|softwareMainVersion") var softwareDevName: String? = respXml.GetChildContent("software|softwareDevName") var softwareDevContact: String? = respXml.GetChildContent("software|softwareDevContact") var softwareDevCountryCode: String? = respXml.GetChildContent("software|softwareDevCountryCode") var softwareDevTaxNumber: String? = respXml.GetChildContent("software|softwareDevTaxNumber") var transactionId: String? = respXml.GetChildContent("transactionId") } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.