History of changes

2026-10-13:

A new method SetArticlePrices has been added, which allows setting the prices of articles in a specific price list.

2026-08-19:

FindClient method has been added, which allows to find an existing client by identity field.

2026-08-11:

A new Note field has been added to FI​ objects containing information about attachments to items and groups in the site. It returns the note to the file.

2026-07-06:

ManageClient method has been added, which allows to create new and edit existing clients.

2026-06-15:

The GetArticles method has been upgraded to return information about stock availability in additional warehouses (shops) that are show-only (cannot be ordered) for the batches too. For this purpose, a new field IsShowOnly has been added to BI objects, containing information about the batches. The new features are described in the method section.

2026-06-02:

The GetArticles method has been upgraded to return information about stock availability in additional warehouses (shops) that are show-only (cannot be ordered). For this purpose, a new field IsShowOnly has been added to QI objects, containing information about the stock by warehouse. The new features are described in the method section.

2026-05-14:

A new input parameter IsQtyExpected has been added to GetArticles method. It specifies whether to return information about expected deliveries of the articles. The new features are described in the method section.

2026-04-06:

GetOrders method has been added, which returns information about orders in Bizzio, made through the integration. It allows filtering by period or by specific orders. Optionally, information about the rows in the orders can also be returned.

2026-03-29:

CreateOrder method was upgraded to support submitting information about whether the prices in the order include VAT. For this purpose, a new input parameter IsVAT was added to the request. The new features are described in the body of the method.

CreateOrder method was upgraded to support submitting parameters to order lines. For this purpose, a new field RowParams has been added to OI objects containing information about the rows. The new features are described in the method body.

2025-12-11:

The CreateOrder method was extended with the possibility to identifying batches by code (when working with variants and the implementation in Bizzio is with batches). For this purpose, a new field BatchCode has been added to OI objects containing information about the rows. The batch code must be entered in it. Until now, batch identification was based on the batch ID (ID_Batch field), which represents one specific batch. Batch code identification (BatchCode field) allows multiple batches to be represented by the code and simplifies working with variants. Thus only the variant can be submitted, and the system can choose which batches to add to the order.

2025-12-02:

GetArticles method was upgraded to return information about batch codes. For this purpose, a new field Code was added to BI objects containing batch information.

2025-11-11:

CreateOrder method was upgraded to allow specifying a carrier and carrier office for the order. For this purpose, the following new fields were added to the method request:

The new features are described in the body of the method.

2025-08-22:

A new RefUri field has been added to FI​ objects containing information about attachments to items and groups in the site. It returns an additional reference address, if any. It is used when a file needs to have an image, by which to visualize it – then the image is uploaded as a file, and the reference address contains the link to the file itself.

2025-08-05:

GetOrderProcessings method was upgraded to return information about bills of lading attached to subsequent order documents. For this purpose, a new input parameter IsBillsOfLading was added to the request. The new features are described in the body of the method.

2025-08-04:

A new payment type TBI has been added with code 11.

2025-05-21:

The CreateOrder method was extended to allow creating documents of type offer (instead of the standard order type). For this purpose, a new field OrderMode was added to the method request. It supports the following values:

When making an offer, there is no check for insufficient stock, no transfer reservations are created, and no quantities are reserved.

2025-05-16:

GetArticles method was upgraded to return information about the positions of items in their site groups. For this purpose, a new field SiteGroupPos was added to SA objects containing information about the site articles.

2024-12-16:

CreateOrder method was upgraded to allow setting an item group and warranties when creating new items. For this purpose, the following new fields have been added to ACI objects containing information about creating the item:

The new features are described in the body of the method.

2024-11-02:

The CreateOrder method was extended to alloy payment with a voucher. For this purpose, a new field VoucherCode was added to the method request. The voucher code must be entered in it. The voucher itself must exist in Bizzio, it must be valid, not used, and it must not exceed the order amount, excluding shipping.

A new error code 101 has been added, indicating a problem with payment by voucher.

2024-06-28:

GetOrderProcessings method was upgraded to return information about invoices released to the sales, related to the orders. For this purpose, a new input parameter IsInvoices was added to the request. The new features are described in the body of the method.

2024-03-21:

The CreateOrder method was extended to allow setting a price list for the lines in the order. For this purpose, a new field PriceListCode has been added to OI objects containing information about the rows. It must contain the price list code, if one is specified. If the field is empty, the system will set the standard price list, as before.

2023-12-19:

A new input parameter IsQtyByWarehouses has been added to GetArticles method. It specifies whether to return information about the availability of items, detailed by warehouses (and not just the total availability). For this purpose, a new field Qties has been added to AI objects containing item information. It is a list of QI objects with information about stock availability by warehouse. Also, a new field ID_Warehouse was added to BI objects containing information about batches. It contains the warehouse ID for the corresponding batch. The new features are described in the body of the method.

2023-12-12:

The following new payment types have been added to be used in CreateOrder method:

2023-12-06:

GetArticles method was upgraded to allow specifying the currency in which to return item prices. For this purpose, a new field Currency was added to the request. It supports the following values:

2023-11-16:

CreateOrder method was upgraded to allow specifying the currency of the prices in the order. For this purpose, a new field Currency was added to the request. A 3-letter ISO code of the currency must be entered in it. If not set, the prices are considered to be in the default currency of the database.

2023-10-17:

CreateOrder method was upgraded to allow setting invoice information to the order. For this purpose, a new field InvoiceData was added to the request. It is of type InvData and contains the fields required to issue an invoice. The new features are described in the body of the method.

2023-07-30:

A new method GetOrderProcessings has been added, which returns information about order processing in Bizzio. Currently, information is returned about site states and/or order shippings in Bizzio, after a specific date and time or for specific orders.

2023-07-18:

Support has been added for the sites in the E-commerce modules of Bizzio. For this purpose, several new methods for reading nomenclature objects were added and changes were made to existing methods. An additional section was also added at the beginning of the documentation with a summarized description of the E-commerce integration.

GetPropGroups method has been added, which returns information about the property groups, used in the sites.

GetSiteGroups method has been added, which returns information about the article groups defined for a specific site.

GetProps method was upgraded to return the type of objects for each property, as well as its position. For this purpose, new fields ObjType and Pos were added to Prop objects containing information about the properties. ObjType is an enumerated type, and its possible values are listed in the description of the method.

GetArticles method was upgraded to return only items registered in a specific site. For this purpose, a new field ID_Site was added to the request. If specified, additional site information is returned for articles and batches. The changes are described in the body of the method.

GetArticles method was upgraded to return the registrations of the articles in the corresponding site. Each article from the nomenclature can be registered in a corresponding group on the site, in which case a corresponding ID is generated. For this purpose, a new field SiteArticles has been added to AI objects containing article information. It is a list of SA objects with registration information. The new features are described in the body of the method.

GetArticles method was upgraded to return the site properties for the articles and batches. For this purpose, a new field SiteProps has been added to AI and BI objects containing information about articles and batches. It is a list of SP objects with information about the properties. The nre features are described in the body of the method.

CreateOrder method was upgraded to consider the settings of a specific site. For this purpose, a new field ID_Site was added to the request. If specified, most of the order settings are read from the site settings (warehouses, price lists, payments, shipping, etc.).

Stripe payment type added with code 6.

2023-07-12:

GetProps method has been added, which returns information about the definitions of the properties and their possible values.

2023-07-10:

GetArticles method was upgraded to return the IDs of the attachments of the articles. For this purpose, a new field ID has been added to FI objects containing information about the attached files. The new field is intended for matching when building redirects during site migration.

2023-04-22:

CreateOrder method was upgraded to allow setting a discount for the lines. For this purpose, a new field Discount has been added to OI objects containing information about order lines.

2023-04-19:

CreateOrder method was upgraded to set an additional phone number to the order's contact information. For this purpose, a new Phone field was added to the request, information about which is given below in the method description.

2023-04-09:

CreateOrder method was upgraded to set the shipping type for the order lines. For this purpose, a new ShippingMode field was added to the request, information about which is given below in the method description.

GetArticles method was upgraded to allow filtering by article manufacturers. For this purpose, a new field ProducerCodes was added to the request, information about which is given below in the method description.

2023-03-16:

CreateOrder method was upgraded to set several new order fields. For this purpose, the following new fields were added to the request:

A new payment type has been added: BNP_Paribas with code 5.

2022-10-27:

GetArticles method was upgraded to return information about the batches of articles, supporting such. For this purpose, a new Batches object, containing a list of BI elements with the batch data, was added to AI objects. Also, a new field PropCodes_Batch was added to the GetArticlesResponse object, containing a list of codes for additional batch properties (the field is similar in meaning and behavior to PropCodes).

CreateOrder method was upgraded to allow ordering a specific batch from an article. For this purpose, a new field ID_Batch has been added to OI objects containing information about order lines.

2022-09-27:

CreateOrder method was upgraded to allow searching for customers by email and phone (in addition to the default - by code). The new features are described in the method section.

A new payment type ePay has been added with code 4.

2022-08-01:

A new input parameter IsCars has been added to GetArticles method. It specifies whether to return information about cars from the car catalog, associated with the articles. The new features are described in the method section.

