12.4. Регистриране на поръчки от външни източници

12.4.1. Общи положения
12.4.2. Импорт на данни чрез използване на Web services
12.4.3. Приемане на поръчки чрез използване на Партньорски портал
12.4.4. Импорт на данни чрез използване на XML файл

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

В настоящата записка предоставяме „извадка“ от документацията, свързана с необходимите разяснения относно контрол върху формата и структурата на УНП при импорт на поръчки от друг СУПТО.

Colibri® ERP отговаря на поставените изисквания като използва разясненията от документа „Разяснения относно импорт в СУПТО от външни източници на данни за продажби / файл ИМПОРТ__В__СУПТО_25_04_2019_-1.pdf“ от сайта на НАП.

Използваме следните сценарии:

12.4.1.1. Раздел I, Вариант 1. (сценарий I.1)

І. Импорт в СУПТО (СУПТО_А) на данни за продажби с УНП, генерирани от друг СУПТО (СУПТО_Б), използван от същото ЗЛ.

Вариант 1: При импорт в СУПТО_А на данни за продажби с УНП, генерирани в СУПТО_Б, се допуска запазване на вече генерираните УНП. Продажбите се приключват в СУПТО_А под УНП, генерирани от СУПТО_Б. При заплащане, изискващо издаване на ФБ, този номер се отпечатва в бона.

При този сценарий заложеният бизнес процес изисква потвърждаването на количествата от поръчката от страна потребител и в средата на Colibri® ERP. По време на импорта се прави анализ на получените данни и ако няма грешки и са с достатъчна пълнота системата ги „импортира“ и генерира поръчка от клиенти, която остава в статус дефиниране. В тази нова поръчка системата прехвърля непроменен УНП. Colibri® ERP няма да генерира нов УНП и ще използва импортирания при отпечатването на ФБ, ако такова се налага от начина на плащане.

12.4.1.2. Раздел I I, (сценарий II)

ІІ. Импорт в СУПТО на данни за продажби от други източници, които не притежават характеристиките на СУПТО и не се използват за управление на продажби.

При този сценарий заложеният бизнес процес изисква потвърждаването на количествата от поръчката от страна потребител и в средата на Colibri® ERP. По време на импорта се прави анализ на получените данни и ако няма грешки и са с достатъчна пълнота системата ги „импортира“ и генерира поръчка от клиенти, която остава в статус дефиниране. В тази нова поръчка няма още генериран УНП, което остава „задължение“ на Colibri® ERP.

12.4.2. Импорт на данни чрез използване на Web services

В раздел 29. Интеграция на Colibri® ERP данни с други системи чрез Web services, в глава 6. Иницииране (създаване) на клиентска поръчка чрез web services – erpSOAPOrderC, подточка 6.4.6. erpSOAPOrderC..RegOrder сме описали интерфейса на API функцията за регистриране на поръчка от клиенти.

Тази функция може се използва и за двата, посочени по-горе, сценария. Кой от двата сценария се приема зависи от комплекта на подадените данни. Ако в тях в елемента UNS има валиден УНП се използва първият сценарий, в противен случай се използва вторият.

12.4.2.1. Примерна заявка по сценарий I.1


<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:erpgate">
   <soapenv:Header/>
   <soapenv:Body>
<urn:erpSOAPOrderC..RegOrder>
   <order xsi:type="urn:erpOrderCNew">
<!-- Номер и дата на поръчката в клиентската система -->
      <POrderNum xsi:type="xsd:string">EX0004</POrderNum>
      <POrderDate xsi:type="xsd:date">2019-07-17</POrderDate>
<!-- Обект -->
      <BNum xsi:type="xsd:string">СУПТО</BNum>
      <SNumber xsi:type="xsd:string">001</SNumber>
      <UNS xsi:type="xsd:string">DT123456-0011-1234567</UNS>
      <UNSWPCode xsi:type="xsd:string">0022</UNSWPCode>
      <UNSOpCode xsi:type="xsd:string">011</UNSOpCode>
      <UNSFPNum xsi:type="xsd:string">DT123456</UNSFPNum>
<!-- Адрес на доставка -->
      <SPName xsi:type="xsd:string">Клиент име</SPName>
      <SAddr xsi:type="xsd:string">Адрес</SAddr>
      <SCity xsi:type="xsd:string">Град</SCity>
      <SZip xsi:type="xsd:string">1000</SZip>
      <SCPerson xsi:type="xsd:string">Контакт / Получател</SCPerson>
      <SPhone xsi:type="xsd:string">Телефон</SPhone>
      <Semail xsi:type="xsd:string">klient@email.na</Semail>
