Dart Requires Chilkat v11.0.0+
Dart
Hungary NAV Manage Annulment Request
See more Hungary NAV Invoicing Examples
Demonstrates the manageAnnulment request for the Hungarian NAV Online Invoicing System REST API v2.0.Chilkat Dart Downloads
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"?>
// <ManageAnnulmentRequest xmlns="http://schemas.nav.gov.hu/OSA/2.0/api">
// <header>
// <requestId>RID338592103413</requestId>
// <timestamp>2019-09-11T13:37:09.385Z</timestamp>
// <requestVersion>2.0</requestVersion>
// <headerVersion>1.0</headerVersion>
// </header>
// <user>
// <login>lwilsmn0uqdxe6u</login>
// <passwordHash>2F43840A882CFDB7DB0 ... F6CA57FE8CD74DC28E</passwordHash>
// <taxNumber>11111111</taxNumber>
// <requestSignature>A297E3BD9 ... 1959ADFAF5</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>dbd03076-3a9b-4312-bbbb-0cee3a6472572P11CS49ASIL</exchangeToken>
// <annulmentOperations>
// <annulmentOperation>
// <index>1</index>
// <annulmentOperation>ANNUL</annulmentOperation>
// <invoiceAnnulment>PD94bWwgdm ... ubnVsbWVudD4=</invoiceAnnulment>
// </annulmentOperation>
// </annulmentOperations>
// </ManageAnnulmentRequest>
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);
// Calculate first (and only) index hash.
final invoiceOperation = 'ANNUL';
final invoiceData = 'PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyI/Pg0KPEludm9pY2VBbm51bG1lbnQgeG1sbnM9Imh0dHA6Ly9zY2hlbWFzLm5hdi5nb3YuaHUvT1NBLzIuMC9hbm51bCI+DQoJCTxhbm51bG1lbnRSZWZlcmVuY2U+MjIyMjIyMjI8L2FubnVsbWVudFJlZmVyZW5jZT4NCgkJPGFubnVsbWVudFRpbWVzdGFtcD4yMDE4LTA2LTE4VDA5OjEwOjQ1LjMwOVo8L2FubnVsbWVudFRpbWVzdGFtcD4NCgkJPGFubnVsbWVudENvZGU+RVJSQVRJQ19EQVRBPC9hbm51bG1lbnRDb2RlPg0KCQk8YW5udWxtZW50UmVhc29uPmNyZWF0ZSBzemFtbGEgYW5udWw8L2FubnVsbWVudFJlYXNvbj4NCjwvSW52b2ljZUFubnVsbWVudD4=';
final sbHashBase = CkStringBuilder();
sbHashBase.append(invoiceOperation);
sbHashBase.append(invoiceData);
final firstHash = crypt.hashStringENC(sbHashBase.getAsString());
// Append the index hash to the final hash base.
sbFinalHashBase.append(firstHash);
// Get our request signature (using sha3-512 because our HashAlgorithm was set to "sha3-512" up above...)
final requestSignature = crypt.hashStringENC(sbFinalHashBase.getAsString());
// Load our recently obtained exchange token.
// See Hungary NAV Invoicing Token Exchange Sample Code
final xmlExchangeToken = CkXml();
try {
xmlExchangeToken.loadXmlFile('qa_data/tokens/nav_exchange_token.xml');
} on ChilkatException catch (e) {
print(e.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..
final encodedEncryptedExchangeToken = xmlExchangeToken.getChildContent('encodedExchangeToken');
// Decode to binary.
final bdExchangeToken = CkBinData();
bdExchangeToken.appendEncoded(encodedEncryptedExchangeToken, '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', 'ascii');
crypt.decryptBd(bdExchangeToken);
final exchangeToken = bdExchangeToken.getString('utf-8');
print('exchange token = $exchangeToken');
// Now build the XML..
final xml = CkXml();
xml.tag = 'ManageAnnulmentRequest';
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('exchangeToken', exchangeToken);
xml.updateChildContent('annulmentOperations|annulmentOperation|index', '1');
xml.updateChildContent('annulmentOperations|annulmentOperation|annulmentOperation', invoiceOperation);
xml.updateChildContent('annulmentOperations|annulmentOperation|invoiceAnnulment', invoiceData);
// POST the XML to https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/manageAnnulment
final http = CkHttp();
http.accept = 'application/xml';
final endpoint = 'https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2/manageAnnulment';
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"?>
// <ManageAnnulmentResponse xmlns="http://schemas.nav.gov.hu/OSA/2.0/api" xmlns:ns2="http://schemas.nav.gov.hu/OSA/2.0/data">
// <header>
// <requestId>RID465317110495</requestId>
// <timestamp>2020-03-25T15:08:40Z</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>2WT6XG9LQ0U9VQNA</transactionId>
// </ManageAnnulmentResponse>
// Use this online tool to generate parsing code from sample XML:
// Generate Parsing Code from XML
final manageAnnulmentResponseXmlns = respXml.getAttrValue('xmlns');
final manageAnnulmentResponseXmlnsNs2 = 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 transactionId = respXml.getChildContent('transactionId');
}