 |
| |
| |
| |
| |
| |
| |
| |
| |
| | |||||||||||||||
|
| |
| |
| |
| |
| |
| |
| |
| |
| | |||||||||||||||
| 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 /WebServicesHR/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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 - 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)
<nameEnglish></nameEnglish> <!-- (Optional)
<descriptionEnglish></descriptionEnglish> <!-- (Optional)
<nameGerman></nameGerman> <!-- (Optional)
<descriptionGerman></descriptionGerman> <!-- (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)
</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). Parameter productCode is optional (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 /WebServicesHR/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductCreate">
<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>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)
<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 /WebServicesHR/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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)
<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> <!-- (Mandatory)
<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 applyed 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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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 applyed 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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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">
<36457559>Product for code 36457559 successfully imported.</36457559>
</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>
Delete product.
Parameters
| productCode | Unique identifier for product. |
Example request and response
POST /WebServicesHR/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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>
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 /WebServicesHR/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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">
<36457559>Product for code 36457559 successfully imported.</36457559>
</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>
Get list of products for specified criteria.
Parameters
| productCode | Product's code. |
| 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) |
Example request and response
POST /WebServicesHR/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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>
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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<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>