<!-- Начин на доставка и начин на плащане -->
      <chrShippingMethod xsi:type="xsd:string">other</chrShippingMethod>
      <ShippingDate xsi:type="xsd:date">2019-07-24</ShippingDate>
      <Transport xsi:type="xsd:string">Куриер</Transport>
      <chrPaymentMethod xsi:type="xsd:string">pos</chrPaymentMethod>
      <PaymentDate xsi:type="xsd:date">2019-07-17</PaymentDate>
      <Descr xsi:type="xsd:string">ТЕСТ Поръчка за СУПТО (EDA Web services)</Descr>
<!-- Списък артикули -->
      <ITEMS xsi:type="urn:erpOrderCItemNewArray">
         <item xsi:type="urn:erpOrderCItemNew">
<!-- Номер на артикула в Colibri® ERP -->
            <MNum xsi:type="xsd:string">200-GS0007</MNum>
<!-- Номер и наименование на артикула в клиентската система -->
            <ProdNo xsi:type="xsd:string">671761302</ProdNo>
            <ProdName xsi:type="xsd:string">NOKIA 5800</ProdName>
<!-- Поръчано количество и цена -->
            <QtyReq xsi:type="xsd:double">2</QtyReq>
            <Price xsi:type="xsd:string">80</Price>
         </item>
      </ITEMS>
   </order>
</urn:erpSOAPOrderC..RegOrder>
  </soapenv:Body>
</soapenv:Envelope>

				      

В тази SOAP заявка освен данните за клиента, вида, количеството и цените на поръчаните артикули, е важно да отбележим и следните две неща:

- В елементите POrderNum и POrderDate задаваме номера и датата на поръчката в системата на партньора;

- В елементите UNS, UNSWPCode, UNSOPCode и UNSFPNum задаваме данните за УНП.

След подаването на SOAP заявката, при успех системата ще предостави следният примерен отговор:


<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
   <SOAP-ENV:Body>
      <ns1:erpSOAPOrderC..RegOrderResponse xmlns:ns1="urn:erpgate">
         <idOrderC xsi:type="xsd:integer">1488</idOrderC>
         <OrderNum xsi:type="xsd:string">0001412</OrderNum>
         <POrderNum xsi:type="xsd:string">EX0004</POrderNum>
         <Message xsi:type="xsd:string">Новата поръчка е регистрирана успешно!</Message>
      </ns1:erpSOAPOrderC..RegOrderResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

				      

Най-същественото в този отговор, освен че операцията е била успешна, е че предоставяме кода и номера на генерираната в Colibri® ERP поръчка от клиенти, както и номер (идентификатора) на партньорската поръчка, за да може отсрещната страна да регистрира при себе си операцията.

След което е препоръчително за партньора да подаде друга SOAP заявка, използвайки друга API функция, а именно erpSOAPOrderC..GetOrder:


<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:erpgate">
   <soapenv:Header/>
   <soapenv:Body>
	<urn:erpSOAPOrderC..GetOrder>
         <filter xsi:type="urn:erpFilter" soapenc:arrayType="urn:erpFilterRule[]">
            <item xsi:type="urn:erpFilterRule">
               <field xsi:type="xsd:string">POrderNum</field>
               <value xsi:type="xsd:string">EX0004</value>
            </item>
         </filter>
      </urn:erpSOAPOrderC..GetOrder>
   </soapenv:Body>
</soapenv:Envelope>

				      

На тази заявка Colibri® ERP отговаря със следните данни:


