Számlázási szolgáltatások

Patikai cikkek kiegészítő adataihoz tartozó végpont. Lehetőséget nyújt központi adatok, illetve gyógyszertár specifikus paraméterek elérésére.

A végponton elérhető egyes funkciókhoz használható az MCC API.

API elérhetőség

https://mcc-web.pointer.hu/assets/js/mcc.api.js

Működési feltételek

Fontos! A HC Pointer Kft által fejlesztett illesztő még fejlesztés alatt áll, ezért most és a jövőben is célszerű a hostolt címről meghívni, vagy esetlegesen lementeni!

Az API használja a jquery függvénykönyvtár object modelljét, illetőleg ajax (aszinkron) metódusát. Jelenleg használt biztosan stabil verzió (mcc.api-hoz): "jquery-1.12.3", ettől eltérni természetesen megengedett.

Fontos! A működéshez szükséges egy API kulcs, melyet minden esetben a HC Pointer Kft. állít ki!

Számla funkciókhoz, minden esetben a rendelés rögzítésénél kapott azonosító szükséges!

Put invoice

Korlátozások

A funkció jelenleg csak a HC Pointer Kft. Medivus készletkezelési rendszer számára elérhető. A webrendelés számla, a rendszerben elérhető számlázási funkcióval kerül kiállításra, egy fogadott rendelés alapján, majd kerül feltöltésre!

Rendeléshez tartozó számla feltöltése.

Használat

Rendelés azonosítóhoz tartozó pdf/xps fájl, BASE64 kódolt formában tölthető fel. Válaszként a rendelés azonosítója jelenik meg. Minden további folyamat a kapott azonosítóval folytatható!

A rendelés azonosító oid, a küldött API-KEY-hez kell, hogy tartozzon, egyéb esetben, a válasz Resource failed

A feltöltendő állomány típusa pdf/xps, tartalma BASE64 kódolt.

https://mcc-web.pointer.hu/MCC/orders/invoice/

Request

	{
		"oid": "",
		"iblob": ""
	}
Invoice
Paraméter Típus Leírás Default
oid String Rendelés azonosító NOT NULL
iblob String File, base64 encoded pdf/xps NOT NULL

A rendelés azonosító oid, a küldött API-KEY-hez kell, hogy tartozzon, egyéb esetben, a válasz Resource failed

A feltöltendő állomány típusa pdf/xps, tartalma BASE64 kódolt.

Response

	{
		1854
	}
Invoice
Paraméter Típus Leírás Default
Integer Rendelés azonosító NOT NULL

A válaszban kapott azonosító mentéséről gondoskodni szükséges, minden további lekérdezés ehhez az adathoz kötött.

Minta kódok

				curl --location --request PUT 'https://mcc-web.pointer.hu/MCC/orders/invoice' \
				--header 'x-api-key: API-KEY' \
				--header 'Content-Type: application/json' \
				--data-raw '{
					"oid" : "",
					"iblob" : ""
				}'
			
			$curl = curl_init();

			curl_setopt_array($curl, array(
			  CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/invoice',
			  CURLOPT_RETURNTRANSFER => true,
			  CURLOPT_ENCODING => '',
			  CURLOPT_MAXREDIRS => 10,
			  CURLOPT_TIMEOUT => 0,
			  CURLOPT_FOLLOWLOCATION => true,
			  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
			  CURLOPT_CUSTOMREQUEST => 'PUT',
			  CURLOPT_POSTFIELDS =>'{
				"oid" : "",
				"iblob" : ""
			}',
			  CURLOPT_HTTPHEADER => array(
				'x-api-key: API-KEY'
				'Content-Type: application/json'
			  ),
			));

			$response = curl_exec($curl);

			curl_close($curl);

Get invoice

Rendeléshez tartozó számla letöltése.

Használat

Rendelés azonosítóhoz tartozó pdf/xps fájl, BASE64 kódolt formában tölthető le.

A rendelés azonosító oid, a küldött API-KEY-hez kell, hogy tartozzon, egyéb esetben, a válasz Resource failed

Amennyiben a központi rendszerben nem található a rendelés, vagy a rendelés nem az API-KEY-ben küldött azonosítóhoz tartozik, vagy nem található számla, úgy a válasz Resource failed

https://mcc-web.pointer.hu/MCC/orders/invoice/1234
	{
		octet/stream
	}
Invoice
Paraméter Típus Leírás Default
Octet/stream Számla BASE64 encoded NOT NULL

A válasz típusa octet/stream, tartalma maga a fájl. Fogadó oldalon gondoskodni kell ennek letöltéséről és tárolásáról. A fájl típusa lehet PDF, illetve XPS.

A válasz tartalmazza a számla nyilvántarott fájl nevét, ami mentésnél használható, formátuma 'Invoice_azonosító_dátum.kiterjesztés'; Invoice_1515_20210223100050.pdf

Minta kódok

			curl --location --request GET 'https://mcc-web.pointer.hu/MCC/orders/invoice/1234' \
			--header 'x-api-key: API-KEY'
			
			$curl = curl_init();

			curl_setopt_array($curl, array(
			  CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/invoice/1234',
			  CURLOPT_RETURNTRANSFER => true,
			  CURLOPT_ENCODING => '',
			  CURLOPT_MAXREDIRS => 10,
			  CURLOPT_TIMEOUT => 0,
			  CURLOPT_FOLLOWLOCATION => true,
			  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
			  CURLOPT_CUSTOMREQUEST => 'GET',
			  CURLOPT_HTTPHEADER => array(
				'x-api-key: API-KEY'
			  ),
			));

			$response = curl_exec($curl);

			curl_close($curl);