@nfctron/eet

eet

Node.js library for EET (Electronic Registration of Sales in the Czech Republic) (Elektronickou evidenci tržeb).

Note: this library is still in development (version 0.x). API should stay the same, but there are not enough tests and documentation. Pull requests are welcome!

Differences against the original library

This is fork of JakubMrozek/eet with the following changes:

• completely rewritten to allow multiple request with the same client (performance improvement)
  + currentDate and uuid moved from options to items and renamed to datOdesl and uuidZpravy to improve consistency
• fixed LICENSE (to be recognized by GitHub)
• improved README
• added yarn.lock
• improved package.json, upgraded dependencies

Installation

Requirements: Node.js 7+ (it might work under 6.x but it is not tested)

Using npm:

npm install @nfctron/eet --save

or with yarn:

yarn add @nfctron/eet

Example usage

const { createClient } = require('eet');

// privatni klic a certifikat podnikatele
const options = {
	privateKey: '...',
	certificate: '...',
	playground: true
};

// polozky, ktere se posilaji do EET 
const items = {
	dicPopl: 'CZ1212121218',
	idPokl: '/5546/RO24',
	poradCis: '0/6460/ZQ42',
	datTrzby: new Date(),
	celkTrzba: 34113,
	idProvoz: '273'
};

// ziskani FIK (kod uctenky) pomoci async/await (Node.js 8+ / Babel)

const client = await createClient(options);

try {
	const { fik } = await client.request(items);
}


// ziskani FIK v Node.js 6+
createClient(options)
	.then(client => client.request(items))
	.then(response => {
		// response.fik
	});

Convert .p12 to .pem

TODO example using command line with OpenSSL

This library works only with certificates and keys in string format .pem. From the binary .p12 you can convert them for example by package pem:

npm install pem --save

const pem = require('pem');

const file = require('fs').readFileSync('cesta/k/souboru.p12');
const password = ''; //pro testovací certifikáty EET je heslo 'eet'

pem.readPkcs12(file, {p12Password: password}, (err, result) => {
	if (err) ...
	// result.key je privátní klíč
	// result.cert je certifikát
});

API

createClient(options)

name	type	required	default	description
privateKey	string	yes		private key for the certificate
certificate	string	yes		certificate
offline	boolean	no	false	if true, includes PKP and BKB in response on unsuccessful request to EET
playground	boolean	no	false	use Playground EET endpoint instead of production
timeout	number	no	2000 ms	maximal time to wait in milliseconds
measureResponseTime	boolean	no	false	measure response time using node-soap's client.lastElapsedTime
httpClient	object	no		see soap options, just for testing

EETClient.request(items)

• items - data to send in EET request, same name as in EET specification but in camel case (so instead of dic_popl use dicPopl)

  TODO add table of items (required, data type, and description)

TODO document whole API

Frequent errors

Neplatny podpis SOAP zpravy (4)

Na 99% půjde o problém s certifikátem, více je popsáno v issue #1.

Roadmap

• possibly create signatures and hashes asynchronously
• better test coverage
• improve documentation
• and JakubMrozek/eet #9 Roadmap v1.0

Changelog

see description of each release in Releases

License

MIT