<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="urn:erpgate">
   <SOAP-ENV:Body>
      <ns1:erpSOAPOrderC..GetOrderResponse xmlns:ns1="urn:erpgate">
         <return xsi:type="tns:erpOrderCInfo">
            <idOrderC xsi:type="xsd:integer">1488</idOrderC>
            <OrderNum xsi:type="xsd:string">0001412</OrderNum>
            <OrderDate xsi:type="xsd:date">2019-07-18 16:58:16</OrderDate>
            <POrderNum xsi:type="xsd:string">EX0004</POrderNum>
            <POrderDate xsi:type="xsd:date">2019-07-17</POrderDate>
            <idBranch xsi:type="xsd:integer">22</idBranch>
            <BNum xsi:type="xsd:string">СУПТО</BNum>
            <BName xsi:type="xsd:string">СУПТО Клон/Обект</BName>
            <SNum xsi:type="xsd:integer">4</SNum>
            <SNumber xsi:type="xsd:string">001</SNumber>
            <SName xsi:type="xsd:string">Основен</SName>
            <idPartner xsi:type="xsd:integer">351</idPartner>
            <PNum xsi:type="xsd:string">00-1</PNum>
            <PName xsi:type="xsd:string">Физически лица продажби на дребно</PName>
            <idPBranch xsi:type="xsd:integer">0</idPBranch>
            <PBNum xsi:nil="true" xsi:type="xsd:string"/>
            <PBName xsi:nil="true" xsi:type="xsd:string"/>
            <SAddrOverride xsi:type="xsd:integer">1</SAddrOverride>
            <SPName xsi:type="xsd:string">Клиент име</SPName>
            <SAddr xsi:type="xsd:string">Адрес</SAddr>
            <SCity xsi:type="xsd:string">Град</SCity>
            <SZip xsi:type="xsd:string">1000</SZip>
            <SCPerson xsi:type="xsd:string">Контакт / Получател</SCPerson>
            <SPhone xsi:type="xsd:string">Телефон</SPhone>
            <Semail xsi:type="xsd:string">klient@email.na</Semail>
            <SCountry xsi:nil="true" xsi:type="xsd:string"/>
            <curCode xsi:type="xsd:string">BGN</curCode>
            <dcmRate xsi:type="xsd:double">1.000000</dcmRate>
            <OStatus xsi:type="xsd:string"/>
            <chrShippingMethod xsi:type="xsd:string">other</chrShippingMethod>
            <ShippingDate xsi:type="xsd:date">2019-07-24 00:00:00</ShippingDate>
            <Transport xsi:type="xsd:string">Куриер</Transport>
            <chrPaymentMethod xsi:type="xsd:string">pos</chrPaymentMethod>
            <PaymentDate xsi:type="xsd:date">2019-07-17</PaymentDate>
            <idPromoCode xsi:type="xsd:integer">0</idPromoCode>
            <PCode xsi:nil="true" xsi:type="xsd:string"/>
            <Descr xsi:type="xsd:string">ТЕСТ Поръчка за СУПТО (EDA Web services)</Descr>
            <Notes xsi:type="xsd:string"/>
            <OSuma xsi:type="xsd:double">160.00</OSuma>
            <OSumaBGL xsi:type="xsd:double">160.00</OSumaBGL>
            <OSumaDDS xsi:type="xsd:double">192</OSumaDDS>
            <OSumaDDSBGL xsi:type="xsd:double">192</OSumaDDSBGL>
            <UNS xsi:type="xsd:string">DT123456-0011-1234567</UNS>
            <UNSWPCode xsi:type="xsd:string">0022</UNSWPCode>
            <UNSWPCode xsi:type="xsd:string">0022</UNSWPCode>
            <UNSFPNum xsi:type="xsd:string">DT123456</UNSFPNum>
            <dtCreated xsi:type="xsd:dateTime">2019-07-18 16:58:16</dtCreated>
            <dtModified xsi:type="xsd:dateTime">2019-07-18 16:58:16</dtModified>
            <ITEMS xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:erpOrderCItem[1]">
               <item xsi:type="tns:erpOrderCItem">
                  <idOrderCItem xsi:type="xsd:integer">2835</idOrderCItem>
                  <idOrderC xsi:type="xsd:integer">1488</idOrderC>
                  <IOrder xsi:type="xsd:string">1</IOrder>
                  <idMat xsi:type="xsd:integer">2813</idMat>
                  <MNum xsi:type="xsd:string">200-GS0007</MNum>
                  <MName xsi:type="xsd:string">NOKIA 5800</MName>
                  <ProdNo xsi:type="xsd:string">671761302</ProdNo>
                  <ProdName xsi:type="xsd:string">NOKIA 5800</ProdName>
                  <Batch xsi:type="xsd:string"/>
                  <MKCode xsi:type="xsd:string">СТО</MKCode>
                  <QtyReq xsi:type="xsd:double">2</QtyReq>
                  <MUnit xsi:type="xsd:string">бр.</MUnit>
                  <Price xsi:type="xsd:double">80</Price>
                  <PriceDDS xsi:type="xsd:double">96</PriceDDS>
                  <PriceBGL xsi:type="xsd:double">80</PriceBGL>
                  <PriceDDSBGL xsi:type="xsd:double">96</PriceDDSBGL>
                  <Suma xsi:type="xsd:double">160.00</Suma>
                  <SumaDDS xsi:type="xsd:double">192</SumaDDS>
                  <SumaBGL xsi:type="xsd:double">160.00</SumaBGL>
                  <SumaDDSBGL xsi:type="xsd:double">192</SumaDDSBGL>
                  <QtyExpected xsi:type="xsd:double">0</QtyExpected>
                  <QtyRejected xsi:type="xsd:double">0</QtyRejected>
                  <QtyReceived xsi:type="xsd:double">0</QtyReceived>
                  <QtyDelivered xsi:type="xsd:double">0</QtyDelivered>
                  <QtyFulfilled xsi:type="xsd:double">0</QtyFulfilled>
                  <QtyComplete xsi:type="xsd:double">0</QtyComplete>
               </item>
            </ITEMS>
            <PDOC xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:erpOrderPDoc[0]"/>
            <SDOC xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:erpOrderSDoc[0]"/>
            <STATUS xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:erpOrderStatus[1]">
               <item xsi:type="tns:erpOrderStatus">
                  <OStatus xsi:type="xsd:string">ORDS_INIT</OStatus>
                  <Changed xsi:type="xsd:date">2019-07-18 16:58:16</Changed>
               </item>
            </STATUS>
         </return>
         <Message xsi:nil="true" xsi:type="xsd:string"/>
      </ns1:erpSOAPOrderC..GetOrderResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

				      

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


            <POrderNum xsi:type="xsd:string">EX0004</POrderNum>
            <POrderDate xsi:type="xsd:date">2019-07-17</POrderDate>

				      

