История на промените

2026-11-04:

Методите по-долу бяха надградени да връщат преводите на данните. За целта, към заявките им бе добавено ново поле Language, в което се подава ISO кодът на езика, а към резултата - нови полета с преводите:

Новостите са описани в тялото на методите.

2026-10-19:

Методът CreateOrder бе надграден да позволява идентификация на клиента по ЕИК и ДДС №. За целта, в поле ClientCode бяха добавени нови стойности [StatNumber] и [VatNumber]. Новостите са описани в тялото на метода.

Методите ManageClient и FindClient бяха надградени да позволяват идентификация на клиента по ЕИК и ДДС №. За целта, в поле IdentityType бяха добавени нови стойности 4 (ЕИК) и 5 (ДДС №).

2026-10-13:

Добавен е нов метод SetArticlePrices, който позволява задаване на цените на артикулите в конкретна ценова листа.

2026-08-19:

Добавен е нов метод FindClient, който позволява намиране на съществуващ клиент по поле за идентификация.

2026-08-11:

Kъм FI обектите, съдържащи информация за прикачените файлове към артикулите и групите в сайта, бе добавено ново поле Note. В него се връща бележката, зададена за файла.

2026-07-06:

Добавен е нов метод ManageClient, който позволява създаване на нови и редактиране на съществуващи клиенти.

2026-06-15:

Методът GetArticles бе надграден да връща информация за наличности в допълнителни складове (магазини), които са само за гледане (не могат да се поръчват) и за партидите. За целта, към BI обектите, съдържащи информация за партидите, бе добавено ново поле IsShowOnly. Новостите са описани в тялото на метода.

2026-06-02:

Методът GetArticles бе надграден да връща информация за наличности в допълнителни складове (магазини), които са само за гледане (не могат да се поръчват). За целта, към QI обектите, съдържащи информация за наличностите по складове, бе добавено ново поле IsShowOnly. Новостите са описани в тялото на метода.

2026-05-14:

Към метод GetArticles бе добавен нов входен параметър IsQtyExpected. Чрез него се указва, дали да се връщат информация за очаквани доставки на артикулите. Новостите са описани в секцията на метода.

2026-04-06:

Добавен е нов метод GetOrders, който връща информация за поръчките в Bizzio, направени през интеграцията. Той позволява филтриране по период или по конкретни поръчки. Опционално може да се връща и информация за редовете в поръчките.

2026-03-29:

Методът CreateOrder бе надграден да поддържа подаване на информация за това, дали цените в поръчката са с ДДС. За целта към заявката бе добавен нов входен параметър IsVAT. Новостите са описани в тялото на метода.

Методът CreateOrder бе надграден да поддържа подаване на параметри към редовете на поръчката. За целта, към OI обектите, съдържащи информация за редовете, бе добавено ново поле RowParams. Новостите са описани в тялото на метода.

2025-12-11:

Към метод CreateOrder бе добавена възможност за идентификация на партидите и по код (при работа с варианти, когато в Bizzio реализацията е чрез партиди). За целта, към OI обектите, съдържащи информация за редовете, бе добавено ново поле BatchCode. В него трябва да се подаде кода на партидата. До момента идентификацията на партидите бе по ID на партидата (поле ID_Batch), зад което стои една конкретна партида. Идентификацията по код на партидата (поле BatchCode) позволява зад кода да стоят множество партиди и опростява работата с варианти. Така може да се подава само варианта, а системата да избира кои точно партиди да добави в поръчката.

2025-12-02:

Метод GetArticles бе надграден да връща информация за кодовете на партидите. За целта, към BI обектите, съдържащи информация за партидите, бе добавено ново поле Code.

2025-11-11:

Методът CreateOrder бе надграден да позволява задаване на превозвач и офис на превозвач за поръчката. За целта, към заявката на метода бяха добавени следните нови полета:

Новостите са описани в тялото на метода.

2025-08-22:

Kъм FI обектите, съдържащи информация за прикачените файлове към артикулите и групите в сайта, бе добавено ново поле RefUri. В него се връща допълнителен референтен адрес, ако има такъв. Използва се когато към някакъв файл трябва да има и изображение, с което да се визуализира – тогава като файл се качва изображението, а в референтния адрес се завежда линка към самия файл.

2025-08-05:

Методът GetOrderProcessings бе надграден да връща информация и за товарителниците, пуснати към последващите документи по поръчките. За целта към заявката бе добавен нов входен параметър IsBillsOfLading. Новостите са описани в тялото на метода.

2025-08-04:

Добавен бе нов тип плащане TBI с код 11.

2025-05-21:

Към метод CreateOrder бе добавена възможност за създаване на документ от тип оферта (вместо стандартния тип поръчка). За целта, към заявката на метода бе добавено ново поле OrderMode. То поддържа следните стойности:

При оферта не се проверява за недостатъчни наличности, не се създават резервации за прехвърляне и не се резервират количества.

2025-05-16:

Методът GetArticles бе надграден да връща информация за позициите на артикулите в сайт групите им. За целта, към SA обектите, съдържащи информация за артикулите в сайта, бе добавено ново поле SiteGroupPos.

2024-12-16:

Методът CreateOrder бе надграден да позволява задаване на артикулна група и гаранции при създаване на нови артикули. За целта, към ACI обектите, съдържащи информация за създаване на артикула, са добавени следните нови полета:

Новостите са описани в тялото на метода.

2024-11-02:

Към метод CreateOrder бе добавена възможност за плащане с ваучер. За целта, към заявката на метода бе добавено ново поле VoucherCode. В него трябва да се подаде кода на ваучера. Самият ваучер трябва да съществува в Bizzio, да е валиден, да не е използван и да не надхвърля сумата на поръчката без транспорта.

Бе добавен нов код за грешка 101, указващ проблем при плащане с ваучер.

2024-06-28:

Методът GetOrderProcessings бе надграден да връща информация и за фактурите, пуснати към продажби по поръчките. За целта към заявката бе добавен нов входен параметър IsInvoices. Новостите са описани в тялото на метода.

2024-03-21:

Към метод CreateOrder бе добавена възможност за задаване на ценова листа за редовете в поръчката. За целта, към OI обектите, съдържащи информация за редовете, бе добавено ново поле PriceListCode. В него трябва да се подаде кода на ценовата листа, ако се посочва конкретна такава. Ако полето е празно, системата ще зададе стандартната ценова листа, както досега.

2023-12-19:

Към метод GetArticles бе добавен нов входен параметър IsQtyByWarehouses. Чрез него се указва, дали да се връща информация и за наличностите на артикулите, разбити по складове (а не само общата наличност). За целта, към AI обектите, съдържащи информация за артикулите, бе добавено ново поле Qties. То представлява списък от QI обекти с информация за наличностите по складове. Също така, към BI обектите, съдържащи информация за партидите, бе добавено ново поле ID_Warehouse. То съдържа ID-то на склада за съответната партида. Новостите са описани в тялото на метода.

2023-12-12:

Добавени са следните нови типове плащания за ползване в метод CreateOrder:

2023-12-06:

Методът GetArticles бе надграден да позволява задаване на валутата, в която да се връщат цените на артикулите. За целта, към заявката бе добавено ново поле Currency. То поддържа следните стойности:

2023-11-16:

