Identifikátory záznamů

Záznamy ve FlexiBee je možné identifikovat několika způsoby:

Název Poznámka Ukázka
Identifikátor FlexiBee Identifikátor přidělený aplikací FlexiBee. Přiděluje FlexiBee a nelze jej měnit. 123
Kód/Značka Uživatelské označení. Přiděleno uživatelem a je možné jej měnit v aplikaci. code:CZK
UUID Globálně unikátní náhodný identifikátor. Délka není nijak stanovena či omezena. V aplikaci jej nelze měnit. Lze měnit z externích systémů. uuid:550e8400-e29b-41d4-a716
Key Unikátní náhodný identifikátor, který přiděluje FlexiBee dokladům (atribut UUID). Nelze jej měnit. key:550e8400e29b41d4a716
PLU PLU je identifikační kód, který se používá při prodeji. Obvykle se jedná o 4- či 5místný číselný kód. plu:4020
EAN Záznam je identifikován podle kódu EAN (čárový kód). Položku ceníku je možné dohledat jak podle jejího EAN tak podle EAN jejího balení. Počet importovaných položek ceníku se v tomto případě nemění. ean:4710937332698
Externí identifikátor Identifikátor z externí aplikace. V aplikaci jej nelze měnit. Lze měnit z externích systémů. Skládá se z identifikátoru externího systému a identifikátoru řádku v tomto systému. Externí identifikátor musí být unikátní pro celou evidenci (např. faktura-vydana). ext:SHOP:123
VAT ID Identifikátor dle daňového čísla. V ČR odpovídá DIČ, v SR odpovídá IČ DPH. vatid:CZ28019920
IČ Identifikátor dle IČ. in:28019920

Díky inkrementální aktualizaci je možné libovolně připojovat další externí identifikátory k již existujícím záznamům:

<winstrom version="1.0">
  <cenik id="123">
     <id>ext:SHOP:abc</id>
     <id>ext:SYSTEM3:xyz</id>
  </cenik>
</winstrom>

Tento zápis je ekvivalentní s tímto:

<winstrom version="1.0">
  <cenik>    
     <id>123</id>
     <id>ext:SHOP:abc</id>
     <id>ext:SYSTEM3:xyz</id>
  </cenik>
</winstrom>

Interní identifikátory

Interní identifikátor (samostatné číslo) jsou identifikátory, které přiděluje systém FlexiBee. Pokud se na něj odkážete a záznam neexistuje, operace selže (na rozdíl od ostatních identifikátorů).

Pro přidělování identifikátorů je používána databázová sequence. Ta zajišťuje, že stejný identifikátor nebude nikdy přidělen dvakrát (ani když záznam smažete). Současně negarantuje číselnou návaznost (např. při rollbacku se číslo zahodí).

Vícenásobné identifikátory

Záznam je možné identifikovat také použitím několika identifikátorů zároveň:

<winstrom version="1.0">
  <cenik>
     <id>123</id>
     <id>code:CZK</id>
  </cenik>
</winstrom>

V takovém případě musí všechny identifikátory označovat tentýž záznam, jinak jde o chybu. Identifikátory, které ve FlexiBee neexistují, budou ignorovány, takže z externího systému lze poslat do FlexiBee všechny známé identifikátory a záznam bude nalezen podle těch existujících.

Více elementů id lze použít pouze v importním XML. Na jiných místech (URL v REST API, ostatní identifikátory záznamů v importním XML, ale u elementů id lze také) je potřeba používat specializovanou syntaxi: [123][code:CZK][ext:SHOP:abc].

Pokud identifikátor obsahuje znaky [, ] nebo \, je potřeba je escapovat: \[, \], \\. Při použití v URL je třeba nezapomenout také na správné zakódování URL jako takového.

Chcete si vyzkoušet REST-API na vlastní kůži? Navštivte naši demo instalaci.