… както и информация за регистрирания УНП в елементите:


            <UNS xsi:type="xsd:string">DT123456-0011-1234567</UNS>
            <UNSWPCode xsi:type="xsd:string">0022</UNSWPCode>
            <UNSWPCode xsi:type="xsd:string">0022</UNSWPCode>
            <UNSFPNum xsi:type="xsd:string">DT123456</UNSFPNum>


				      

Ако „отворим“ тази новосъздадена поръчка от клиенти в Colibri® ERP ще видим следната информация. Всички основни данни за поръчката, (1) статус на поръчката – Иницииране, (2) име на клиента, (3) секция Информация за УНП с импортираните данни. Има, обаче и нещо ново. В същата секция в горния десен ъгъл виждаме текста WS, което означава, че тази поръчка е „импортирана“ от външен източник от тип Web services и данните за УНП са вписани от него.

След което потребителят следвайки заложената бизнес логика, може да започне „изпълнението“ на поръчката по етапите в нея. (От основната документация - раздел 12. Продажби, глава 2. Поръчки от клиенти).

Фигура 12.74. Информация за клиентска поръчка: 1) Статус; 2) клиент; 3) данни за УНП; 4) Индикатор за външен източник от тип Web services.

Информация за клиентска поръчка: 1) Статус; 2) клиент; 3) данни за УНП; 4) Индикатор за външен източник от тип Web services.


В Журнала на промените е вписана информацията за подадените данни в структуриран вид.

Фигура 12.75. Журнал на промените: 1) Раздел Журнал; 2) Първи запис в журнала.

Журнал на промените: 1) Раздел Журнал; 2) Първи запис в журнала.


Както се вижда в колонката Основание е вписано „Запис на поръчка от друг източник WS“, а в колонката Потребител пише „SOAP Client“. Когато отворим този запис ще видим по-подробна информация.

Фигура 12.76. Запис от Журнала на промените: 1) Потребител; 2) Описание; 3) Импортирани данни в структуриран вид.

Запис от Журнала на промените: 1) Потребител; 2) Описание; 3) Импортирани данни в структуриран вид.


Тук можем да видим подробности относно данните в подадената заявка.

12.4.2.2. Примерна заявка по сценарий I I.

Примерна заявка:


<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:erpgate">
   <soapenv:Header/>
   <soapenv:Body>
<urn:erpSOAPOrderC..RegOrder>
   <order xsi:type="urn:erpOrderCNew">
<!-- Номер и дата на поръчката в клиентската система -->
      <POrderNum xsi:type="xsd:string">EX0005</POrderNum>
      <POrderDate xsi:type="xsd:date">2019-07-17</POrderDate>
      <PNum xsi:type="xsd:date">Е001</PNum>
<!-- Обект -->
      <BNum xsi:type="xsd:string">СУПТО</BNum>
      <SNumber xsi:type="xsd:string">001</SNumber>
<!-- Начин на доставка и начин на плащане -->
      <chrShippingMethod xsi:type="xsd:string">other</chrShippingMethod>
      <ShippingDate xsi:type="xsd:date">2019-07-24</ShippingDate>
      <Transport xsi:type="xsd:string">Куриер</Transport>
      <chrPaymentMethod xsi:type="xsd:string">pos</chrPaymentMethod>
      <PaymentDate xsi:type="xsd:date">2019-07-17</PaymentDate>
      <Descr xsi:type="xsd:string">ТЕСТ Поръчка от не-СУПТО (EDA Web services)</Descr>
<!-- Списък артикули -->
      <ITEMS xsi:type="urn:erpOrderCItemNewArray">
         <item xsi:type="urn:erpOrderCItemNew">
<!-- Номер на артикула в Colibri® ERP -->
            <MNum xsi:type="xsd:string">200-GS0007</MNum>
<!-- Номер и наименование на артикула в клиентската система -->
            <ProdNo xsi:type="xsd:string">671761302</ProdNo>
            <ProdName xsi:type="xsd:string">NOKIA 5800</ProdName>
