EDI - Revision history

Andrus: Replaced content with "Teenus on suletud alates 01.01.2021"

2021-04-07T08:15:03Z

Replaced content with "Teenus on suletud alates 01.01.2021"

Rait: /* Sihtgrupp */

2017-06-13T07:50:39Z

Sihtgrupp

← Older revision		Revision as of 10:50, 13 June 2017
Line 11:		Line 11:
	== Sihtgrupp ==		== Sihtgrupp ==

	EDI teenuse sihtgrupiks on majandustarkvara teenuse pakkujad (vahendajad). Majandustarkvara teenuse pakkujad saavad Creditinfo EDI teenust pakkuda edasi oma klientidele, ~~integreerides selle oma tootesse~~.		EDI teenuse sihtgrupiks on majandustarkvara teenuse pakkujad (vahendajad). Majandustarkvara teenuse pakkujad saavad Creditinfo EDI teenust pakkuda edasi oma klientidele.

			Kliendid ehk lõpptarbijad (arve väljastajad/saajad) ei saa ise otse EDI-ga liituda (küll aga saavad EDI-ga otse suhelda kui vahendaja neile tokeni väljastab),
			vaid saab seda teha läbi majandustarkvara teenuse pakkuja.

			Kui lõpptarbija ei soovi kasutada vahendajat ja otse liituda EDI-ga, siis peab ta ise katma lisaks kliendi rollile ka vahendaja rolli. Ehk siis EDI-ga liitub kui vahendaja ja väljastab ise endale kui vahendajale kliendi tokeni.

	== Eeldused ==		== Eeldused ==

Rait: /* cURL */ http->https

2017-01-20T20:00:15Z

cURL: http->https

