EKAER.Client 1.0.0

Preamble and warnings

PLEASE NOTE: this is not an official client, and not supported by the EKAER or by the National Tax and Customs Administration of Hungary.

Please read and understand the license before you start to use it!

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

What is it?

This is an unofficial .NET standard client library for the hungarian ekaer API interface. With this library you can:

• Create trade cards
• List your trade cards
• Modify your trade cards
• Delete your trade cards
• Finalize your trade cards

For more information see the official website at https://ekaer.nav.gov.hu/ and the official API documentation at: https://ekaer.nav.gov.hu/faq/?page_id=9

How to use?

Basically you must understand the official documentation, then add this project as reference.

Query tradecard

var client = new ApiClient(apiUser, apiPassword, VATNumber, apiSecret);
var tradeCard = client.QueryTradeCard("TCN NUMBER");

Modify tradecard

tradeCard = client.ModifyTradeCard(tradeCard);

Finalize tradecard

client.FinalizeTradeCard(tradeCard.Tcn);

Create tradecard

client.CreateTradeCard(tradeCard);

Delete tradecard

client.DeleteTradeCard(tradeCard.Tcn, "Reason text");

Error handling

When something goes wrong, you can catch the EKAERException exception for error details.

try
{
    var finalized = client.FinalizeTradeCard(tradeCard.Tcn);
}
catch (EKAERException e)
{
    Console.WriteLine(e.Result.ReasonCode);
    Console.WriteLine(e.Result.FuncCode);
    Console.WriteLine(e.Message);
}