<!-- Поръчано количество и цена -->
            <QtyReq xsi:type="xsd:double">2</QtyReq>
            <Price xsi:type="xsd:string">80</Price>
         </item>
      </ITEMS>
   </order>
</urn:erpSOAPOrderC..RegOrder>
  </soapenv:Body>
</soapenv:Envelope>

				      

Както се вижда в заявката, в нея липсва информация за УНП.

Отговор на заявката:


<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
   <SOAP-ENV:Body>
      <ns1:erpSOAPOrderC..RegOrderResponse xmlns:ns1="urn:erpgate">
         <idOrderC xsi:type="xsd:integer">1490</idOrderC>
         <OrderNum xsi:type="xsd:string">0001414</OrderNum>
         <POrderNum xsi:type="xsd:string">EX0005</POrderNum>
         <Message xsi:type="xsd:string">Новата поръчка е регистрирана успешно!</Message>
      </ns1:erpSOAPOrderC..RegOrderResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

				      

Илюстрация на посочената по-горе заявка и получения по нея отговор чрез екранна снимка на SOAP клиент, използван за демонстриране на функционалността в реално време.

Фигура 12.77. SOAP заявка erpSOAPOrderC..RegOrder: 1) Отправена заявка; 2) Получен отговор.

SOAP заявка erpSOAPOrderC..RegOrder: 1) Отправена заявка; 2) Получен отговор.


Ако „отворим“ тази новосъздадена поръчка от клиенти в Colibri® ERP ще видим следната информация. Всички основни данни за поръчката, (1) статус на поръчката – Иницииране, (2) име на клиента, (3) секция Информация за УНП без данни . Има, обаче и нещо ново. В същата секция в горния десен ъгъл виждаме текста WS, което означава, че тази поръчка е „импортирана“ от външен източник от тип Web services и данните за УНП са вписани от него.

Фигура 12.78. Информация за клиентска поръчка: 1) Статус; 2) клиент; 3) данни за УНП - няма; 4) Индикатор за външен източник от тип Web services.

Информация за клиентска поръчка: 1) Статус; 2) клиент; 3) данни за УНП - няма; 4) Индикатор за външен източник от тип Web services.


12.4.3. Приемане на поръчки чрез използване на Партньорски портал

Клиентите на Colibri® ERP могат да използват функционалността за Партньорски портал (Част 30. Партньорски (клиентски, дилърски) портал) - Основни възможности.

Тази функционалност се заявява от клиента и се активира от производителя на Colibri® ERP.

Тази функционалност е част от Colibri® ERP и работи в единна база данни, конфигурирана за клиента.

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

Процесът на създаване, иницииране, обслужване на поръчки от партньорския портал е абсолютно същия като този, вече заложен в системата. Работи се с една и съща база данни и в този смисъл данни от външни източници не се прехвърлят. Разликите са единствено следните:

- Първоначалното съдържание, като вид и количество на поръчваните стоки, се генерира в страницата на партньорския портал от партньорите (или клиентите) на клиента;

- Colibri® ERP вписва в поръчката като източник Партньорския портал;

- Поръчката се Инициира от партньора в Партньорския портал, а се изпълнява изцяло от търговеца (потребител) в Colibri® ERP, в това число: потвърждаване на количества и дати на доставка; издаване на документ за продажба; издаване на складов документ за експедиране на артикулите;

Т.е. бизнес процесът изисква Потвърждение от страна на търговеца (потребител) в Colibri® ERP.

Обвързването на процеса на клиентски поръчки, получавани от Партньорския портал, с генерирания от системата УНП следва същата последователна процедура, каквато е и за другите клиентски поръчки.

12.4.3.2. Онагледяване на процеса

Онагледяването на процеса ще го осъществим с екранни снимки от гледна точка на клиента (потребител) в Colibri® ERP (back office) и от гледна точка на партньорите на клиента, използващи Партньорския портал.

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

Фигура 12.79. Страница за вход в Партньорския портал

Страница за вход в Партньорския портал


След успешна автентикация се показва страницата с главното меню от където се вижда какви данни може да получи партньора и какви операции да извършва.

Фигура 12.80. Главно меню на Партньорския портал

Главно меню на Партньорския портал


Ще започнем създаването на нова поръчка, като първо посетим страницата с продуктите.

Фигура 12.81. Партньорски портал: 1) Страница Продукти; 2) Бутон за добавяне на продукт в клиентската кошница;

Партньорски портал: 1) Страница Продукти; 2) Бутон за добавяне на продукт в клиентската кошница;


След като изберем продукт и натиснем бутона за добавяне, Colibri® ERP създава клиентска кошница, добавя избрания продукт в нея и директно отваря страницата „Кошница“.