2022-07-23:

CreateOrder method was upgraded to allow assigning properties of the order. For this purpose, a new Props field was added to the request, which is a list of PV objects containing information about the properties.

2022-06-23:

CreateOrder method was upgraded to allow the creation of new articles. For this purpose, a new field ArticleData has been added to OI objects containing information about order lines. It is of type ACI and contains the information for creating the article if it is not found. If articles will be created in the corresponding profile, ArticleData must always be filled in - otherwise it should be null.

CreateOrder method has been upgraded to allow assigning an agent to the order. For this purpose, a new AgentCode has been added to the request. It contains the agent code and is optional. Agents can be used, for example, to differentiate the site from which the order comes.

2022-02-17:

GetOrderStates has been added, which returns information about the Bizzio status of the orders.

2022-02-02:

A new method GetArticleGroups has been added, which returns information about article groups.

2022-01-21:

A new input parameter IsFiles has been added to GetArticles method. It specifies whether to return information about files attached to articles. The new features are described in the method section.

2020-02-12:

The naming scheme for articles has been cleaned up, as well as the specification of their properties. The information has been added to the beginning of the description of the GetArticles method.


General remarks

Description:

The interface represents a WCF web service, which is SOAP based. It provides a set of methods through which certain operations can be performed. The name of the method to be called is specified in a standard request header, having name SOAPAction and value http://tempuri.org/IRiznShopExtService/[method name], for instance:

SOAPAction: "http://tempuri.org/IRiznShopExtService/GetArticles"

Each request requires authentication, which is sent in its body in the form of a user header , which we call Authentication (described below). Each response has a standard part, in which information about a possible error is returned (ErrorCode/ErrorMessage/ErrorType -> code/text/type) and a specific part, depending on the corresponding method.

Authentication header

Description:

Every request must contain an authentication header. It is named Authentication and contains the following fields:

FieldTypeDescription
DatabasestringDatabase name
UsernamestringUsername
PasswordstringPassword

Error codes

Description:

ErrorCode = 0 means a successful result, and the possible errors returned by the system are the following:

ErrorCodeErrorTypeDescription
-1UnknownUntyped error
1PartialSuccessPartially successful result
2NotAuthorizedAuthentication failed
3NotFoundThe requested object was not found
4ManyFoundMore than one object found
5FieldTooLongText value exceeds the allowed character length
6FieldRequiredRequired field
7FieldInvalidInvalid field
8ActionInvalidInvalid action
101VoucherInvalidProblem with payment with voucher

Working with sites

Description:

In Bizzio there is a group of modules named E-commerce, which provides tools for connecting external sites to the system. The modules include:

In general, modules are a kind of template, designed to display information from the main nomenclature to the external system - in a way that is suitable for both parties. The main emphasis of the connection is that for each site an alternative site artgicle groups nomenclature is created, in which already existing articles from the main nomenclature are registered. Also, through the groups of properties, a subset of the relevant properties of the articles is described for each site, and for each site group is set which group of properties to use.

The following integration methods are related to working with sites:


GetArticles method

Description:

It is used to read the nomenclature of articles, with different clients having some peculiarities in the returned data.

Request:

It accepts an argument of type GetArticlesRequest, including the following fields:

FieldTypeDescription
Barcodesstring[]Optional filter by articles with specific barcodes
AvailableOnlyboolfalse - all articles; true - only available articles
ModifiedAfterdatetime?If a date is provided, only articles changed after that date are returned
IsFilesboolWhether to return information about attachments to the articles
IsCarsboolWhether to return information about cars from the car catalog associated with the articles
IsQtyByWarehousesboolWhether to return information about the stock of the articles, detailed by warehouses
IsQtyExpectedboolWhether to return information about expected deliveries of the articles
ProducerCodesstring[]Optional filter by articles manufacturer codes
ID_Sitelong?ID – if set, only articles registered on the corresponding site are returned, along with additional site information about them
Currency string

Currency in which to return article prices. The following values are supported:

  • null - prices are returned in the base currency;
  • empty string - prices are returned in the currencies in which they are set;
  • 3-letter ISO code - prices are returned in the requested currency.

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetArticlesRequest xmlns="http://tempuri.org/">
      <AvailableOnly>false</AvailableOnly>
      <Barcodes xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <Currency i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <ID_Site i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <IsCars>false</IsCars>
      <IsFiles>false</IsFiles>
      <IsQtyByWarehouses>false</IsQtyByWarehouses>
      <IsQtyExpected>false</IsQtyExpected>
      <ModifiedAfter>2019-11-15T00:00:00</ModifiedAfter>
      <ProducerCodes xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
    </GetArticlesRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetArticlesResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
ArticlesAI[]List of AI elements with article information
PropCodesstring[]List of property codes, which are exported for the articles (the values in the AI object are in the same order as in this list)
PropCodes_Batchstring[]List of property codes, which are exported for the batches (the values in the BI object are in the same order as in this list)

The AI object has the following structure:

FieldTypeDescription
NamestringArticle name
BarcodestringBarcode
Propsstring[]List of property values for the article
P_Saledecimal?Base price (if any)
P_Promodecimal?Promotional price (if any)
QtydecimalStock
QtiesQI[]List of QI elements with data for the stock of the article, detailed by warehouses
QtyExpectedQE[]List of QE elements with data for the expected deliveries of the article
FilesFI[]List of FI elements with data for the attached files of the article
CarsCI[]List of CI elements with data for the auto catalog cars, associated with the article
BatchesBI[]List of BI elements with data for the batches of the article (for article with batch support)
SiteArticlesSA[]List of SA elements with data for the site registrations of the article (if ID_Site is provided)
SitePropsSP[]List of SP elements with data for the site properties of the articles (if ID_Site is provided)

The FI object has the following structure:

FieldTypeDescription
IDlongFile ID
NamestringFile name
UristringFile address
RefUristringFile reference address - used when a file needs to have an image to visualize it - then the Uri field points to the image, while the actual file address is stored in the RefUri field
NotestringFile note

The CI object has the following structure:

FieldTypeDescription
CategorystringCar category
BrandstringCar brand
ModelstringCar model
YearstringCar year

The BI object has the following structure:

FieldTypeDescription
IDlongBatch ID
CodestringBatch code
ID_Warehouselong?Warehouse ID (null, if IsQtyByWarehouses is false)
QtydecimalStock
IsShowOnly Bool

false – can be ordered; true – show-only

Whether the stock is show-only:

  • false (can be ordered - free stock in warehouse);
  • true (show-only - can be seen locally in shop).
Propsstring[]List of batch properties

The SA object has the following structure:

FieldTypeDescription
ID_SiteArticlelongArticle site registration ID
ID_SiteGrouplongSite group ID
SiteGroupPosint?Article position in site group

The SP object has the following structure:

FieldTypeDescription
ID_ProplongProperty ID
ValstringProperty value

The QI object has the following structure:

FieldTypeDescription
ID_WarehouselongWarehouse ID
QtydecimalStock
IsShowOnly Bool

false – can be ordered; true – show-only

Whether the stock is show-only:

  • false (can be ordered - free stock in warehouse);
  • true (show-only - can be seen locally in shop).

The QE object has the following structure:

FieldTypeDescription
QtyOrdersdecimalExpected quantities from orders to suppliers
QtyDeliveriesdecimalQuantities from incoming deliveries (in shipping process)
Datedatetime?Expected shipping date

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetArticlesResponse xmlns="http://tempuri.org/">
      <Articles xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:AI>
          <a:Barcode>8051498744978</a:Barcode>
          <a:Batches>
            <a:BI>
              <a:Code>116992510105136</a:Code>
              <a:ID>342555175505895334</a:ID>
              <a:ID_Warehouse>291045224703066113</a:ID_Warehouse>
              <a:IsShowOnly>false</a:IsShowOnly>
              <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <b:string>36</b:string>
              </a:Props>
              <a:Qty>2.000000000</a:Qty>
              <a:SiteProps i:nil="true" />
            </a:BI>
            <a:BI>
              <a:Code>116992510105140</a:Code>
              <a:ID>342555175505957543</a:ID>
              <a:ID_Warehouse>291045224703066114</a:ID_Warehouse>
              <a:IsShowOnly>true</a:IsShowOnly>
              <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <b:string>40</b:string>
              </a:Props>
              <a:Qty>1.000000000</a:Qty>
              <a:SiteProps i:nil="true" />
            </a:BI>
            <a:BI>
              <a:Code>116992510105141</a:Code>
              <a:ID>342555175505957544</a:ID>
              <a:ID_Warehouse>291045224703066114</a:ID_Warehouse>
              <a:IsShowOnly>true</a:IsShowOnly>
              <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <b:string>41</b:string>
              </a:Props>
              <a:Qty>2.000000000</a:Qty>
              <a:SiteProps i:nil="true" />
            </a:BI>
          </a:Batches>
          <a:Cars i:nil="true" />
          <a:Files i:nil="true" />
          <a:Name>ILAC1378-L1102272-019-3XL</a:Name>
          <a:P_Promo i:nil="true" />
          <a:P_Sale>85</a:P_Sale>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <b:string>3XL</b:string>
            <b:string />
            <b:string>24</b:string>
            <b:string>24AA</b:string>
            <b:string>Колан</b:string>
            <b:string>019</b:string>
            <b:string>100%Телешка кожа</b:string>
            <b:string>46</b:string>
          </a:Props>
          <a:Qties>
            <a:QI>
              <a:ID_Warehouse>291045224703066113</a:ID_Warehouse>
              <a:IsShowOnly>false</a:IsShowOnly>
              <a:Qty>2</a:Qty>
            </a:QI>
            <a:QI>
              <a:ID_Warehouse>291045224703066114</a:ID_Warehouse>
              <a:IsShowOnly>true</a:IsShowOnly>
              <a:Qty>3</a:Qty>
            </a:QI>
          </a:Qties>
          <a:Qty>2</a:Qty>
          <a:QtyExpected>
            <a:QE>
              <a:Date>2026-05-28T00:00:00</a:Date>
              <a:QtyDeliveries>3.000000000</a:QtyDeliveries>
              <a:QtyOrders>7.000000000</a:QtyOrders>
            </a:QE>
            <a:QE>
              <a:Date i:nil="true" />
              <a:QtyDeliveries>0.000000000</a:QtyDeliveries>
              <a:QtyOrders>15.000000000</a:QtyOrders>
            </a:QE>
          </a:QtyExpected>
          <a:SiteArticles i:nil="true" />
          <a:SiteProps i:nil="true" />
        </a:AI>
      </Articles>
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <PropCodes xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:string>Size</a:string>
        <a:string>Length</a:string>
        <a:string>Brand</a:string>
        <a:string>Collection</a:string>
        <a:string>Description</a:string>
        <a:string>Color</a:string>
        <a:string>Materials</a:string>
        <a:string>Season</a:string>
      </PropCodes>
      <PropCodes_Batch xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:string>Size</a:string>
      </PropCodes_Batch>
    </GetArticlesResponse>
  </s:Body>
</s:Envelope>

GetArticleGroups method

Description:

It is used to read the nomenclature of the article groups. They are hierarchical, with no limit on the number of levels.

Request:

Accepts an argument of type GetArticleGroupsRequest (currently - no fields).

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetArticleGroupsRequest xmlns="http://tempuri.org/" />
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetArticleGroupsResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
ArticleGroupsGI[]List of GI elements with information about the article groups
PropCodesstring[]List of property codes, which are exported for the article groups (the values in the GI object are in the same order as in this list)

The GI object has the following structure:

FieldTypeDescription
IDlongArticle group ID
ID_Parentlong?ID of parent group (null - main group)
NamestringArticle group name
Propsstring[]List of property values for the article group

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetArticleGroupsResponse xmlns="http://tempuri.org/">
      <ArticleGroups xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GI>
          <a:ID>318629789600579595</a:ID>
          <a:ID_Parent>318629789600579759</a:ID_Parent>
          <a:Name>Велика</a:Name>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
        </a:GI>
        <a:GI>
          <a:ID>318629789600579759</a:ID>
          <a:ID_Parent i:nil="true" />
          <a:Name>Дерони</a:Name>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
        </a:GI>
        <a:GI>
          <a:ID>318629789600579760</a:ID>
          <a:ID_Parent i:nil="true" />
          <a:Name>Леда</a:Name>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
        </a:GI>
      </ArticleGroups>
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <PropCodes xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
    </GetArticleGroupsResponse>
  </s:Body>
</s:Envelope>

CreateOrder method

Description:

It is used to register an order, supporting two approaches - with or without customer registration. In both cases, information about the specific customer is recorded in the contact information of the order. The customer is located by identifier, which can be its code, email or phone. If an identifier is provided and the customer is not found, an account is created using the current information about the order's shipping. The behavior of the identifier is described below in the ClientCode field.

It also supports the creation of articles that are not present in Bizzio. For this purpose, the necessary information is always submitted to each order line and if the article is not found, it is created by using that data. This is a specific functionality and should be used only where necessary.

Request:

It accepts an argument of type CreateOrderRequest, including the following fields:

FieldTypeDescription
OrderMode int

Document type:

  • 0 – order (default);
  • 1 – offer – in this case, no check for insufficient stock is made, no transfer reservations are created, and no quantities are reserved.
OrderNumberstring(32)Order number from the online shop
OrderNotestring(128)Order note
AgentCodestringAgent code for the order
CompanyCodestringOur company code for the order
UserCodestringCode of the user who created the order
ClientCode string(48)

Customer identifier - the following fixed values are supported:

  • [Email] - locate by customer email (entered in the Email field);
  • [Mobile] - locate by customer phone number (entered in the Mobile field).
  • [MobileLast] - searches by customer phone number (entered in the Mobile field), and if more than one is found - uses the last registered one.

If any other value is provided - locate by client code (the value itself).

Missing customers are created.

If no identifier is provided - the default client is used.

ClientNamestring(48)Name of the customer
Addressstring(128)Address (city, street, number)
Citystring(48)City
PostCodestring(16)Postal code
Provincestring(48)Region
CountryCodestring(2)ISO country code
GPS_LatitudedoubleLatitude for GPS coordinates
GPS_LongitudedoubleLongitude for GPS coordinates
Mobilestring(64)Mobile phone
Phonestring(64)Additional phone
Emailstring(128)Email
Currencystring(3)ISO code of the currency of the prices in the order (if not set, the default currency in the database is used)
IsVATbool?Indicates whether the prices in the order include VAT (null - true)
PaymentTypeintPayment type (0=Bank; 1=Card; 2=Cash on delivery; 3=Cash; 4=ePay ; 5=BNP_Paribas; 6=Stripe; 7=PayPal; 8=b-Payment; 9=myPOS; 10=B2B; 11=TBI) – the codes are fixed
ShippingTypelongShipping type (0=Free; [ code1 ]=[ delivery1 ] ; ... ) – the codes are dynamic (except 0, which is fixed)
ShippingCostdecimalShipping cost (for free shipping it is zero - otherwise it must be non-zero)
ShippingDatedatetime?Order shipping date
ShippingModeint?Shipping mode for the lines (0=immediately; 1=postponed; 2=by date; 4=by days) – the codes are fixed
TransporterCodestringCode of the carrier for the order
TransporterOfficeID string

ID of the carrier's office to which the order will be shipped (from the carrier's nomenclature) .

If set, TransporterCode must also be set or if in site mode (ID_Site is set) the shipping type (specified in ShippingType) must have a carrier assigned (in Bizzio). For the assigned carrier, a bill of lading type must also be assigned (in Bizzio).

Here are some examples of several real carrier offices:

Speedy:

  • ID - 2
  • Name - SOFIA - SOMAT
  • Address - SOFIA, 22 ABAGAR Str.

Econt:

  • ID - 133
  • Code - 8501
  • Name - Aytos Bus Station
  • Address - Aytos, 7 Georgi Kondolov Street

Transpress:

  • ID - PLO
  • Name - Plovdiv
  • Address - Plovdiv, 11 Kuklensko Shose Street
VoucherCodestringVoucher code to pay with. The voucher itself must exist in Bizzio, be valid, not used and it must not exceed the order amount excluding shipping cost.
ID_Sitelong?Site ID - if set, uses the settings, payments and shipping of the site, when creating an order
InvoiceDataInvDataAn object of type InvData containing the invoice information, if any
PropsPV[]List of PV elements with information about the properties of the order
ItemsOI[]List of OI elements with information about the lines of the order

The PV object has the following structure:

FieldTypeDescription
CodestringProperty code
Value object

Property value - string encoded as follows:

  • bool - 0 = False, 1 = True
  • decimal - decimal separator point
  • datetime - format yyyyMMddHHmmss

The OI object has the following structure:

FieldTypeDescription
ArticleDataACIACI element with information about creating the article (if needed) - if articles will be created, it must always be filled in - otherwise it should be null
BarcodestringArticle barcode
DiscountdecimalDiscount for the line
ID_Batchlong?Batch ID (to specify a variant when working with variants and the implementation in Bizzio is with batches) – in this case, a specific batch is set. Either batch ID or batch code must be used
BatchCodestringBatch code (to specify a variant when working with variants and the implementation in Bizzio is with batches) – in this case, the specified code may refer to multiple batches, and the system chooses which ones to add to the order. Either batch ID or batch code must be used
IsPromoboolPrice type (true - promotional; false - standard)
PriceListCodestringPrice list code (if not provided, the default price list is used)
QtydecimalQuantity for the line
TotalPricedecimalFinal price with VAT for the row with discount included
RowParamsRP[]List of RP elements with information about the parameters for the line

The ACI object has the following structure:

FieldTypeDescription
ArticleGroupNamestringName of the article group (if not set, the "NEW ITEMS" group is used, as before; if not found, it is created)
NamestringArticle name
CodestringArticle code (if it is an identification field in the profile and it is not set - the Barcode field of OI element is used)
BarcodestringArticle barcode (if it is an identification field in the profile and it is not set - the Barcode field of OI element is used)
MetricstringArticle metric (for instance "pcs.")
WarrantyBuyWIWI element with information about warranty "Buy" (null - no warranty)
WarrantySellWIWI element with information about warranty "Sell" (null - no warranty)