Методът CreateOrder бе надграден да позволява задаване на валутата, в която са цените в поръчката. За целта, към заявката бе добавено ново поле Currency. В него трябва да се подаде 3-буквения ISO код на валутата. Ако не е зададено се счита, че цените са в основната валута в базата.

2023-10-17:

Методът CreateOrder бе надграден да позволява задаване на фактурна информация към поръчката. За целта, към заявката бе добавено ново поле InvoiceData. То е от тип InvData и съдържа полетата, необходими за издаване на фактура. Новостите са описани в тялото на метода.

2023-07-30:

Добавен е нов метод GetOrderProcessings, който връща информация за обработките на поръчките в Bizzio. Към момента се връща информация за сайт статусите и/или за спедициите на поръчките в Bizzio, след конкретна дата и час или за конкретни поръчки.

2023-07-18:

Бе добавена поддръжка за работа със сайтовете от E-commerce модулите в Bizzio. За целта бяха добавени няколко нови методи за прочитане на номенклатурни обекти и бяха направени промени във вече съществуващи методи. Беше добавена и допълнителна секция в началото на документацията с обобщено описание на интеграцията на E-commerce.

Добавен е нов метод GetPropGroups, който връща информация за групите от характеристики, ползвани в сайтовете.

Добавен е нов метод GetSiteGroups, който връща информация за артикулните групи, дефинирани за конкретен сайт.

Методът GetProps бе надграден да връща типа на обектите, за които е предназначена всяка характеристика, както и позицията й. За целта, към Prop обектите, съдържащи информация за характеристиките, бяха добавени новите полета ObjType и Pos. ObjType е от изброен тип, като възможните му стойности са изредени в описанието на метода.

Методът GetArticles бе надграден да връща само артикулите, регистрирани в конкретен сайт. За целта, към заявката бе добавено ново поле ID_Site. Ако е подададено, за артикулите и партидите се връща допълнителна сайт информация. Новостите са описани в тялото на метода.

Методът GetArticles бе надграден да връща регистрацииите на артикулите в съответния сайт. Всеки артикул от номенклатурата може да бъде регистриран в съответна група на сайта, при което се генерира и съответно ID. За целта, към AI обектите, съдържащи информация за артикулите, бе добавено ново поле SiteArticles. То представлява списък от SA обекти с информация за регистрацията. Новостите са описани в тялото на метода.

Методът GetArticles бе надграден да връща характеристиките от сайтовете за артикулите и партидите. За целта, към AI и BI обектите, съдържащи информация за артикулите и партидите, бе добавено ново поле SiteProps. То представлява списък от SP обекти с информация за характеристиките. Новостите са описани в тялото на метода.

Методът CreateOrder бе надграден да отчита параметрите на конкретен сайт. За целта, към заявката бе добавено ново поле ID_Site. Ако е подададено, повечето от настройките за поръчката се четат от зададеното за сайта (складове, ценови листи, плащания, спедиция и др.).

Добавен бе нов тип плащане Stripe с код 6.

2023-07-12:

Добавен е нов метод GetProps, който връща информация за дефинициите на характеристиките и възможните им стойности.

2023-07-10:

Методът GetArticles бе надграден да връща ID-тата на прикачените файлове към артикулите. За целта, към FI обектите, съдържащи информация за прикачените файлове, бе добавено ново поле ID. Новото поле е предназначено за намиране на съответствия при изграждане на редиректите при миграция на сайтове.

2023-04-22:

Методът CreateOrder бе надграден да позволява задаване на отстъпка към редовете. За целта, към OI обектите, съдържащи информация за редовете на поръчката, е добавено ново поле Discount.

2023-04-19:

Методът CreateOrder бе надграден да задава допълнителен телефон към контактната информация на поръчката. За целта, към заявката бе добавено ново поле Phone, информация за което е дадена по-долу в описанието на метода.

2023-04-09:

Методът CreateOrder бе надграден да задава типът на спедицията за редовете в поръчката. За целта, към заявката бе добавено нов поле ShippingMode, информация за което е дадена по-долу в описанието на метода.

Методът GetArticles бе надграден да приема филтът по производители на артикулите. За целта, към заявката бе добавено ново поле ProducerCodes, информация за което е дадена по-долу в описанието на метода.

2023-03-16:

Методът CreateOrder бе надграден да задава няколко нови параметъра на поръчката. За целта, към заявката бяха добавени следните нови полета:

Добавен бе нов тип плащане BNP_Paribas с код 5.

2022-10-27:

Методът GetArticles бе надграден да връща информация за партидите на артикулите, поддържащи такива. За целта, към AI обектите бе добавено ново Batches, съдържащо списък от BI елементи с данните за партидите. Също така, към обекта GetArticlesResponse бе добавено ново поле PropCodes_Batch, съдържащо списък с кодовете на допълнителните характеристики на партидите (полето е подобно по смисъл и поведение на PropCodes).

Методът CreateOrder бе надграден да позволява поръчка на конкретна партида от артикул. За целта, към OI обектите, съдържащи информация за редовете на поръчката, е добавено ново поле ID_Batch.

2022-09-27:

Методът CreateOrder бе надграден да позволява търсене на клиентите и по email и телефон (освен стандартното по код). Новостите са описани в секцията на метода.

Добавен е нов тип плащане ePay с код 4.

2022-08-01:

Към метод GetArticles бе добавен нов входен параметър IsCars. Чрез него се указва, дали да се връщат информация за автомобилите от автокаталога, асоциирани към артикулите. Новостите са описани в секцията на метода.

2022-07-23:

Методът CreateOrder бе надграден да позволява задаване на характеристики към поръчката. За целта, към заявката бе добавено ново поле Props, което представлява списък от PV обекти, съдържащи информация за характеристиките.

2022-06-23:

Методът CreateOrder бе надграден да позволява създаване на ненамерени артикули. За целта, към OI обектите, съдържащи информация за редовете на поръчката, е добавено ново поле ArticleData. То е от тип ACI и съдържа информацията за създаване на артикула, ако не е намерен. Ако в съответният профил ще се създават артикули, ArticleData трябва да се попълва винаги - иначе следва да е null.

Методът CreateOrder бе надграден да позволява задаване на агент към поръчката. За целта, към полетата на заявката бе добавено ново AgentCode. То съдържа кода на агента и е опционално. Агентите могат да се ползват например за диференциране на сайта, от който идва поръчката.

2022-02-17:

Добавен е нов метод GetOrderStates, който връща информация за Bizzio статуса на поръчките.

2022-02-02:

Добавен е нов метод GetArticleGroups, който връща информация за артикулните групи.

2022-01-21:

Към метод GetArticles бе добавен нов входен параметър IsFiles. Чрез него се указва, дали да се връщат информация за прикачените файлове към артикулите. Новостите са описани в секцията на метода.

2020-02-12:

Бе изчистена схемата за наименоване на артикулите, както и задаването на характеристиките им. Информацията е добавена в началото на описанието на метод GetArticles.


Общи положения

Описание:

Интерфейсът представлява WCF Web service, който е SOAP базиран. Той предоставя набор от методи, чрез който да се извършват определени операции. Името на метода, който трябва да се извика, се задава в стандартен хедър на заявката с име SOAPAction и стойност http://tempuri.org/IRiznShopExtService/[име на метода], напр.:

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

