eOrdering API 1.3, revízia 2022-04-13
Štruktúra

Syntax

{
  /* identifikator objednavky */
  "id": integer,
  
  /* unikatne cislo objednavky */
  "key": string,
  
  /* typ objednavky */
  "type": integer,
  
  /* autor objednávky */
  "owner": {
      /* meno */
      "name": string,
      
      /* email */
      "email": string,
  },
  
  /* stav spracovania objednavky */
  "status": integer,
  
  /* identifikacne cislo lekarne */
  "pharmacyId": integer,
  
  /* kod PZS lekarne */
  "pharmacyKey": string,
  
  /* identifikacne cislo dodavatela */
  "supplierId": integer,
  
  /* unikatny nazov dodavatela */
  "supplierUniqueName": string,
  
  /* datum vytvorenia */
  "createdAt": string,
  
  /* datum odoslania */
  "sendAt": string,
  
  /* sledovanie objednavky */
  "watch": boolean,
  
  /* datum ukoncenia sledovania objednavky */
  "watchUntil": string,
  
  /* stav sledovania */
  "watchStatus": integer,
  
  /* stav spracovania posleneho pokusu (objednavky) o vybavenie sledovanej objednavky */
  "watchLastTryStatus": integer,
  
  /* klientovo vlastne id objednavky */
  "customId": string,
  
  /* polozky objednavky */
  "items": [
    {
      /* ADC kod polozky */
      "adc": string,
	  
      /* typ zlavy */
      "discountType": integer,
	  
      /* kod polozky u dodavatela */
      "supplierCode": string,
	  
      /* nazov produktu */
      "name": string,
	  
      /* mnozstvo */
      "amount": integer,
      
      /* potvrdene mnozstvo */
      "confirmedAmount": integer,
	  
      /* stav potvrdenia polozky */
      "status": integer,
	  
      /* priznak polozky */
      "flags": integer
    }
  ]
}

Popis atribútov

id

  • Jednoznačný identifikátor objednávky.
  • Typ: integer

key

  • Unikátne "číslo objednávky". Pod týmto číslom je objednávka známa u dodávateľa.
  • Typ: string

type

  • Typ objednávky.
  • Typ: integer
  • Hodnoty:
    • 0: Objednávka cez webové služby.
    • 1: Objednávka emailom.

owner

  • Autor objednávky, respektíve zodpovedná osoba.
  • Objekt s vlastnosťami
    • name: Meno
    • email: Email

status

  • Stav spracovania objednávky.
  • Typ: integer
  • Hodnoty:
    • 0: Nová objednávka. Stav pred odoslaním.
    • 1XX
      • 100: Pripravená na odoslanie.
    • 2XX
      • 200: Odosielaná.
    • 3XX
      • 300: Potvrdená. Všetky položky boli potvrdené.
      • 301: Potvrdená. Niektoré položky boli potvrdené.
    • 4XX
      • 400: Zrušená.
    • 5XX
      • 500: Chyba pri odosielaní.
    • 6XX
      • 600: Chyba pri spracovaní dodávateľom.
      • 601: Chyba pri spracovaní dodávateľom. Neznámy zákazník.
      • 602: Chyba pri spracovaní dodávateľom. Blokovaný zákazník.
      • 603: Chyba pri spracovaní dodávateľom. Čas určený na spracovanie vypršal.
      • 604: Chyba pri spracovaní dodávateľom. Žiadna z položiek nebola potvrdená.
      • 605: Chyba pri spracovaní dodávateľom. Zákazník prekročil úverový limit.
      • 606: Chyba pri spracovaní dodávateľom. Objednávka nespĺňa dodávateľom stanovené minimálne požiadavky na množstvo alebo celkovú cenu.

pharmacyId

  • Identifikačné číslo lekárne.
  • Typ: integer

supplierId

  • Identifikačné číslo dodávateľa.
  • Typ: integer

supplierUniqueName

  • Unikátny názov dodávateľa
  • Typ: string