The WI object has the following structure:

FieldTypeDescription
Type int

Warranty type with the following possible values:

  • 0 - no warranty;
  • 1 - days;
  • 2 - weeks;
  • 3 - months;
  • 4 - years;
  • 5 - to date;
  • 6 - unlimited.
AmountintNumber of days/weeks/months/years of the warranty (only for types 1, 2, 3 and 4)
ValidTodatetime?Warranty expiration date (type 5 only)

The RP object has the following structure:

FieldTypeDescription
SectionstringParameter section
ParamstringParameter name
ValuestringParameter value

The InvData object has the following structure:

FieldTypeDescription
AddressstringRegistration address (residential district, street, number)
CitystringCity of registration
CompanyNamestringCompany name
CountryCodestringISO code of the country of registration
ResponsiblestringResponsible person
StatNumberstringUIC / BULSTAT
VatNumberstringVAT / VAT No.

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <CreateOrderRequest xmlns="http://tempuri.org/">
      <Address>бул.България 1</Address>
      <AgentCode i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <City>София</City>
      <ClientCode i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <ClientName>Иван Петров</ClientName>
      <CompanyCode>4001</CompanyCode>
      <CountryCode>BG</CountryCode>
      <Currency>BGN</Currency>
      <Email>petrov@gmail.com</Email>
      <GPS_Latitude>42.7103651</GPS_Latitude>
      <GPS_Longitude>23.365277</GPS_Longitude>
      <ID_Site i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <InvoiceData xmlns:d4p1="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <d4p1:Address>бул. Владимир Вазов 90Б</d4p1:Address>
        <d4p1:City>София</d4p1:City>
        <d4p1:CompanyName>ГенКлауд</d4p1:CompanyName>
        <d4p1:CountryCode>BG</d4p1:CountryCode>
        <d4p1:Responsible>Генчо Чокоев</d4p1:Responsible>
        <d4p1:StatNumber>203378562</d4p1:StatNumber>
        <d4p1:VatNumber>BG203378562</d4p1:VatNumber>
      </InvoiceData>
      <IsVAT>true</IsVAT>
      <Items xmlns:d4p1="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <d4p1:OI>
          <d4p1:ArticleData>
            <d4p1:ArticleGroupName>Тениски</d4p1:ArticleGroupName>
            <d4p1:Barcode>8051498744978</d4p1:Barcode>
            <d4p1:Code i:nil="true" />
            <d4p1:Metric>бр.</d4p1:Metric>
            <d4p1:Name>ILAC1378-L1102272-019/3XL</d4p1:Name>
            <d4p1:WarrantyBuy>
              <d4p1:Amount>6</d4p1:Amount>
              <d4p1:Type>3</d4p1:Type>
              <d4p1:ValidTo i:nil="true" />
            </d4p1:WarrantyBuy>
            <d4p1:WarrantySell i:nil="true" />
          </d4p1:ArticleData>
          <d4p1:Barcode>8051498744978</d4p1:Barcode>
          <d4p1:BatchCode i:nil="true" />
          <d4p1:Discount>0</d4p1:Discount>
          <d4p1:ID_Batch i:nil="true" />
          <d4p1:IsPromo>false</d4p1:IsPromo>
          <d4p1:PriceListCode i:nil="true" />
          <d4p1:Qty>1</d4p1:Qty>
          <d4p1:RowParams>
            <d4p1:RP>
              <d4p1:Param>Доставка</d4p1:Param>
              <d4p1:Section i:nil="true" />
              <d4p1:Value>бърза</d4p1:Value>
            </d4p1:RP>
            <d4p1:RP>
              <d4p1:Param>Разфасовка</d4p1:Param>
              <d4p1:Section>Пакетаж</d4p1:Section>
              <d4p1:Value>1 л.</d4p1:Value>
            </d4p1:RP>
          </d4p1:RowParams>
          <d4p1:TotalPrice>85</d4p1:TotalPrice>
        </d4p1:OI>
      </Items>
      <Mobile>0888 888 888</Mobile>
      <OrderMode>0</OrderMode>
      <OrderNote>без регистрация</OrderNote>
      <OrderNumber>10045</OrderNumber>
      <PaymentType>1</PaymentType>
      <Phone>0888 999 999</Phone>
      <PostCode>1000</PostCode>
      <Props xmlns:d4p1="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <d4p1:PV>
          <d4p1:Code>BOL_LABEL</d4p1:Code>
          <d4p1:Value>http://ee.econt.com/api_export.php?exportMethod=printLoading&amp;loading_num=1054297111122&amp;_key=0c9555fb90269e98e57cd2ba15a2fd16e9c74d37&amp;label=10x15&amp;;</d4p1:Value>
        </d4p1:PV>
      </Props>
      <Province>СОФИЯ</Province>
      <ShippingCost>0</ShippingCost>
      <ShippingDate>2023-05-26T16:03:00</ShippingDate>
      <ShippingMode i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <ShippingType>0</ShippingType>
      <TransporterCode>ECONT</TransporterCode>
      <TransporterOfficeID>474</TransporterOfficeID>
      <UserCode>U01</UserCode>
      <VoucherCode i:nil="true" />
    </CreateOrderRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type CreateOrderResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
IDlongID of the generated document

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <CreateOrderResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <ID>291045276242993251</ID>
    </CreateOrderResponse>
  </s:Body>
</s:Envelope>

GetOrderStates method

Description:

Used to read Bizzio order states. In Bizzio, document states are calculated. Furthermore, a document can be in more than one state. For the purpose of the integration, a linear list of states is introduced, described below. Since the states are calculated, the chosen method is to read the states of all orders, placed after a certain date (since there is no state change date). For each integration, a reasonable period back in time should be chosen, corresponding in general to the normal time for completing an order.

The possible states are:

The following is a description of the input parameters of the method.

Request:

It accepts an argument of type GetOrderStatesRequest, including the following fields:

FieldTypeDescription
AfterDatedatetimeReturn the states of orders, placed after this date

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetOrderStateRequest xmlns="http://tempuri.org/">
      <AfterDate>2022-02-01T00:00:00</AfterDate>
    </GetOrderStateRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetOrderStatesResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
OrdersGOS[]List from GOS elements with state information

The GOS object has the following structure:

FieldTypeDescription
NumberstringOrder number
StateintOrder state

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetOrderStateResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <Orders xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GOS>
          <a:Number>8676548264</a:Number>
          <a:State>300</a:State>
        </a:GOS>
        <a:GOS>
          <a:Number>1672346276</a:Number>
          <a:State>200</a:State>
        </a:GOS>
        <a:GOS>
          <a:Number>1296421266</a:Number>
          <a:State>400</a:State>
        </a:GOS>
        <a:GOS>
          <a:Number>3951199031</a:Number>
          <a:State>100</a:State>
        </a:GOS>
      </Orders>
    </GetOrderStateResponse>
  </s:Body>
</s:Envelope>

GetProps method

Description:

It is used to read the definitions of the properties and their possible values.

Request:

Accepts an argument of type GetPropsRequest (currently - no fields).

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetPropsRequest xmlns="http://tempuri.org/" />
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetPropsResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
PropsProp[]List from Prop elements with information about the properties

The Prop object has the following structure:

FieldTypeDescription
IDlongProperty ID
NamestringProperty name
CodestringProperty code
DataType int

Data type of the property with the following possible values:

  • 1 - string
  • 2 - bool (format is: 0 - false; 1 - true)
  • 3 - long
  • 4 - double
  • 5 - datetime (format is: yyyy-MM-dd HH:mm:ss)
ObjType int

Type of objects to which the property is for, with following possible values:

  • 20 - Partners
  • 27 - Article groups
  • 28 - Articles
  • 30 - Batches
  • 35 - Documents
  • 80 - Sites
PosintPosition (to sort in ascending order)
ValsPPV[]List of PPV elements with information about the possible values (if supported)

The PPV object has the following structure:

FieldTypeDescription
IDlongPossible value ID
CodestringPossible value code
ValstringValue

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetPropsResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <Props xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:Prop>
          <a:Code>COLOR</a:Code>
          <a:DataType>1</a:DataType>
          <a:ID>291045134508752897</a:ID>
          <a:Name>Цвят</a:Name>
          <a:ObjType>30</a:ObjType>
          <a:Pos>0</a:Pos>
          <a:Vals>
            <a:PPV>
              <a:Code>GREEN</a:Code>
              <a:ID>291045138803730268</a:ID>
              <a:Val>зелен</a:Val>
            </a:PPV>
            <a:PPV>
              <a:Code>WHITE</a:Code>
              <a:ID>291045138803730269</a:ID>
              <a:Val>бял</a:Val>
            </a:PPV>
          </a:Vals>
        </a:Prop>
        <a:Prop>
          <a:Code>BRAND</a:Code>
          <a:DataType>1</a:DataType>
          <a:ID>291045134508752904</a:ID>
          <a:Name>Марка</a:Name>
          <a:ObjType>28</a:ObjType>
          <a:Pos>0</a:Pos>
          <a:Vals i:nil="true" />
        </a:Prop>
      </Props>
    </GetPropsResponse>
  </s:Body>