Всеки request изисква аутентикация, която се изпраща в тялото му по формата на потребителски хедър, наречен от нас Authentication (описан е по-долу). Всеки response има стандартна част, в която се връща информация за евентуална грешка (ErrorCode/ErrorMessage/ErrorType -> код/текст/тип) и конкретна част, зависеща от съответния метод.

Хедър за аутентикация

Описание:

Всяка заявка трябва да съдържа хедър за аутентикация. Той е наименован Authentication и съдържа следните полета:

ПолеТипОписание
DatabasestringИме на базата данни
UsernamestringПотребителско име
PasswordstringПарола

Кодове за грешка

Описание:

ErrorCode = 0 означава успешен резултат, като възможните грешки връщани от системата са следните:

ErrorCodeErrorTypeОписание
-1UnknownНетипизирана грешка
1PartialSuccessЧастично успешен резултат
2NotAuthorizedНеуспешна аутентикация
3NotFoundТърсеният обект не е намерен
4ManyFoundНамерени са повече от един обекти
5FieldTooLongТекстова стойност надхвърля позволената дължина в символи
6FieldRequiredЗадължително поле
7FieldInvalidНевалидно поле
8ActionInvalidНевалидно действие
101VoucherInvalidПроблем при плащане с ваучер

Работа със сайтове

Описание:

В Bizzio има група от модули, наречена E-commerce, която предоставя инструменти за свързване на външни сайтове със системата. Модулите включват:

Обобщено казано, модулите представляват нещо като шаблон, предназначен за показване на информацията от основната номенклатура към външната система - при това, по подходящ и за двете страни начин. Основният акцент на връзката е, че за всеки сайт се създава алтернативна номенклатура от сайт артикулни групи, в които се регистрират вече съществуващи артикули от основната номенклатура. Също така, чрез групите от характеристики се описва подмножеството от представляващите интерес за сайта характеристики на артикулите, а за всяка сайт група се задава с коя група от характеристики работи.

Следните методи от интеграцията са свързани с работата със сайтове:


Метод GetArticles

Описание:

Използва се за прочитане на номенклатурата на артикулите, като при различните клиенти има особености във връщаните данни.

Заявка:

Приема аргумент от тип GetArticlesRequest, включващ следните полета:

ПолеТипОписание
Barcodesstring[]Опционален филтър по артикули с конкретни баркодове
AvailableOnlyboolfalse - всички артикули; true - само наличните артикулите
ModifiedAfterdatetime?Ако е подадена дата се връщат само артикулите, променени след нея
IsFilesboolДали да се връща информация за прикачените файлове към артикулите
IsCarsboolДали да се връща информация за автомобилите от автокаталога, асоциирани към артикулите
IsQtyByWarehousesboolДали да се връща информация за наличностите на артикулите, разбити по складове
IsQtyExpectedboolДали да се връща информация за очаквани доставки на артикулите
ProducerCodesstring[]Опционален филтър по кодове на производители на артикулите
ID_Sitelong?ID на сайт - ако е подадено се връщат само артикулите, регистрирани в съответния сайт, както и допълнителна сайт информация за тях
Currency string

Валута, в която да се връщат цените на артикулите. Поддържат се следните стойности:

  • null - цените се връщат в основната валута в базата;
  • празен стринг - цените се връщат във валутите, в които са зададени;
  • 3-буквен ISO код - цените се връщат в подадената валута.
Language string

2-буквен ISO код на език (напр. EN), на който да се връщат преводите на артикулите и характеристиките. Ако не е подаден, преводи не се връщат и полетата NameLang, PropsLang и ValLang са null. Ако езикът не е намерен, се връща грешка.

Не всички полета могат да се превеждат. Превеждат се:

  • името на артикула;
  • текстовите характеристики на артикулите, групите и партидите (числовите, датите и логическите не се превеждат);
  • полетата Art.Name, Art.WebName, Art.WebNote, Grp.Name, както и имената на мерната единица, държавата на произход, доставчика, производителя и уеб групата.

За поле, което не се превежда или няма въведен превод, се връща празен стринг - в този случай трябва да се ползва оригиналната стойност.

Ето примерна заявка:

<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>
      <Language>EN</Language>
      <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>
Отговор:

Връща обект от тип GetArticlesResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
ArticlesAI[]Списък от AI елементи с информация за артикулите
PropCodesstring[]Списък от кодове на характеристики, които се изпращат за артикулите (стойностите в AI обекта са в същият ред, както в този списък)
PropCodes_Batchstring[]Списък от кодове на характеристики, които се изпращат за партидите (стойностите в BI обекта са в същият ред, както в този списък)

Обектът от тип AI е със следната структура:

ПолеТипОписание
NamestringИме на артикула
NameLangstringПревод на името на артикула (при подадено Language)
BarcodestringБаркод
Propsstring[]Списък със стойностите на характеристиките за артикула
PropsLangstring[]Списък с преводите на характеристиките за артикула, в реда на Props (при подадено Language)
P_Saledecimal?Основна цена (ако има)
P_Promodecimal?Промоционална цена (ако има)
QtydecimalНаличност
QtiesQI[]Списък с информация за наличностите, разбити по складове
QtyExpectedQE[]Списък с информация за очакваните доставки
FilesFI[]Списък с информация за прикачените файлове към артикула
CarsCI[]Списък с информация за автомобилите от автокаталога, асоциирани към артикула
BatchesBI[]Списък с информация за партидите към артикула (за артикули, поддържащи такива)
SiteArticlesSA[]Списък с информация за сайт регистрациите на артикулите (при подадено ID_Site)
SitePropsSP[]Списък с информация за сайт характеристиките на артикулите (при подадено ID_Site)

Обектът от тип FI е със следната структура:

ПолеТипОписание
IDlongID на файла
NamestringИме на файла
UristringАдрес на файла
RefUristringРеферентен адрес на файла - използва се когато към някакъв файл трябва да има и изображение, с което да се визуализира – тогава като файл се качва изображението, а в референтния адрес се завежда линка към самия файл.
NotestringБележка на файла

Обектът от тип CI е със следната структура:

ПолеТипОписание
CategorystringКатегория на автомобила
BrandstringМарка на автомобила
ModelstringМодел на автомобила
YearstringГодина на автомобила

Обектът от тип BI е със следната структура:

ПолеТипОписание
IDlongID на партидата
CodestringКод на партидата
ID_Warehouselong?ID на склада (null, ако IsQtyByWarehouses е false)
QtydecimalНаличност
IsShowOnly bool

Дали наличността е само за гледане:

  • false (може да се поръчва - свободна наличност в склад);
  • true (само за гледане - може да се види на място в магазин).
Propsstring[]Списък със стойностите на характеристиките за партидата
PropsLangstring[]Списък с преводите на характеристиките за партидата, в реда на Props (при подадено Language)

Обектът от тип SA е със следната структура:

ПолеТипОписание
ID_SiteArticlelongID на сайт регистрацията на артикула
ID_SiteGrouplongID на сайт групата
SiteGroupPosint?Позиция на артикула в сайт групата

Обектът от тип SP е със следната структура:

ПолеТипОписание
ID_ProplongID на характеристиката
ValstringСтойност на характеристиката
ValLangstringПревод на стойността на характеристиката (при подадено Language)

Обектът от тип QI е със следната структура:

ПолеТипОписание
ID_WarehouselongID на склада
QtydecimalНаличност
IsShowOnly bool