Фигура 12.82. Партньорски портал: 1) Страница Кошница; 2) Съобщение за добавен продукт; 3) Информация за продуктите в кошницата;

Партньорски портал: 1) Страница Кошница; 2) Съобщение за добавен продукт; 3) Информация за продуктите в кошницата;


Както вече отбелязахме по-рано, Партньорския портал работи чрез уеб интерфейс с базата данни на клиента.. От гледна точка на клиента в Colibri® ERP регистъра с поръчки от клиенти се появява нова поръчка. Тази поръчка се „назначава" на „отговорника“ за този партньор и той от своя страна може да наблюдава в реално време как се формира тази поръчка.

Фигура 12.83. Colibri® ERP: 1) Клиентска поръчка; 2) Първоначален статус на поръчката – Дефиниране; 3) Индикатор за произход на поръчката – Партньорски портал; 4) Информация за УНП;

Colibri® ERP: 1) Клиентска поръчка; 2) Първоначален статус на поръчката – Дефиниране; 3) Индикатор за произход на поръчката – Партньорски портал; 4) Информация за УНП;


Както се вижда, УНП все още няма, т.к. все още поръчката не е потвърдена.

Следва иницииране на поръчката от страна на партньора. Това става с помощта на бутона „Поръчвам“.

Фигура 12.84. Партньорски портал: 1) Страница Кошница; 2) Бутон за „поръчване“.

Партньорски портал: 1) Страница Кошница; 2) Бутон за „поръчване“.


След натискането на този бутон, Colibri® ERP поставя поръчката в статус Иницииране и показва общ изглед на цялата поръчка в страница Поръчки на портала.

Фигура 12.85. Партньорски портал: 1) Страница Поръчки; 2) Статус Иницииране; 3) Артикули и обща стойност.

Партньорски портал: 1) Страница Поръчки; 2) Статус Иницииране; 3) Артикули и обща стойност.


Същата информация за статуса се наблюдава и в Colibri® ERP. Това е индикация за отговорния търговец по сделката с този партньор , че може да започне процеса по стартиране и изпълнение на поръчката.

Фигура 12.86. Colibri® ERP: 1) Поръчки от клиенти; 2) Статус – Иницииране.

Colibri® ERP: 1) Поръчки от клиенти; 2) Статус – Иницииране.


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

Фигура 12.87. Colibri® ERP: 1) Поръчки от клиенти; 2) Поръчани артикули.

Colibri® ERP: 1) Поръчки от клиенти; 2) Поръчани артикули.


Докато поръчката е в статус иницииране, търговецът не може да започне процеса по изпълнение, включително и не може да потвърди графика на доставка (дати и количества). Както се вижда от следващия екран помощната форма за потвърждаване не е налична.

Фигура 12.88. Colibri® ERP: Поръчки от клиенти: 1) Статус Иницииране 2) Етап Потвърждение.

Colibri® ERP: Поръчки от клиенти: 1) Статус Иницииране 2) Етап Потвърждение.


Търговецът „стартира“ изпълнението на поръчката като от формата избира статус Стартирана и записва новото състояние.

Фигура 12.89. Colibri® ERP: 1) Избор на статус Стартирана; 2) Бутон за запис.

Colibri® ERP: 1) Избор на статус Стартирана; 2) Бутон за запис.


След тази операция в Партньорския портал може да се види отразяването на тези промени в реално време.

Фигура 12.90. Партньорски портал: 1) Страница Поръчки; 2) Статус – Стартирана и дата на установяването му.

Партньорски портал: 1) Страница Поръчки; 2) Статус – Стартирана и дата на установяването му.


От този момент нататък, изпълнението на поръчката се извършва изцяло от търговеца (потребител) в Colibri® ERP. Партньорът може само да наблюдава този процес, но това се случва в реално време.

Обратно в Colibri® ERP търговецът може да потвърди датите и количествата по тази поръчка.

Фигура 12.91. Colibri® ERP: 1) Статус Стартирана; 2) Етап Потвърждение; 3) Бутон за добавяне на дата.

Colibri® ERP: 1) Статус Стартирана; 2) Етап Потвърждение; 3) Бутон за добавяне на дата.


След тази операция се визуализира информацията за потвърждение.

Фигура 12.92. Colibri® ERP: Потвърдени количества и дата на доставка.

Colibri® ERP: Потвърдени количества и дата на доставка.


В Партньорския портал това също се отразява в информацията за поръчката.

Фигура 12.93. Партньорски портал: 1) Статус Активна; 2) Очаквана експедиция.

Партньорски портал: 1) Статус Активна; 2) Очаквана експедиция.


По аналогия на бизнес процеса за изпълняване на клиентски поръчки и в този случай настъпва момента, когато Colibri® ERP генерира УНП и се вписва в поръчката.