</s:Envelope>

GetPropGroups method

Description:

Used to read site property groups.

Request:

Accepts an argument of type GetPropGroupsRequest (currently - no fields).

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetPropGroupsRequest xmlns="http://tempuri.org/" />
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetPropGroupsResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
PropGroupsPG[]List of PG elements with information about the site property groups

The PG object has the following structure:

FieldTypeDescription
IDlongGroup ID
NamestringGroup name
ObjType int

Type of objects to which the group for with the following possible values:

  • 0 - Articles
  • 1 - Partners
  • 2 - Documents
  • 3 - Warehouses
  • 4 – Sites
ItemsPGI[]List of PGI elements with information about the included properties

The PGI object has the following structure:

FieldTypeDescription
IDlongElement ID
ID_ProplongProperty ID
PosintPosition (to sort ascending in combination with Pos field of the property definition)
FilterType int

Filter type (intended for Articles) with the following possible values:

  • 0 - Do not show
  • 1 - Detailed (all possible values are displayed)
  • 2 - Summarized (with the meaning of a boolean filter - set/not set)
ShowType int

Display type with the following possible values:

  • 0 - Standard
  • 1 - Extended (with alternative element - e.g. via tab)
  • 2 - System (for internal site use)
EditType int

Edit type (intended for Partners and Documents) with the following possible values:

  • 0 - Forbidden
  • 1 - Only when new
  • 2 - Allowed

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetPropGroupsResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <PropGroups xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:PG>
          <a:ID>291045503875940353</a:ID>
          <a:Items>
            <a:PGI>
              <a:EditType>0</a:EditType>
              <a:FilterType>1</a:FilterType>
              <a:ID>291045508170907649</a:ID>
              <a:ID_Prop>291045134508752897</a:ID_Prop>
              <a:Pos>1</a:Pos>
              <a:ShowType>0</a:ShowType>
            </a:PGI>
            <a:PGI>
              <a:EditType>0</a:EditType>
              <a:FilterType>2</a:FilterType>
              <a:ID>291045508170907704</a:ID>
              <a:ID_Prop>291045134508752918</a:ID_Prop>
              <a:Pos>-1</a:Pos>
              <a:ShowType>2</a:ShowType>
            </a:PGI>
          </a:Items>
          <a:Name>Дрехи</a:Name>
          <a:ObjType>0</a:ObjType>
        </a:PG>
      </PropGroups>
    </GetPropGroupsResponse>
  </s:Body>
</s:Envelope>

GetSiteGroups method

Description:

It is used to read the nomenclature of the site groups. They are hierarchical, with no limit on the number of levels.

Request:

Accepts an argument of type GetSiteGroupsRequest with the following structure:

FieldTypeDescription
ID_SitelongSite ID
IsFilesboolWhether to return information about attachments to groups

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetSiteGroupsRequest xmlns="http://tempuri.org/">
      <ID_Site>291045469516201985</ID_Site>
      <IsFiles>true</IsFiles>
    </GetSiteGroupsRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetSiteGroupsResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
SiteGroupsSG[]List of SG elements with information for the site groups

The SG object has the following structure:

FieldTypeDescription
IDlongGroup ID
ID_Parentlong?ID of parent group (null - main group)
NamestringGroup name
CodestringGroup code
PosintGroup position
NotestringGroup description (can include BBCode or HTML)
BatchShowType int

Display type for the batches of the articles in the group with the following possible values:

  • 0 - Do not show (but the articles themselves are displayed)
  • 1 - Show as batches (appropriate visualization on the product page)
  • 2 - Show as articles (each batch is shown as a separate item)
ID_PropGrouplong?ID of property group
MetaNamestringShort description (keywords) for search engines
MetaNotestringExtended description for search engines
FilesFI[]List of FI elements with information about group attachments

The FI object is described in the GetArticles method.

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetSiteGroupsResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <SiteGroups xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:SG>
          <a:BatchShowType>0</a:BatchShowType>
          <a:Code />
          <a:Files>
            <a:FI>
              <a:ID>291045151688622245</a:ID>
              <a:Name>airoh-aviation-rockstar-helmet[1].jpg</a:Name>
              <a:Note />
              <a:RefUri />
              <a:Uri>http://localhost/Bizzio.Web/a/MzZ3KUghemp8LFkHeQIRQ2QAAHcccA8ERnVsAXU.jpg</a:Uri>
            </a:FI>
          </a:Files>
          <a:ID>291045490991039759</a:ID>
          <a:ID_Parent>291045490991039758</a:ID_Parent>
          <a:ID_PropGroup>291045503875940355</a:ID_PropGroup>
          <a:MetaName>Слюди за мотори Puig</a:MetaName>
          <a:MetaNote>Богат асортимент от слюди за мотори на фирмата Puig. Стандартни, състезателни и спортни модели на отлична цена. Вземете всичко необходимо онлайн.</a:MetaNote>
          <a:Name>Слюди</a:Name>
          <a:Note />
          <a:Pos>0</a:Pos>
        </a:SG>
        <a:SG>
          <a:BatchShowType>0</a:BatchShowType>
          <a:Code />
          <a:Files i:nil="true" />
          <a:ID>291045490991039760</a:ID>
          <a:ID_Parent>291045490991039758</a:ID_Parent>
          <a:ID_PropGroup>291045503875940355</a:ID_PropGroup>
          <a:MetaName>Краш тапи за мотори Puig</a:MetaName>
          <a:MetaNote>Богат асортимент от краш тапи за мотори на фирмата Puig. Най-високо качество на изработка на отлична цена. Поръчайте всичко необходимо онлайн.</a:MetaNote>
          <a:Name>Краш тапи</a:Name>
          <a:Note />
          <a:Pos>1</a:Pos>
        </a:SG>
      </SiteGroups>
    </GetSiteGroupsResponse>
  </s:Body>
</s:Envelope>

GetOrderProcessings method

Description:

Used to read information about processings of order in Bizzio, changed after a specific date and time or for specific orders. After that, the site can perform some actions (e.g. when changing the site state - send a letter to the end customer or when shipped - send a letter about what exactly was shipped).

Request:

It accepts an argument of type GetOrderProcessingsRequest, including the following fields:

FieldTypeDescription
AfterDatedatetime?Return order processing after this date and time
ID_Orderslong[]Return processing of specific orders
IsSiteStatesboolWhether to return information about site states
IsShippingsboolWhether to return information about shippings
IsInvoicesboolWhether to return information about invoices for the sales to the orders
IsBillsOfLadingboolWhether to return information about bills of lading to subsequent documents

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetOrderProcessingsRequest xmlns="http://tempuri.org/">
      <AfterDate>2023-07-30T15:01:00</AfterDate>
      <ID_Orders xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <IsBillsOfLading>true</IsBillsOfLading>
      <IsInvoices>true</IsInvoices>
      <IsShippings>true</IsShippings>
      <IsSiteStates>true</IsSiteStates>
    </GetOrderProcessingsRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetOrderProcessingsResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
SiteStatesGO_SS[]List of GO_SS elements with information about the site states
ShippingsGO_SH[]List of GO_SH elements with information about the shippings
InvoicesGO_IV[]List of GO_IV elements with information about the invoices
BillsOfLadingGO_BL[]List of GO_BL elements with information about the bills of lading

The GO_SS object has the following structure:

FieldTypeDescription
ID_OrderlongOrder ID
SiteState int

Site state of the order with the following possible values:

  • 10 - Finalization by the client (not used in the integration)
  • 20 - Confirmed by the customer (newly registered order from the site)
  • 30 - Accepted for processing
  • 40 - Sent to customer
SiteStateDatedatetimeDate and time of change of the site status of the order

The GO_SH object has the following structure:

FieldTypeDescription
ID_OrderlongOrder ID
ID_ShippinglongShipping ID
ShippingDatedatetimeDate and time of shipping
ShippingItemsGO_SHI[]List of GO_SHI elements with information about the lines from the shippings

The GO_SHI object has the following structure:

FieldTypeDescription
BarcodestringArticle barcode
QtydecimalShipped quantity

The GO_IV object has the following structure:

FieldTypeDescription
ID_OrderlongOrder ID
ID_InvoicelongInvoice ID
InvoiceType int

Invoice type with the following possible values:

  • 34 - invoice
  • 36 - credit note (for quantity)
  • 38 - credit note (for revaluation)
  • 96 - credit note (for bonus)
  • 77 - debit note (for quantity)
  • 42 - debit note (for revaluation)
InvoiceNumberlongNumber of the invoice
InvoiceDatedatetimeDate and time of the invoice
InvoiceAmountdecimalAmount of the invoice
InvoiceCurrencystringCurrency of the invoice
InvoiceUrlstringDownload link of the invoice

The GO_BL object has the following structure:

