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.
https://mcc-web.pointer.hu/assets/js/mcc.api.js
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!
Rendelés funkciókhoz, minden esetben a rendelés rögzítésénél kapott azonosító szükséges!
A funkciókhoz a következő szótár elemek tartoznak
| Azonosító | Név | Leírás |
|---|---|---|
| hcid/HCTTID/EXTID | Központi termékazonosító | Központilag nyilvántartott termékazonosító |
| patikaid/HCID/CIKKID | Patikai egyedi termékazonosító | Patika rendszerben nyilvántartott termékazonosító |
| webshopid/itemnumber | Webshop egyedi termékazonosító | Webshopban nyilvántartott termékazonosító |
Az adott termék azonosításához szükséges, legalább az egyik termékazonosító megléte; központi, patikai, webshop
| Azonosító | Név | Leírás |
|---|---|---|
| 1 | Készül | Webáruházban készül (technikai státusz) |
| 2 | Küldött | Webáruház rendszerből küldve |
| 3 | Fogadott | Gyógyszertári rendszer által befogadva |
| 4 | Visszaigazolt | Gyógyszertári rendszer által visszaigazolt |
| 5 | Számlázott | Gyógyszertári rendszer által számlázott |
| 6 | Szállított | Gyógyszertári rendszer által szállított |
| 7 | Elutasított | Gyógyszertári rendszer által elutasított |
| 8 | Szállításra átadott | Szállításra átadott |
| 9 | Elévült | Elévült |
| 10 | Sztornózott | Gyógyszertári rendszerben sztornózott |
| 11 | Megrendelt | Gyógyszertári rendszerben megrendelt |
| Azonosító | Név |
|---|---|
| 0 | Nincs megadva |
| 1 | Magánszemély |
| 2 | Vállalkozás, cég |
| 3 | Egyéni vállalkozó |
| 4 | Intézmény |
| 5 | Alapítvány, egyesület, KHT |
Rendelés feltöltése.
Biztonsági, illetve adatkezelési megfontolásból, a rendelések kezelése a következők szerint történik:
Rendelés feltöltése
https://mcc-web.pointer.hu/MCC/orders/webshop/
{"orders":
[
{
"ordernumber" : "TESZT_R0000001",
"status" : 2,
"orderdate" : "2021-01-11 11:48:58",
"deliverymode" : "Házhozszállítás",
"note" : "",
"message" : "",
"billing" :
{
"azonosito" : "",
"firstname" : "Teszt",
"lastname" : "Vevő",
"ceg" : "",
"orszag" : "",
"tarsasagiforma":1,
"adoszam" : "",
"helyseg" : "Budapest",
"cim" : "Teszt út 1.",
"irszam" : "1023",
"tel" : "",
"email" : "",
"kerulet" : "",
"kozteruletjelleg" : "",
"hazszam" : "",
"epulet" : "",
"lepcsohaz" : "",
"szintemelet" : "",
"ajto" : "",
"megjegyzes" : ""
},
"delivery" :
{
"azonosito" : "",
"firstname" : "Teszt",
"lastname" : "Vevő",
"ceg" : "",
"orszag" : "",
"helyseg" : "Budapest",
"cim" : "Teszt u. 2",
"irszam" : "1023",
"tel" : "+36101234567",
"email" : "info@email.com",
"kerulet" : "",
"kozteruletjelleg" : "",
"hazszam" : "",
"epulet" : "",
"lepcsohaz" : "",
"szintemelet" : "",
"ajto" : "",
"megjegyzes" : ""
},
"customer" :
{
"azonosito" : "",
"firstname" : "Teszt",
"lastname" : "Vevő",
"megjegyzes" : ""
},
"payment" : {
"name":"Bankkártya",
"hcid":0,
"patikaid":1000001,
"cardissuer":"",
"cardnumber":"",
"trxid":"",
"note":"",
"webshopid":""
},
"shipping" : {
"name":"Házhozszállítás",
"hcid":0,
"patikaid":1014835,
"number":"",
"price": 999.5,
"note": "",
"webshopid":""
},
"items" :
[
{
"name" : "1X1 VITADAY C-VITAMIN",
"hcid" : 137362,
"patikaid" : 0,
"quantity" : 1,
"price" : 913,
"note" : "",
"itemnumber" : "1006499"
},
{
"name" : "ACC NASAL 3% ORRSPRAY SANDOZ",
"hcid" : 92815,
"patikaid" : 0,
"quantity" : 1,
"price" : 111,
"note" : "",
"itemnumber" : "1021678"
},
{
"name" : "Kupon Engedmény",
"hcid" : 0,
"patikaid" : 1014843,
"quantity" : 1,
"price" : -100,
"note" : "",
"itemnumber" : ""
}
]
}
]}
A Payment, Shipping, Delivery, Customer, object-et nem szükséges üres, vagy NULL,0,'',"" paraméterekkel szerepeltetni! Ebben az esetben default értékkel kerül rögzítésre.
Hiányzó, vagy null paraméter esetén, az adott adat, default értékkel kerül rögzítésre.
Használható ország ISO kódok.
Hiányzó Billing, Items esetén, a rögzítés parameter hibával meghiúsul!
Amennyiben a szerepeltetett érték típusa, eltér az előírttól, a rögzítés parameter hibával meghiúsul!
Amennyiben a szerepeltetett érték hossza, eltér az előírttól, a rögzítés parameter hibával meghiúsul!
Amennyiben a szerepeltetett azonosítók (hcid, patikaid, webshopid) nem definiált, vagy értéke null a rögzítés default értékekkel történik és további azonosításuk nem lehetséges!
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| ordernumber | String | 50 | Rendelés azonosító | NOT NULL |
| status | Integer | Rendelés státusz | 2 | |
| orderdate | DateTime | Rendelés időpont | NOT NULL | |
| deliverymode | String | 50 | Szálíltási mód | "" |
| note | Text | Rendelés megjegyzés | "" | |
| message | Text | Rendelés üzenet | "" | |
| billing | Object | 1 | Rendelés számlázási adatok | NOT NULL |
| delivery | Object | 1 | Rendelés szállítási adatok | |
| customer | Object | 1 | Vevő adatok | |
| payment | Object | 1 | Fizetési adatok | |
| shipping | Object | 1 | Szállításimód adatok | |
| items | Array | Termékek | NOT NULL |
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| azonosito | String | 50 | Számlázási azonosító | "" |
| firstname | String | 25 | Vezetéknév | "" |
| lastname | String | 25 | Keresztnév | "" |
| orszag | String | 2 | Ország ISO kód | "" |
| ceg | String | 50 | Cég név | "" |
| tarsasagiforma | Integer | Társasági forma | 0 | |
| adoszam | String | 13 | Adószám | "" |
| helyseg | String | 30 | Helység | "" |
| cim | String | 30 | Cím | "" |
| irszam | String | 8 | Irányítószám | "" |
| tel | String | 15 | Telefonszám | "" |
| String | 50 | E-mail cím | "" | |
| kerulet | String | 10 | Kerület | "" |
| kozteruletjelleg | String | 30 | Közterület jellege | "" |
| hazszam | String | 10 | Házszám | "" |
| epulet | String | 10 | Épület | "" |
| lepcsohaz | String | 10 | Lépcsőház | "" |
| szintemelet | String | 10 | Szint, emelet | "" |
| ajto | String | 10 | Ajtó | "" |
| megjegyzes | String | 2147483647 | Megjegyzés | "" |
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| azonosito | String | 50 | Számlázási azonosító | "" |
| firstname | String | 25 | Vezetéknév | "" |
| lastname | String | 25 | Keresztnév | "" |
| orszag | String | 2 | Ország ISO kód | "" |
| ceg | String | 50 | Cég név | "" |
| helyseg | String | 30 | Helység | "" |
| cim | String | 30 | Cím | "" |
| irszam | String | 8 | Irányítószám | "" |
| tel | String | 15 | Telefonszám | "" |
| String | 50 | E-mail cím | "" | |
| kerulet | String | 10 | Kerület | "" |
| kozteruletjelleg | String | 30 | Közterület jellege | "" |
| hazszam | String | 10 | Házszám | "" |
| epulet | String | 10 | Épület | "" |
| lepcsohaz | String | 10 | Lépcsőház | "" |
| szintemelet | String | 10 | Szint, emelet | "" |
| ajto | String | 10 | Ajtó | "" |
| megjegyzes | String | 2147483647 | Megjegyzés | "" |
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| azonosito | String | 50 | Számlázási azonosító | "" |
| firstname | String | 25 | Vezetéknév | "" |
| lastname | String | 25 | Keresztnév | "" |
| megjegyzes | String | 2147483647 | Megjegyzés | "" |
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| name | String | 50 | Fizetés megnevezés | "" |
| hcid | Integer | Központi azonosító | 0 | |
| patikaid | Integer | Patika azonosító | 0 | |
| cardissuer | String | 50 | Kártya kibocsátó | "" |
| cardnumber | String | 20 | Kártyaszám | "" |
| trxid | String | 50 | Tranzakció azonosító | "" |
| note | String | 2147483647 | Tranzakció megjegyzés | "" |
| webhsopid | String | 50 | Webshop azonosító | "" |
Az adott termék azonosításához szükséges az egyik termékazonosító megléte; hcid, patikaid, webshopid
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| name | String | 50 | Szállításimód megnevezés | "" |
| hcid | Integer | Központi azonosító | 0 | |
| patikaid | Integer | Patika azonosító | 0 | |
| number | String | 20 | Szállítási szám | "" |
| price | Float | Szállítási ár | 0 | |
| note | String | 2147483647 | Szállítási megjegyzés | "" |
| webhsopid | String | 50 | Webshop azonosító | "" |
Az adott termék azonosításához szükséges az egyik termékazonosító megléte; hcid, patikaid, webshopid
| Paraméter | Típus | Hossz | Leírás | Default |
|---|---|---|---|---|
| name | String | 100 | Termék megnevezés | "" |
| hcid | Integer | Központi azonosító | 0 | |
| patikaid | Integer | Patika azonosító | 0 | |
| quantity | Float | Mennyiség | 0 | |
| price | Float | Fogyasztói ár | 0 | |
| itemnumber | String | 20 | Webshop azonosító | "" |
Az adott termék azonosításához szükséges az egyik termékazonosító megléte; hcid, patikaid, itemnumber
A gyökérelem orders bármennyi order elemet tartalmazhat, külön-külön különböző vevő és rendelési adatokkal.
A rendelés items eleme több item elemet tartalmazhat a rendelt termékek szerint.
Az orders.order.ordernumber azonosítja a rendelést.
A vevő szállítási és számlázási címe minden esetben rögzítésre kerül, majd periódikusan törlődik a rendelés lezárása után.
A vevő azonosítására a billing.azonosito, billing.adoszam mezők szolgálnak.
Amennyiben egészségpénztári vásárlás történik, akkor az EP adatait a Billing részben, míg a vevő adatai a Customer részben kell szerepeltetni.
A feltöltött rendelés alap státusza minden esetben 2 kell, hogy legyen. Ellenkező esetben a gyógyszertári rendszer, nem, vagy hibásan fogja jelezni.
Terméknél, az items.item.hcid, illetve items.item.patikaid azonosító alapján történik a webáruház és a gyógyszertári cikktörzs összekapcsolása. Minden egyéb azonosító az items.item.itemnumber mezőbe kerülhet.
Fizetési módnál, az payment.hcid, illetve payment.patikaid azonosító alapján történik a webáruház és a gyógyszertári cikktörzs összekapcsolása. Minden egyéb azonosító az payment.webhsopid mezőbe kerülhet.
Szállítási módnál, az shipping.hcid, illetve shipping.patikaid azonosító alapján történik a webáruház és a gyógyszertári cikktörzs összekapcsolása. Minden egyéb azonosító az shipping.webshopid mezőbe kerülhet.
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.
{
1854
}
curl --location --request PUT 'https://mcc-web.pointer.hu/MCC/orders/webshop' \
--header 'x-api-key: API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"orders":
[
{
"ordernumber" : "TESZT_R0000001",
"status" : 2,
"orderdate" : "2021-01-11 11:48:58",
"deliverymode" : "Házhozszállítás",
"note" : "",
"message" : "",
"billing" : {},
"delivery" : {},
"customer" : {},
"payment" : {},
"shipping" : {},
"items" :
[
{},{...}
]
},{...}
]
}'
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/webshop',
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 =>'{
"orders":
[
{
"ordernumber" : "TESZT_R0000001",
"status" : 2,
"orderdate" : "2021-01-11 11:48:58",
"deliverymode" : "Házhozszállítás",
"note" : "",
"message" : "",
"billing" : {},
"delivery" : {},
"customer" : {},
"payment" : {},
"shipping" : {},
"items" :
[
{},{...}
]
},{...}
]
}',
CURLOPT_HTTPHEADER => array(
'x-api-key: API-KEY'
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
Az API kulcshoz tárolt megrendelés adatok elérése.
Figyelem! A lekérdezés elsődlegesen a patikai rendszer számára elérhető, a rendelések szinkronizálására!
Lekérdezhető az összes folyamatban lévő rendelés (gyógyszertári rendszer), illetve egy konkrét rendelés (webáruház).
A lekérdezés, a rendelés státusz követésére szolgál Státuszok. A lekérdezéshez szükséges a megfelelő rendelés azonosító megléte!
https://mcc-web.pointer.hu/MCC/orders/webshop/1234
[{
"order": {
"ocreated": "2021-02-10 15:37:02.440",
"omodified": "2021-02-17 09:54:04.537",
"opartner": "1111111000",
"ostatus": 7,
"oordernumber": "R0000001",
"oorderdate": "2021-02-10 15:37:02.000",
"obillingid": null,
"odeliveryid": null,
"opaymentid": null,
"oshippingid": null,
"odeliverymode": "Házhozszállítás",
"onote": "",
"omessage": "",
"ochanged": 0,
"oid": 1234
},
"orderitems": [
{},{...}
],
"billing": {},
"delivery": {},
"customer": {},
"payment": {},
"shipping": {}
}
]
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| ocreated | DateTime | Rendelés létrehozás | NOT NULL |
| omodified | DateTime | Rendelés módosítás | NOT NULL |
| oorderdate | DateTime | Rendelés dátum | NOT NULL |
| opartner | String | Rendelés patika azonosító | NOT NULL |
| ordernumber | String | Rendelés azonosító | NOT NULL |
| ostatus | String | Rendelés státusz | NOT NULL |
| odeliveryid | Integer | Szálíltásicím azonosító | NULL |
| obillingid | Integer | Számlázásicím azonosító | NULL |
| opaymentid | Integer | Fizetésimód azonosító | NULL |
| oshippingid | Integer | Szállításimód azonosító | NULL |
| odeliverymode | String | Szállításimód | "" |
| onote | String | Megjegyzés | "" |
| omessage | String | Megjegyzés | "" |
| ochanged | Integer | Rendelés változás | NOT NULL |
| oid | Integer | Rendelés azonosító | NOT NULL |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| bazonosito | String | Számlázási azonosító | "" |
| bfirstname | String | Vezetéknév | "" |
| blastname | String | Keresztnév | "" |
| borszag | String | Ország ISO kód | "" |
| bceg | String | Cég név | "" |
| btarsasagiforma | String | Társasági forma | 0 |
| badoszam | String | Adószám | "" |
| bhelyseg | String | Helység | "" |
| bcim | String | Cím | "" |
| birszam | String | Irányítószám | "" |
| btel | String | Telefonszám | "" |
| bemail | String | E-mail cím | "" |
| bkerulet | String | Kerület | "" |
| bkozteruletjelleg | String | Közterület jellege | "" |
| bhazszam | String | Házszám | "" |
| bepulet | String | Épület | "" |
| blepcsohaz | String | Lépcsőház | "" |
| bszintemelet | String | Szint, emelet | "" |
| bajto | String | Ajtó | "" |
| bmegjegyzes | String | Megjegyzés | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| dazonosito | String | Számlázási azonosító | "" |
| dfirstname | String | Vezetéknév | "" |
| dlastname | String | Keresztnév | "" |
| dorszag | String | Ország ISO kód | "" |
| dceg | String | Cég név | "" |
| dhelyseg | String | Helység | "" |
| dcim | String | Cím | "" |
| dirszam | String | Irányítószám | "" |
| dtel | String | Telefonszám | "" |
| demail | String | E-mail cím | "" |
| dkerulet | String | Kerület | "" |
| dkozteruletjelleg | String | Közterület jellege | "" |
| dhazszam | String | Házszám | "" |
| depulet | String | Épület | "" |
| dlepcsohaz | String | Lépcsőház | "" |
| dszintemelet | String | Szint, emelet | "" |
| dajto | String | Ajtó | "" |
| dmegjegyzes | String | Megjegyzés | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| cazonosito | String | Számlázási azonosító | "" |
| cfirstname | String | Vezetéknév | "" |
| clastname | String | Keresztnév | "" |
| cmegjegyzes | String | Megjegyzés | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| pname | String | Fizetés megnevezés | NOT NULL |
| phcid | Integer | Központi azonosító | NULL |
| ppatikaid | Integer | Patika azonosító | NOT NULL |
| pcardissuer | String | Kártya kibocsátó | "" |
| pcardnumber | String | Kártyaszám | "" |
| trxid | String | Tranzakció azonosító | "" |
| pnote | String | Tranzakció megjegyzés | "" |
| pwebhsopid | String | Webshop azonosító | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| sname | String | Szállításimód megnevezés | NOT NULL |
| shcid | Integer | Központi azonosító | NULL |
| spatikaid | Integer | Patika azonosító | NOT NULL |
| snumber | String | Szállítási szám | "" |
| sprice | Float | Szállítási ár | NOT NULL |
| snote | String | Szállítási megjegyzés | "" |
| swebhsopid | String | Webshop azonosító | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| oiitemname | String | Termék megnevezés | NOT NULL |
| oihcid | Integer | Központi azonosító | NULL |
| oipatikaid | Integer | Patika azonosító | NOT NULL |
| oiquantity | Float | Mennyiség | NOT NULL |
| price | Float | Fogyasztói ár | NOT NULL |
| oinote | String | Megjegyzés | "" |
| oinumber | String | Webshop azonosító | "" |
curl --location --request GET 'https://mcc-web.pointer.hu/MCC/orders/webshop/1234' \ --header 'x-api-key: API-KEY'
$curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/webshop/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);
Rendelés megjegyzés módosítás.
Figyelem! A funkció a webáruház rendelés, megjegyzés módosítására szolgál!
Visszaigazolást (acknowledged) csak a patikai rendszer küld, a módosítás nyugtázására!
Rendelés módosítás
A lekérdezés, a rendelés megjegyzés módosítására szolgál.
Amennyiben nem visszaigazolás történik (acknowledged = 1), úgy a rendelés változásmező (changed) értéke 1-re állítódik.
A funkcióhoz szükséges a megfelelő rendelés azonosító megléte!
https://mcc-web.pointer.hu/MCC/orders/modified/
{
"acknowledged" : 1
"id": 1234,
"message": ""
}
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| String | Ok |
curl --location --request POST 'https://mcc-web.pointer.hu/MCC/orders/webshop/1234' \
--header 'x-api-key: API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"id":1234,
"acknowledged":1,
"message":""
}'
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/webshop/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 => 'POST',
CURLOPT_POSTFIELDS =>'{
"id":1234,
"acknowledged":1,
"message":""
}',
CURLOPT_HTTPHEADER => array(
'x-api-key: API-KEY'
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
Rendelés státusz módosítás.
Figyelem! A funkció a patikai rendszer számára elérhető, a rendelés státuszok módosítására!
A státuszt a webáruháznak tilos állítani!
Rendelés módosítás
A lekérdezés, a rendelés státusz módosítására szolgál Státuszok. A funkcióhoz szükséges a megfelelő rendelés azonosító megléte!
https://mcc-web.pointer.hu/MCC/orders/webshop/
{
"id": 1234,
"status": 7,
"note": ""
}
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| String | Ok |
curl --location --request POST 'https://mcc-web.pointer.hu/MCC/orders/webshop/1234' \
--header 'x-api-key: API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"id":1234,
"status":7,
"note": ""
}'
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/webshop/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 => 'POST',
CURLOPT_POSTFIELDS =>'{
"id":1234,
"status":7,
"note":""
}',
CURLOPT_HTTPHEADER => array(
'x-api-key: API-KEY'
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
A funkció óránként 1000 darab lekérdezésre van korlátozva, API kulcsonként.
A végpont adott patikához tartozó, adott időpillanattól bekövetkezett rendelés módosulási adatokat szolgáltat.
Eredményül a patikához, adott dátumtól módosult rendelés információk, JSON formában jelennek meg.
A paraméterben szereplő timestamp, UNIX timestamp, ahol: 2020.01.23. 12:00:00 -> 1579777200. Teszteléshez, a következő Online tesztoldal szolgálhat.
UNIX timestamp-től eltérő adat esetén (pl.: 2020/01/01 2:00PM), a válasz Resource failed konverziós hiba lesz.
https://mcc-web.pointer.hu/MCC/orders/modified/1588096800
[{
"order": {
"ocreated": "2021-02-10 15:37:02.440",
"omodified": "2021-02-17 09:54:04.537",
"opartner": "1111111000",
"ostatus": 7,
"oordernumber": "R0000001",
"oorderdate": "2021-02-10 15:37:02.000",
"obillingid": null,
"odeliveryid": null,
"opaymentid": null,
"oshippingid": null,
"odeliverymode": "Házhozszállítás",
"onote": "",
"message": "",
"ocreated": 0,
"oid": 1234
},
"orderitems": [
{},{...}
],
"billing": {},
"delivery": {},
"customer": {},
"payment": {},
"shipping": {}
}
]
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| ocreated | DateTime | Rendelés létrehozás | NOT NULL |
| omodified | DateTime | Rendelés módosítás | NOT NULL |
| oorderdate | DateTime | Rendelés dátum | NOT NULL |
| opartner | String | Rendelés patika azonosító | NOT NULL |
| ordernumber | String | Rendelés azonosító | NOT NULL |
| ostatus | String | Rendelés státusz | NOT NULL |
| odeliveryid | Integer | Szálíltásicím azonosító | NULL |
| obillingid | Integer | Számlázásicím azonosító | NULL |
| opaymentid | Integer | Fizetésimód azonosító | NULL |
| oshippingid | Integer | Szállításimód azonosító | NULL |
| odeliverymode | String | Szállításimód | "" |
| onote | String | Megjegyzés | "" |
| omessage | String | Megjegyzés | "" |
| ocreated | Integer | Rendelés változás | NOT NULL |
| oid | Integer | Rendelés azonosító | NOT NULL |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| bazonosito | String | Számlázási azonosító | "" |
| bfirstname | String | Vezetéknév | "" |
| blastname | String | Keresztnév | "" |
| borszag | String | Ország ISO kód | "" |
| bceg | String | Cég név | "" |
| btarsasagiforma | String | Társasági forma | 0 |
| badoszam | String | Adószám | "" |
| bhelyseg | String | Helység | "" |
| bcim | String | Cím | "" |
| birszam | String | Irányítószám | "" |
| btel | String | Telefonszám | "" |
| bemail | String | E-mail cím | "" |
| bkerulet | String | Kerület | "" |
| bkozteruletjelleg | String | Közterület jellege | "" |
| bhazszam | String | Házszám | "" |
| bepulet | String | Épület | "" |
| blepcsohaz | String | Lépcsőház | "" |
| bszintemelet | String | Szint, emelet | "" |
| bajto | String | Ajtó | "" |
| bmegjegyzes | String | Megjegyzés | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| dazonosito | String | Számlázási azonosító | "" |
| dfirstname | String | Vezetéknév | "" |
| dlastname | String | Keresztnév | "" |
| dorszag | String | Ország ISO kód | "" |
| dceg | String | Cég név | "" |
| dhelyseg | String | Helység | "" |
| dcim | String | Cím | "" |
| dirszam | String | Irányítószám | "" |
| dtel | String | Telefonszám | "" |
| demail | String | E-mail cím | "" |
| dkerulet | String | Kerület | "" |
| dkozteruletjelleg | String | Közterület jellege | "" |
| dhazszam | String | Házszám | "" |
| depulet | String | Épület | "" |
| dlepcsohaz | String | Lépcsőház | "" |
| dszintemelet | String | Szint, emelet | "" |
| dajto | String | Ajtó | "" |
| dmegjegyzes | String | Megjegyzés | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| cazonosito | String | Számlázási azonosító | "" |
| cfirstname | String | Vezetéknév | "" |
| clastname | String | Keresztnév | "" |
| cmegjegyzes | String | Megjegyzés | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| pname | String | Fizetés megnevezés | NOT NULL |
| phcid | Integer | Központi azonosító | NULL |
| ppatikaid | Integer | Patika azonosító | NOT NULL |
| pcardissuer | String | Kártya kibocsátó | "" |
| pcardnumber | String | Kártyaszám | "" |
| trxid | String | Tranzakció azonosító | "" |
| pnote | String | Tranzakció megjegyzés | "" |
| pwebhsopid | String | Webshop azonosító | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| sname | String | Szállításimód megnevezés | NOT NULL |
| shcid | Integer | Központi azonosító | NULL |
| spatikaid | Integer | Patika azonosító | NOT NULL |
| snumber | String | Szállítási szám | "" |
| sprice | Float | Szállítási ár | NOT NULL |
| snote | String | Szállítási megjegyzés | "" |
| swebhsopid | String | Webshop azonosító | "" |
| Paraméter | Típus | Leírás | Default |
|---|---|---|---|
| oiitemname | String | Termék megnevezés | NOT NULL |
| oihcid | Integer | Központi azonosító | NULL |
| oipatikaid | Integer | Patika azonosító | NOT NULL |
| oiquantity | Float | Mennyiség | NOT NULL |
| price | Float | Fogyasztói ár | NOT NULL |
| oinote | String | Megjegyzés | "" |
| oinumber | String | Webshop azonosító | "" |
curl --location --request GET 'https://mcc-web.pointer.hu/MCC/orders/modified/1588096800' \ --header 'Content-Type: application/json' \ --header 'x-api-key: API-KEY' \
$curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://mcc-web.pointer.hu/MCC/orders/modified/1588096800', 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( 'Content-Type: application/json', 'x-api-key: API-KEY' ), )); $response = curl_exec($curl); curl_close($curl);