ProductGetByCode | Get product by product's code. |
ProductCreate | Create new product |
ProductUpdate | Update existing product |
ProductPriceCalculationUpdate | Update product price calculation. |
ProductMassPriceCalculationUpdate | Update up to 5000 price calculations with setting only 3 basic prices (supplier price, gross price and sales price) |
ProductImport | Import product by creating new and/or updating existing one. |
ProductMassImport | Import up to 5000 products with basic data. |
ProductDelete | Delete product. |
ProductList | Get list of products for specified criteria |
ProductPriceListGet | Get price list for product if used for specified product |
ProductPriceDiscountActionList | Get price discount action list for given article. |
ProductPriceDiscountActionAdd | Add price discount action list for given articles. |
ProductImageAdd | Add image/attachment to product. |
ProductImageSetDefault | Add image/attachment to product and set is as default. |
ProductImageGet | Get default image/attachment of product. |
ProductImageList | Get all images/attachments of product. |
Get product by productCode.
Parameters
productCode | Product code. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductGetByCode">
<parameter name="productCode" value="PA2521U-2AC3" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<Product>
<productCode>PA2521U-2AC3</productCode> <!-- (Mandatory and Unique)
<barCode></barCode> <!-- (Optional but must be unique)
<catalogueCode>V000061280</catalogueCode> <!-- (Optional)
<status>active</status> <!-- (Optional if not specified default is used true=active, false=inactive = product can not be put on the document
<type>goodsWithoutStockManagement</type> <!-- (Optional if not specified default is used - goodsWithStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
<trackItemsBySerialNumbers>true</trackItemsBySerialNumbers> <!-- (Optional default false)
<name>TOSHIBA charger 15V/ 6A 90 W</name> <!-- (one of properties: "name" or "description" is mandatory)
<description>Toshiba charger for 15V, 6A, 90W, 3-pin</description> <!-- (one of properties: "name" or "description" is mandatory)
<englishName></englishName> <!-- (Optional)
<englishDescription></englishDescription> <!-- (Optional)
<germanName></germanName> <!-- (Optional)
<germanDescription></germanDescription> <!-- (Optional)
<productGroupPrimary>01125</productGroupPrimary> <!-- (Optional)
<productGroupSecondary>00106</productGroupSecondary> <!-- (Optional)
<customProperty1>true</customProperty1> <!-- (Optional)
<customProperty2>leather</customProperty2> <!-- (Optional)
<customProperty3>shine</customProperty3> <!-- (Optional)
<customProperty4>XL</customProperty4> <!-- (Optional)
<brand>Minoti</brand> <!-- (Optional)
<costPosition>0001</costPosition> <!-- (Optional). This property can be used as product selection criteria for several reports.
<unit>piece</unit> <!-- (Optional)
<packingQuantity>5.000</packingQuantity> <!-- (Optional)
<minimalStockQuantity>100.0000</minimalStockQuantity> <!-- (Optional)
<warrantyPeriod>24</warrantyPeriod> <!-- (Optional)
<weight>0.500000</weight> <!-- (Optional)
<useOfPriceList>false</useOfPriceList> <!-- (Optional default false) true=use price list for the product, false=do not use price list for product.
<vatPercentage>20.0</vatPercentage> <!-- (Mandatory. Values: 0, 8.5, 20)
<currency>EUR</currency> <!-- (Optional)
<exchangeRate>SlovenianBankMiddleRate</exchangeRate> <!-- (Optional. Values: SlovenianBankMiddleRate , NLBSellingRate. Default: SlovenianBankMiddleRate)
<purchasePrice>20.49</purchasePrice> <!-- (Optional)
<retailPrice>30.00</retailPrice> <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
<grossPrice>25.00</grossPrice> <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
<procurementTransactionAccount>760200</procurementTransactionAccount> <!-- (Optional)
<domesticSalesTransactionAccount>760100</domesticSalesTransactionAccount> <!-- (Optional)
<foreignSalesTransactionAccount>760100</foreignSalesTransactionAccount> <!-- (Optional)
<allowChangeOfProductDescriptionOnTheInvoice>false</allowChangeOfProductDescriptionOnTheInvoice> <!-- (Optional default false)
<allowChangeOfPriceOnTheInvoice>false</allowChangeOfPriceOnTheInvoice> <!-- (Optional default false)
<allowChangeOfVatRateOnTheInvoice>false</allowChangeOfVatRateOnTheInvoice> <!-- (Optional default false)
<invoicingRemarks>Technical documentation for the bottom of the document</invoicingRemarks> <!-- (Optional)
<countryOfOrigin>SI</countryOfOrigin> <!-- (Optional) ISO code for country can be inserted
<defaultWarehouseLocation>Hidden behind doors</defaultWarehouseLocation> <!-- (Optional) default warehouse location
<onlineShopVisibility>visibleOnline</onlineShopVisibility> <!-- Optional, this attribute is used to tell if product is visible in online web shop, possible values are: visibleOnline, notVisibleOnline.
<itemWidth>10.90</itemWidth> <!-- (Optional)
<itemHeight>20.99</itemHeight> <!-- (Optional)
<itemDepth>15.15</itemDepth> <!-- (Optional)
<deliveryTimeInDays></deliveryTimeInDays> <!-- (Optional) delivery time in number of days
<intrastatCn8Code>88888888</intrastatCn8Code> <!-- (Optional)
</Product>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for code: PA2521U-2AC3,
</response>
Create new product. (for product's data structure look in API for ProductGetByCode). Property productCode is not obligatory (if not specified, it will be automatically generated), but if product with such code already exists, error response will be returned.
Parameters
product | Product's data in xml substructure. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductCreate">
<parameter name="product">
<productCode>PA2521U-2AC3</productCode> <!-- (Mandatory and Unique in case there is no counter set. In case counter is set this is optional)
<catalogueCode>V000061280</catalogueCode> <!-- (Optional)
<status>active</status> <!-- (Optional if not specified default is used true=active, false=inactive = product can not be put on the document
<type>goodsWithStockManagement</type> <!-- (Optional if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
<trackItemsBySerialNumbers>true</trackItemsBySerialNumbers> <!-- (Optional default false)
<name>TOSHIBA charger 15V/ 6A 90 W</name> <!-- (one of properties: "name" or "description" is mandatory)
<description>Toshiba charger for 15V, 6A, 90W, 3-pin</description> <!-- (one of properties: "name" or "description" is mandatory)
<englishName></englishName> <!-- (Optional)
<englishDescription></englishDescription> <!-- (Optional)
<germanName></germanName> <!-- (Optional)
<germanDescription></germanDescription> <!-- (Optional)
<productGroupPrimary>01125</productGroupPrimary> <!-- (Optional)
<brand>TOSHIBA</brand> <!-- (Optional)
<unit>piece</unit> <!-- (Optional)
<packingQuantity>1.000</packingQuantity> <!-- (Optional)
<minimalStockQuantity>10</minimalStockQuantity> <!-- (Optional)
<warrantyPeriod>24</warrantyPeriod> <!-- (Optional)
<useOfPriceList>false</useOfPriceList> <!-- (Optional default false) true=use price list for the product, false=do not use price list for product.
<vatPercentage>20.0</vatPercentage> <!-- (Mandatory. Values: 0, 8.5, 20)
<currency>EUR</currency> <!-- (Optional)
<exchangeRate>SlovenianBankMiddleRate</exchangeRate> <!-- (Optional. Values: SlovenianBankMiddleRate , NLBSellingRate. Default: SlovenianBankMiddleRate)
<purchasePrice>20.49</purchasePrice> <!-- (Optional)
<retailPrice>30.00</retailPrice> <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
<grossPrice>25.00</grossPrice> <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
<procurementTransactionAccount>760200</procurementTransactionAccount> <!-- (Optional)
<domesticSalesTransactionAccount>760100</domesticSalesTransactionAccount> <!-- (Optional)
<foreignSalesTransactionAccount>760100</foreignSalesTransactionAccount> <!-- (Optional)
<allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice> <!-- (Optional default false)
<allowChangeOfPriceOnTheInvoice>true</allowChangeOfPriceOnTheInvoice> <!-- (Optional default false)
<allowChangeOfVatRateOnTheInvoice>false</allowChangeOfVatRateOnTheInvoice> <!-- (Optional default false)
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<productCode>PA2521U-2AC3</productCode>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="Product for productCode: PA2521U-2AC3 already exists!><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <product> must be specified., missing mandatory attributes, invalid values, no privileges, Error creating product
</response>
Update existing product.
Parameters
product | Product's data in xml substructure |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductUpdate">
<parameter name="product">
<productCode>PA2521U-2AC3</productCode> <!-- (Mandatory and Unique)
<catalogueCode>V000061280</catalogueCode> <!-- (Optional)
<status>active</status> <!-- (Optional if not specified default is used true=active, false=inactive = product can not be put on the document
<type>product</type> <!-- (Optional if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
<trackItemsBySerialNumbers>true</trackItemsBySerialNumbers> <!-- (Optional default false)
<name>TOSHIBA charger 15V/ 6A 90 W </name> <!-- (one of properties: "name" or "description" is mandatory)
<description>Toshiba charger for 15V, 6A, 90W, 3-pin</description> <!-- (one of properties: "name" or "description" is mandatory)
<englishName></englishName> <!-- (Optional)
<englishDescription></englishDescription> <!-- (Optional)
<germanName></germanName> <!-- (Optional)
<germanDescription></germanDescription> <!-- (Optional)
<unit>piece</unit> <!-- (Optional)
<packingQuantity>1.000</packingQuantity> <!-- (Optional)
<minimalStockQuantity>20</minimalStockQuantity> <!-- (Optional)
<warrantyPeriod>36</warrantyPeriod> <!-- (Optional)
<vatPercentage>20.0</vatPercentage> <!-- (Mandatory. Values: 0, 8.5, 20)
<currency>EUR</currency> <!-- (Optional)
<purchasePrice>20.49</purchasePrice> <!-- (Optional)
<retailPrice>30.00</retailPrice> <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
<grossPrice>25.00</grossPrice> <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
<allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice> <!-- (Optional default false)
<allowChangeOfPriceOnTheInvoice>false</allowChangeOfPriceOnTheInvoice> <!-- (Optional default false)
<allowChangeOfVatRateOnTheInvoice>true</allowChangeOfVatRateOnTheInvoice> <!-- (Optional default false)
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<productCode>PA2521U-2AC3</productCode>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <product> needed, Product's property <productCode> is required, Can not find product for productCode: PA2521U-2AC3, missing mandatory attributes, invalid values, no privileges,
</response>
Update product's price calculation.
Parameters
productCode | Unique identifier for product. |
applyPricesToArticle | Decide if inventory, gross and sales prices are applied also to article. |
priceCalculation | Price calculation |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductPriceCalculationUpdate">
<parameter name="productCode" value="000001" />
<parameter name="applyPricesToArticle" type="Boolean" value="true" />
<parameter name="priceCalculation">
<calculationCurrency>EUR</calculationCurrency>
<costsDirectAmount>0.00000</costsDirectAmount>
<costsDirectPercentage>0.00</costsDirectPercentage>
<costsOfCustomsAmount>0.00000</costsOfCustomsAmount>
<costsOfCustomsPercentage>0.00</costsOfCustomsPercentage>
<costsOfTransportAmount>0.00000</costsOfTransportAmount>
<costsOfTransportPercentage>0.00</costsOfTransportPercentage>
<grossMarginAmount>7.00000</grossMarginAmount>
<grossMarginPercentage>38.89</grossMarginPercentage>
<grossPrice>25.00000</grossPrice>
<inboundVatAmount>0.00000</inboundVatAmount>
<inboundVatPercentage>0.00</inboundVatPercentage>
<inventoryPrice>18.00000</inventoryPrice>
<outgoingVatAmount>5.94000</outgoingVatAmount>
<outgoingVatPercentage>22.00</outgoingVatPercentage>
<retailMarginAmount>9.00000</retailMarginAmount>
<retailMarginPercentage>50</retailMarginPercentage>
<retailPrice>27.00000</retailPrice>
<salesPrice>32.94000</salesPrice>
<supplierDiscountAmount>0.00000</supplierDiscountAmount>
<supplierDiscountPercentage>0.00</supplierDiscountPercentage>
<supplierPrice>18.00000</supplierPrice>
<supplierPriceCurrency>EUR</supplierPriceCurrency>
<supplierPriceInCalculationCurrency>18.00000</supplierPriceInCalculationCurrency>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<message>Successfully updated price calculation for product with code 00001</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for productCode: PA2521U-2AC3
</response>
Update up to 5000 product's price calculations. In this case only 3 basic prices can be updated which are supplier price, gross price and sales price.
Parameters
applyPricesToArticle | Decide if inventory, gross and sales prices are applied also to article. |
priceCalculations | Price calculations |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8" ?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductMassPriceCalculationUpdate">
<parameter name="applyPricesToArticle" type="Boolean" value="true"/>
<parameter name="priceCalculations">
<PriceCalculations>
<PriceCalculation>
<productCode>36457558</productCode>
<supplierPrice>10.50</supplierPrice>
<grossPrice>30.44</grossPrice>
<salesPrice>40.99</salesPrice>
</PriceCalculation>
<PriceCalculation>
<productCode>000009</productCode>
<supplierPrice>11.50</supplierPrice>
<grossPrice>32.44</grossPrice>
<salesPrice>42.99</salesPrice>
</PriceCalculation>
<PriceCalculation>
<productCode>000010</productCode>
<supplierPrice>13.50</supplierPrice>
<grossPrice>36.44</grossPrice>
<salesPrice>47.99</salesPrice>
</PriceCalculation>
</PriceCalculations>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<message>Product price calculation for product with code 36457558 successfully updated.</message>
<message>Product price calculation for product with code 000009 successfully updated.</message>
<message>Product price calculation for product with code 000010 successfully updated.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!--Possible errors: Access denied. User account does not have sufficient privileges for the given request, Maximum number of price calculations for update exceeded, Product for code 0099 not foud.
</response>
Import product by creating new and/or updating existing ones. Parameter 'importType' can be used to specify type of import. If parameter is not specified, "createOrUpdate" is used as default. For updating product with this api call, product's data must contain code as unique identifier.
Parameters
importType | Flag for the type of import
|
product | Product's data in xml substructure. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductImport">
<parameter name="importType" value="createOrUpdate" />
<parameter name="product"> <!-- parameter here is the same as for ProductUpdate or ProductCreate depending on importType
<productCode>PA2521U-2AC3</productCode> <!-- (Mandatory and Unique)
<catalogueCode>V000061280</catalogueCode> <!-- (Optional)
<status>active</status> <!-- (Optional if not specified default is used true=active, false=inactive = product can not be put on the document
<type>product</type> <!-- (Optional if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
<trackItemsBySerialNumbers>true</trackItemsBySerialNumbers> <!-- (Optional default false)
<name>TOSHIBA charger 15V/ 6A 90 W </name> <!-- (one of properties: "name" or "description" is mandatory)
<description>Toshiba charger for 15V, 6A, 90W, 3-pin</description> <!-- (one of properties: "name" or "description" is mandatory)
<unit>piece</unit> <!-- (Optional)
<packingQuantity>1.000</packingQuantity> <!-- (Optional)
<minimalStockQuantity>20</minimalStockQuantity> <!-- (Optional)
<warrantyPeriod>36</warrantyPeriod> <!-- (Optional)
<vatPercentage>20.0</vatPercentage> <!-- (Mandatory. Values: 0, 8.5, 20)
<currency>EUR</currency> <!-- (Optional)
<purchasePrice>20.49</purchasePrice> <!-- (Optional)
<retailPrice>30.00</retailPrice> <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
<grossPrice>25.00</grossPrice> <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
<allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice> <!-- (Optional default false)
<allowChangeOfPriceOnTheInvoice>false</allowChangeOfPriceOnTheInvoice> <!-- (Optional default false)
<allowChangeOfVatRateOnTheInvoice>true</allowChangeOfVatRateOnTheInvoice> <!-- (Optional default false)
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<parameter name="productCode" value="PA2521U-2AC3" />
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!--Possible errors: Access denied. User account does not have sufficient privileges for the given request, missing mandatory attributes, invalid
</response>
Import up to 5000 products with basic data, by creating new and/or updating existing ones. Parameter 'importType' can be used to specify type of import. If parameter is not specified, "createOrUpdate" is used as default. For updating product with this api call, product's data must contain code as unique identifier.
Parameters
importType | Flag for the type of import
|
products | Products basic data in xml substructure. Below is and example of all basic basic data that can be set. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8" ?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductMassImport">
<parameter name="importType" value="createOrUpdate" />
<parameter name="products">
<Products>
<Product>
<productCode>36457558</productCode> <!-- (Mandatory and Unique)
<name>Mass import product 1</name> <!-- (one of properties: "name" or "description" is mandatory)
<description>Mass import product 1 description</description> <!-- (one of properties: "name" or "description" is mandatory)
<vatPercentage>22</vatPercentage> <!-- (Mandatory. Values: 0, 9.5, 22)
<currency>EUR</currency> <!-- (Optional)
<unit>pc</unit> <!-- (Optional)
<allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice>
<status>active</status> <!-- (Optional if not specified default is used true=active, false=inactive = product can not be put on the document
<type>product</type> <!-- (Optional if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
<purchasePrice>20.49</purchasePrice> <!-- (Optional)
<retailPrice>30.00</retailPrice> <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
<grossPrice>25.00</grossPrice> <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
</Product>
....
</Products>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<message>Product for code 36457559 successfully imported.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!--Possible errors: Access denied. User account does not have sufficient privileges for the given request, missing mandatory attributes, Product for code 0099 not foud., Product for code 8847 already exists.
</response>
Delete product.
Parameters
productCode | Unique identifier for product. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductDelete">
<parameter name="productCode" value="PA2521U-2AC3" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for productCode: PA2521U-2AC3, Can not delete. Found 3 product with productCode: PA2521U-2AC3,
</response>
Get list of products for specified criteria.
Parameters
productCode | Product's code. |
productCodeFrom | Search by product code range. |
productCodeTo | Search by product code range. |
searchKey | Search key. The value from this property is used for searching for values in fields: "name", "description" and "brand" |
supplierCode | Supplier code |
barCode | Bar code |
brand | Name of the product's brand |
productGroup | Code of product group (primary or secondary) |
status | Usage status (active, inactive) |
type | Type of article, possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license |
catalogueCode | Catalogue code. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductList">
<parameter name="searchKey" type="String" value="" />
<parameter name="productCode" value="123456" />
<parameter name="barCode" value="" />
<parameter name="brand" type="String" value="Samsung" />
<parameter name="status" value="active"/>
</method>
</request>
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductList">
<parameter name="productCodeFrom" value="ART-1*" />
<parameter name="productCodeTo" value="ART-3*" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<Product>
<!-- structure of product data is the same as in ProductGetByCode
</Product>
<Product>
<!-- structure of product data is the same as in ProductGetByCode
</Product>
...
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Access denied. User account does not have sufficient privileges for the given request, Invalid search keys, invalid values, no privileges,
</response>
Get price list for product if used for specified product.
Parameters
productCode | Product's code. |
priceListCurrency | Price list currency |
priceListDate | Price list date |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductPriceListGet">
<parameter name="productCode" value="123456" />
<parameter name="priceListCurrency" value="EUR" />
<parameter name="priceListDate" value="2014-11-13" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<PriceListItem>
<grossPrice>160.00000</grossPrice>
<productPriceListCurrency>EUR</productPriceListCurrency>
<purchasePrice>101.00000</purchasePrice>
<retailPrice>300.00000</retailPrice>
<validFrom>2014-11-11</validFrom>
<validTo>2014-11-13</validTo>
</PriceListItem>
<PriceListItem>
<grossPrice>170.00000</grossPrice>
<productPriceListCurrency>EUR</productPriceListCurrency>
<purchasePrice>106.00000</purchasePrice>
<retailPrice>366.00000</retailPrice>
<validFrom>2014-12-11</validFrom>
<validTo>2015-01-13</validTo>
</PriceListItem>
...
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Access denied. User account does not have sufficient privileges for the given request, Invalid search keys, invalid values, no privileges,
</response>
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="Use of price list for this product is disabled."><error/>
</response>
Get price discount action list for given article.
Parameters
productCode | Product's code. |
productGroupCode | Product group's code. |
buyerGroupCode | Buyer group's code. |
warehouseCode | Warehouse code. |
validFrom | Validity date from. |
validTo | Validity date to. |
discountPercentage | Disctount percentage. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductPriceDiscountActionList">
<parameter name="productCode" type="String" value="000001" />
<parameter name="productGroupCode" type="String" value="ABC" />
<parameter name="buyerGroupCode" type="String" value="101" />
<parameter name="warehouseCode" type="String" value="WH01" />
<parameter name="validFrom" type="Date" value="2021-05-01" />
<parameter name="validTo" type="Date" value="2021-05-31" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<ProductPriceDiscountAction>
<discountPercentage>50.0000</discountPercentage>
<productCode>000001</productCode>
<validFrom>2021-05-10</validFrom>
<validTo>2021-05-14</validTo>
</ProductPriceDiscountAction>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, No price discount actions were found matching search criteria!
</response>
Add price discount action list for given article.
Parameters
priceDiscountAction | Discount action data. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductPriceDiscountActionAdd">
<parameter name="priceDiscountAction">
<productCode>00001</productCode>
<articleGroupCode>AR01</articleGroupCode>
<buyerGroupCode>BY01</buyerGroupCode>
<warehouseCode>00001</warehouseCode>
<discountPercentage>34.00</discountPercentage>
<validFrom>2022-01-01</validFrom>
<validTo>2022-04-01</validTo>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<message>Successfully added price discount action for product with code 00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Can not find product for code: 9999.
</response>
Add image/attachment to product.
Parameters
productCode | Product code. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductImageAdd">
<parameter name="productCode" type="String" value="000001" />
<parameter name="image">
<contents encoding="BASE64">BASE64...</contents>
<fileName>att.jpg</fileName>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<message>Successfully added image att.jpg to Artikel: 000001</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for code: PA2521U-2AC3, Parameter <image> is missing, Parameter <image>: cannot parse contents
</response>
Add image/attachment to product and set is as default.
Parameters
productCode | Product code. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductImageSetDefault">
<parameter name="productCode" type="String" value="000001" />
<parameter name="image">
<contents encoding="BASE64">BASE64...</contents>
<fileName>att.jpg</fileName>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<message>Successfully added image att.jpg to Artikel: 000001</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for code: PA2521U-2AC3, Parameter <image> is missing, Parameter <image>: cannot parse contents
</response>
Get default image/attachment of product.
Parameters
productCode | Product code. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductImageGet">
<parameter name="productCode" type="String" value="000001" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<Product>
<Attachments>
<Attachment>
<fileName>att.jpg</fileName>
<contents encoding="BASE64">BASE64</contents>
</Attachment>
</Attachments>
</Product>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for code: PA2521U-2AC3, Product does not have attachemnts.
</response>
Get all images/attachments of product.
Parameters
productCode | Product code. |
Example request and response
POST /WebServicesSI/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ProductImageList">
<parameter name="productCode" type="String" value="000001" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<Product>
<Attachments>
<Attachment>
<fileName>att1.jpg</fileName>
<contents encoding="BASE64">1BASE64</contents>
</Attachment>
<Attachment>
<fileName>att2.jpg</fileName>
<contents encoding="BASE64">2BASE64</contents>
</Attachment>
<Attachment>
<fileName>att3.jpg</fileName>
<contents encoding="BASE64">3BASE64</contents>
</Attachment>
</Attachments>
</Product>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for code: PA2521U-2AC3, Product does not have attachemnts.
</response>