Pomocí kusovníku lze ve Flexi nastavit obsah a strukturu materiálu, ze kterého se výrobek či polotovar skládá. Konkrétní principy a možnosti nastavení popisuje dokumentace k nastavení v aplikaci ABRA Flexi.

V této dokumentaci se však podíváme na to, jak s kusovníkem pracovat v REST API.

Založení kusovníku (POST / PUT)

Kusovník můžeme založit metodou POST nebo PUT na URL endpoint /kusovnik. Dostupné pole endpointu (resp. evidence) naleznete v tzv. evidence-listu.

Jeden záznam kusovníku je vždy hlavičku kusovníku (výrobek / polotovar) nebo jeden materiál (jinak taky řádka, uzel), který pro hlavičku kusovníku vytváříte.

Na příklad si však ukážeme, jak založit kusovník pro jednu položku pouze s poli nezbytnými pro založení. Řada polí dostupných v evidenci je totiž nepovinná.

Pole vyplněná níže v requestu pro založení jsou povinná.

Příklad

Chceme založit kusovník pro výrobu předního kola, zároveň však i hlavičku a materiál v něm obsažený. Vše tedy zahrneme do jednoho requestu.

XML

POST / PUT na https://demo.flexibee.eu/c/kusovnik.xml

<winstrom version="1.0">
	<kusovnik>
		<id>ext:KUS:1</id>
		<mnoz>1.0</mnoz>
		<hladina>1</hladina>
		<poradi>1</poradi>
		<cesta>1/</cesta>
		<otecCenik>code:PŘEDNÍ_KOLO</otecCenik>
		<cenik>code:PŘEDNÍ_KOLO</cenik> <!-- Jedná se o hlavičku kusovníku, shodný s otecCenik-->
		<otec></otec> <!-- Prázdný, jedná se o hlavičku-->
	</kusovnik>
	<kusovnik>
		<id>ext:KUS:2</id>
		<mnoz>1.0</mnoz>
		<hladina>2</hladina>
		<poradi>1</poradi>
		<cesta>1/1/</cesta>
		<otecCenik>code:PŘEDNÍ_KOLO</otecCenik>
		<cenik>code:RÁFEK</cenik>
		<otec>ext:KUS:1</otec>
	</kusovnik>
	<kusovnik>
		<id>ext:KUS:3</id>
		<mnoz>32.0</mnoz>
		<hladina>2</hladina>
		<poradi>2</poradi>
		<cesta>1/2/</cesta>
		<otecCenik>code:PŘEDNÍ_KOLO</otecCenik>
		<cenik>code:DRÁTY</cenik>
		<otec>ext:KUS:1</otec>
	</kusovnik>
	<kusovnik>
		<id>ext:KUS:4</id>
		<mnoz>1.0</mnoz>
		<hladina>2</hladina>
		<poradi>3</poradi>
		<cesta>1/3/</cesta>
		<otecCenik>code:PŘEDNÍ_KOLO</otecCenik>
		<cenik>code:STŘED</cenik>
		<otec>ext:KUS:1</otec>
	</kusovnik>
</winstrom>

JSON

{
   "winstrom":{
      "@version":"1.0",
      "kusovnik":[
         {
            "id":"ext:KUS:1",
            "mnoz":"1.0",
            "hladina":"1",
            "poradi":"1",
            "cesta":"1/",
            "otecCenik":"code:PŘEDNÍ_KOLO",
            "cenik":"code:PŘEDNÍ_KOLO",
            "otec":""
         },
         {
            "id":"ext:KUS:2",
            "mnoz":"1.0",
            "hladina":"2",
            "poradi":"1",
            "cesta":"1/1/",
            "otecCenik":"code:PŘEDNÍ_KOLO",
            "cenik":"code:RÁFEK",
            "otec":"ext:KUS:1"
         },
         {
            "id":"ext:KUS:3",
            "mnoz":"32.0",
            "hladina":"2",
            "poradi":"2",
            "cesta":"1/2/",
            "otecCenik":"code:PŘEDNÍ_KOLO",
            "cenik":"code:DRÁTY",
            "otec":"ext:KUS:1"
         },
         {
            "id":"ext:KUS:4",
            "mnoz":"1.0",
            "hladina":"2",
            "poradi":"3",
            "cesta":"1/3/",
            "otecCenik":"code:PŘEDNÍ_KOLO",
            "cenik":"code:STŘED",
            "otec":"ext:KUS:1"
         }
      ]
   }
}

Získání kusovníku (GET)

Metodou GET můžeme exportovat všechny vytvořené kusovníky, hlavičky i jednotlivý materiál v kusovníku obsažený.

Příklad

Chceme získat výše založený kusovník, tedy kompletní kusovník pro ceníkovou položku s kódem "PŘEDNÍ_KOLO".

Libovolně lze použít filtrace (v URL / query), úroveň detailu nebo jiný z podporovaných formátů.

XML

GET na /kusovnik/(otecCenik='code:PŘEDNÍ_KOLO').xml?detail=full

Příklad kompletní URL adresy:

https://demo.flexibee.eu/c/flexi/kusovnik/(otecCenik='code:PŘEDNÍ_KOLO').xml?detail=full

JSON

GET na /kusovnik/(otecCenik='code:PŘEDNÍ_KOLO').json?detail=full

Příklad kompletní URL adresy:

https://demo.flexibee.eu/c/flexi/kusovnik/(otecCenik='code:PŘEDNÍ_KOLO').json?detail=full

Přepočet cen kusovníku

Hodnotu výrobku (položky, kde je nastaven kusovník) lze přepočítávat z cen materiálu, popř. služeb (obecně položek, které jsou v kusovníku nastaveny).

Veškerý postup je popsán v naší dokumentaci.