FieldTypeDescription
ID_OrderlongOrder ID
NumberStringBill of lading number
CarrierType Int

Carrier type with the following possible values:

  • 1 - Speedy
  • 2 - LeoExpress
  • 3 - UPS
  • 4 - Econt
  • 5 - Interlogistica
  • 6 - Transpress
  • 7 - NetCourier
  • 8 - Sameday
  • 9 - InTime
  • 10 – BoxNow
  • 12 – DPD
  • 13 - PigeonExpress
TraceUrlstringBill of lading tracking address

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetOrderProcessingsResponse xmlns="http://tempuri.org/">
      <BillsOfLading xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GO_BL>
          <a:CarrierType>4</a:CarrierType>
          <a:ID_Order>291045276242993255</a:ID_Order>
          <a:Number>123</a:Number>
          <a:TraceUrl>https://www.econt.com/services/track-shipment/123</a:TraceUrl>
        </a:GO_BL>
        <a:GO_BL>
          <a:CarrierType>1</a:CarrierType>
          <a:ID_Order>291045276242993255</a:ID_Order>
          <a:Number>456</a:Number>
          <a:TraceUrl>https://www.speedy.bg/bg/track-shipment?shipmentNumber=456</a:TraceUrl>
        </a:GO_BL>
      </BillsOfLading>
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <Invoices xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GO_IV>
          <a:ID_Invoice>283163976894875309</a:ID_Invoice>
          <a:ID_Order>283163976894855314</a:ID_Order>
          <a:InvoiceAmount>21.60</a:InvoiceAmount>
          <a:InvoiceCurrency>BGN</a:InvoiceCurrency>
          <a:InvoiceDate>2024-06-28T14:50:33.173</a:InvoiceDate>
          <a:InvoiceNumber>16</a:InvoiceNumber>
          <a:InvoiceType>34</a:InvoiceType>
          <a:InvoiceUrl i:nil="true" />
        </a:GO_IV>
      </Invoices>
      <Shippings xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GO_SH>
          <a:ID_Order>291045276242883259</a:ID_Order>
          <a:ID_Shipping>291045276242883263</a:ID_Shipping>
          <a:ShippingDate>2023-07-31T01:16:31.243</a:ShippingDate>
          <a:ShippingItems>
            <a:GO_SHI>
              <a:Barcode>A1</a:Barcode>
              <a:Qty>1.000000000</a:Qty>
            </a:GO_SHI>
          </a:ShippingItems>
        </a:GO_SH>
        <a:GO_SH>
          <a:ID_Order>291045276242883259</a:ID_Order>
          <a:ID_Shipping>291045276242883266</a:ID_Shipping>
          <a:ShippingDate>2023-07-31T01:30:06.52</a:ShippingDate>
          <a:ShippingItems>
            <a:GO_SHI>
              <a:Barcode>A1</a:Barcode>
              <a:Qty>1.000000000</a:Qty>
            </a:GO_SHI>
            <a:GO_SHI>
              <a:Barcode>A1</a:Barcode>
              <a:Qty>1.000000000</a:Qty>
            </a:GO_SHI>
          </a:ShippingItems>
        </a:GO_SH>
      </Shippings>
      <SiteStates xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GO_SS>
          <a:ID_Order>291045276242883259</a:ID_Order>
          <a:SiteState>40</a:SiteState>
          <a:SiteStateDate>2023-07-30T16:50:15.097</a:SiteStateDate>
        </a:GO_SS>
      </SiteStates>
    </GetOrderProcessingsResponse>
  </s:Body>
</s:Envelope>

GetOrders method

Description:

Used to return information about orders in Bizzio, made through the integration. Allows filtering by period or by specific orders. Optionally, information about the rows in the orders can also be returned.

Request:

It accepts an argument of type GetOrdersRequest, including the following fields:

FieldTypeTypeDescriptionDescription
OrderMode int

Document type:

  • 0 – order (default);
  • 1 – offer.
AfterDatedatetime?Return orders after this date and time
BeforeDatedatetime?Return orders before this date and time
ID_Orderslong[]Return specific orders by list of IDs
IsItemsboolWhether to return information about order lines

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <GetOrdersRequest xmlns="http://tempuri.org/">
      <AfterDate>2023-10-17T00:00:00</AfterDate>
      <BeforeDate>2023-10-18T00:00:00</BeforeDate>
      <ID_Orders xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <IsItems>true</IsItems>
      <OrderMode>0</OrderMode>
    </GetOrdersRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type GetOrdersResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
PropCodesstring[]List of property codes, which are exported for the documents (the values in the GOR_OH object are in the same order as in this list)
OrdersGOR_OH[]List of GOR_OH elements with order information

The GOR_OH object has the following structure:

FieldTypeDescription
ID_OrderintOrder ID
OrderNumberstringOrder number from the online shop
OrderNotestringOrder note
OrderDatedatetimeOrder date
SiteStateint?Site state of the order (if working in site mode) – information about site states is located in the GetOrderProcessings method
ClientNamestringCustomer name in the order contact
AddressstringAddress (city, street, number) in the order contact
CitystringCity in the order contact
PostCodestringPostal code in the order contact
ProvincestringRegion in the order contact
CountryCodestringISO country code in the order contact
MobilestringMobile phone in the order contact
PhonestringAdditional phone in the order contact
EmailstringEmail in the order contact
TotalPricedecimalTotal price excluding VAT of the order
TotalPriceVATdecimalTotal price with VAT of the order (if there is no VAT it is equal to TotalPrice)
CurrencystringOrder currency ISO code
PaymentTypeintOrder payment type – information about payment types is located in the CreateOrder method
ShippingDatedatetime?Order shipping date
TransporterCodestringCarrier code for the order
TransporterOfficeIDstringID of the carrier's office to which the order will be shipped (from the carrier's nomenclature) - information about the offices is found in the CreateOrder method
Propsstring[]List of values for additional order fields
ItemsGOR_OI[]List of GOR_OI elements with information about the order lines

The GOR_OI object has the following structure:

FieldTypeDescription
BarcodestringArticle barcode for the order line
QtydecimalOrder line quantity
TotalPricedecimalTotal price excluding VAT for the order line
TotalPriceVATdecimalTotal price with VAT for the order line
CurrencystringISO currency code for the order line
ID_Batchlong?Batch ID for the order line (when implementing variants with batches) – information about working with batches is located in the CreateOrder method
BatchCodestringBatch code for the order line (when implementing variants with batches) – information about working with batches is located in the CreateOrder method

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <GetOrdersResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <Orders xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:GOR_OH>
          <a:Address>ул. Резбарска 47</a:Address>
          <a:City>София</a:City>
          <a:ClientName>GenCloud</a:ClientName>
          <a:CountryCode>BG</a:CountryCode>
          <a:Currency>EUR</a:Currency>
          <a:Email>office@gencloud.bg</a:Email>
          <a:ID_Order>291045276242913235</a:ID_Order>
          <a:Items>
            <a:GOR_OI>
              <a:Barcode>A1</a:Barcode>
              <a:BatchCode i:nil="true" />
              <a:Currency>EUR</a:Currency>
              <a:ID_Batch i:nil="true" />
              <a:Qty>1.000000000</a:Qty>
              <a:TotalPrice>16.666667</a:TotalPrice>
              <a:TotalPriceVAT>20.00</a:TotalPriceVAT>
            </a:GOR_OI>
            <a:GOR_OI>
              <a:Barcode>2436-001</a:Barcode>
              <a:BatchCode>1608050285</a:BatchCode>
              <a:Currency>EUR</a:Currency>
              <a:ID_Batch>291045254767840338</a:ID_Batch>
              <a:Qty>1.000000000</a:Qty>
              <a:TotalPrice>258.333333</a:TotalPrice>
              <a:TotalPriceVAT>310.00</a:TotalPriceVAT>
            </a:GOR_OI>
            <a:GOR_OI>
              <a:Barcode>10</a:Barcode>
              <a:BatchCode i:nil="true" />
              <a:Currency>EUR</a:Currency>
              <a:ID_Batch i:nil="true" />
              <a:Qty>1.000000000</a:Qty>
              <a:TotalPrice>7.5</a:TotalPrice>
              <a:TotalPriceVAT>9.00</a:TotalPriceVAT>
            </a:GOR_OI>
          </a:Items>
          <a:Mobile>0888 88 88 88</a:Mobile>
          <a:OrderDate>2023-10-17T15:24:04.18</a:OrderDate>
          <a:OrderNote />
          <a:OrderNumber>20231017.01</a:OrderNumber>
          <a:PaymentType>3</a:PaymentType>
          <a:Phone i:nil="true" />
          <a:PostCode>1510</a:PostCode>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <b:string>Фирма=ГенКлауд
