FORMAT: 1A HOST: https://dealer.penta.cz/i6ws
Penta CZ webservice
PENTA CZ webservice (known also as i6ws) is a SOAP based API for communicating with PENTA CZ company such as:
- downloading product data
- creating B2B and dropshipment orders
- getting information about orders
- downloading invoices
- getting fullfilment data
- many others
The main API is based on standard solution from Cybersoft s.r.o. company plus there are some endpoints prepared just for PENTA.
For first you need the credentials which will be provided by your seller.
PENTA CZ together with PENTA SK have several endpoints. Use the one matching the B2B portal where you make orders:
- for Czech Republic - portal https://dealer.penta.cz use endpoint https://dealer.penta.cz/i6ws
- for Slovak Republic - portal https://dealer.pentask.sk use endpoint https://dealer.pentask.sk/i6ws
- for Poland - portal http://dealer.epenta.pl use endpoint http://dealer.epenta.pl/i6ws
- for Hungary - portal https://dealer.epenta.hu use endpoint https://www.epenta.hu/i6ws
- for Slovenia - use endpoint https://www.epenta.si/i6ws
When you buy from another country contact, please, your seller.
If you have some technical question contact us on system@penta.cz (CZ/SK/EN).
Changelog
- 2025-05-05 - Added X-StoItemDelivCostBasket export
- 2025-02-27 - Added X-StoItemDelivCost export
- 2025-01-16 - Change value in fields PriceEU, PriceDea - suggested retail price instead of our end custommer retail price
Data exports/feeds
Basic information
Autentication
All of the i6ws exports are provided after initial authentication.
There is basic authentication, so you will use the credential like this: https://USER:PASSWORD@i6wsURL.
Or use them base64 encoded in request headers like in the example:
StoItemBase [GET]
Request
Headers
Authorization: Basic ABCDEF
Example
If you use Czech i6ws, your base URL is https://USER:PASSWORD@dealer.penta.cz/i6ws
Export methods
There are available 3 main export methods which you can use:
1. GetResult
API returns data for all ids
2. ByCode
API returns data for specified id
3. ByFromTo
API returns data for specified interval
Time restrictions
There are used time restrictions for exports due to huge amount of data. You can find all time restrictions for each export type in "Available exports" section.
We can also adjust the time restrictions for you for necessary time during your implementation process. In that case write an email to system@penta.cz.
Available exports
All available exports with export types and time restrictions are available at https://USER:PASSWORD@i6wsURL/ResultTypeInfo.ashx.
Example
If you use Czech i6ws, the URL will be https://USER:PASSWORD@dealer.penta.cz/i6ws/ResultTypeInfo.ashx
ResultTypeInfo table explanation:
ResultType - Export name
- used as argument for resultType
Schema - Link provides schema detailed schema with required returned fields
GetResult - Information about time restrictions for method GetResult. You can use this method for black values only.
ByCode - Information about time restrictions for method GetResultByCode. You can use this method for black values only.
ByFromTo - Information about time restrictions for method GetResultByFromTo. You can use this method for black values only.
- If all values are grey, method is not implemented (cannot be used)
- If there are some grey values in |Allowed days of week| method cannot be used in these days
- If there are some grey values in |Allowed hours| method cannot be used in these hours - for example method GetResult for export StoItemBase can be used only from 8 p.m. to 8 a.m.
Description
You can use for most exports 2 schema types:
- standard - values are exported as parameters of main tag
- _el - values are in their own tags
Most used exports with examples
Here are some of the most used exports with explanation and examples. The documentation of all endpoint is provided on https://USER:PASSWORD@i6wsURL/Default.asmx or https://USER:PASSWORD@i6wsURL/ResultTypeInfo.ashx
StoItemBase [GET]
This is the base export with all base product data. Downloading export with method GetResult is enabled only from 8 p.m. to 8 a.m. When you need fresh data about prices or quantity in stock during the day, see StoItemQtyFree and StoItemPriceOrd exports.
Example URL for this export and method "GetResult" will be https://USER:PASSWORD@dealer.penta.cz/i6ws/Default.asmx/GetResult?resultType=StoItemBase. For method GeResultByCode for product 6390305 will be URL https://USER:PASSWORD@dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=StoItemBase&code=6390305.
Response 200 (text/xml)
<Result UrlBase="http://dealer.penta.cz/default.asp?cls=stoitem&stiid=" UrlBaseThumbnail="http://dealer.penta.cz/img.asp?attname=thumbnail&attpedid=52&attsrcid=" UrlBaseImg="http://dealer.penta.cz/img.asp?stiid=" UrlBaseEnlargement="http://dealer.penta.cz/img.asp?attname=enlargement&attpedid=52&attsrcid=" UrlBaseImgGalery="http://dealer.penta.cz/img.asp?attid=" CouCode="CZ" TaxRateLow="12" TaxRateHigh="21"> <StoItem Id="119584" Code="6390305" Code2="KYQ-31ST" PartNo="GAH-3ED" PartNo2="8595627405861" EAN="8595627405861" Name="Plynový gril G21 California BBQ Premium line 4 hořáky + zdarma redukční ventil" NameSeo="g21-california-bbq" ManName="G21" CouCode="CN" PriceEU="7429.7500" PriceDea="7429.7500" PriceOrd="7429.7500" PriceRef="0.0000" PriceRef2="0.0000" QtyFree="21" TaxRate="21.0000" CutCode="73211190" WarDur="744" WarDurEU="744" Weight="42.50000" ScaId="3147" ThumbnailIs="1" ThumbnailSize="6251" ImgIs="1" ImgSize="20466" EnlargementIs="1" EnlargementSize="513305" SisName="Doporučujeme" NoteShort="Nerezový plynový gril G21 California BBQ Premium Line s litinovým roštem, litinovým plátem, elektrickým zapalováním, plynovou regulací, s bočním hořákem o výkonu 3,15 kW a 3 hlavními hořáky, každý o maximálním výkonu 3,5 kW, systém Flame Tamer." StiDemIdDis="99,100,211,212" Note="Nerezový plynový gril G21 California BBQ Premium Line s litinovým roštem, litinovým plátem, elektrickým zapalováním, plynovou regulací, s bočním hořákem o výkonu 3,15 kW a 3 hlavními hořáky, každý o maximálním výkonu 3,5 kW, systém Flame Tamer."> <ImgGal Id="11165164" Name="Image1" Tag="sys-gal-enl" Sort="1" Size="425931" /> <ImgGal Id="11165165" Name="Image1" Tag="sys-gal-enl" Sort="2" Size="510324" /> <ImgGal Id="11165166" Name="Image1" Tag="sys-gal-enl" Sort="3" Size="591620" /> <ImgGal Id="11165167" Name="Image1" Tag="sys-gal-enl" Sort="4" Size="533422" /> <ImgGal Id="11165168" Name="Image1" Tag="sys-gal-enl" Sort="5" Size="652582" /> <ImgGal Id="11750209" Name="Image1" Tag="sys-gal-thu" Sort="1" Size="2882" /> <ImgGal Id="11750210" Name="Image1" Tag="sys-gal-thu" Sort="2" Size="3417" /> <ImgGal Id="11750211" Name="Image1" Tag="sys-gal-thu" Sort="3" Size="4214" /> <ImgGal Id="11750212" Name="Image1" Tag="sys-gal-thu" Sort="4" Size="3539" /> <ImgGal Id="11750213" Name="Image1" Tag="sys-gal-thu" Sort="5" Size="4048" /> </StoItem> </Result>
#### Explanation
##### Don't forget to replace char \& to &
- UrlBase - product detail page
- We don't publish complete url of products or images. We give you the database id which you can use to prepare the links yourself
- For example - for product 6390305 url will be http://dealer.penta.cz/default.asp?cls=stoitem&stiid=119584
- UrlBaseImg - for main image
- use Id from tag <StoItem>
- For example - for product 6390305 url will be http://dealer.penta.cz/img.asp?stiid=119584
- UrlBaseThumbnail - thumbnail of main image
- use value from tag Id
- For example - for product 6390305 url will be http://dealer.penta.cz/img.asp?attname=thumbnail&attpedid=52&attsrcid=119584
- UrlBaseEnlargement - large main image
- use value from tag Id
- For example - for product 6390305 url will be http://dealer.penta.cz/img.asp?attname=enlargement&attpedid=52&attsrcid=119584
- UrlBaseImgGalery - image from gallery - from tag <ImgGal>
- use Id from tag <ImgGal>
- there are 2 types of image - There is value in field Tag in <ImgGal> which specifies image type
- for main image find images with Tag="sys-gal-enl"
- for thumbnail find and use Id with Tag="sys-gal-thu"
- CouCode - Country Code
- TaxRateLow - Lower tax rate value
- TaxRateHigh - Standard tax rate value
<StoItem> - main product info
- Id - database ID - used in other exports
- Code - product code - main identification of the product
- Code2 - alternative identification of the product
- PartNo - manufacturer code
- PartNo2 - EAN code -- deprecated
- EAN - EAN code
- Name - product name
- NameSeo - name for SEO
- ManName - manufacturer
- CouCode - country of origin
- PriceEU - suggested retail price without tax
- PriceDea - suggested retail price without tax
- PriceOrd - ordering price
- PriceRef - recycling fee without tax
- PriceRef2 - author fee without tax
- QtyFree - actual information about pieces in stock
- TaxRate - tax rate
- CutCode - customs code
- WarDur - warranty duration in days
- WarDurEU - warranty duration for end custommer - if not specified use value from WarDur
- Weight - weight without packaging
- ScaId - our identification of manufacturer
- SisName - flag
- NoteShort - short note
- Note - long formatted note
- StiXXL - oversized product, cannot be sent as standard package
StoItemQtyFree [GET]
This export is usable to get actual warehouse info during the whole day. Data are generated on demand. Export with method GetResult is enabled during the whole day.
Example response is for URL https://dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=StoItemQtyFree&code=6390305
Response 200 (text/xml)
<Result> <StoItem Id="119584" Code="6390305" Code2="KYQ-31ST" PartNo="GAH-3ED" PartNo2="8595627405861" EAN="8595627405861" QtyFree="21"/> </Result> #### Explanation - QtyFree - this is actual quantity in stock - if the field is missing => quantity is 0 - sold out - other fields are same as in StoItemBase
StoItemPriceOrd [GET]
This export is usable to get actual selling prices during the whole day. Data are generated on demand. Export with method GetResult is enabled during the whole day.
Example response is for URL https://dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=StoItemPriceOrd&code=6390305
Response 200 (text/xml)
<Result> <StoItem Id="119584" Code="6390305" Code2="KYQ-31ST" PartNo="GAH-3ED" PartNo2="8595627405861" EAN="8595627405861" PriceOrd="7429.7500" PriceEU="7429.7500" PriceRef="0.0000" PriceRef2="0.0000" TaxRate="21.0000" /> </Result> #### Explanation - fields are same as in StoItemBase
StoItemShoptet_El [GET]
This export is in Shoptet style and can be used for eshops (not only) based on Shoptet platform
- Response 200 (text/xml)
<SHOP>
<SHOPITEM>
<CODE>6390305</CODE>
<EAN>8595627405861</EAN>
<PART_NUMBER>GAH-3ED</PART_NUMBER>
<NAME>Plynový gril G21 California BBQ Premium line 4 hořáky + zdarma redukční ventil</NAME>
<MANUFACTURER>G21</MANUFACTURER>
<SHORT_DESCRIPTION>Nerezový plynový gril G21 California BBQ Premium Line s litinovým roštem, litinovým plátem, elektrickým zapalováním, plynovou regulací, s bočním hořákem o výkonu 3,15 kW a 3 hlavními hořáky, každý o maximálním výkonu 3,5 kW, systém Flame Tamer.</SHORT_DESCRIPTION>
<DESCRIPTION>Long description.........</DESCRIPTION>
<WARRANTY>24</WARRANTY>
<ITEM_TYPE>product</ITEM_TYPE>
<UNIT>ks</UNIT>
<PRICE>7429.75</PRICE>
<STANDARD_PRICE>7429.75</STANDARD_PRICE>
<PURCHASE_PRICE>7429.75</PURCHASE_PRICE>
<VAT>21</VAT>
<PRICE_VAT>8990.00</PRICE_VAT>
<CURRENCY>CZK</CURRENCY>
<LOGISTIC>
<WEIGHT>42.50000</WEIGHT>
</LOGISTIC>
<STOCK>
<AMOUNT>21.000</AMOUNT>
</STOCK>
<AVAILABILITY>skladem</AVAILABILITY>
<CATEGORIES>
<CATEGORY>Dle výrobce > G21 > Zahrada > Grily > Plynové grily</CATEGORY>
<CATEGORY>Produkt G21 > Zahrada > Grily a ohniště</CATEGORY>
<CATEGORY>Koncový shop I6 > Zahrada > Grily > Plynové grily</CATEGORY>
<CATEGORY>Produkt G21 i6 > Zahrada > Grily G21 > Plynové grily G21</CATEGORY>
<CATEGORY>Koncovy shop I6 (reklamni) > TOP produkty z recenzí</CATEGORY>
<CATEGORY>Koncový shop HU i6 > Zahrada > Grily > Plynové grily</CATEGORY>
<CATEGORY>Koncový shop PL i6 > Zahrada > Grily > Plynové grily</CATEGORY>
<CATEGORY>Produkt G21-vitality i6 > Zahrada > Grily > Plynové grily</CATEGORY>
</CATEGORIES>
<IMAGES>
<IMAGE>https://dealer.penta.cz/img.asp?attid=13516001</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165164</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165165</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165166</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165167</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165168</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165169</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165170</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165171</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165172</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165173</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=11165174</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=13109546</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=13109547</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=13109548</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19832971</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19832975</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19832979</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19832983</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19832988</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19832996</IMAGE>
<IMAGE>https://dealer.penta.cz/img.asp?attid=19833001</IMAGE>
</IMAGES>
<TEXT_PROPERTIES>
<TEXT_PROPERTY>
<NAME>Hmotnost (kg)</NAME>
<VALUE>41</VALUE>
</TEXT_PROPERTY>
<TEXT_PROPERTY>
<NAME>Flag - Doporučujeme</NAME>
<VALUE>Koncový shop Penta</VALUE>
</TEXT_PROPERTY>
<TEXT_PROPERTY>
<NAME>Materiál</NAME>
<VALUE>nerezová ocel</VALUE>
</TEXT_PROPERTY>
<TEXT_PROPERTY>
<NAME>Flag - Prodloužená záruka</NAME>
<VALUE>Záruka 4 roky</VALUE>
</TEXT_PROPERTY>
</TEXT_PROPERTIES>
<FLAGS>
<ACTION>0</ACTION>
<NEW>0</NEW>
<TIP>0</TIP>
</FLAGS>
</SHOPITEM>
</SHOP>
StoItemShop_El [GET]
This export is similar to StoItemShoptet_El but is universal and contains more information
Response 200 (text/xml)
<SHOP> <SHOPITEM ID="119584"> <CODE>6390305</CODE> <EAN>8595627405861</EAN> <PART_NUMBER>GAH-3ED</PART_NUMBER> <NAME>Plynový gril G21 California BBQ Premium line 4 hořáky + zdarma redukční ventil</NAME> <MANUFACTURER>G21</MANUFACTURER> <SHORT_DESCRIPTION>Nerezový plynový gril G21 California BBQ Premium Line s litinovým roštem, litinovým plátem, elektrickým zapalováním, plynovou regulací, s bočním hořákem o výkonu 3,15 kW a 3 hlavními hořáky, každý o maximálním výkonu 3,5 kW, systém Flame Tamer.</SHORT_DESCRIPTION> <DESCRIPTION></DESCRIPTION> <WARRANTY>24</WARRANTY> <ITEM_TYPE>product</ITEM_TYPE> <UNIT>ks</UNIT> <PRICE>7429.75</PRICE> <STANDARD_PRICE>7429.75</STANDARD_PRICE> <PURCHASE_PRICE>7429.75</PURCHASE_PRICE> <VAT>21</VAT> <PRICE_VAT>8990.00</PRICE_VAT> <PURCHASE_PRICE_VAT>8125.15</PURCHASE_PRICE_VAT> <CURRENCY>CZK</CURRENCY> <LOGISTIC> <WEIGHT>42.50000</WEIGHT> </LOGISTIC> <STOCK> <AMOUNT>21.000</AMOUNT> </STOCK> <AVAILABILITY>skladem</AVAILABILITY> <CATEGORIES> <CATEGORY ID="56454">Dle výrobce > G21 > Zahrada > Grily > Plynové grily</CATEGORY> <CATEGORY ID="39389">Produkt G21 > Zahrada > Grily a ohniště</CATEGORY> <CATEGORY ID="56254">Koncový shop I6 > Zahrada > Grily > Plynové grily</CATEGORY> <CATEGORY ID="55517">Produkt G21 i6 > Zahrada > Grily G21 > Plynové grily G21</CATEGORY> <CATEGORY ID="71915">Koncovy shop I6 (reklamni) > TOP produkty z recenzí</CATEGORY> <CATEGORY ID="63549">Koncový shop HU i6 > Zahrada > Grily > Plynové grily</CATEGORY> <CATEGORY ID="73546">Koncový shop PL i6 > Zahrada > Grily > Plynové grily</CATEGORY> <CATEGORY ID="71027">Produkt G21-vitality i6 > Zahrada > Grily > Plynové grily</CATEGORY> <DEFAULT_CATEGORY ID="56454">Dle výrobce > G21 > Zahrada > Grily > Plynové grily</DEFAULT_CATEGORY> </CATEGORIES> <IMAGES> <IMAGE>https://dealer.penta.cz/img.asp?attid=13516001</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165164</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165165</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165166</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165167</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165168</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165169</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165170</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165171</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165172</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165173</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=11165174</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=13109546</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=13109547</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=13109548</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19832971</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19832975</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19832979</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19832983</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19832988</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19832996</IMAGE> <IMAGE>https://dealer.penta.cz/img.asp?attid=19833001</IMAGE> </IMAGES> <TEXT_PROPERTIES> <TEXT_PROPERTY> <NAME>Hmotnost (kg)</NAME> <VALUE>41</VALUE> </TEXT_PROPERTY> <TEXT_PROPERTY> <NAME>Flag - Doporučujeme</NAME> <VALUE>Koncový shop Penta</VALUE> </TEXT_PROPERTY> <TEXT_PROPERTY> <NAME>Materiál</NAME> <VALUE>nerezová ocel</VALUE> </TEXT_PROPERTY> <TEXT_PROPERTY> <NAME>Flag - Prodloužená záruka</NAME> <VALUE>Záruka 4 roky</VALUE> </TEXT_PROPERTY> </TEXT_PROPERTIES> <FLAGS> <ACTION>0</ACTION> <NEW>0</NEW> <TIP>0</TIP> </FLAGS> </SHOPITEM> </SHOP>
X-SipPriceSTORECurAll [GET]
There are recommended retail prices for european countries with their VAT. Currently there are recommended prices for:
- Czech Republic
- Slovakia
- Hungary
Example response bellow is for request dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=X-SipPriceSTORECurAll&code=6390305
Response 200 (text/xml)
<Result> <StoItem Id="119584" Code="6390305" SipPriceSTORETotVatCZK="8990.0000" SipPriceSTORETotVatEUR="360.9000" SipPriceSTORETotVatHUF="151900.0000" SipPriceSTORETotVatEUR_SI="363.9000"/> </Result>
Explanation
- SipPriceSTORETotVatCZK - final rounded price with 21% VAT, recycling and author fees in CZK
- could be used for Czech Republic
- SipPriceSTORETotVatEUR - final rounded price with 20% VAT, recycling and author fees in EUR
- could be used for all countries with EUR with 20% VAT rate like Slovakia
- SipPriceSTORETotVatHUF - final rounded price with 27% VAT, recycling and author fees in HUF
- could be used for Hungary
- SipPriceSTORETotVatEUR_SI - final rounded price with 22% VAT, recycling and author fees in EUR
- could be used for all countries with EUR with 22% VAT rate like Slovenia
X-StoItemInternalPart [GET]
There are specified integral parts together with free gifts in this export. Integral parts are products which you have to buy together with the main product, for example non-standard pallet
Example response bellow is for request https://dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=X-StoItemInternalPart&code=635545
Response 200 (text/xml)
<Result> <StoItem> <Id>206413</Id> <Code>635545</Code> <Name>Solární panel G21 MCS LINUO SOLAR 450W mono, hliníkový rám</Name> <IntegralPart> <Id>207429</Id> <Code>PAL-215</Code> <Name>Paleta 80x215</Name> <PriceOrd>661.0000</PriceOrd> <TaxRate>21.0000</TaxRate> <PriceOrdTot>799.8100</PriceOrdTot> <EachPiece>0</EachPiece> </IntegralPart> </StoItem> </Result>Explanation
- StoItem
- Id - Main product ID - belongs to Id in StoItemBase
- Code - Main product code
- Name - Main product name
- IntegralPart - Part with related product, you cannot buy the main product without this related product - could be more integral parts for 1 main product
- Id - Related product ID - belongs to Id in StoItemBase export - related products don't have to be exported in StoItemBase export
- Code - Related product code
- Name - Related product name - for better identification
- PriceOrd - Base price without VAT which will be added to the order
- TaxRate - Related product tax rate
- PriceRef - optinally - recycling fee without tax
- PriceRef2 - optionally - author fee without tax
- PriceOrdTot - Related product price with VAT, recycling and autor fees included
- EachPiece - There are only 2 possible values:
- 0 - means there is 1 piece or related product added to main product - For example 10 pieces of main product = still 1 related product
- 1 - means number of related products belongs to number of main product pieces - For example 10 pieces of main product = 10 pieces of the related product
- StoItem
For pallets you can alternatively use XLSX or CSV export which is generated once a day
Czech Republic
https://datastore.penta.cz/export/pallets/pallets_dealer_penta_cz.xlsx https://datastore.penta.cz/export/pallets/pallets_dealer_penta_cz.csv
export from Czech Republic to other countries
https://datastore.penta.cz/export/pallets/pallets_penta_export.xlsx https://datastore.penta.cz/export/pallets/pallets_penta_export.csv
Slovak Republic
https://datastore.penta.cz/export/pallets/pallets_dealer_penta_sk.xlsx https://datastore.penta.cz/export/pallets/pallets_dealer_penta_sk.csv
Hungary
https://datastore.penta.cz/export/pallets/pallets_dealer_penta_hu.xlsx https://datastore.penta.cz/export/pallets/pallets_dealer_penta_hu.csv
X-StoItemDelivCost [GET]
You find delivery expences in this export. Both methods (GetResult and GetResultByCode) are allowed. There is calculated the cheapest delivery method for specified delivery type (parcel shops and boxes, packages and pallets) for specified bussiness type (B2B or dropshipment)
Example response bellow is for request https://dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=X-StoItemDelivCost&code=60022123
Response 200 (text/xml)
<Result> <StoItem Id="153019" Code="60022123" StiCode2="KXN-1157 " PartNo="KXN-1157SZ" PartNo2="8595627410070" EAN="8595627410070" Name="Láhev G21 na smoothie/juice, 600 ml, šedá-zmrzlá"> <Deliv App="B2B" Typ="BOX" Cod="0" DemId="292" DemName="Balíkovna" DemPrc="41.0000" DemPrcTot="49.6100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="66.0000" PrcTot="79.8600" /> <Deliv App="B2B" Typ="BOX" Cod="1" DemId="197" DemName="Zásilkovna - dobírka" DemPrc="55.0000" DemPrcTot="66.5500" PawPrc="15.7000" PawPrcTot="19.0000" ManPrc="25.0000" ManPrcTot="30.2500" Prc="95.7000" PrcTot="115.8000" /> <Deliv App="B2B" Typ="PAL" Cod="0" DemId="237" DemName="Toptrans" DemPrc="161.0000" DemPrcTot="194.8100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="186.0000" PrcTot="225.0600" /> <Deliv App="B2B" Typ="PAL" Cod="1" DemId="238" DemName="Toptrans - dobírka" DemPrc="161.0000" DemPrcTot="194.8100" PawPrc="40.5000" PawPrcTot="49.0100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="226.5000" PrcTot="274.0700" /> <Deliv App="B2B" Typ="PCK" Cod="0" DemId="50" DemName="Balíkovna na adresu" DemPrc="51.0000" DemPrcTot="61.7100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="76.0000" PrcTot="91.9600" /> <Deliv App="B2B" Typ="PCK" Cod="1" DemId="51" DemName="Balíkovna na adresu - dobírka" DemPrc="51.0000" DemPrcTot="61.7100" PawPrc="40.5000" PawPrcTot="49.0100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="116.5000" PrcTot="140.9700" /> <Deliv App="B2C" Typ="PAL" Cod="0" DemId="237" DemName="Toptrans" DemPrc="161.0000" DemPrcTot="194.8100" ManPrc="100.0000" ManPrcTot="121.0000" Prc="261.0000" PrcTot="315.8100" /> <Deliv App="B2C" Typ="PAL" Cod="1" DemId="238" DemName="Toptrans - dobírka" DemPrc="161.0000" DemPrcTot="194.8100" PawPrc="40.0000" PawPrcTot="48.4000" ManPrc="100.0000" ManPrcTot="121.0000" Prc="301.0000" PrcTot="364.2100" /> <Deliv App="B2C" Typ="PCK" Cod="0" DemId="165" DemName="GLS" DemPrc="95.0000" DemPrcTot="114.9500" ManPrc="20.0000" ManPrcTot="24.2000" Prc="115.0000" PrcTot="139.1500" /> <Deliv App="B2C" Typ="PCK" Cod="1" DemId="269" DemName="GLS - dobírka" DemPrc="95.0000" DemPrcTot="114.9500" PawPrc="40.0000" PawPrcTot="48.4000" ManPrc="20.0000" ManPrcTot="24.2000" Prc="155.0000" PrcTot="187.5500" /> </StoItem> </Result>Explanation
- StoItem
- Id - Main product ID - belongs to Id in StoItemBase
- Code - Main product code
- StiCode2 - Alternative code
- PartNo - Part number
- PartNo2 - Alternative part number
- EAN - EAN
- Name - Main product name
- Deliv - Each tag is best delivery for specified parameters
- App
- B2B
- B2C (means dropshipment)
- Typ - Delivery type
- BOX = parcelshops and boxes
- PCK = home delivery
- PAL = pallet
- Cod - Cash on delivery service
- DemId - Delivery ID which should be used in Order request to get the best delivery price
- DemName - Delivery name
- DemPrc - Delivery fee without VAT
- DemPrcTot - Delivery fee with VAT
- PawPrc - COD fee without VAT
- PawPrcTot - COD fee with VAT
- ManPrc - Manipulation fee without VAT
- ManPrcTot - Manipulation fee with VAT
- Prc - Total delivery fee with COD and manipulation fee included without VAT
- PrcTot - Total delivery fee with COD and manipulation fee included with VAT
- App
- StoItem
X-StoItemDelivCostBasket [GET]
You find delivery fees for the entered combination in this export.
Only GetResultByCode method is allowed.
There is calculated the cheapest delivery method for specified delivery type (parcel shops and boxes, packages and pallets) for specified bussiness type (B2B or dropshipment)
You need to specify the combination of the products and the quantity in the export URL. Delimiter between products is TAB. The full syntax is: https://dealer.penta.cz/i6ws/Default.asmx/GetResultByCode?resultType=X-StoItemDelivCostBasket&code= + qty*product_codeTABqty*product_code...
For example - product 1x 6390305 + 2x 60022123 - export URL will be:
Response 200 (text/xml)
<Result> <StoItem Qty="1 2" Code="6390305 60022123" StiCode2="KYQ-31ST KXN-1157 " PartNo="GAH-3ED KXN-1157SZ" PartNo2="8595627405861 8595627410070" EAN="8595627405861 8595627410070" Name="Plynový gril G21 California BBQ Premium line 4 hořáky + zdarma redukční ventil Láhev G21 na smoothie/juice, 600 ml, šedá-zmrzlá"> <Deliv App="B2B" Typ="PAL" Cod="0" DemId="186" DemName="GEIS KAT B2B" DemPrc="475.0000" DemPrcTot="574.7500" ManPrc="25.0000" ManPrcTot="30.2500" Prc="500.0000" PrcTot="605.0000"/> <Deliv App="B2B" Typ="PAL" Cod="1" DemId="187" DemName="GEIS KAT B2B - dobírka" DemPrc="475.0000" DemPrcTot="574.7500" PawPrc="40.5000" PawPrcTot="49.0100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="540.5000" PrcTot="654.0100"/> <Deliv App="B2B" Typ="PCK" Cod="0" DemId="50" DemName="Balíkovna na adresu" DemPrc="0.0000" DemPrcTot="0.0000" ManPrc="25.0000" ManPrcTot="30.2500" Prc="25.0000" PrcTot="30.2500"/> <Deliv App="B2B" Typ="PCK" Cod="1" DemId="51" DemName="Balíkovna na adresu - dobírka" DemPrc="0.0000" DemPrcTot="0.0000" PawPrc="40.5000" PawPrcTot="49.0100" ManPrc="25.0000" ManPrcTot="30.2500" Prc="65.5000" PrcTot="79.2600"/> <Deliv App="B2C" Typ="PAL" Cod="0" DemId="200" DemName="GEIS KAT B2C" DemPrc="475.0000" DemPrcTot="574.7500" ManPrc="100.0000" ManPrcTot="121.0000" Prc="575.0000" PrcTot="695.7500"/> <Deliv App="B2C" Typ="PAL" Cod="1" DemId="201" DemName="GEIS KAT B2C - dobírka" DemPrc="475.0000" DemPrcTot="574.7500" PawPrc="40.0000" PawPrcTot="48.4000" ManPrc="100.0000" ManPrcTot="121.0000" Prc="615.0000" PrcTot="744.1500"/> <Deliv App="B2C" Typ="PCK" Cod="0" DemId="318" DemName="One" DemPrc="110.0000" DemPrcTot="133.1000" ManPrc="40.0000" ManPrcTot="48.4000" Prc="150.0000" PrcTot="181.5000"/> <Deliv App="B2C" Typ="PCK" Cod="1" DemId="319" DemName="One - dobírka" DemPrc="110.0000" DemPrcTot="133.1000" PawPrc="40.0000" PawPrcTot="48.4000" ManPrc="40.0000" ManPrcTot="48.4000" Prc="190.0000" PrcTot="229.9000"/> </StoItem> </Result>
The response looks similar to X-StoItemDelivCost export.
Ordering
There is also possible to create orders via the webservice API straight into our system. Ordering is standard solution from Cybersoft s.r.o.
There is endpoint Order.asmx?op=Create for creating orders.
There are several settings which you should know before passing an order:
Authentication
- For first you need to be authenticated. This is the same authentication as for downloading exports.
Delivery method
- All delivery methods are available in export named OrderDelivMode (method GetResult, see \"Available exports\" section)
- There are all available delivery methods. Not all products could be delivered with all methods. If there will be a problem with delivery settings, your merchant will contact you
- values in OrderDelivMode export:
- Code - usable value for ZDmDemIdO
- Type
- 0 - for deliveries with non-cache payment
- 1 - personal pickups
- 2 - for COD payment deliveries
- All delivery methods are available in export named OrderDelivMode (method GetResult, see \"Available exports\" section)
Payment method
- All payment methods are available in export named OrderPaymentMode (method GetResult, see \"Available exports\" section)
- There are all available payment methods. Not all of them are enabled with all delivery methods. If there will be a problem with payment settings, your merchant will contact you
- If PawId value isn't filled, system tries to add best payment type depended on Delivery method type
- All payment methods are available in export named OrderPaymentMode (method GetResult, see \"Available exports\" section)
B2B Order [POST]
There is shown standard B2B order for 1 piece of product 6390305 with delivery PPL B2B (_WS_DIST_006) and payment type is invoice (4). You can add your order indentification into field CodeO. In the example request it's value "Order 1". You get all information about the order in the response as shown bellow. As shown in the example request - returned data couldn't be the same you send. There could be logic which adds some other products like delivery feed, manipulation fees, pallets, gifts...
+ Request (text/xml)
+ Headers
{
"Soapaction": "http://www.cybersoft.cz/I6/Web/WebService/Order/Create",
"Content-type": "text/xml",
}
+ Body
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Body>
<ns0:CreateRequest xmlns:ns0="http://www.cybersoft.cz/I6/Web/WebService/Order/">
<ns0:Order CodeO="Order 1" ZDmDemIdO="_WS_DIST_006" PawId="4">
<ns0:OrdItemList>
<ns0:OrdItem Qty="1" StiCode="6390305"/>
</ns0:OrdItemList>
</ns0:Order>
</ns0:CreateRequest>
</soap-env:Body>
</soap-env:Envelope>
Response 200 (text/xml)
+ Body <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <CreateResult xmlns="http://www.cybersoft.cz/I6/Web/WebService/Order/"> <Order Id="1987750" Code="OP24042716" CodeO="Order 1" CurCode="CZK" ValCur="9020" Val="9020" ZVal="0" AdvPay="0" DelFrom="1900-01-01T00:00:00" DelTo="2079-06-06T00:00:00" DelCompl="0" InvReady="0" PayTI="0" Ref="1" Ref2="1" Tag="" Tax="1" Type="0" ZDirect="0" ZDmDemIdO="_WS_DIST_006" ZDmName="PPL B2B" PawId="4" PawName="Příkazem" QudId="21" QudName="KAT - Katovice hlavní sklad" ZIPrn="1" Note="" ZsRndInv="7" SyncId="-1" C="2024-08-15T11:28:00"> <OrdItemList> <OrdItem Id="6465363" Qty="1" Canc="0" Block="0" Proc="0" Deliv="0" StiCode="6390305" StiCodePack="6390305" Prc="7429.75" PrcTax="1560.25" TaxRate="21" PrcRef="0" PrcRef2="0" ZPrc="0" ZPrcRef2="0" Note="" SyncId="-1" /> <OrdItem Id="6465367" Qty="1" Canc="0" Block="0" Proc="0" Deliv="0" StiCode="MANPD" StiCodePack="MANPD" Prc="25" PrcTax="5.25" TaxRate="21" PrcRef="0" PrcRef2="0" ZPrc="0" ZPrcRef2="0" Note="" SyncId="-1" /> <OrdItem Id="6465373" Qty="1" Canc="0" Block="0" Proc="0" Deliv="0" StiCode="DOPRAVAB2B" StiCodePack="DOPRAVAB2B" Name="Dopravné - dealer.penta.cz" Prc="180" PrcTax="37.8" TaxRate="21" PrcRef="0" PrcRef2="0" ZPrc="0" ZPrcRef2="0" Note="" SyncId="-1" /> </OrdItemList> <XCompany Id="0" RegId="" TaxNum="" Title="" FName="System" LName="Penta" Name="System Penta" NameAdd="" Street="Kosmetická 450" PostCode="38711" City="Katovice" CouCode="CZ" Tel="+420123456789" Fax="" EMail="system@penta.cz" PayTI="0" Note="" LogName="" SyncId="-1" /> </Order> </CreateResult> </soap:Body> </soap:Envelope>
B2B Order with another delivery address [POST]
There is shown standard B2B order for 1 piece of product 6390305 with delivery PPL B2B (_WS_DIST_006) and payment type is invoice (4). The delivery is to address specified in
- You can only send the Id in <ComShipTo="Id"> => Order will be delivered into this address
- You can send Id togegher with new data => old address found by Id will be updated
- You can send new address without Id value specified => New address will be added
- export ComShipTo
- type 0 - delivery address is for B2B order
- type 1 - delivery address is for B2C order
+ Request (text/xml)
+ Headers
{
"Soapaction": "http://www.cybersoft.cz/I6/Web/WebService/Order/Create",
"Content-type": "text/xml",
}
+ Body
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Body>
<ns0:CreateRequest xmlns:ns0="http://www.cybersoft.cz/I6/Web/WebService/Order/">
<ns0:Order CodeO="Order 2" ZDmDemIdO="_WS_DIST_006" PawId="4">
<ComShipTo Name="Name" Street="Street with house number" City="City" PostCode="Post Code" Tel="+420 000 000 000" EMail="test@test.com" />
<ns0:OrdItemList>
<ns0:OrdItem Qty="1" StiCode="6390305"/>
</ns0:OrdItemList>
</ns0:Order>
</ns0:CreateRequest>
</soap-env:Body>
</soap-env:Envelope>
B2B Order with COD [POST]
There is shown standard B2B order for 1 piece of product 6390305 with delivery PPL B2B with COD (_WS_DIST_007). Payment type COD 1 is filled automatically. The delivery is to address specified in
+ Request (text/xml)
+ Headers
{
"Soapaction": "http://www.cybersoft.cz/I6/Web/WebService/Order/Create",
"Content-type": "text/xml",
}
+ Body
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Body>
<ns0:CreateRequest xmlns:ns0="http://www.cybersoft.cz/I6/Web/WebService/Order/">
<ns0:Order CodeO="Order 3" ZDmDemIdO="_WS_DIST_007">
<ns0:OrdItemList>
<ns0:OrdItem Qty="1" StiCode="6390305"/>
</ns0:OrdItemList>
</ns0:Order>
</ns0:CreateRequest>
</soap-env:Body>
</soap-env:Envelope>
Dropshipment order [POST]
There is shown dropshipment order for 1 piece of product 6390305 with delivery PPL B2C (_WS_DIST_053). You need to use Delivery method with parameter IsB2C="1"
Payment type is invoicing.
End custommer delivery address is specified in tag
+ Request (text/xml)
+ Headers
{
"Soapaction": "http://www.cybersoft.cz/I6/Web/WebService/Order/Create",
"Content-type": "text/xml",
}
+ Body
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Body>
<ns0:CreateRequest xmlns:ns0="http://www.cybersoft.cz/I6/Web/WebService/Order/">
<ns0:Order ZDirect="1" ZDmDemIdO="_WS_DIST_53" PawId="4" Note="test" CodeO="Order 4">
<ns0:ZCompany Name="Dropshopment customer" Street="Street" PostCode="Postal code" City="City" Tel="+420123456789" EMail="test@test.test"/>
<ns0:OrdItemList>
<ns0:OrdItem Qty="1" StiCode="6390305"/>
</ns0:OrdItemList>
</ns0:Order>
</ns0:CreateRequest>
</soap-env:Body>
</soap-env:Envelope>
Dropshipment order with COD [POST]
There is shown dropshipment order for 1 piece of product 6390305 with delivery PPL B2C COD (_WS_DIST_054). You need to use Delivery method with parameter IsB2C="1"
Payment type is COD.
End custommer delivery address is specified in tag
If you want to start using dropshipment orders with COD, first contact your merchant to prepare conditions for you. Then our technical support (system@penta.cz) needs to set up the CODs.
+ Request (text/xml)
+ Headers
{
"Soapaction": "http://www.cybersoft.cz/I6/Web/WebService/Order/Create",
"Content-type": "text/xml",
}
+ Body
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
<soap-env:Body>
<ns0:CreateRequest xmlns:ns0="http://www.cybersoft.cz/I6/Web/WebService/Order/">
<ns0:Order ZDirect="1" ZDmDemIdO="_WS_DIST_54" PawId="4" Note="test" CodeO="Order 5" OrdZVal="12345">
<ns0:ZCompany Name="Dropshopment customer" Street="Street" PostCode="Postal code" City="City" Tel="+420123456789" EMail="test@test.test"/>
<ns0:OrdItemList>
<ns0:OrdItem Qty="1" StiCode="6390305"/>
</ns0:OrdItemList>
</ns0:Order>
</ns0:CreateRequest>
</soap-env:Body>
</soap-env:Envelope>