Дали наличността е само за гледане:

  • false (може да се поръчва - свободна наличност в склад);
  • true (само за гледане - може да се види на място в магазин).

Обектът от тип QE е със следната структура:

ПолеТипОписание
QtyOrdersdecimalОчаквани количества по поръчки към доставчици
QtyDeliveriesdecimalКоличества по входящи доставки (в процес на спедиране)
Datedatetime?Очаквана дата на спедиция

Ето примерен отговор:

<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:PropsLang xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <b:string />
              </a:PropsLang>
              <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:PropsLang xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <b:string />
              </a:PropsLang>
              <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:PropsLang xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <b:string />
              </a:PropsLang>
              <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:NameLang>ILAC1378-L1102272-019-3XL Leather belt</a:NameLang>
          <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:PropsLang xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <b:string />
            <b:string />
            <b:string />
            <b:string />
            <b:string>Belt</b:string>
            <b:string />
            <b:string>100% calf leather</b:string>
            <b:string />
          </a:PropsLang>
          <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>
            <a:SP>
              <a:ID_Prop>291045224703067201</a:ID_Prop>
              <a:Val>Черен</a:Val>
              <a:ValLang>Black</a:ValLang>
            </a:SP>
          </a:SiteProps>
        </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

Описание:

Използва се за прочитане на номенклатурата на артикулните групи. Те са йерархични, като няма ограничение в броя на нивата.

Заявка:

Приема аргумент от тип GetArticleGroupsRequest със следната структура:

ПолеТипОписание
Languagestring2-буквен ISO код на език (напр. EN), на който да се връщат преводите. Ако не е подаден, преводи не се връщат и полетата с преводи са null. Ако езикът не е намерен, се връща грешка. Превеждат се името на групата, текстовите характеристики и полето Grp.Name. За поле, което не се превежда или няма въведен превод, се връща празен стринг - в този случай трябва да се ползва оригиналната стойност.

Ето примерна заявка:

<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/">
      <Language>EN</Language>
    </GetArticleGroupsRequest>
  </s:Body>
</s:Envelope>
Отговор:

Връща обект от тип GetArticleGroupsResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
ArticleGroupsGI[]Списък от GI елементи с информация за артикулните групи
PropCodesstring[]Списък от кодове на характеристики, които се изпращат за артикулните групи (стойностите в GI обекта са в същият ред, както в този списък)

Обектът от тип GI е със следната структура:

ПолеТипОписание
IDlongID на артикулната група
ID_Parentlong?ID на групата родител (null - главна група)
NamestringИме на артикулната група
NameLangstringПревод на името на артикулната група (при подадено Language)
Propsstring[]Списък със стойностите на характеристиките за артикулната група
PropsLangstring[]Списък с преводите на характеристиките за артикулната група, в реда на Props (при подадено Language)

Ето примерен отговор:

<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:NameLang>Velika</a:NameLang>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
          <a:PropsLang 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:NameLang>Deroni</a:NameLang>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
          <a:PropsLang 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:NameLang>Leda</a:NameLang>
          <a:Props xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
          <a:PropsLang 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

Описание:

Използва се за регистриране на поръчка, като се поддържат два подхода - с или без регистрация на клиента. И в двата случая, информацията за конкретния клиент се записва в контактната информация на поръчката. Намирането на клиента става по идентификатор, който може да бъде код, email или телефон. При подаден идентификатор и ненамерен клиент се създава акаунт, ползвайки текущата информация за спедицията на поръчката. Поведението на идентификатора е описано по-долу в поле ClientCode.

Поддържа се и създаване на артикули, които не присъстват в Bizzio. За целта, необходимата информация винаги се подава към всеки ред от поръчката и ако артикулът не е намерен, той се създава на нейна база. Това е специфична функционалност и следва да се ползва само, където се налага.

Заявка:

Приема аргумент от тип CreateOrderRequest, включващ следните полета:

ПолеТипОписание
OrderMode int

Тип на документа:

  • 0 – поръчка (по подразбиране);
  • 1 – оферта – в тази ситуация не се проверява за недостатъчни наличности, не се създават резервации за прехвърляне и не се резервират количества.
OrderNumberstring(32)Номер на поръчката от online магазина
OrderNotestring(128)Бележка към поръчката
AgentCodestringКод на агента за поръчката
CompanyCodestringКод на наша фирма за поръчката
UserCodestringКод на потребител, създал поръчката
ClientCode string(48)

Идентификатор на клиента - поддържат се следните фиксирани стойности:

  • [Email] - търси по email на клиентите (подаденото в поле Email);
  • [Mobile] - търси по телефон на клиентите (подаденото в поле Mobile).
  • [MobileLast] - търси по телефон на клиентите (подаденото в поле Mobile), като при намерени повече от един - ползва последно регестрираният;
  • [StatNumber] - търси по ЕИК на клиентите (подаденото в поле InvoiceData.StatNumber);
  • [VatNumber] - търси по ДДС № на клиентите (подаденото в поле InvoiceData.VatNumber).

Ако е подадена някаква друга стойност - търси по код на клиента (стойността).

Ненамерените клиенти се създават.

При [StatNumber] и [VatNumber] поле InvoiceData е задължително (заедно с полето, по което се търси). Клиентът на поръчката е самата фирма: ненамерен клиент се създава като фирма с данните от InvoiceData (име, ЕИК, ДДС №, МОЛ, адрес по регистрация), без контактна информация, а фактурната информация не се записва отделно към поръчката.

Ако не е подаден идентификатор - ползва се общият клиент.

ClientNamestring(48)Имена на клиента
Addressstring(128)Адрес (ж.к., ул., №)
Citystring(48)Град
PostCodestring(16)Пощенски код
Provincestring(48)Област
CountryCodestring(2)ISO код на държавата
GPS_LatitudedoubleШирина за GPS координати
GPS_LongitudedoubleДължина за GPS координати
Mobilestring(64)Мобилен телефон
Phonestring(64)Допълнителен телефон
Emailstring(128)Електронна поща
Currencystring(3)ISO код на валутата, в която са цените в поръчката (ако не е подадена се ползва основната валута в базата)
IsVATbool?Указва, дали цените в поръчката са с ДДС (null == true)
PaymentTypeintТип на плащането (0=Банка; 1=Карта; 2=Наложен платеж; 3=В брой; 4=ePay; 5=BNP_Paribas; 6=Stripe; 7=PayPal; 8=b-Payment; 9=myPOS; 10=B2B; 11=TBI) - кодовете са фиксирани
ShippingTypelongТип на доставката (0=Безплатна; [код1]=[доставка1]; ... ) - кодовете са динамични (с изключение на 0, който е фиксиран)
ShippingCostdecimalЦена за доставка (при безплатните доставки е нула - иначе трябва да е ненулева)
ShippingDatedatetime?Дата на спедиция на поръчката
ShippingModeint?Тип на спедиция за редовете (0=веднага; 1=отложено; 2=до дата; 4=до дни) - кодовете са фиксирани
TransporterCodestringКод на превозвача за поръчката
TransporterOfficeID string

ID на офиса на презовача, до който ще се спедира поръчката (от номенклатурата на превозвача).

Ако е зададено, трябва TransporterCode също да е зададено или в режим сайт (ID_Site е зададено) за типа на доставката (посочен в ShippingType) да има зададен превозвач (в Bizzio). За зададеният превозвач трябва да има зададена и тип на товарителницата (в Bizzio).