Фигура 12.94. Colibri® ERP: 1) Информация за УНП в клиентската поръчка.

Colibri® ERP: 1) Информация за УНП в клиентската поръчка.


Търговецът следва да издаде документ за продажба – фактура, което се извършва от контекста на поръчката в раздела ЕТАПИ, под-раздел Продажба.

Фигура 12.95. Colibri® ERP: 1) Регистрирана продажба с вид, номер,дата и връзка (хиперлинк) към документа.

Colibri® ERP: 1) Регистрирана продажба с вид, номер,дата и връзка (хиперлинк) към документа.


От гледна точка на партньора също се визуализира новата информация в секция Документи на поръчката.

Фигура 12.96. Партньорски портал: 1) Страница Поръчки; 2) Секция Документи.

Партньорски портал: 1) Страница Поръчки; 2) Секция Документи.


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

Фигура 12.97. Партньорски портал: 1) Страница Документи; 2) Вид, номер и дата на документа за продажба; 3) Общ статус; 4) Секции Плащане, Документи и Сума – подробен статус.

Партньорски портал: 1) Страница Документи; 2) Вид, номер и дата на документа за продажба; 3) Общ статус; 4) Секции Плащане, Документи и Сума – подробен статус.


Когато партньорът плати, а търговецът съответно отрази плащането по фактурата в Colibri® ERP, търговецът може да приключи процеса като установи статуса на поръчката в Изпълнена. Тази информация се визуализира страницата на поръчката и в Партньорския портал.

Фигура 12.98. Партньорски портал, страница Поръчки: 1) Статус Изпълнена; 2) Информация за издължено плащане.

Партньорски портал, страница Поръчки: 1) Статус Изпълнена; 2) Информация за издължено плащане.


12.4.4. Импорт на данни чрез използване на XML файл

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

Във функционалните възможности на Colibri® ERP е наличен особен режим за въвеждане на данни, който помага на потребителя да въведе данни, получени от съдържанието на XML файл.

Тази функционалност позволява: 1) да се зареди файл или неговото съдържание; 2) да се анализират данните за коректност и съвместимост; 3) да се асоциират елементите на входните данни, като клиент, поръчка номер и дата, дата на доставка, вид и количество на поръчаните артикули (без цени); и накрая 4) да се генерира нова поръчка.

Тази функционалност не може да се използва за т.нар. „пакетно импортиране“ (batch import) на множество поръчки от файл. Тя се използва за въвеждане на клиентски поръчки една по една и играе ролята на помощник, който води през последователни стъпки.

12.4.4.2. Процес на поръчка с данни от XML файл

В регистъра с Поръчки от клиенти, в режим на въвеждане на нов документ избираме Нова поръчка от файл. В този раздел се показва помощна форма за въвеждане на първоначалните данни.

Фигура 12.99. Нова поръчка: 1) Нова поръчка от файл; 2) Помощна форма за избор на файл и добавяне на текст (XML).

Нова поръчка: 1) Нова поръчка от файл; 2) Помощна форма за избор на файл и добавяне на текст (XML).


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

Фигура 12.100. Нова поръчка от файл: 1) Бутон за следваща стъпка Анализ; 2) Име на избрания файл.

Нова поръчка от файл: 1) Бутон за следваща стъпка Анализ; 2) Име на избрания файл.


В този момент Colibri® ERP зарежда локалния XML файл на сървъра, извлича съдържанието му и прави анализ за съответствие на данните според формата на системата ECOD. Прави се съпоставка на „познатите“ елементи от заявката с такива, необходими за създаването на нова поръчка. Като минимум това са номер и дата на заявката, ILN на купувача и продавача, EAN на артикулите и поръчаните количества.

Фигура 12.101. Нова поръчка от файл: 1) Раздел Анализ; 2) „Разпознати“ данни; 3) Бутон стъпка Назад; 4) Бутон стъпка напред – Асоцииране.

Нова поръчка от файл: 1) Раздел Анализ; 2) „Разпознати“ данни; 3) Бутон стъпка Назад; 4) Бутон стъпка напред – Асоцииране.


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

Фигура 12.102. Нова поръчка: 1) Раздел Нова поръчка от файл; 2) Форма – Текст; 3) Съдържание на данните (от файла).

Нова поръчка: 1) Раздел Нова поръчка от файл; 2) Форма – Текст; 3) Съдържание на данните (от файла).


Ако на етапа Анализ натиснем бутона Асоцииране, ще се появи форма, показваща как са асоциирани входните данни със съществуващите в системата регистри, а именно: дали е „открит“ съответен клиент със съответния номер и дали за открити асортименти в каталога на клиента със съответните им номера.

