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

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

  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 = 'QueryTaxpayerRequest';
  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');
  xml.updateChildContent('taxNumber', '22222222');

  // POST the XML to https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/queryTaxpayer
  final http = CkHttp();
  http.accept = 'application/xml';
  final endpoint = 'https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/queryTaxpayer';
  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());

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

  final queryTaxpayerResponseXmlns = respXml.getAttrValue('xmlns');
  final queryTaxpayerResponseXmlnsNs2 = 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 infoDate = respXml.getChildContent('infoDate');
  final taxpayerValidity = respXml.getChildContent('taxpayerValidity');
  final taxpayerName = respXml.getChildContent('taxpayerData|taxpayerName');
  final ns2TaxpayerId = respXml.getChildIntValue('taxpayerData|taxNumberDetail|ns2:taxpayerId');
  final ns2VatCode = respXml.getChildIntValue('taxpayerData|taxNumberDetail|ns2:vatCode');
  final taxpayerAddressType = respXml.getChildContent('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddressType');
  final ns2CountryCode = respXml.getChildContent('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:countryCode');
  final ns2PostalCode = respXml.getChildIntValue('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:postalCode');
  final ns2City = respXml.getChildContent('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:city');
  final ns2StreetName = respXml.getChildContent('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:streetName');
  final ns2PublicPlaceCategory = respXml.getChildContent('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:publicPlaceCategory');
  final ns2Number = respXml.getChildIntValue('taxpayerData|taxpayerAddressList|taxpayerAddressItem|taxpayerAddress|ns2:number');
}