Прилагаме примери за няколко реални офиса на превозвачи:

Speedy:

  • ID - 2
  • Име - СОФИЯ - СОМАТ
  • Адрес - СОФИЯ, ул. АБАГАР No 22

Econt:

  • ID - 133
  • Код - 8501
  • Име - Айтос Автогара
  • Адрес - Айтос, ул. Георги Кондолов №7

Transpress:

  • ID - ПЛО
  • Име - Пловдив
  • Адрес - Пловдив, ул. Кукленско шосе 11
VoucherCodestringКод на ваучер, с който да се плати. Самият ваучер трябва да съществува в Bizzio, да е валиден, да не е използван и да не надхвърля сумата на поръчката без транспорта
ID_Sitelong?ID на сайт - ако е подадено ползва параметрите на сайта и заложените плащания и спедиции при създаване на поръчка
InvoiceDataInvDataОбект от тип InvData, съдържащ фактурната информация, ако ще има фактура
PropsPV[]Списък от PV елементи с информация за характеристиките на поръчката
ItemsOI[]Списък от OI елементи с информация за артикулите за поръчка

Обектът от тип PV е със следната структура:

ПолеТипОписание
CodestringКод на характеристиката
Value object

Стойност на характеристиката - кодирана в string, както следва:

  • bool - 0 = False, 1 = True;
  • decimal - десетичен разделител точка
  • datetime - формат yyyyMMddHHmmss

Обектът от тип OI е със следната структура:

ПолеТипОписание
ArticleDataACIОбект от тип ACI с информация за създаване на артикула (при нужда) - ако ще се създават артикули, трябва да се попълва винаги - иначе следва да е null
BarcodestringБаркод на артикула
DiscountdecimalОтстъпка за реда
ID_Batchlong?ID на партида (за указване на вариант при реализация с партиди) – в този случай се подава конкретна партида. Може да се работи или само с ID-та или само с кодове на партидите.
BatchCodestringКод на партида (за указване на вариант при реализация с партиди) – в този случай, зад подадения код може да стоят множество партиди, като системата избира кои точно да добави в поръчката. Може да се работи или само с кодове или само с ID-та на партидите.
IsPromoboolВид цена (true - промоционална; false - стандартна)
PriceListCodestringКод на ценова листа (ако не е подаден се ползва стандартната ценова листа)
QtydecimalКоличество за реда
TotalPricedecimalКрайна цена с ДДС за реда с включена отстъпка
RowParamsRP[]Списък от RP елементи с информация за параметрите към реда на поръчката

Обектът от тип ACI е със следната структура:

ПолеТипОписание
ArticleGroupNamestringИме на артикулната група (ако не е зададена, се ползва група "НОВИ АРТИКУЛИ", както досега; ако не е намерена се създава)
NamestringИме на артикула
CodestringКод на артикула (ако е идентификационно поле в профила и не е подадено - ползва се поле Barcode на елемента)
BarcodestringБаркод на артикула (ако е идентификационно поле в профила и не е подадено - ползва се поле Barcode на елемента)
MetricstringМерна единица на артикула (напр. "бр.")
WarrantyBuyWIОбект от тип WI с информация за гаранция "Купува" (null - без гаранция)
WarrantySellWIОбект от тип WI с информация за гаранция "Продава" (null - без гаранция)

Обектът от тип WI е със следната структура:

ПолеТипОписание
Type int

Тип на гаранцията със следните възможни стойности:

  • 0 - без гаранция;
  • 1 - дни;
  • 2 - седмици;
  • 3 - месеци;
  • 4 - години;
  • 5 - до дата;
  • 6 - доживотна.
AmountintБрой дни/седмици/месеци/години на гаранцията (само за типове 1, 2, 3 и 4)
ValidTodatetime?Дата, до която е валидна гаранцията (само за тип 5)

Обектът от тип RP е със следната структура:

ПолеТипОписание
SectionstringСекция на параметъра
ParamstringИме на параметъра
ValuestringСтойност на параметъра

Обектът от тип InvData е със следната структура:

ПолеТипОписание
AddressstringАдрес на регистрация (ж.к., ул., №)
CitystringГрад на регистрация
CompanyNamestringИме на фирмата
CountryCodestringISO код на държавата на регистрация
ResponsiblestringМОЛ
StatNumberstringЕИК / БУЛСТАТ
VatNumberstringИНЗДДС / ДДС №

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип CreateOrderResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
IDlongID на генерирания документ

Ето примерен отговор:

<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

Описание:

Използва се за прочитане на Bizzio статусите на поръчките. В Bizzio, статусите на документите са калкулируеми. Освен това, даден документ може да е в повече от един статус. За целите на интеграцията, е въведен един линеен списък от статуси, описан по-долу. Понеже статусите са калкулируеми, е избран подход за прочитане на статусите на всички поръчки, направени след определена дата (понеже няма дата на смяна на статуса). При всяка интеграция трябва да се избере разумен период назад във времето, отговарящ като цяло на нормалното време за изпълняване на поръчка.

Възможните статуси са:

Следва описание на входните параметри на метода.

Заявка:

Приема аргумент от тип GetOrderStatesRequest, включващ следните полета:

ПолеТипОписание
AfterDatedatetimeДа се върнат статусите на поръчките, направени след тази дата

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип GetOrderStatesResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
OrdersGOS[]Списък от GOS елементи с информация за статусите

Обектът от тип GOS е със следната структура:

ПолеТипОписание
NumberstringНомер на поръчката
StateintСтатус на поръчката

Ето примерен отговор:

<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

Описание:

Използва се за прочитане на дефинициите на характеристиките и възможните им стойности.

Заявка:

Приема аргумент от тип GetPropsRequest със следната структура:

ПолеТипОписание
Languagestring2-буквен ISO код на език (напр. EN), на който да се връщат преводите. Ако не е подаден, преводи не се връщат и полетата с преводи са null. Ако езикът не е намерен, се връща грешка. За поле без въведен превод се връща празен стринг - в този случай трябва да се ползва оригиналната стойност.

Ето примерна заявка:

<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/">
      <Language>EN</Language>
    </GetPropsRequest>
  </s:Body>
</s:Envelope>
Отговор:

Връща обект от тип GetPropsResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
PropsProp[]Списък от Prop елементи с информация за характеристиките

Обектът от тип Prop е със следната структура:

ПолеТипОписание
IDlongID на характеристиката
NamestringИме на характеристиката
NameLangstringПревод на името на характеристиката (при подадено Language)
CodestringКод на характеристиката
DataType int

Тип на данните на характеристиката със следните възможни стойности:

  • 1 - string
  • 2 - bool (форматът е: 0 - false; 1 - true)
  • 3 - long
  • 4 - double
  • 5 - datetime (форматът е: yyyy-MM-dd HH:mm:ss)
ObjType int

Тип на обектите, за които е характеристиката със следните възможни стойности:

  • 20 - Партньори
  • 27 - Артикулни групи
  • 28 - Артикули
  • 30 - Партиди
  • 35 - Документи
  • 80 - Сайтове
PosintПозиция (за сортиране във възходящ ред)
ValsPPV[]Списък от PPV елементи с информация за възможните стойности (ако поддържа)

Обектът от тип PPV е със следната структура:

ПолеТипОписание
IDlongID на възможната стойност
CodestringКод на възможната стойност
ValstringСтойност
ValLangstringПревод на стойността (при подадено Language; превеждат се само текстовите стойности)

Ето примерен отговор:

<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:NameLang>Color</a:NameLang>
          <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:ValLang>green</a:ValLang>
            </a:PPV>
            <a:PPV>
              <a:Code>WHITE</a:Code>
              <a:ID>291045138803730269</a:ID>
              <a:Val>бял</a:Val>
              <a:ValLang>white</a:ValLang>
            </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:NameLang>Brand</a:NameLang>
          <a:ObjType>28</a:ObjType>
          <a:Pos>0</a:Pos>
          <a:Vals i:nil="true" />
        </a:Prop>
      </Props>
    </GetPropsResponse>
  </s:Body>
</s:Envelope>

Метод GetPropGroups

Описание:

Използва се за прочитане на сайт групите от характеристики.

Заявка:

Приема аргумент от тип GetPropGroupsRequest (към момента - без полета).

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип GetPropGroupsResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
PropGroupsPG[]Списък от PG елементи с информация за сайт групите от характеристики

Обектът от тип PG е със следната структура:

ПолеТипОписание
IDlongID на групата
NamestringИме на групата
ObjType int

Тип на обектите, за които е групата със следните възможни стойности:

  • 0 - Артикули
  • 1 - Партньори
  • 2 - Документи
  • 3 - Складове
  • 4 - Сайтове
ItemsPGI[]Списък от PGI елементи с информация за включените характеристики

Обектът от тип PGI е със следната структура:

ПолеТипОписание
IDlongID на елемента
ID_ProplongID на характеристиката
PosintПозиция (за сортиране във възходящ ред в комбинация с Pos на дефиницията на характеристиката)
FilterType int

Тип филтър (предназначено за Артикули) със следните възможни стойности:

  • 0 - Не показвай
  • 1 - Детайлно (показват се всички възможни стойности)
  • 2 - Обобщено (със смисъл на булев филтър - зададено/незададено)
ShowType int

Показване със следните възможни стойности:

  • 0 - Стандартно
  • 1 - Разширено (с алтернативен елемент - напр. чрез табче)
  • 2 - Системно (за вътрешно ползване от сайта)
EditType int

Редактиране (предназначено за Партньори и Документи) със следните възможни стойности:

  • 0 - Забранено
  • 1 - Само при нов
  • 2 - Разрешено

Ето примерен отговор:

<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

Описание:

Използва се за прочитане на номенклатурата на сайт артикулните групи. Те са йерархични, като няма ограничение в броя на нивата.

Заявка:

Приема аргумент от тип GetSiteGroupsRequest със следната структура:

ПолеТипОписание
ID_SitelongID на сайт
IsFilesboolДали да се връща информация за прикачените файлове към групите
Languagestring2-буквен ISO код на език (напр. EN), на който да се връщат преводите. Ако не е подаден, преводи не се връщат и полетата с преводи са null. Ако езикът не е намерен, се връща грешка. За поле без въведен превод се връща празен стринг - в този случай трябва да се ползва оригиналната стойност.

Ето примерна заявка:

<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>
      <Language>EN</Language>
    </GetSiteGroupsRequest>
  </s:Body>
</s:Envelope>
Отговор:

Връща обект от тип GetSiteGroupsResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
SiteGroupsSG[]Списък от SG елементи с информация за сайт артикулните групи

Обектът от тип SG е със следната структура:

ПолеТипОписание
IDlongID на групата
ID_Parentlong?ID на групата родител (null - главна група)
NamestringИме на групата
NameLangstringПревод на името на групата (при подадено Language)
CodestringКод на групата
PosintПозиция на групата
NotestringОписание на групата (може да включва BBCode или HTML)
NoteLangstringПревод на описанието на групата (при подадено Language)
BatchShowType int

Показване на партидите на артикулите в групата със следните възможни стойности:

  • 0 - Не показвай (но самите артикули се показват)
  • 1 - Показвай като партиди (подходяща визуализация в продуктовата страница)
  • 2 - Показвай като артикули (всяка партида се показва като отделен артикул)
ID_PropGrouplong?ID на група характеристики
MetaNamestringКратко описание (ключови думи) за търсачките
MetaNameLangstringПревод на краткото описание за търсачките (при подадено Language)
MetaNotestringРазширено описание за търсачките
MetaNoteLangstringПревод на разширеното описание за търсачките (при подадено Language)
FilesFI[]Списък с информация за прикачените файлове към групата

Обектът от тип FI е описан в метод GetArticles.

Ето примерен отговор:

<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:MetaNameLang>Puig motorcycle windscreens</a:MetaNameLang>
          <a:MetaNote>Богат асортимент от слюди за мотори на фирмата Puig. Стандартни, състезателни и спортни модели на отлична цена. Вземете всичко необходимо онлайн.</a:MetaNote>
          <a:MetaNoteLang />
          <a:Name>Слюди</a:Name>
          <a:NameLang>Windscreens</a:NameLang>
          <a:Note />
          <a:NoteLang />
          <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:MetaNameLang />
          <a:MetaNote>Богат асортимент от краш тапи за мотори на фирмата Puig. Най-високо качество на изработка на отлична цена. Поръчайте всичко необходимо онлайн.</a:MetaNote>
          <a:MetaNoteLang />
          <a:Name>Краш тапи</a:Name>
          <a:NameLang>Crash pads</a:NameLang>
          <a:Note />
          <a:NoteLang />
          <a:Pos>1</a:Pos>
        </a:SG>
      </SiteGroups>
    </GetSiteGroupsResponse>
  </s:Body>
</s:Envelope>

Метод GetOrderProcessings

Описание:

Използва се за прочитане на информация за обработките на поръчките в Bizzio, променени след конкретна дата и час или за конкретни поръчки. След това, сайтът може да извърши някакви действия (напр. при промяна на сайт статус - да изпрати писмо на крайния клиент или при спедиция - да изпрати писмо какво точно е спедирано).

Заявка:

Приема аргумент от тип GetOrderProcessingsRequest, включващ следните полета:

ПолеТипОписание
AfterDatedatetime?Да се върнат обработки на поръчките след тази дата и час
ID_Orderslong[]Да се върнат обработки на конкретни поръчки
IsSiteStatesboolДали да се връща информация за сайт статусите
IsShippingsboolДали да се връща информация за спедициите
IsInvoicesboolДали да се връща информация за фактурите по продажби към поръчките
IsBillsOfLadingboolДали да се връща информация за товарителниците към последващи документи по поръчките

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип GetOrderProcessingsResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
SiteStatesGO_SS[]Списък от GO_SS елементи с информация за сайт статусите
ShippingsGO_SH[]Списък от GO_SH елементи с информация за спедициите
InvoicesGO_IV[]Списък от GO_IV елементи с информация за фактурите
BillsOfLadingGO_BL[]Списък от GO_BL елементи с информация за товарителниците

Обектът от тип GO_SS е със следната структура:

ПолеТипОписание
ID_OrderlongID на поръчката
SiteState int

Сайт статус на поръчката със следните възможни стойности:

  • 10 - Финализиране от клиента (не се ползва в интеграцията)
  • 20 - Потвърдена от клиента (новорегистрирана поръчка от сайта)
  • 30 - Приета за обработка
  • 40 - Изпратена към клиента
