A new method SetArticlePrices has been added, which allows setting the prices of articles in a specific price list.
A new method SetArticlePrices has been added, which allows setting the prices of articles in a specific price list.
FindClient method has been added, which allows to find an existing client by identity field.
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.
ManageClient method has been added, which allows to create new and edit existing clients.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
A new payment type TBI has been added with code 11.
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.
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.
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.
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.
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.
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.
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.
The following new payment types have been added to be used in CreateOrder method:
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:
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.
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.
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.
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.
GetProps method has been added, which returns information about the definitions of the properties and their possible values.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
GetOrderStates has been added, which returns information about the Bizzio status of the orders.
A new method GetArticleGroups has been added, which returns information about article groups.
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.
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.
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.
Every request must contain an authentication header. It is named Authentication and contains the following fields:
| Field | Type | Description |
|---|---|---|
| Database | string | Database name |
| Username | string | Username |
| Password | string | Password |
ErrorCode = 0 means a successful result, and the possible errors returned by the system are the following:
| ErrorCode | ErrorType | Description |
|---|---|---|
| -1 | Unknown | Untyped error |
| 1 | PartialSuccess | Partially successful result |
| 2 | NotAuthorized | Authentication failed |
| 3 | NotFound | The requested object was not found |
| 4 | ManyFound | More than one object found |
| 5 | FieldTooLong | Text value exceeds the allowed character length |
| 6 | FieldRequired | Required field |
| 7 | FieldInvalid | Invalid field |
| 8 | ActionInvalid | Invalid action |
| 101 | VoucherInvalid | Problem with payment with voucher |
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:
It is used to read the nomenclature of articles, with different clients having some peculiarities in the returned data.
It accepts an argument of type GetArticlesRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| Barcodes | string[] | Optional filter by articles with specific barcodes |
| AvailableOnly | bool | false - all articles; true - only available articles |
| ModifiedAfter | datetime? | If a date is provided, only articles changed after that date are returned |
| IsFiles | bool | Whether to return information about attachments to the articles |
| IsCars | bool | Whether to return information about cars from the car catalog associated with the articles |
| IsQtyByWarehouses | bool | Whether to return information about the stock of the articles, detailed by warehouses |
| IsQtyExpected | bool | Whether to return information about expected deliveries of the articles |
| ProducerCodes | string[] | Optional filter by articles manufacturer codes |
| ID_Site | long? | 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:
|
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>
Returns an object of type GetArticlesResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| Articles | AI[] | List of AI elements with article information |
| PropCodes | string[] | 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_Batch | string[] | 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:
| Field | Type | Description |
|---|---|---|
| Name | string | Article name |
| Barcode | string | Barcode |
| Props | string[] | List of property values for the article |
| P_Sale | decimal? | Base price (if any) |
| P_Promo | decimal? | Promotional price (if any) |
| Qty | decimal | Stock |
| Qties | QI[] | List of QI elements with data for the stock of the article, detailed by warehouses |
| QtyExpected | QE[] | List of QE elements with data for the expected deliveries of the article |
| Files | FI[] | List of FI elements with data for the attached files of the article |
| Cars | CI[] | List of CI elements with data for the auto catalog cars, associated with the article |
| Batches | BI[] | List of BI elements with data for the batches of the article (for article with batch support) |
| SiteArticles | SA[] | List of SA elements with data for the site registrations of the article (if ID_Site is provided) |
| SiteProps | SP[] | 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:
| Field | Type | Description |
|---|---|---|
| ID | long | File ID |
| Name | string | File name |
| Uri | string | File address |
| RefUri | string | File 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 |
| Note | string | File note |
The CI object has the following structure:
| Field | Type | Description |
|---|---|---|
| Category | string | Car category |
| Brand | string | Car brand |
| Model | string | Car model |
| Year | string | Car year |
The BI object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long | Batch ID |
| Code | string | Batch code |
| ID_Warehouse | long? | Warehouse ID (null, if IsQtyByWarehouses is false) |
| Qty | decimal | Stock |
| IsShowOnly | Bool |
false – can be ordered; true – show-only Whether the stock is show-only:
|
| Props | string[] | List of batch properties |
The SA object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_SiteArticle | long | Article site registration ID |
| ID_SiteGroup | long | Site group ID |
| SiteGroupPos | int? | Article position in site group |
The SP object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Prop | long | Property ID |
| Val | string | Property value |
The QI object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Warehouse | long | Warehouse ID |
| Qty | decimal | Stock |
| IsShowOnly | Bool |
false – can be ordered; true – show-only Whether the stock is show-only:
|
The QE object has the following structure:
| Field | Type | Description |
|---|---|---|
| QtyOrders | decimal | Expected quantities from orders to suppliers |
| QtyDeliveries | decimal | Quantities from incoming deliveries (in shipping process) |
| Date | datetime? | 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>
It is used to read the nomenclature of the article groups. They are hierarchical, with no limit on the number of levels.
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>
Returns an object of type GetArticleGroupsResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| ArticleGroups | GI[] | List of GI elements with information about the article groups |
| PropCodes | string[] | 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:
| Field | Type | Description |
|---|---|---|
| ID | long | Article group ID |
| ID_Parent | long? | ID of parent group (null - main group) |
| Name | string | Article group name |
| Props | string[] | 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>
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.
It accepts an argument of type CreateOrderRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| OrderMode | int |
Document type:
|
| OrderNumber | string(32) | Order number from the online shop |
| OrderNote | string(128) | Order note |
| AgentCode | string | Agent code for the order |
| CompanyCode | string | Our company code for the order |
| UserCode | string | Code of the user who created the order |
| ClientCode | string(48) |
Customer identifier - the following fixed values are supported:
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. |
| ClientName | string(48) | Name of the customer |
| Address | string(128) | Address (city, street, number) |
| City | string(48) | City |
| PostCode | string(16) | Postal code |
| Province | string(48) | Region |
| CountryCode | string(2) | ISO country code |
| GPS_Latitude | double | Latitude for GPS coordinates |
| GPS_Longitude | double | Longitude for GPS coordinates |
| Mobile | string(64) | Mobile phone |
| Phone | string(64) | Additional phone |
| string(128) | ||
| Currency | string(3) | ISO code of the currency of the prices in the order (if not set, the default currency in the database is used) |
| IsVAT | bool? | Indicates whether the prices in the order include VAT (null - true) |
| PaymentType | int | Payment 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 |
| ShippingType | long | Shipping type (0=Free; [ code1 ]=[ delivery1 ] ; ... ) – the codes are dynamic (except 0, which is fixed) |
| ShippingCost | decimal | Shipping cost (for free shipping it is zero - otherwise it must be non-zero) |
| ShippingDate | datetime? | Order shipping date |
| ShippingMode | int? | Shipping mode for the lines (0=immediately; 1=postponed; 2=by date; 4=by days) – the codes are fixed |
| TransporterCode | string | Code 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:
Econt:
Transpress:
|
| VoucherCode | string | Voucher 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_Site | long? | Site ID - if set, uses the settings, payments and shipping of the site, when creating an order |
| InvoiceData | InvData | An object of type InvData containing the invoice information, if any |
| Props | PV[] | List of PV elements with information about the properties of the order |
| Items | OI[] | List of OI elements with information about the lines of the order |
The PV object has the following structure:
| Field | Type | Description |
|---|---|---|
| Code | string | Property code |
| Value | object |
Property value - string encoded as follows:
|
The OI object has the following structure:
| Field | Type | Description |
|---|---|---|
| ArticleData | ACI | ACI 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 |
| Barcode | string | Article barcode |
| Discount | decimal | Discount for the line |
| ID_Batch | long? | 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 |
| BatchCode | string | Batch 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 |
| IsPromo | bool | Price type (true - promotional; false - standard) |
| PriceListCode | string | Price list code (if not provided, the default price list is used) |
| Qty | decimal | Quantity for the line |
| TotalPrice | decimal | Final price with VAT for the row with discount included |
| RowParams | RP[] | List of RP elements with information about the parameters for the line |
The ACI object has the following structure:
| Field | Type | Description |
|---|---|---|
| ArticleGroupName | string | Name of the article group (if not set, the "NEW ITEMS" group is used, as before; if not found, it is created) |
| Name | string | Article name |
| Code | string | Article code (if it is an identification field in the profile and it is not set - the Barcode field of OI element is used) |
| Barcode | string | Article barcode (if it is an identification field in the profile and it is not set - the Barcode field of OI element is used) |
| Metric | string | Article metric (for instance "pcs.") |
| WarrantyBuy | WI | WI element with information about warranty "Buy" (null - no warranty) |
| WarrantySell | WI | WI element with information about warranty "Sell" (null - no warranty) |
The WI object has the following structure:
| Field | Type | Description |
|---|---|---|
| Type | int |
Warranty type with the following possible values:
|
| Amount | int | Number of days/weeks/months/years of the warranty (only for types 1, 2, 3 and 4) |
| ValidTo | datetime? | Warranty expiration date (type 5 only) |
The RP object has the following structure:
| Field | Type | Description |
|---|---|---|
| Section | string | Parameter section |
| Param | string | Parameter name |
| Value | string | Parameter value |
The InvData object has the following structure:
| Field | Type | Description |
|---|---|---|
| Address | string | Registration address (residential district, street, number) |
| City | string | City of registration |
| CompanyName | string | Company name |
| CountryCode | string | ISO code of the country of registration |
| Responsible | string | Responsible person |
| StatNumber | string | UIC / BULSTAT |
| VatNumber | string | VAT / 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&loading_num=1054297111122&_key=0c9555fb90269e98e57cd2ba15a2fd16e9c74d37&label=10x15&;</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>
Returns an object of type CreateOrderResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| ID | long | ID 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>
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.
It accepts an argument of type GetOrderStatesRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| AfterDate | datetime | Return 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>
Returns an object of type GetOrderStatesResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| Orders | GOS[] | List from GOS elements with state information |
The GOS object has the following structure:
| Field | Type | Description |
|---|---|---|
| Number | string | Order number |
| State | int | Order 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>
It is used to read the definitions of the properties and their possible values.
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>
Returns an object of type GetPropsResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| Props | Prop[] | List from Prop elements with information about the properties |
The Prop object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long | Property ID |
| Name | string | Property name |
| Code | string | Property code |
| DataType | int |
Data type of the property with the following possible values:
|
| ObjType | int |
Type of objects to which the property is for, with following possible values:
|
| Pos | int | Position (to sort in ascending order) |
| Vals | PPV[] | List of PPV elements with information about the possible values (if supported) |
The PPV object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long | Possible value ID |
| Code | string | Possible value code |
| Val | string | Value |
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>
Used to read site property groups.
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>
Returns an object of type GetPropGroupsResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| PropGroups | PG[] | List of PG elements with information about the site property groups |
The PG object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long | Group ID |
| Name | string | Group name |
| ObjType | int |
Type of objects to which the group for with the following possible values:
|
| Items | PGI[] | List of PGI elements with information about the included properties |
The PGI object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long | Element ID |
| ID_Prop | long | Property ID |
| Pos | int | Position (to sort ascending in combination with Pos field of the property definition) |
| FilterType | int |
Filter type (intended for Articles) with the following possible values:
|
| ShowType | int |
Display type with the following possible values:
|
| EditType | int |
Edit type (intended for Partners and Documents) with the following possible values:
|
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>
It is used to read the nomenclature of the site groups. They are hierarchical, with no limit on the number of levels.
Accepts an argument of type GetSiteGroupsRequest with the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Site | long | Site ID |
| IsFiles | bool | Whether 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>
Returns an object of type GetSiteGroupsResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| SiteGroups | SG[] | List of SG elements with information for the site groups |
The SG object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long | Group ID |
| ID_Parent | long? | ID of parent group (null - main group) |
| Name | string | Group name |
| Code | string | Group code |
| Pos | int | Group position |
| Note | string | Group description (can include BBCode or HTML) |
| BatchShowType | int |
Display type for the batches of the articles in the group with the following possible values:
|
| ID_PropGroup | long? | ID of property group |
| MetaName | string | Short description (keywords) for search engines |
| MetaNote | string | Extended description for search engines |
| Files | FI[] | 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>
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).
It accepts an argument of type GetOrderProcessingsRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| AfterDate | datetime? | Return order processing after this date and time |
| ID_Orders | long[] | Return processing of specific orders |
| IsSiteStates | bool | Whether to return information about site states |
| IsShippings | bool | Whether to return information about shippings |
| IsInvoices | bool | Whether to return information about invoices for the sales to the orders |
| IsBillsOfLading | bool | Whether 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>
Returns an object of type GetOrderProcessingsResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| SiteStates | GO_SS[] | List of GO_SS elements with information about the site states |
| Shippings | GO_SH[] | List of GO_SH elements with information about the shippings |
| Invoices | GO_IV[] | List of GO_IV elements with information about the invoices |
| BillsOfLading | GO_BL[] | List of GO_BL elements with information about the bills of lading |
The GO_SS object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Order | long | Order ID |
| SiteState | int |
Site state of the order with the following possible values:
|
| SiteStateDate | datetime | Date and time of change of the site status of the order |
The GO_SH object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Order | long | Order ID |
| ID_Shipping | long | Shipping ID |
| ShippingDate | datetime | Date and time of shipping |
| ShippingItems | GO_SHI[] | List of GO_SHI elements with information about the lines from the shippings |
The GO_SHI object has the following structure:
| Field | Type | Description |
|---|---|---|
| Barcode | string | Article barcode |
| Qty | decimal | Shipped quantity |
The GO_IV object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Order | long | Order ID |
| ID_Invoice | long | Invoice ID |
| InvoiceType | int |
Invoice type with the following possible values:
|
| InvoiceNumber | long | Number of the invoice |
| InvoiceDate | datetime | Date and time of the invoice |
| InvoiceAmount | decimal | Amount of the invoice |
| InvoiceCurrency | string | Currency of the invoice |
| InvoiceUrl | string | Download link of the invoice |
The GO_BL object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Order | long | Order ID |
| Number | String | Bill of lading number |
| CarrierType | Int |
Carrier type with the following possible values:
|
| TraceUrl | string | Bill 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>
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.
It accepts an argument of type GetOrdersRequest, including the following fields:
| Field | Type | Type | Description | Description |
|---|---|---|---|---|
| OrderMode | int |
Document type:
|
||
| AfterDate | datetime? | Return orders after this date and time | ||
| BeforeDate | datetime? | Return orders before this date and time | ||
| ID_Orders | long[] | Return specific orders by list of IDs | ||
| IsItems | bool | Whether 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>
Returns an object of type GetOrdersResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| PropCodes | string[] | 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) |
| Orders | GOR_OH[] | List of GOR_OH elements with order information |
The GOR_OH object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID_Order | int | Order ID |
| OrderNumber | string | Order number from the online shop |
| OrderNote | string | Order note |
| OrderDate | datetime | Order date |
| SiteState | int? | Site state of the order (if working in site mode) – information about site states is located in the GetOrderProcessings method |
| ClientName | string | Customer name in the order contact |
| Address | string | Address (city, street, number) in the order contact |
| City | string | City in the order contact |
| PostCode | string | Postal code in the order contact |
| Province | string | Region in the order contact |
| CountryCode | string | ISO country code in the order contact |
| Mobile | string | Mobile phone in the order contact |
| Phone | string | Additional phone in the order contact |
| string | Email in the order contact | |
| TotalPrice | decimal | Total price excluding VAT of the order |
| TotalPriceVAT | decimal | Total price with VAT of the order (if there is no VAT it is equal to TotalPrice) |
| Currency | string | Order currency ISO code |
| PaymentType | int | Order payment type – information about payment types is located in the CreateOrder method |
| ShippingDate | datetime? | Order shipping date |
| TransporterCode | string | Carrier code for the order |
| TransporterOfficeID | string | ID 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 |
| Props | string[] | List of values for additional order fields |
| Items | GOR_OI[] | List of GOR_OI elements with information about the order lines |
The GOR_OI object has the following structure:
| Field | Type | Description |
|---|---|---|
| Barcode | string | Article barcode for the order line |
| Qty | decimal | Order line quantity |
| TotalPrice | decimal | Total price excluding VAT for the order line |
| TotalPriceVAT | decimal | Total price with VAT for the order line |
| Currency | string | ISO currency code for the order line |
| ID_Batch | long? | Batch ID for the order line (when implementing variants with batches) – information about working with batches is located in the CreateOrder method |
| BatchCode | string | Batch 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>
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).
It accepts an argument of type ManageClientRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| Client | PartnerRec | An object of type PartnerRec with information about the client |
| ManageType | int |
Operation type with the following possible values:
|
| IdentityType | int |
Identification field, checked to be unique:
|
The PartnerRec object has the following structure:
| Field | Type | Description |
|---|---|---|
| ID | long? | ID of the client – for identification when editing (wnen creating it must be null) |
| Code | string | Code of the client (can be set an additional identification field, using IdentityType) |
| Kind | int? |
Kind of the client with the following possible values:
|
| Name | string | Name of the client (mandatory when creating) |
| PartnerGroup | string | Partner group of the client (empty value means no value) |
| Contact | CR | An object of type CR wich main contact information |
| Contacts | CR[] | 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. |
| VatNumber | string | The VAT number of the client |
| VatStatNumber | string | The VAT STAT number (BULSTAT) of the client |
| VatPerson | string | Responsible person of the client |
| InvoiceStreet | string | Street of the registration address of the client |
| InvoiceCity | string | Settlement of the registration address of the client |
| InvoicePostCode | string | Post code of the registration address of the client |
| InvoiceProvince | string | Province of the registration address of the client |
| InvoiceCountry | string | ISO code of the country of the registration address of the client |
| CreditLimit | decimal? | Credit limit of the client (use -1 to set no credit limit) |
| Currency | string | ISO code of the currency of the client (must be set, if there is a credit limit) |
| PriceGroup | string | Name of the price group of the client (empty value means no value) |
| VatStatus | int? |
VAT status of the client with the following possible values:
|
| VatType | int? |
VAT charging of the client with the following possible values:
|
| PaymentType | int? |
Payment type of the client with the following possible values:
|
| PaymentDays | int? | Number of days for to days payment |
| ShipmentType | int? |
Shipment type of the client with the following possible values:
|
| ShipmentDays | int? | Number of days for to days shipment |
| Asset | string | Name of the asset of the client (empty value means no value) |
| WarehouseCode | string | Code of the warehouse of the client (empty value means no value) |
| AgentCode | string | Code of the agent of the client (empty value means no value) |
| TransporterCode | string | Code of the transporter of the client (empty value means no value) |
| MainCompanyCode | string | Code of the main company of the client (empty value means no value) |
| EmployeeCode | string | The code of the responsible employee of the client (empty value means no value) |
| CompanyCode | string | The code of the company of the client (empty value means no value) |
| Props | PV[] | List of PV elements with information about the properties of the client |
| Files | FR[] | List of FR elements with information about the files of the client |
| IsActive | bool? | Whether the client is active or not |
The CR object has the following structure:
| Field | Type | Description |
|---|---|---|
| Description | string | Description of the contact (used for identification) |
| Mobile | string | Mobile phone of the contact (can be set an additional identification field of the main contact, using IdentityType) |
| string | Email of the contact (can be set an additional identification field of the main contact, using IdentityType) | |
| Person | string | Contact person of the contact |
| Street | string | Street of the contact |
| City | string | Settlement of the contact |
| PostCode | string | Post code of the contact |
| Province | string | Province of the contact |
| Country | string | ISO code of the country of the contact |
The FR object has the following structure:
| Field | Type | Description |
|---|---|---|
| Uri | string | Internet link of the file (mandatory) |
| Name | string | File name (mandatory – must contain the extension) |
| AsLink | bool | Whether 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>
Returns an object of type ManageClientResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| ID | long | ID 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>
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.
It accepts an argument of type FindClientRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| Identity | string | Identity field value |
| IdentityType | int |
Identity field to search by, with the following possible values:
|
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>
Returns an object of type FindClientResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success) |
| ErrorMessage | string | Error text (if error) |
| ErrorType | string | Result type |
| Client | PartnerRec | An 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>
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.
It accepts an argument of type SetArticlePricesRequest, including the following fields:
| Field | Type | Description |
|---|---|---|
| PriceListCode | string | Price list code (required) |
| Prices | ArticlePriceRec[] | List of ArticlePriceRec elements with the prices of the articles (required, at least one) |
The ArticlePriceRec object has the following structure:
| Field | Type | Description |
|---|---|---|
| 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). |
| Price | decimal | Price (cannot be negative) - with or without VAT, according to the price list setting |
| Currency | string(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>
It returns an object of type SetArticlePricesResponse, including the following fields:
| Field | Type | Description |
|---|---|---|
| ErrorCode | int | Result code (0 on success; 1 (PartialSuccess) - if any of the prices was not saved) |
| ErrorMessage | string | Text of a possible error |
| ErrorType | string | Result type |
| SuccessCount | int | Number of saved prices |
| SkippedCount | int | Number of skipped prices (unchanged) |
| Errors | ArticlePriceError[] | List of ArticlePriceError elements with information about the prices not saved (null, if there are none) |
The ArticlePriceError object has the following structure:
| Field | Type | Description |
|---|---|---|
| Barcode | string | Article identifier (as submitted in the request) |
| Error | string |
Reason why the price was not saved, e.g.:
|
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>