createdAt

  • Dátum vytvorenia objednávky.
  • Typ: datetime

sendAt

  • Dátum odoslania objednávky.
  • Typ: datetime

watch

  • Príznak sledovania objednávky "strážnym psom" (objednávka je sledovaná nastavenú dobu za účelom jej kompletného vybavenia aj v prípade nepredvídaných problémov ako sú napríklad nedostatočné množstvo na sklade, alebo výpadok služby dodávateľa).
  • Typ: boolean

watchUntil

  • Dátum a čas ukončenia sledovania objednávky.
  • Typ: datetime

watchStatus

  • Stav sledovania objednávky.
  • Typ: integer
  • Hodnoty:
    • 0: Nesledovaná objednávka.
    • 100: Sledovaná objednávka.
    • 200: Sledovanie je zastavené.

watchLastTryStatus

  • Stav spracovania posleného pokusu (objednávky) o vybavenie sledovanej objednávky (objednávka je na pozadí odosielaná ako viacero samostatných objednávok postupne až do úplného vybavenia, alebo vypršania stanoveného času).
  • Typ: integer
  • Hodnoty: (rovnaké ako status)

customId

  • Vlastné ID klienta, ktorým si môže označiť objednávku.
  • Musí byť unikátne v rámci klientových objednávok.
  • Nepovinný atribut

items

  • Pole položiek objednávky.
  • Položka:
    • adc
      • ADC kód produktu.
      • Typ: guid
    • discountType
      • Typ aplikovanej zľavy.
      • Typ: integer
      • Hodnoty:
        • 0: Žiadna zľava
        • 1: Naturálny rabat (len pokiaľ dodávateľ podporuje rabaty)
    • supplierCode
      • Kód položky u dodávateľa.
      • Typ: string
    • name
      • Názov produktu.
      • Typ: string
    • amount
      • Množstvo.
      • Typ: integer
    • confirmedAmount
      • Potvrdené množstvo.
      • Typ: integer
    • status
      • Stav potvrdenia položky.
      • Typ: integer
      • Hodnoty:
        • 0: Stav položky ešte nebol vyhodnotený.
        • 1XX
          • 100: Položka potvrdená v plnom rozsahu.
          • 101: Položka potvrdená čiastočne. Množstvo je menšie ako objednané.
          • 102: Položka nebola potvrdená. Množstvo je 0.
        • 2XX
          • 200: Pri objednávaní položky nastala nešpecifikovaná chyba.
          • 201: Nenájdená položka.
          • 202: Nepovolený predaj nešpecifikovaný.
          • 203: Nepovolený predaj alkoholu.
          • 204: Nepovolený predaj liekov.
          • 205: Nepovolený predaj opiátov.
          • 206: Nepovolený predaj pre lekáreň.
          • 207: Nepovolený predaj prekurzorov.
          • 208: Neznámy alebo nepovolený rabat.
        • 3XX
          • 300: Položka nebola v odpovedi nájdená.
    • flags
      • Príznaky položky.

Flags - príznaky položky

Bit Názov Popis
20 Položka zaradená do objednávky na strane dodávateľa. Položka bola zaradená do objednávky dodávateľom.

Príklad objednávky

{
    "id": 4112,
    "key": "AAA303220003",
    "type": 1,
    "owner": {
        "name": "PharmINFO",
        "email": "info@pharminfo.sk"
    },
    "status": 300,
    "pharmacyId": 1088,
    "supplierId": 7,
    "supplierUniqueName": "PI",
    "createdAt": "2013-03-22T13:02:53.697Z",
    "sendAt": "2013-03-21T23:00:00Z",
    "watch": false,
    "watchStatus": 0,
    "customId": "RR78GHx79-2013-11-07",
    "items": [
        {
            "adc": "2877d8e9-2737-4598-beab-6d2a9947215b",
            "discountType": 0,
            "supplierCode": "004819",
            "name": "PANADOL BABY",
            "amount": 10,
            "confirmedAmount": 10,
            "status": 100,
            "flags": 0
        }
    ]
}