Popis datového rozhraní k iFIS*Zásoby - Rezervační objednávky
Popis vzájemné komunikace a technický popis rozhraní
Popis datového rozhraní iFIS*Prodejna
Přenos informací o zboží z iFIS*Zásoby/Katalog zboží do externího e-Obchodu
Externí aplikace (dále e-Obchod) čerpá aktuální informace o zboží na prodejních skladech z evidence iFIS*Zásoby/Sklady/Skladové položky/10510 - Skladová karta - prodejní ceník, zpátky do iFIS*Zásoby/Výdej/Rezervační objednávky zapisuje přijaté objednávky. Všechny operace zajištuje e-Obchod pod přiděleným uživatelským účtem přes datové rozhraní databáze iFIS (Oracle DB).
Popisy datových objektů v rozhraní iFIS*Prodejna
VOBECENK Katalog zboží a prodejních cen – struktura datového objektu
| Položka | Pořadí | Datový typ | Null? | Popis položky |
|---|---|---|---|---|
| CENIDNO | 1 | NUMBER (10) | N | Interní a neměnný identifikátor skladové karty (skladové položky, zboží) |
| KARTIDNO | 2 | NUMBER (20) | Y | Číslo skladové položky, obvykle číslo čárového kódu, v případě literatury obvykle ISBN |
| NAZEV | 3 | VARCHAR2 (4000 Byte) | Y | Název skladové položky-zboží |
| NAZEV_AUTOR | 4 | VARCHAR2 (225 Byte) | Y | Autor skladové položky - vyplněno u literatury, skript apod. |
| NAZEV_NAZEV | 5 | VARCHAR2 (4000 Byte) | Y | Název skladové položky |
| DRUH | 6 | VARCHAR2 (4000 Byte) | Y | Druh zboží |
| SKUPINA | 7 | VARCHAR2 (4000 Byte) | Y | Skupina zboží |
| POLSKL | 8 | VARCHAR2 (1 Byte) | N | Skladovatelnost položky - A.. Skladovatelné položky, N..služby typu poštovné, balné |
| KATEGORIE | 9 | VARCHAR2 (10 Byte) | Y | Kategorie prodejní ceny, kategorie odběratele |
| TYP_CENY | 10 | VARCHAR2 (1 Byte) | Y | Typ prodejní ceny Z..Základní cena... |
| DAN | 11 | NUMBER (5,2) | Y | Sazba DPH |
| CENA | 12 | NUMBER (14,2) | Y | Prodejní cena bez DPH |
| CENADPH | 13 | NUMBER | Y | Prodejní cena včetně DPH |
| SKLCENA | 14 | NUMBER (16,4) | Y | Aktuální skladová cena skladové položky (průměrná pořizovací cena) |
| SKLADEM | 15 | NUMBER (10,3) | Y | Počet MJ na všech skladech |
| MJ | 16 | VARCHAR2 (10 Byte) | Y | Měrná jednotka |
| SKLAD | 17 | VARCHAR2 (30 Byte) | Y | Prodejní sklad |
| SKLADEM_SKL | 18 | NUMBER | Y | Počet MJ na prodejním skladu |
| SREZER | 19 | NUMBER | Y | Počet MJ, které jsou aktuálně zarezervované platnými objednávkami a čekají v expedičním skladu na odbavení |
| STOP_STAV | 20 | NUMBER (10,3) | Y | Minimální počet MJ na prodejním skladě |
| POPIS | 21 | VARCHAR2 (4000 Byte) | Y | Textový popis skladové položky - zboží |
| ZARUKA | 22 | VARCHAR2 (30 Byte) | Y | Záruka na zboží |
| VYROBCE | 23 | VARCHAR2 (101 Byte) | Y | Obvykle výrobce nebo dodavatel zboží |
| POL01 | 24 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL02 | 25 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL03 | 26 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL04 | 27 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL05 | 28 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL06 | 29 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL07 | 30 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL08 | 31 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL09 | 32 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL10 | 33 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL11 | 34 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| POL12 | 35 | VARCHAR2 (4000 Byte) | Y | Volitelná položka skladové karty, u různých druhů zboží se může lišit datový typ, obsah i význam uložených dat |
| DRUPIDNO | 36 | NUMBER (10) | Y | Interní identifikátor druhu zboží |
| SKUPIDNO | 37 | NUMBER (10) | Y | Interní identifikátor skupiny zboží |
| SKLIDNO | 38 | NUMBER (10) | Y | Interní identifikátor skladu |
| STR_ID | 39 | NUMBER (10) | Y | Interní identifikátor střediska, které prodejnu provozuje |
| KATOBIDNO | 40 | NUMBER (10) | Y | Interní identifikátor kategorie prodejní ceny, kategorie odběratele |
| BONUS_CENIDNO | 41 | NUMBER (10) | Y | Interní identifikátor bonusové skladové položky, která se má automaticky přičíst do objednávky |
| BONUS_POCET | 42 | NUMBER | Y | Bonusový počet MJ, který se má automaticky přičíst do objednávky |
| BONUS_CENAD | 43 | NUMBER (16,2) | Y | Bonusová cena včetně DPH za MJ, za kterou se bonusová položka automaticky přičte do objednávky |
| OBR | 44 | BLOB | Y | Náhled na zboží - obvykle fotografie ve formátu JPG nebo sken přebalu knihy, skripta apod. |
| OBRPOPIS | 45 | VARCHAR2 (225 Byte) | Y | Textový popis k náhledu na zboží |
Tab. 1 Describe datového objektu VOBECENK – Katalog zboží a prodejních cen
Podrobnější popisy k položkám objektu VOBECENK – Katalog zboží a prodejních cen
Jednoznačný identifikátor skladové položky je CENIDNO, číslo skladové karty, od kterého je odvozován čárový kód je uveden v položce KARTIDNO, cena včetně daně je pro každou kategorii prodejní ceny uvedena v položce CENAD atd. Skladové položky je potřeba vždy filtrovat s patřičnou podmínkou na SKLAD (sklidno), prodejní kategorii (katobidno). Disponibilní počet kusů na skladě je určen položkou SKLADEM_SKL minus SREZER (rezevace zboží jinými platnými objednávkami) mínus STOP_STAV (nastavené minimální počet MJ na skladové kartě). Položky POL01 až POL12 jsou implementačně závislé, mohou proto mít u různých prodejních skladů různý datový formát, obsah i význam. Náhled na zboží ve formě obrázku lze získat z položky OBR (BLOB). Seznam neskladovatelných položek (služby typu poštovné, balné atd.) včetně prodejní ceny za MJ lze ze seznamu získat podmínkou POLSKL=’N’. U každé skladové položky je uvedeno tzv. evidenční středisko (obvykle středisko, ne kterém je provozován prodejní sklad) v položce STR_ID. Zlevněné položky nebo položky v prodejních akcích lze získat dotazy přes položku TYP_CENY. Podrobnosti o zboží s bonusem (kup 1ks a k tomu dostaneš druhý zdarma apod.) lze získat dotazy přes položky TYP_CENY, BONUS_CENIDNO, BONUS_POCET a BONUS_CENAD.
VOBEZAKH Hlavičky přijatých rezervačních objednávek – struktura datového objektu
| Položka | Pořadí | Datový typ | Null? | Popis položky |
|---|---|---|---|---|
| ZAKIDNO | 1 | NUMBER (10) | N | ID přijaté rezervační objednávky |
| ODBERID | 2 | NUMBER (10) | N | ID odběratele v hlavičce objednávky |
| ODBERATEL | 3 | VARCHAR2 (101 Byte) | Y | Odběratel v hlavičce objednávky |
| KATOBIDNO | 5 | NUMBER (10) | N | ID kategorie odběratele |
| KATEGORIE | 6 | VARCHAR2 (10 Byte) | Y | Kategorie prodejní ceny - odběratele |
| TERMIN | 10 | VARCHAR2 (30 Byte) | Y | Termín dodávky |
| EJIDNO | 11 | NUMBER | Y | ID ekonomické jednotky, obvykle konstanta 1 |
| POZNAMKA | 12 | VARCHAR2 (255 Byte) | Y | Interní textová poznámka v objednávce |
| KOMENTAR | 13 | VARCHAR2 (2000 Byte) | Y | Komentář k objednávce |
| PRIJEMID | 14 | NUMBER (10) | Y | ID konečného příjemce |
| PRIJEMCE | 15 | VARCHAR2 (101 Byte) | Y | Konečný příjemce |
| DOPRAVA | 16 | VARCHAR2 (4000 Byte) | Y | Zvolený způsob dopravy |
| SMLOUVA | 17 | VARCHAR2 (10 Byte) | Y | Číslo smlouvy |
| STAV | 20 | VARCHAR2 (1 Byte) | Y | Stav objednávky |
| NSTAV | 21 | VARCHAR2 (4000 Byte) | Y | Stav objednávky - text |
| SPOZ | 22 | NUMBER | Y | Suma požadovaných MJ za celou objednávku |
| SREZ | 23 | NUMBER | Y | Suma zarezervovaných MJ za celou objednávku |
| ZDOD | 24 | NUMBER | Y | Suma již vyexpedovaných MJ za celou objednávku |
| ZNED | 25 | NUMBER | Y | Suma ještě nevyexpedovaných MJ za celou objednávku |
| CNT | 26 | NUMBER | Y | Počet objednaných položek |
| PLATNOST | 27 | VARCHAR2 (4000 Byte) | Y | Platnost objednávky |
| COBJED | 28 | VARCHAR2 (20 Byte) | Y | Číslo externí objednávky |
| CENA | 29 | NUMBER | Y | Celková cena bez DPH za celou objednávku |
| CENAD | 30 | NUMBER | Y | Celková cena včetně DPH za celou objednávku |
| 31 | VARCHAR2 (50 Byte) | Y | E-mailová adresa na odběratele | |
| TEL | 32 | VARCHAR2 (30 Byte) | Y | Telefonní kontakt na odběratele |
| IDENT_PLATBA | 33 | VARCHAR2 (30 Byte) | Y | ID transakce platební kartou |
| EXT_ID | 34 | VARCHAR2 (60 Byte) | Y | Externí jednoznačný identifikátor zákazníka v e-Obchodě |
| FIROTEXT | 36 | VARCHAR2 (2000 Byte) | Y | Odběratel - text |
Tab. 2 Describe datového objektu VOBEZAKH – Hlavičky přijatých rezervačních objednávek
Podrobnější popisy k položkám objektu VOBEZAKH – Hlavičky přijatých rezervačních objednávek Jednoznačným číslem objednávky je ZAKIDNO, celková cena objednávky je v položkách CENA (základ daně) a CENAD (cena včetně daně), číslo externí objednávky je zobrazeno v položce COBJED, v položce EXT_ID může být uložen identifikátor odběratele z E-Obchod, NSTAV určuje stav zpracování objednávky v iFIS*Prodejna.
VOBEZAKR Řádky přijatých rezervačních objednávek – struktura datového objektu
| Položka | Pořadí | Datový typ | Null? | Popis položky |
|---|---|---|---|---|
| ZAKIDNO | 1 | NUMBER (10) | N | ID přijaté rezervační objednávky |
| CENIDNO | 2 | NUMBER (10) | N | ID skladové položky zboží |
| RADKIDNO | 3 | NUMBER (10) | N | ID řádku objednávky |
| CENA | 4 | NUMBER (14,2) | N | Cena za MJ bez DPH |
| CENAD | 5 | NUMBER (14,2) | Y | Cena za MJ včetně DPH |
| SUMCENA | 6 | NUMBER | Y | Celková cena za MJ bez DPH |
| MENA | 7 | VARCHAR2 (3 Byte) | N | Měna |
| POZADAVEK | 8 | NUMBER (10,3) | N | Požadovaný počet MJ |
| REZERVACE | 9 | NUMBER (10,3) | N | Rezervovaný počet MJ |
| EXPEDICE | 10 | NUMBER (10,3) | N | Počet MJ, které byly vyexpedovány z prodejního skladu |
| DODANO | 11 | NUMBER (10,3) | N | Počet již vyskladněných MJ |
| NEDODANO | 12 | NUMBER (10,3) | N | Počet ještě nevyskladněných MJ |
Tab. 3 Describe datového objektu VOBEZAKR – Řádky přijatých rezervačních objednávek
Podrobnější popisy k položkám objektu VOBEZAKR – Řádky přijatých rezervačních objednávek
Referenční vazba na hlavičku přes položku ZAKIDNO.
Zápis přijatých rezervačních objednávek přes datové rozhraní do iFIS*Prodejna
- Pro zápis přijatých rezervačních objednávek zboží do iFIS*Prodejna je využívána databázová package PA102_EOBC, která obsahuje jednotlivé konektory (funkce). Package PA102_EOBC je součástí každého privátního schématu FIS_XX.
- Konektorem se rozumí databázová funkce, která umožňuje externí aplikaci aktivně manipulovat s daty iFIS*.
- Externí aplikace ovlivňuje prostřednictvím oprávněného uživatele chování konektoru zadáním tzv. vstupních argumentů.
- Vstupní argumenty konektorů, které mají definovány default hodnoty, jsou nepovinné.
- Argumenty, u nichž jsou uvedeny možné hodnoty, nebo odkazy na domény, nebo odkazy na jiné číselníky jsou na tyto hodnoty kontrolovány.
- Konektor kontroluje všechna databázová integritní omezení.
- Jakákoliv chyba při zpracování transakce způsobí automatické odvolání všech změn, které konektor v rámci transakce provedl.
- Databázový konektor po provedení transakce automaticky vrací tzv. výstupní argumenty. Tyto výstupní argumenty informují externí aplikaci o stavu provedené transakce. Mohou to být např. informace o správně provedené transakci, informace o jednoznačných identifikátorech nově založených záznamů v iFIS, informace o chybných vstupních argumentech, informace o porušených integritních omezeních, nebo informace o porušení jiných pravidel pro ukládání dat v iFIS*Prodejna.
- Další pravidla jsou součástí popisu příslušných konektorů (viz. dále).