ЕИК=203378562
ДДС №=BG203378562
МОЛ=Генчо Чокоев
Държава=BG
Град=София
Улица=бул. Владимир Вазов 90Б</b:string>
            <b:string>42.710254</b:string>
            <b:string>23.365736</b:string>
            <b:string>999999999</b:string>
          </a:Props>
          <a:Province i:nil="true" />
          <a:ShippingDate>2023-10-18T00:00:00</a:ShippingDate>
          <a:SiteState i:nil="true" />
          <a:TotalPrice>282.50</a:TotalPrice>
          <a:TotalPriceVAT>339.00</a:TotalPriceVAT>
          <a:TransporterCode i:nil="true" />
          <a:TransporterOfficeID />
        </a:GOR_OH>
      </Orders>
      <PropCodes xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:string>INVOICE_DATA</a:string>
        <a:string>Doc.Contact.GPS_Latitude</a:string>
        <a:string>Doc.Contact.GPS_Longitude</a:string>
        <a:string>Doc.Partner.VatStatNumber</a:string>
      </PropCodes>
    </GetOrdersResponse>
  </s:Body>
</s:Envelope>

ManageClient method

Description:

It is used to create new and edit existing clients, with the type of operation being set in the request.

The main identification of the client is by ID. When creating a client, an ID is generated, which is returned as a result. Subsequently, when editing a client, the same ID must be provided in order to find the customer by it. There is also an additional identification field, provided in the request. It is used for compatibility with the partner identification method in the CreateOrder method. The corresponding field is checked to be unique.

Partner fields are only set, if they are different than null. Therefore, it is possible to edit only certain fields (by providing a value for them), and leave the rest with a null value (they will be skipped during editing).

Request:

It accepts an argument of type ManageClientRequest, including the following fields:

FieldTypeDescription
ClientPartnerRecAn object of type PartnerRec with information about the client
ManageType int

Operation type with the following possible values:

  • 1 – Creation of a new client;
  • 2 – Editing of an existing client.
IdentityType int

Identification field, checked to be unique:

  • 1 – Code (Client.Code);
  • 2 – Email (Client.Contact.Email);
  • 3 – Mobile (Client.Contact.Mobile).

The PartnerRec object has the following structure:

FieldTypeDescription
IDlong?ID of the client – for identification when editing (wnen creating it must be null)
CodestringCode of the client (can be set an additional identification field, using IdentityType)
Kind int?

Kind of the client with the following possible values:

  • 0 - Company;
  • 1 - Person;
  • 2 - Man;
  • 3 - Woman.
NamestringName of the client (mandatory when creating)
PartnerGroupstringPartner group of the client (empty value means no value)
ContactCRAn object of type CR wich main contact information
ContactsCR[]A list of CR objects, containing information about the additional contacts of the client. Only items, which are supplied in the request, are processed - the rest of the actual contacts are not processed. Each contact is identified by its Description field. If a contact with the description is found - it is modified, otherwise a new additional contact is created. If all the fields, except the description, are null or empty after editing - the contact is deleted.
VatNumberstringThe VAT number of the client
VatStatNumberstringThe VAT STAT number (BULSTAT) of the client
VatPersonstringResponsible person of the client
InvoiceStreetstringStreet of the registration address of the client
InvoiceCitystringSettlement of the registration address of the client
InvoicePostCodestringPost code of the registration address of the client
InvoiceProvincestringProvince of the registration address of the client
InvoiceCountrystringISO code of the country of the registration address of the client
CreditLimitdecimal?Credit limit of the client (use -1 to set no credit limit)
CurrencystringISO code of the currency of the client (must be set, if there is a credit limit)
PriceGroupstringName of the price group of the client (empty value means no value)
VatStatus int?

VAT status of the client with the following possible values:

  • 0 - unknown;
  • 1 - registered;
  • 2 – not registered;
VatType int?

VAT charging of the client with the following possible values:

  • 0 - not set;
  • 1 - VAT exclusive;
  • 2 - VAT inclusive;
PaymentType int?

Payment type of the client with the following possible values:

  • -1 - not set;
  • 0 - instantly;
  • 1 - postponed;
  • 4 - to days.
PaymentDaysint?Number of days for to days payment
ShipmentType int?

Shipment type of the client with the following possible values:

  • -1 - not set;
  • 0 - instantly;
  • 1 - postponed;
  • 4 - to days.
ShipmentDaysint?Number of days for to days shipment
AssetstringName of the asset of the client (empty value means no value)
WarehouseCodestringCode of the warehouse of the client (empty value means no value)
AgentCodestringCode of the agent of the client (empty value means no value)
TransporterCodestringCode of the transporter of the client (empty value means no value)
MainCompanyCodestringCode of the main company of the client (empty value means no value)
EmployeeCodestringThe code of the responsible employee of the client (empty value means no value)
CompanyCodestringThe code of the company of the client (empty value means no value)
PropsPV[]List of PV elements with information about the properties of the client
FilesFR[]List of FR elements with information about the files of the client
IsActivebool?Whether the client is active or not

The CR object has the following structure:

FieldTypeDescription
DescriptionstringDescription of the contact (used for identification)
MobilestringMobile phone of the contact (can be set an additional identification field of the main contact, using IdentityType)
EmailstringEmail of the contact (can be set an additional identification field of the main contact, using IdentityType)
PersonstringContact person of the contact
StreetstringStreet of the contact
CitystringSettlement of the contact
PostCodestringPost code of the contact
ProvincestringProvince of the contact
CountrystringISO code of the country of the contact

The FR object has the following structure:

FieldTypeDescription
UristringInternet link of the file (mandatory)
NamestringFile name (mandatory – must contain the extension)
AsLinkboolWhether to import as link (true) or to download locally (false)

The PV object is described in the CreateOrder method.

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <ManageClientRequest xmlns="http://tempuri.org/">
      <Client xmlns:d4p1="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <d4p1:AgentCode i:nil="true" />
        <d4p1:Asset i:nil="true" />
        <d4p1:Code i:nil="true" />
        <d4p1:CompanyCode i:nil="true" />
        <d4p1:Contact>
          <d4p1:City>София</d4p1:City>
          <d4p1:Country>BG</d4p1:Country>
          <d4p1:Description>ОФИС</d4p1:Description>
          <d4p1:Email>office@gencloud.bg</d4p1:Email>
          <d4p1:Mobile>0882 07 17 77</d4p1:Mobile>
          <d4p1:Person>Богдан Кръстев</d4p1:Person>
          <d4p1:PostCode>1510</d4p1:PostCode>
          <d4p1:Province i:nil="true" />
          <d4p1:Street>ул. Резбарска 47</d4p1:Street>
        </d4p1:Contact>
        <d4p1:Contacts>
          <d4p1:CR>
            <d4p1:City>София</d4p1:City>
            <d4p1:Country>BG</d4p1:Country>
            <d4p1:Description>ФИНАНСИ</d4p1:Description>
            <d4p1:Email>ceo@gencloud.bg</d4p1:Email>
            <d4p1:Mobile>0884 73 06 01</d4p1:Mobile>
            <d4p1:Person>Виолета Андерсенова</d4p1:Person>
            <d4p1:PostCode>1510</d4p1:PostCode>
            <d4p1:Province i:nil="true" />
            <d4p1:Street>ул. Резбарска 47</d4p1:Street>
          </d4p1:CR>
          <d4p1:CR>
            <d4p1:City>София</d4p1:City>
            <d4p1:Country>BG</d4p1:Country>
            <d4p1:Description>УПРАВИТЕЛ</d4p1:Description>
            <d4p1:Email>gen@gencloud.bg</d4p1:Email>
            <d4p1:Mobile>0888 54 01 05</d4p1:Mobile>
            <d4p1:Person>Генчо Чокоев</d4p1:Person>
            <d4p1:PostCode>1510</d4p1:PostCode>
            <d4p1:Province i:nil="true" />
            <d4p1:Street>ул. Резбарска 47</d4p1:Street>
          </d4p1:CR>
        </d4p1:Contacts>
        <d4p1:CreditLimit i:nil="true" />
        <d4p1:Currency>EUR</d4p1:Currency>
        <d4p1:EmployeeCode i:nil="true" />
        <d4p1:Files>
          <d4p1:FR>
            <d4p1:AsLink>false</d4p1:AsLink>
            <d4p1:Name>BizzioLogo.png</d4p1:Name>
            <d4p1:Uri>https://gencloud.bg/img/Bizzio%20logo.png</d4p1:Uri>
          </d4p1:FR>
        </d4p1:Files>
        <d4p1:ID i:nil="true" />
        <d4p1:InvoiceCity>София</d4p1:InvoiceCity>
        <d4p1:InvoiceCountry>BG</d4p1:InvoiceCountry>
        <d4p1:InvoicePostCode>1538</d4p1:InvoicePostCode>
        <d4p1:InvoiceProvince i:nil="true" />
        <d4p1:InvoiceStreet>бул. Вл.Вазов 90</d4p1:InvoiceStreet>
        <d4p1:IsActive>true</d4p1:IsActive>
        <d4p1:Kind>0</d4p1:Kind>
        <d4p1:MainCompanyCode i:nil="true" />
        <d4p1:Name>ГЕНКЛАУД ООД</d4p1:Name>
        <d4p1:PartnerGroup>Крайни клиенти</d4p1:PartnerGroup>
        <d4p1:PaymentDays>14</d4p1:PaymentDays>
        <d4p1:PaymentType>4</d4p1:PaymentType>
        <d4p1:PriceGroup>Ниво 2</d4p1:PriceGroup>
        <d4p1:Props>
          <d4p1:PV>
            <d4p1:Code>CATEGORY</d4p1:Code>
            <d4p1:Value>Дистрибутори</d4p1:Value>
          </d4p1:PV>
        </d4p1:Props>
        <d4p1:ShipmentDays i:nil="true" />
        <d4p1:ShipmentType i:nil="true" />
        <d4p1:TransporterCode i:nil="true" />
        <d4p1:VatNumber>BG203378562</d4p1:VatNumber>
        <d4p1:VatPerson>Генчо Чокоев</d4p1:VatPerson>
        <d4p1:VatStatNumber>203378562</d4p1:VatStatNumber>
        <d4p1:VatStatus>1</d4p1:VatStatus>
        <d4p1:VatType>2</d4p1:VatType>
        <d4p1:WarehouseCode i:nil="true" />
      </Client>
      <IdentityType>2</IdentityType>
      <ManageType>1</ManageType>
    </ManageClientRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type ManageClientResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