Фигура 12.103. Нова поръчка от файл: 1) Раздел (стъпка) Асоцииране; 2) Бутон за създаване на нова поръчка; 3) Асоциирани данни за поръчката, клиента и вида и количеството на артикулите; 4) Бутон стъпка Назад.

Нова поръчка от файл: 1) Раздел (стъпка) Асоцииране; 2) Бутон за създаване на нова поръчка; 3) Асоциирани данни за поръчката, клиента и вида и количеството на артикулите; 4) Бутон стъпка Назад.


Ако всичко е наред, можем да пристъпим и към последната стъпка – създаване на клиентска поръчка. За целта натискаме бутона Създаване. Колибри създава нова поръчка и показва нейния номер и дата под формата връзка (хиперлинк) до етикета Поръчка.

Фигура 12.104. Нова поръчка от файл: 1) Раздел (стъпка) Асоцииране; 2) Номер и дата на създадената поръчка.

Нова поръчка от файл: 1) Раздел (стъпка) Асоцииране; 2) Номер и дата на създадената поръчка.


Ако последваме тази връзка можем да видим съдържанието на новата поръчка. Трябва да отбележим следните данни: поръчката е в статус Дефиниране; в основанието е вписано името на файла, който е бил зареден; вписани са номера и датата на клиентската поръчка от външния източник; в секцията за УНП няма данни, но е посочен източника – XML.

Фигура 12.105. Клиентска поръчка: 1) Раздел Редактиране; 2) Статус – Дефиниране; 3) Описание на поръчката с име на файла; 4) Заявена дата на доставка; 5) Информация за УНП – няма; 6) Източник на данните –XML; 7) Номер и дата на поръчката от външния източник.

Клиентска поръчка: 1) Раздел Редактиране; 2) Статус – Дефиниране; 3) Описание на поръчката с име на файла; 4) Заявена дата на доставка; 5) Информация за УНП – няма; 6) Източник на данните –XML; 7) Номер и дата на поръчката от външния източник.


Всички тези първоначални данни са вписани в Журнала на промените за този документ. В раздела Журнал виждаме записите на направените промени, който в случая е само един – първоначалния запис. Като описание е посочено „Запис на поръчка от друг източник XML“.

Фигура 12.106. Журнал на промените: 1) Раздел Журнал; 2) Първоначално вписване.

Журнал на промените: 1) Раздел Журнал; 2) Първоначално вписване.


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

Фигура 12.107. Журнал на промените – подробен изглед на първия запис: 1) Описание - Запис на поръчка от друг източник XML; 2) Планирана дата на доставка; 3) Номер и дата на поръчката от външния източник; 4) Име на файла; 5) Данни за артикулите.

Журнал на промените – подробен изглед на първия запис: 1) Описание - Запис на поръчка от друг източник XML; 2) Планирана дата на доставка; 3) Номер и дата на поръчката от външния източник; 4) Име на файла; 5) Данни за артикулите.


От този момент нататък следваме етапите от процеса на работа с клиентски поръчки, описан по-рано. А имено: Потвърждаване на количества и дати, т.к. вече имаме информация за желаната от клиента дата на доставка; издаване на документ за Продажба; и доставка на артикулите, съпроводени и със складов документ за Експедиране.

Първо променяме статуса на поръчката на Стартирана и записваме промените.

Фигура 12.108. Клиентска поръчка

Клиентска поръчка


Това ни дава възможност да преминем към потвърждаване на количествата от раздел ЕТАПИ, под-раздел Потвърждение използваме бутона за запис от помощната форма за потвърждение към дата. Датата в тази форма е получена от първоначалните данни и няма нужда да се въвежда отново.

Фигура 12.109. Клиентска поръчка

Клиентска поръчка


След тази операция вече имаме потвърдени количества и според поставените изисквания, Colibri® ERP е създала УНП.

Фигура 12.110. Клиентска поръчка

Клиентска поръчка


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

Фигура 12.111. Клиентска поръчка: 1) Раздел Допълнителни данни; 2) Секция Информация за УНП.

Клиентска поръчка: 1) Раздел Допълнителни данни; 2) Секция Информация за УНП.


В крайна сметка, като погледнем Журнала на промените в него ще има вече три вписвания:

1) Запис на поръчка от друг източник XML – първоначално записване;

2) Запис на поръчка – когато сменихме статуса и записахме;

3) Потвърдени всички остатъчни количества/Инициализация на УНП! – когато потвърдихме количествата на етап Потвърждение.

Фигура 12.112. Журнал на промените: 1) Раздел Журнал; 2) Запис на поръчка от друг източник XML; 3) Промяна на статуса; 4) Генериране на УНП.

Журнал на промените: 1) Раздел Журнал; 2) Запис на поръчка от друг източник XML; 3) Промяна на статуса; 4) Генериране на УНП.


Copyright © 2006-2024 EDA Ltd.