SiteStateDatedatetimeДата и час на промяна на сайт статуса на поръчката

Обектът от тип GO_SH е със следната структура:

ПолеТипОписание
ID_OrderlongID на поръчката
ID_ShippinglongID на спедицията
ShippingDatedatetimeДата и час на спедицията
ShippingItemsGO_SHI[]Списък от GO_SHI елементи с информация за редовете от спедициите

Обектът от тип GO_SHI е със следната структура:

ПолеТипОписание
BarcodestringБаркод на артикула
QtydecimalСпедирано количество

Обектът от тип GO_IV е със следната структура:

ПолеТипОписание
ID_OrderlongID на поръчката
ID_InvoicelongID на фактурата
InvoiceType int

Тип на фактурата със следните възможни стойности:

  • 34 - фактура
  • 36 - кредитно известие (за количество)
  • 38 - кредитно известие (за преоценка)
  • 96 - кредитно известие (за бонус)
  • 77 - дебитно известие (за количество)
  • 42 - дебитно известие (за преоценка)
InvoiceNumberlongНомер на фактурата
InvoiceDatedatetimeДата и час на фактурата
InvoiceAmountdecimalСтойност на фактурата
InvoiceCurrencystringВалута на фактурата
InvoiceUrlstringЛинк за сваляне на фактурата

Обектът от тип GO_BL е със следната структура:

ПолеТипОписание
ID_OrderlongID на поръчката
NumberStringНомер на товарителницата
CarrierType int

Тип на превозвача със следните възможни стойности:

  • 1 - Speedy
  • 2 - LeoExpress
  • 3 - UPS
  • 4 - Econt
  • 5 - Interlogistica
  • 6 - Transpress
  • 7 - NetCourier
  • 8 - Sameday
  • 9 – InTime
  • 10 – BoxNow
  • 12 – DPD
  • 13 - PigeonExpress
TraceUrlstringАдрес за проследяване на товарителницата

Ето примерен отговор:

<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

Описание:

Използва се за връщане на информация за поръчките в Bizzio, направени през интеграцията. Позволява филтриране по период или по конкретни поръчки. Опционално може да се връща и информация за редовете в поръчките.

Заявка:

Приема аргумент от тип GetOrdersRequest, включващ следните полета:

ПолеТипТипОписаниеОписание
OrderMode int

Тип на документа:

  • 0 – поръчка (по подразбиране);
  • 1 – оферта.
AfterDatedatetime?Да се върнат поръчките след тази дата и час
BeforeDatedatetime?Да се върнат поръчките преди тази дата и час
ID_Orderslong[]Да се върнат конкретни поръчки по списък с ID-та
IsItemsboolДали да се връща информация за редовете на поръчките

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип GetOrdersResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
PropCodesstring[]Списък от кодове на допълнителни полета, които се изпращат за документите (стойностите в GOR_OH обекта са в същият ред, както в този списък)
OrdersGOR_OH[]Списък от GOR_OH елементи с информация за поръчката

Обектът от тип GOR_OH е със следната структура:

ПолеТипОписание
ID_OrderintID на поръчката
OrderNumberstringНомер на поръчката от online магазина
OrderNotestringБележка на поръчката
OrderDatedatetimeДата на поръчката
SiteStateint?Сайт статус на поръчката (ако се работи в режим сайт) – информацията за сайт статусите се намира в метод GetOrderProcessings
ClientNamestringИмена на клиента в контакта на поръчката
AddressstringАдрес (ж.к., ул., №) в контакта на поръчката
CitystringГрад в контакта на поръчката
PostCodestringПощенски код в контакта на поръчката
ProvincestringОбласт в контакта на поръчката
CountryCodestringISO код на държавата в контакта на поръчката
MobilestringМобилен телефон в контакта на поръчката
PhonestringДопълнителен телефон в контакта на поръчката
EmailstringЕлектронна поща в контакта на поръчката
TotalPricedecimalКрайна цена без ДДС на поръчката
TotalPriceVATdecimalКрайна цена с ДДС на поръчката (ако няма ДДС е равна на TotalPrice)
CurrencystringISO код на валутата на поръчката
PaymentTypeintТип на плащането на поръчката – информацията за типовете плащане се намира в метод CreateOrder
ShippingDatedatetime?Дата на спедиция на поръчката
TransporterCodestringКод на превозвача за поръчката
TransporterOfficeIDstringID на офиса на презовача, до който ще се спедира поръчката (от номенклатурата на превозвача) – информацията за офисите се намира в метод CreateOrder
Propsstring[]Списък със стойностите на допълнителните полета на поръчката
ItemsGOR_OI[]Списък от GOR_OI елементи с информация за редовете на поръчката

Обектът от тип GOR_OI е със следната структура:

ПолеТипОписание
BarcodestringБаркод на артикула за реда на поръчката
QtydecimalКоличество за реда на поръчката
TotalPricedecimalКрайна цена без ДДС за реда на поръчката
TotalPriceVATdecimalКрайна цена с ДДС за реда на поръчката
CurrencystringISO код на валутата за реда на поръчката
ID_Batchlong?ID на партида за реда на поръчката (при реализация на варианти с партиди) – информацията за работата с партиди се намира в метод CreateOrder
BatchCodestringКод на партида за реда на поръчката (при реализация на варианти с партиди) – информацията за работата с партиди се намира в метод CreateOrder

Ето примерен отговор:

<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

Описание:

Използва се за създаване на нови и за редактиране на съществуващи клиенти, като типа на операцията се подава в заявката.

Основната идентификация на клиента е по ID. При създаване се генерира ID, което се връща като резултат. В последствие при редактиране трябва да се подаде същото ID, за да се намери клиента по него. Има и допълнително поле за идентификация, което се подава в заявката. То е предвидено за запазване на съвместимост с метода за идентификация на партньора в метод CreateOrder. Съответното поле се проверява за уникалност.

Полетата на партньора се задават само, ако са различни от null. Поради това може да се реализира редактиране само на определени полета (като се подаде стойност за тях), а останалите да бъдат със стойност null (ще се пропуснат при редакцията).

Заявка:

Приема аргумент от тип ManageClientRequest със следната структура:

ПолеТипОписание
ClientPartnerRecОбект от тип PartnerRec с информация за клиента
ManageType int

Тип на операцията със следните възможни стойности:

  • 1 – Създаване на нов клиент;
  • 2 – Редактиране на съществуващ клиент.
IdentityType int

Поле за идентификация, което да се проверява за уникалност:

  • 1 – Код (Client.Code);
  • 2 – Имейл (Client.Contact.Email);
  • 3 – Мобилен (Client.Contact.Mobile);
  • 4 – ЕИК (Client.VatStatNumber);
  • 5 – ДДС № (Client.VatNumber).

При 4 и 5 нов клиент се създава като фирма, ако не е подаден Client.Kind.

Обектът от тип PartnerRec е със следната структура:

ПолеТипОписание
IDlong?ID на клиента – за идентификация при редактиране (при нов трябва да е null)
CodestringКод на клиента (може да се подаде като поле за допълнителна идентификация чрез IdentityType)
Kind int?

Вид на клиента със следните възможни стойности:

  • 0 - Фирма;
  • 1 - Лице;
  • 2 - Мъж;
  • 3 - Жена.
