Sample code for 30+ languages & platforms
Dart 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 Dart Downloads

Dart
import 'package:chilkat/chilkat.dart';

void main() {
  // 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>

  final crypt = CkCrypt2();

  final dtNow = CkDateTime();
  dtNow.setFromCurrentSystemTime();
  print(dtNow.getAsTimestamp(false));

  // The hash algorithm for the password is SHA512 (not SHA3-512).
  crypt.hashAlgorithm = 'sha512';
  crypt.encodingMode = 'hex';
  final myPassword = 'my-password';
  final passwordHash = crypt.hashStringENC(myPassword);

  // Generate a random request ID like "RID215118906689"
  final prng = CkPrng();
  final sbRequestId = CkStringBuilder();
  sbRequestId.append('RID');
  sbRequestId.append(prng.randomString(12, true, false, false));
  print('generated requestId = ${sbRequestId.getAsString()}');

  // Calculate the requestSignature
  crypt.hashAlgorithm = 'sha3-512';
  final signatureKey = 'ce-8f5e-215119fa7dd621DLMRHRLH2S';

  final sbFinalHashBase = CkStringBuilder();

  // First append the timestamp because we are going to remove certain chars/parts.
  sbFinalHashBase.append(dtNow.getAsTimestamp(false));
  var numReplaced = sbFinalHashBase.replace('Z', '');
  numReplaced = sbFinalHashBase.replace('-', '');
  numReplaced = sbFinalHashBase.replace(':', '');
  numReplaced = sbFinalHashBase.replace('T', '');

  // Prepend the requestId and append the signatureKey
  sbFinalHashBase.prepend(sbRequestId.getAsString());
  sbFinalHashBase.append(signatureKey);

  final requestSignature = crypt.hashStringENC(sbFinalHashBase.getAsString());

  final xml = CkXml();
  xml.tag = 'TokenExchangeRequest';
  xml.addAttribute('xmlns', 'http://schemas.nav.gov.hu/OSA/2.0/api');
  xml.updateChildContent('header|requestId', sbRequestId.getAsString());
  xml.updateChildContent('header|timestamp', dtNow.getAsTimestamp(false));
  xml.updateChildContent('header|requestVersion', '2.0');
  xml.updateChildContent('header|headerVersion', '1.0');
  xml.updateChildContent('user|login', 'lwilsmn0uqdxe6u');
  xml.updateChildContent('user|passwordHash', passwordHash);
  xml.updateChildContent('user|taxNumber', '11111111');
  xml.updateChildContent('user|requestSignature', requestSignature);
  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
  final http = CkHttp();
  http.accept = 'application/xml';
  final endpoint = 'https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/tokenExchange';
  final resp = CkHttpResponse();
  try {
    http.httpStr('POST', endpoint, xml.getXml(), 'utf-8', 'application/xml', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('Response status code = ${resp.statusCode}');

  final respXml = CkXml();
  respXml.loadXml(resp.bodyStr);
  print('Response body:');
  print(respXml.getXml());

  // Save our exchange token to a file to be used for subsequent requests.
  respXml.saveXml('qa_data/tokens/nav_exchange_token.xml');

  // 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

  final tokenExchangeResponseXmlns = respXml.getAttrValue('xmlns');
  final tokenExchangeResponseXmlnsNs2 = respXml.getAttrValue('xmlns:ns2');
  final requestId = respXml.getChildContent('header|requestId');
  final timestamp = respXml.getChildContent('header|timestamp');
  final requestVersion = respXml.getChildContent('header|requestVersion');
  final headerVersion = respXml.getChildContent('header|headerVersion');
  final funcCode = respXml.getChildContent('result|funcCode');
  final softwareId = respXml.getChildContent('software|softwareId');
  final softwareName = respXml.getChildContent('software|softwareName');
  final softwareOperation = respXml.getChildContent('software|softwareOperation');
  final softwareMainVersion = respXml.getChildContent('software|softwareMainVersion');
  final softwareDevName = respXml.getChildContent('software|softwareDevName');
  final softwareDevContact = respXml.getChildContent('software|softwareDevContact');
  final softwareDevCountryCode = respXml.getChildContent('software|softwareDevCountryCode');
  final softwareDevTaxNumber = respXml.getChildContent('software|softwareDevTaxNumber');
  final encodedExchangeToken = respXml.getChildContent('encodedExchangeToken');
  final tokenValidityFrom = respXml.getChildContent('tokenValidityFrom');
  final tokenValidityTo = respXml.getChildContent('tokenValidityTo');
}