IDlongID of the client (when creating - it is generated, when editing – returns the ID, supplied in the request)

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <ManageClientResponse xmlns="http://tempuri.org/">
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
      <ID>283163912470415880</ID>
    </ManageClientResponse>
  </s:Body>
</s:Envelope>

FindClient method

Description:

It is used to find an existing customer by identity field. The main purpose of the method is when the site creates a new customer to check if it already exists in the database. It can also be used for subsequent synchronization of customer data.

Request:

It accepts an argument of type FindClientRequest, including the following fields:

FieldTypeDescription
IdentitystringIdentity field value
IdentityType int

Identity field to search by, with the following possible values:

  • -1 – ID;
  • 1 – Code;
  • 2 – Email;
  • 3 – Mobile.

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <FindClientRequest xmlns="http://tempuri.org/">
      <Identity>101</Identity>
      <IdentityType>1</IdentityType>
    </FindClientRequest>
  </s:Body>
</s:Envelope>
Response:

Returns an object of type FindClientResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success)
ErrorMessagestringError text (if error)
ErrorTypestringResult type
ClientPartnerRecAn object of type PartnerRec client information

The PartnerRec object is described in the ManageClient method.

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <FindClientResponse xmlns="http://tempuri.org/">
      <Client xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:AgentCode i:nil="true" />
        <a:Asset i:nil="true" />
        <a:Code>101</a:Code>
        <a:CompanyCode i:nil="true" />
        <a:Contact>
          <a:City>София</a:City>
          <a:Country>BG</a:Country>
          <a:Description />
          <a:Email>plamen@gencloud.bg</a:Email>
          <a:Mobile>0889 889 889</a:Mobile>
          <a:Person>Иван Петров</a:Person>
          <a:PostCode>1510</a:PostCode>
          <a:Province />
          <a:Street>Резбарска 47</a:Street>
        </a:Contact>
        <a:Contacts>
          <a:CR>
            <a:City i:nil="true" />
            <a:Country>BG</a:Country>
            <a:Description>Счетоводство/[ACC]/</a:Description>
            <a:Email>admin@gencloud.bg</a:Email>
            <a:Mobile />
            <a:Person />
            <a:PostCode i:nil="true" />
            <a:Province i:nil="true" />
            <a:Street />
          </a:CR>
          <a:CR>
            <a:City i:nil="true" />
            <a:Country>BG</a:Country>
            <a:Description>Офис/[OFFICE][SALES]/</a:Description>
            <a:Email>plamen@gencloud.bg</a:Email>
            <a:Mobile i:nil="true" />
            <a:Person i:nil="true" />
            <a:PostCode i:nil="true" />
            <a:Province i:nil="true" />
            <a:Street i:nil="true" />
          </a:CR>
        </a:Contacts>
        <a:CreditLimit i:nil="true" />
        <a:Currency i:nil="true" />
        <a:EmployeeCode i:nil="true" />
        <a:Files i:nil="true" />
        <a:ID>283163912470265858</a:ID>
        <a:InvoiceCity>София</a:InvoiceCity>
        <a:InvoiceCountry>BG</a:InvoiceCountry>
        <a:InvoicePostCode>1510</a:InvoicePostCode>
        <a:InvoiceProvince />
        <a:InvoiceStreet>Резбарска 47</a:InvoiceStreet>
        <a:IsActive>true</a:IsActive>
        <a:Kind>0</a:Kind>
        <a:MainCompanyCode i:nil="true" />
        <a:Name>КЛИЕНТ</a:Name>
        <a:PartnerGroup>Крайни клиенти</a:PartnerGroup>
        <a:PaymentDays>15</a:PaymentDays>
        <a:PaymentType>-1</a:PaymentType>
        <a:PriceGroup i:nil="true" />
        <a:Props i:nil="true" />
        <a:ShipmentDays>0</a:ShipmentDays>
        <a:ShipmentType>-1</a:ShipmentType>
        <a:TransporterCode i:nil="true" />
        <a:VatNumber>BG203378562</a:VatNumber>
        <a:VatPerson />
        <a:VatStatNumber>203378562</a:VatStatNumber>
        <a:VatStatus>1</a:VatStatus>
        <a:VatType>0</a:VatType>
        <a:WarehouseCode i:nil="true" />
      </Client>
      <ErrorCode>0</ErrorCode>
      <ErrorMessage />
      <ErrorType>Success</ErrorType>
    </FindClientResponse>
  </s:Body>
</s:Envelope>

SetArticlePrices method

Description:

It is used to set the prices of articles in a specific price list. If an article has no price in the list, it is created - otherwise it is updated.

Each price is processed and saved separately - a problematic price does not stop the processing of the others. The prices that are not saved due to an error are returned in Errors, along with the reason. The prices that do not change (the submitted price and currency match the current ones) are skipped.

The price list must be with fixed prices.

Request:

It accepts an argument of type SetArticlePricesRequest, including the following fields:

FieldTypeDescription
PriceListCodestringPrice list code (required)
PricesArticlePriceRec[]List of ArticlePriceRec elements with the prices of the articles (required, at least one)

The ArticlePriceRec object has the following structure:

FieldTypeDescription
Barcode string Article identifier (required) - barcode, code or ID of the article, according to the integration setting for the database (the same identifier as in the other methods). It cannot be repeated within the request (case-insensitive).
PricedecimalPrice (cannot be negative) - with or without VAT, according to the price list setting
Currencystring(3)ISO code of the price currency (required)

In case of a missing or invalid value of PriceListCode, Prices or Barcode (incl. repeated values), as well as in case of an unsuitable price list, no price is saved - the method returns the corresponding error.

Here is a sample request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:Authentication xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:h="http://tempuri.org/">
      <Database xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">DB</Database>
      <Password xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">1</Password>
      <Username xmlns="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop">Admin</Username>
    </h:Authentication>
  </s:Header>
  <s:Body>
    <SetArticlePricesRequest xmlns="http://tempuri.org/">
      <PriceListCode>Promo</PriceListCode>
      <Prices xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:ArticlePriceRec>
          <a:Barcode>8051498744978</a:Barcode>
          <a:Currency>EUR</a:Currency>
          <a:Price>10.40</a:Price>
        </a:ArticlePriceRec>
        <a:ArticlePriceRec>
          <a:Barcode>8051498744985</a:Barcode>
          <a:Currency>EUR</a:Currency>
          <a:Price>12.90</a:Price>
        </a:ArticlePriceRec>
      </Prices>
    </SetArticlePricesRequest>
  </s:Body>
</s:Envelope>
Response:

It returns an object of type SetArticlePricesResponse, including the following fields:

FieldTypeDescription
ErrorCodeintResult code (0 on success; 1 (PartialSuccess) - if any of the prices was not saved)
ErrorMessagestringText of a possible error
ErrorTypestringResult type
SuccessCountintNumber of saved prices
SkippedCountintNumber of skipped prices (unchanged)
ErrorsArticlePriceError[]List of ArticlePriceError elements with information about the prices not saved (null, if there are none)

The ArticlePriceError object has the following structure:

FieldTypeDescription
BarcodestringArticle identifier (as submitted in the request)
Error string

Reason why the price was not saved, e.g.:

  • no article found with the submitted identifier, or more than one found;
  • no currency found with the submitted ISO code;
  • negative price or missing currency.

Here is a sample response:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header />
  <s:Body>
    <SetArticlePricesResponse xmlns="http://tempuri.org/">
      <ErrorCode>1</ErrorCode>
      <ErrorMessage />
      <ErrorType>PartialSuccess</ErrorType>
      <Errors xmlns:a="http://schemas.datacontract.org/2004/07/Bizzio.Srv.Extensions.RiznShop" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:ArticlePriceError>
          <a:Barcode>8051498744985</a:Barcode>
          <a:Error>Ненамерен артикул '8051498744985'!</a:Error>
        </a:ArticlePriceError>
      </Errors>
      <SkippedCount>0</SkippedCount>
      <SuccessCount>1</SuccessCount>
    </SetArticlePricesResponse>
  </s:Body>
</s:Envelope>