← Older revision		Revision as of 23:00, 20 January 2017
Line 757:		Line 757:

	<pre>		<pre>
	$> curl -i "~~http~~://services.krediidiinfo.ee/edi/sales-invoices" -X POST -d @invoice.xml -H "Authorization: Bearer zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz" -H "Content-Type: application/vnd.ki.einvoice+json; version=1.11"		$> curl -i "https://services.krediidiinfo.ee/edi/sales-invoices" -X POST -d @invoice.xml -H "Authorization: Bearer zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz" -H "Content-Type: application/vnd.ki.einvoice+json; version=1.11"
	</pre>		</pre>

	== Viited ==		== Viited ==
	* [https://github.com/raigu/kiediclient Näidisklient PHP-s]		* [https://github.com/raigu/kiediclient Näidisklient PHP-s]

Rait: /* Testkeskkond */ http->https

2017-01-20T19:59:58Z

Testkeskkond: http->https

← Older revision		Revision as of 22:59, 20 January 2017
Line 256:		Line 256:


	Testimiseks ja arendamiseks on eraldi testserver serveris katseklaas.krediidiinfo.ee. Ehk siis kui tavapärane URI-i on https://services.krediidiinfo.ee/edi/purchase-invoices, siis testserveri poole pöördumisel tuleb kasutada hoopis ~~http~~://katseklaas.krediidiinfo.ee/edi/purchase-invoices.		Testimiseks ja arendamiseks on eraldi testserver serveris katseklaas.krediidiinfo.ee. Ehk siis kui tavapärane URI-i on https://services.krediidiinfo.ee/edi/purchase-invoices, siis testserveri poole pöördumisel tuleb kasutada hoopis https://katseklaas.krediidiinfo.ee/edi/purchase-invoices.

	Testserveri kasutamiseks on vaja küsida Creditinfo käest vahendaja tokenit testserverisse.		Testserveri kasutamiseks on vaja küsida Creditinfo käest vahendaja tokenit testserverisse.



	= REST liidese dokumentatsioon =		= REST liidese dokumentatsioon =

Rait: /* Autentimine */

2017-01-18T14:01:05Z

Autentimine

← Older revision		Revision as of 17:01, 18 January 2017
Line 106:		Line 106:
	Tokeni põhjal tehakse kindlaks päringu tegija ning vastavalt sellele lubatakse/keelatakse juurdepääsud ressurssidele. Näiteks kui klient teeb oma tokeniga päringu ''GET /edi/purchase-invoices'', siis on vastuseks vaid selle kliendi ostuarved, mitte kõik serveris olevad ostuarved.		Tokeni põhjal tehakse kindlaks päringu tegija ning vastavalt sellele lubatakse/keelatakse juurdepääsud ressurssidele. Näiteks kui klient teeb oma tokeniga päringu ''GET /edi/purchase-invoices'', siis on vastuseks vaid selle kliendi ostuarved, mitte kõik serveris olevad ostuarved.

	Oluline on eristada '''vahendaja''' ja '''kliendi''' tokenit. Vahendaja saab teha päringuid kliendi andmete küsimiseks, kliendi registreerimiseks või kustutamiseks ja kliendi tokeni uuendamist. Klient saab päringuid teha vaid siis kui vahendaja on kliendi EDI-s registreerinud, uuendanud kliendi tokeni ja selle kliendile edastanud. Kui vahendaja soovib teha päringut kliendi nimel, siis peab vahendaja kasutama kliendi tokenit.
			Oluline on eristada '''vahendaja''' ja '''kliendi''' tokenit. Edaspidi on dokumentatsioonis vahendaja token viidatud stringiga xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ja klienditoken stringiga yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy. Vahendaja saab teha päringuid kliendi andmete küsimiseks, kliendi registreerimiseks või kustutamiseks ja kliendi tokeni uuendamist. Klient saab päringuid teha vaid siis kui vahendaja on kliendi EDI-s registreerinud, uuendanud kliendi tokeni ja selle kliendile edastanud. Kui vahendaja soovib teha päringut kliendi nimel, siis peab vahendaja kasutama kliendi tokenit.


	Vahendajad saavad tokeni Creditinfo käest pärast EDI kasutuslepingu sõlmimist ning see saadetakse krüpteeritult. Selle tokeniga saab vahendaja registreerida kliente ja küsida või uuendada kliendi tokenit.		Vahendajad saavad tokeni Creditinfo käest pärast EDI kasutuslepingu sõlmimist ning see saadetakse krüpteeritult. Selle tokeniga saab vahendaja registreerida kliente ja küsida või uuendada kliendi tokenit.
Line 112:		Line 114:

	'''<span style="color:red">Token tuleb hoida saladuses</span>''', sest selle põhjal toimub päringu tegija autentimine ja autoriseerimine. Teades vahendaja tokenit võib vahendaja nimel suvalisi kliente registreerida või eemaldada. Samuti peavad klientide tokenid olema salvestatud turvaliselt ning selle eest vastutab vahendaja. Kõik tokeniga seotud päringud peavad toimuma üle HTTPS ühenduse, et vältida ''man-in-the-middle'' rünnakut.		'''<span style="color:red">Token tuleb hoida saladuses</span>''', sest selle põhjal toimub päringu tegija autentimine ja autoriseerimine. Teades vahendaja tokenit võib vahendaja nimel suvalisi kliente registreerida või eemaldada. Samuti peavad klientide tokenid olema salvestatud turvaliselt ning selle eest vastutab vahendaja. Kõik tokeniga seotud päringud peavad toimuma üle HTTPS ühenduse, et vältida ''man-in-the-middle'' rünnakut.


	Kui pöördute abi saamiseks Creditinfo tehnilise toe poole ning e-postiga on vaja saata HTTP päringu päis ja keha, siis eemaldage saadetavatest andmetest tokenid. Creditinfo ei küsi kunagi kogu teie tokenit, vajadusel võib Creditinfo küsida silumisel vaid kolme esimest ja/või viimast sümbolit.		Kui pöördute abi saamiseks Creditinfo tehnilise toe poole ning e-postiga on vaja saata HTTP päringu päis ja keha, siis eemaldage saadetavatest andmetest tokenid. Creditinfo ei küsi kunagi kogu teie tokenit, vajadusel võib Creditinfo küsida silumisel vaid kolme esimest ja/või viimast sümbolit.


	== Veahaldus ==		== Veahaldus ==

Rait at 08:57, 3 January 2017

2017-01-03T08:57:42Z

← Older revision		Revision as of 11:57, 3 January 2017
Line 48:		Line 48:

	[[File:Edi kasutuslugude diagramm.png]]		[[File:Edi kasutuslugude diagramm.png]]

			= Arendajale =

			Sammud vahendaja arendajale liidese integreerimiseks.


			* Loe läbi kogu dokumentatsioon
			* Küsi Creditinfo käest '''vahendaja token''' '''testserveri''' jaoks.

			* Realiseeri kasutuslood, mis kasutavad '''vahendaja tokenit'''.
			** kliendi lisamine
			** kliendi eemaldamine
			** kliendi tokeni uuendamine

			Nüüd saab klient ennast registreerida ja '''kliendi tokeni''' abil oma müügiarveid saata ja ostuarveid vastu võtta.

			* Realiseeri kasutuslood, mis kasutavad '''kliendi tokenit''':
			** müügiarvete saatmine
			** müügiarvete vastuvõtmine

			* kui kõik valmis ja testkeskkonnas toimib, siis peab vahendaja sõlmima Creditinfoga lepingu ning koos lepinguga väljastatakse '''live serveri vahendaja token'''. Vaheta testserveri domeeni nimetus live serveri oma vastu ning asenda testserveri vahendaja token live serveri vahendaja tokeniga. Ongi kõik.

Rait: struktuuri muutmine.

2017-01-03T08:45:09Z

struktuuri muutmine.

Show changes

Rait: /* Tutvustus */

2017-01-03T08:29:53Z

Tutvustus

← Older revision		Revision as of 11:29, 3 January 2017
Line 35:		Line 35:


	Kui klient A soovib saata arvet teisele kliendile B, siis annab ta arve EDI-le ning EDI paigutab arve kliendi B postkasti. Klient B kontrollib regulaarselt oma postkasti ~~ning võtab ära kõik saabunud elektroonilised dokumendid~~.		Kui klient (saatja) A soovib saata arvet teisele kliendile (saaja) B, siis annab ta arve EDI-le ning EDI paigutab arve kliendi B ostuarvete postkasti. Klient B kontrollib ja tühjendab regulaarselt oma ostuarvete postkasti.


Line 42:		Line 42:

	Kui klient tuleb oma postkasti kontrollima, siis peab EDI aru saama kellega on tegemist. See on vajalik, et takistada võõrastesse postkastidesse piilumist ja lubada vaadata vaid oma postkasti. Selle probleemi lahendamiseks väljastatakse iga kliendi jaoks oma parool ehk kliendi token. Tokeni peab küsima ja kliendile edastama vahendaja. <font style="color:red">NB! Token tuleb hoida saladuses!</font> Kes iganes teab kliendi tokenit saab esineda kliendi nimel.		Kui klient tuleb oma postkasti kontrollima, siis peab EDI aru saama kellega on tegemist. See on vajalik, et takistada võõrastesse postkastidesse piilumist ja lubada vaadata vaid oma postkasti. Selle probleemi lahendamiseks väljastatakse iga kliendi jaoks oma parool ehk kliendi token. Tokeni peab küsima ja kliendile edastama vahendaja. <font style="color:red">NB! Token tuleb hoida saladuses!</font> Kes iganes teab kliendi tokenit saab esineda kliendi nimel.


			EDI üldised kasutuslood koos kasutajate rollidega:


			[[File:Edi kasutuslugude diagramm.png]]

	= Liidese tehniline kirjeldus =		= Liidese tehniline kirjeldus =

Rait: /* Tutvustus */

2017-01-03T08:03:16Z

Tutvustus

← Older revision		Revision as of 11:03, 3 January 2017
Line 42:		Line 42:

	Kui klient tuleb oma postkasti kontrollima, siis peab EDI aru saama kellega on tegemist. See on vajalik, et takistada võõrastesse postkastidesse piilumist ja lubada vaadata vaid oma postkasti. Selle probleemi lahendamiseks väljastatakse iga kliendi jaoks oma parool ehk kliendi token. Tokeni peab küsima ja kliendile edastama vahendaja. <font style="color:red">NB! Token tuleb hoida saladuses!</font> Kes iganes teab kliendi tokenit saab esineda kliendi nimel.		Kui klient tuleb oma postkasti kontrollima, siis peab EDI aru saama kellega on tegemist. See on vajalik, et takistada võõrastesse postkastidesse piilumist ja lubada vaadata vaid oma postkasti. Selle probleemi lahendamiseks väljastatakse iga kliendi jaoks oma parool ehk kliendi token. Tokeni peab küsima ja kliendile edastama vahendaja. <font style="color:red">NB! Token tuleb hoida saladuses!</font> Kes iganes teab kliendi tokenit saab esineda kliendi nimel.



	= Liidese tehniline kirjeldus =		= Liidese tehniline kirjeldus =

Rait: lisatud süsteemi olemuse tutvustus

2017-01-03T08:01:12Z

lisatud süsteemi olemuse tutvustus

@@ Line 1: / Line 1: @@
-= Tutvustus =
+= Sissejuhatus =
 == Eesmärk ==
@@ Line 27: / Line 27: @@
 *'''vahendaja''' - Vahendaja on majandustarkvara teenuse pakkuja, kes on oma tarkvarasse integreerinud klientidele võimaluse saata ja vastu võtta elektroonilisi dokumente läbi EDI. Vahendaja ülesanne on tuvastada klient, kliendi registreerimine EDI-s ning kliendi ja EDI liidese nõuete kohane toimimine.
 = Liidese tehniline kirjeldus =