NamestringИме на клиента (задължително при нов)
PartnerGroupstringИме на партньорска група на клиента (празна стойност означава без стойност)
ContactCRОбект от тип CR с основната контактна информация
ContactsCR[]Списък от CR елементи с допълнителна контактна информация. Обработват се само подадените – останалите, зададени на клиента не се променят. Идентификацията на допълнителните контакти е по поле Description. Ненамерените се създават, а намерените се редактират. Ако след редакция всички полета на даден контакт са празни, той се изтрива.
VatNumberstringДДС номер на клиента (може да се подаде като поле за допълнителна идентификация чрез IdentityType)
VatStatNumberstringЕИК / БУЛСТАТ на клиента (може да се подаде като поле за допълнителна идентификация чрез IdentityType)
VatPersonstringМОЛ на клиента
InvoiceStreetstringУлица от адрес по регистрация на клиента
InvoiceCitystringГрад от адрес по регистрация на клиента
InvoicePostCodestringПощенски код от адрес по регистрация на клиента
InvoiceProvincestringОбласт от адрес по регистрация на клиента
InvoiceCountrystringISO код на държава от адрес по регистрация на клиента
CreditLimitdecimal?Кредитен лимит на клиента (стойност -1 означава, че няма кредитен лимит)
CurrencystringISO код на валутата на клиента (трябва да е подадена, ако има кредитен лимит)
PriceGroupstringИме на ценова група на клиента (празна стойност означава без стойност)
VatStatus int?

ДДС статус на клиента със следните възможни стойности:

  • 0 - неизвестен;
  • 1 - реристриран;
  • 2 - нерегистриран;
VatType int?

Начисляване на ДДС със следните възможни стойности:

  • 0 - незададено;
  • 1 – без ДДС;
  • 2 – с ДДС;
PaymentType int?

Начин на плащане със следните възможни стойности:

  • -1 - незададено;
  • 0 - веднага;
  • 1 - отложено;
  • 4 – до дни.
PaymentDaysint?Брой дни при плащане до дни (задължително при плащане до дни)
ShipmentType int?

Начин на спедиция със следните възможни стойности:

  • -1 - незададено;
  • 0 - веднага;
  • 1 - отложено;
  • 4 – до дни.
ShipmentDaysint?Брой дни при спедиция до дни (задължително при спедиция до дни)
AssetstringИме на авоара на клиента (празна стойност означава без стойност)
WarehouseCodestringКод на склада на клиента (празна стойност означава без стойност)
AgentCodestringКод на агента на клиента (празна стойност означава без стойност)
TransporterCodestringКод на превозвача на клиента (празна стойност означава без стойност)
MainCompanyCodestringКод на главната фирма на клиента (празна стойност означава без стойност)
EmployeeCodestringКод на отговорния служител на клиента (празна стойност означава без стойност)
CompanyCodestringКод на нашата фирма на клиента (празна стойност означава без стойност)
PropsPV[]Списък от PV елементи с информация за характеристиките на клиента
FilesFR[]Списък от FR елементи с информация за файловете на клиента
IsActivebool?Дали клиентът е активен или не

Обектът от тип CR е със следната структура:

ПолеТипОписание
DescriptionstringОписание на контакта (ползва се за идентификация)
MobilestringМобилен телефон на контакта (може да се подаде като поле за допълнителна идентификация на основния контакт чрез IdentityType)
EmailstringИмейл на контакта (може да се подаде като поле за допълнителна идентификация на основния контакт чрез IdentityType)
PersonstringЛице за връзка на контакта
StreetstringУлица на контакта
CitystringГрад на контакта
PostCodestringПощенски код на контакта
ProvincestringОбласт на контакта
CountrystringISO код на държава на контакта

Обектът от тип FR е със следната структура:

ПолеТипОписание
UristringИнтернет адрес на файла (задължително)
NamestringИме на файла (задължително – трябва да съдържа и разширението)
AsLinkboolДали да се импортира като линк (true) или да се изтегли локално (false)

Обектът от тип PV е описан в метод CreateOrder.

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип ManageClientResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
IDlongID на клиента (генерира се при нов, при съществуващ се връща подаденото в заявката)

Ето примерен отговор:

<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

Описание:

Използва се за намиране на съществуващ клиент по поле за идентификация. Основното предназначение на метода е когато сайта създава нов клиент да провери, дали той вече съществува в базата. Може да се ползва и за последваща синхронизация на данните за клиентите.

Заявка:

Приема аргумент от тип FindClientRequest със следната структура:

ПолеТипОписание
IdentitystringСтойност на полето за идентификация
IdentityType int

Поле за идентификация, по което да се търси, със следните възможни стойности:

  • -1 – ID;
  • 1 – Код;
  • 2 – Имейл;
  • 3 – Мобилен;
  • 4 – ЕИК;
  • 5 – ДДС №.

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип FindClientResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
ClientPartnerRecОбект от тип PartnerRec с информация за клиента

Обектът от тип PartnerRec е описан в метод ManageClient.

Ето примерен отговор:

<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

Описание:

Използва се за задаване на цените на артикулите в конкретна ценова листа. Ако артикулът няма цена в листата, тя се създава - иначе се редактира.

Всяка цена се обработва и записва поотделно - проблемна цена не спира обработката на останалите. Цените, които не са записани поради грешка, се връщат в Errors, заедно с причината. Цените, които не се променят (подадената цена и валута съвпадат с текущите), се пропускат.

Ценовата листа трябва да е с фиксирани цени.

Заявка:

Приема аргумент от тип SetArticlePricesRequest, включващ следните полета:

ПолеТипОписание
PriceListCodestringКод на ценовата листа (задължително)
PricesArticlePriceRec[]Списък от ArticlePriceRec елементи с цените на артикулите (задължително, поне един)

Обектът от тип ArticlePriceRec е със следната структура:

ПолеТипОписание
Barcode string Идентификатор на артикула (задължително) - баркод, код или ID на артикула, според настройката на интеграцията за базата (същият идентификатор, както в останалите методи). Не може да се повтаря в рамките на заявката (без значение малки/главни букви).
PricedecimalЦена (не може да е отрицателна) - с или без ДДС, според настройката на ценовата листа
Currencystring(3)ISO код на валутата на цената (задължително)

При липсваща или невалидна стойност на PriceListCode, Prices или Barcode (вкл. повтарящи се стойности), както и при неподходяща ценова листа, не се записва нито една цена - методът връща съответната грешка.

Ето примерна заявка:

<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>
Отговор:

Връща обект от тип SetArticlePricesResponse, включващ следните полета:

ПолеТипОписание
ErrorCodeintКод на резултата (0 при успех; 1 (PartialSuccess) - ако някоя от цените не е записана)
ErrorMessagestringТекст на евентуална грешка
ErrorTypestringТип на резултата
SuccessCountintБрой записани цени
SkippedCountintБрой пропуснати цени (без промяна)
ErrorsArticlePriceError[]Списък от ArticlePriceError елементи с информация за незаписаните цени (null, ако няма такива)

Обектът от тип ArticlePriceError е със следната структура:

ПолеТипОписание
BarcodestringИдентификатор на артикула (подаденият в заявката)
Error string

Причина, поради която цената не е записана, напр.:

  • не е намерен артикул с подадения идентификатор или са намерени няколко;
  • не е намерена валута с подадения ISO код;
  • отрицателна цена или липсваща валута.

Ето примерен отговор:

<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>