Интернет-дүкенді Torgsoft бағдарламасымен синхрондау үшін техникалық талаптар

Деректер	Деректер түрі	Символдар саны	Әдепкі баған	Түсініктеме	Дерекқор нұсқасынан
Тауар кілті — GoodID (іздеу)	Бүтін сан/Integer		GoodID
Тауар атауы	Жол/String	500	GoodName
Тауар сипаттамасы	Жол/String	255	Description
Ел	Жол/String	100	Country
Артикул	Жол/String	30	Articul
Бөлшек бағасы	Нақты/Float		RetailPrice
Көтерме бағасы	Нақты/Float		WholesalePrice
Акциялық баға (тауарлық жеңілдікпен)	Нақты/Float		RetailPriceWithDiscount
Клиент үшін тапсырыстың минималды саны, дана	Бүтін сан/Integer		MinQuantityForOrder
Биіктік, см =0	Нақты/Float		Height
Ені, см =0	Нақты/Float		Width
Интернет-дүкен бөлімі идентификаторы — Санат	Бүтін сан/Integer		Category
Қоймадағы саны	Нақты/Float		WarehouseQuantity
Көрсету			Display	0 — сайтта көрсетілмейді;  1 — сайтта көрсетіледі
Өлшемі	Жол/String	20	TheSize
Түсі	Жол/String	50	Color
Материалы	Жол/String	200	Material
Тауар үлгісінің атауы	Жол/String	500	FashionName
Жынысы	Бүтін сан/Integer		Sex	0 — жынысы анықталмаған, 1 — еркек, 2 — әйел, 3 — ұл бала, 4 — қыз бала, 5 — унисекс
Тауардың қысқаша атауы	Жол/String	255	ShortName
Тауар түрі толық	Жол/String	максимальная длина неопределена	GoodTypeFull	містить всю ієрархію виду товару зверху вниз, розділені між собою комами (приклад "одяг,джинси,кльош")
Өндірушінің коллекциясы толық	Жол/String	максимальная длина неопределена	ProducerCollectionFull	містить усю ієрархію колекції виробника згори донизу, розділені між собою комами (приклад "Польща,WOJCIK")
Маусым	Жол/String	100	Season
Штрих-код	Жол/String	40	Barcode		376
Қаптама	Жол/String	255	Pack		380
Қаптаманың өлшемі	Жол/String	255	PackSize		380
Қуат көзі	Жол/String	255	PowerSupply		380
Қораптағы саны	Жол/String	255	CountUnitsPerBox		380
Жасы	Жол/String	255	Age		380
Өлшем	Нақты/Float		Measure		380
Өлшем бірлігі	Жол/String	255	MeasureUnit		380
Тауардың бағасы белгісі	Бүтін сан/Integer		Closeout	0 — баға белгіленбеген,  1 — баға белгіленген тауар	403
Бөлшек өлшем бірлігі бойынша баға	Нақты/Float		RetailPricePerUnit		428
Көтерме өлшем бірлігі бойынша баға	Нақты/Float		WholesalePricePerUnit		428
Бөлшек бағасының эквиваленті	Нақты/Float		EqualSalePrice		449
Көтерме бағасының эквиваленті	Нақты/Float		EqualWholesalePrice		449
Эквиваленттік бағаның валютасы	Жол/String		EqualCurrencyName		449
Өзіндік құн	Нақты/Float		PrimeCost		461
Жеткізуші коды	Жол/String	255	SuppLierCode		461
Аналогтар	Жол/String	1000	Analogs		481
Тауардың кез келген динамикалық сипаттамалары				Әдепкі баған атауы — "Аты" динамикалық сипаттамасы	481
Минималды көтерме саны	Нақты/Float		WholesaleCount		482
Өлшем бірлігі	Жол/String	10	MesUnit		482
Жеңілдік	Нақты/Float		PriceDiscountPercent		482
Өндіруші	Жол/String	100	PCName		482
Үлгі идентификаторы	Бүтін сан/Integer		ModelGoodID		482
Тауар түрі	Жол/String	255	GoodTypeName	Синхрондау түбірлік түрінің атауы	492
Синхрондау бөлімі	Жол/String	255	SynchronizationSection	Синхрондалған өнімге сілтеме жасайтын синхрондау бөлімінің түбірлік түрінің атауы	492
Валютадағы бөлшек бағасы	Нақты/Float		CurrencyPriceRetail_"валюта ID"	бірнеше болуы мүмкін	492
Валютадағы көтерме бағасы	Нақты/Float		CurrencyPriceWholesale_"валюта ID"	бірнеше болуы мүмкін	492
Кепіл мерзімі	Бүтін сан/Integer		GuaranteePeriod		493
Кепіл мерзімінің бірлігі	Жол/String		GuaranteeMesUnit	бірі үш мәннің бірін қабылдауы мүмкін — д., ай., ж.	493

Баға тізімі және тапсырыстар ftp-сервердегі кез келген қалтада, фотосуреттер — басқа қалтада және GoodID сияқты атаулары бар, ал фотосурет файлдарының кеңейтімдері олардың түріне сәйкес келеді.

Дерекқордың 452-нұсқасынан бастап, қосымша өнімнің фотосуреттері келесі форматтағы атаумен фотосуреттер қалтасына тасымалданады: фотосурет коды (өнім идентификаторы), төменгі сызықша, қосымша фотосурет нөмірі (міндетті түрде дәйекті емес), нүкте, файл кеңейтімі.

Интернет-дүкеніңіздің дерекқ орындағы өрістерді қалай атайтыныңыз маңызды емес, оларды барлығын қолданасыз ба немесе жоқ па — да маңызды емес.

Қосымша опциялар

*.csv файлындағы өрістердің ретін баптау және интернет-дүкенге қажет емес өрістерді файлдан шығару мүмкіндігі.

*.csv файлындағы баған атауларын жасау. Олар автоматты түрде немесе пайдаланушы қолмен жасай алады.

YML файлына экспорттау кезінде резервтелген тегтер тізімі бар (егер біз экспорттау өрісін осылай атасақ, ол дәл осы атаумен тег ретінде экспортталады, тауар сипаттамасының қосымша тегтері арқылы емес):

• name — тауар атауы,

• model — тауар моделі атауы,

• vendor — өндіруші,

• vendorCode — артикул,

• price — жеңілдік бағасы,

• oldprice — бөлшек бағасы,

• price_old — бөлшек бағасы,

• categoryId — өнім түрі/санатының идентификаторы,

• description — өнімнің сипаттамасы,

• country — өндіруші елі,

• group_id — өнім моделінің идентификаторы,

• stock_quantity — өнімнің саны,

• barcode — өнімнің штрих-коды,

• url — дүкен сайтындағы өнімнің бетінің URL-і,

• enable_auto_discounts — ұсыныс үшін жеңілдіктерді автоматты есептеу және көрсету,

• vat — ҚҚС мөлшерлемесі,

• delivery —  true|false — курьерлік жеткізу мүмкіндігі,

• delivery-options — дүкен аймағы бойынша өнімнің курьерлік жеткізу шарттары: жеткізу түрлері, мерзімдері, құны,

• option — дүкен аймағы бойынша өнімнің курьерлік жеткізу шарттары: жеткізу түрлері, мерзімдері, құны,

• cost — жеткізу құны,

• days — жеткізу мерзімі жұмыс күндерінде,

• order-before — осы мерзімде алу үшін тапсырыс беру уақыты,

• pickup — true|false— дүкен жеткізетін барлық аймақтарда шығару пункттерінен өздігінен шығару мүмкіндігі,

• store — true|false — алдын ала тапсырыссыз тауарды сатып алу мүмкіндігі,

• sales_notes — сатып алу кезінде шектеулеріңіз бар болса міндетті элемент, мысалы, ең аз мөлшердегі тауарлар саны немесе алдын ала төлем қажеттілігі. Сондай-ақ, төлем нұсқаларын, акциялар мен сату туралы ақпаратты көрсетуге болады, бұл жағдайда элементті пайдалану міндетті емес.

• min-quantity — тапсырыстағы бірдей тауарлардың ең аз саны, егер сатып алу тек жинақпен мүмкін болса, жеке-жеке емес.

• manufacturer_warranty — true|false — өндірушінің ресми кепілдігі,

• adult — true|false — өнім сексуалдық қажеттіліктерді қанағаттандыруға байланысты немесе жыныстық қатынасқа қызығушылықты пайдаланатын басқа жолмен байланысты,

• expiry — жарамдылық мерзімі, қызмет ету мерзімі немесе жарамдылық мерзімі,

• weight — өнімнің салмағы, қаптаманы ескере отырып, килограмммен,

• dimensions — қаптамадағы өнімнің өлшемдері: ұзындығы, ені, биіктігі. Өлшемдерді сантиметрмен көрсетіңіз.

• age — өнімнің жас санаты,

• typePrefix — түрі/санаты, 

• country_of_origin — шығу елі,

• partType — бөліп төлеу,

• partCount — бөліп төлеу санын,

• sale — өнім "Жылы несиелер" бағдарламасына қатыса алады, егер міндетті түрде "Бөліп төлеу" блогының болуы талап етіледі, мәні hc болуы керек,

• partPrice — төлем сомасы.

2. Бағдарламада тапсырыстарды өңдеу

Сондай-ақ, Торгсофт TSClients.trs клиенттік базасымен *.csv (бөлгіш ;) файлын жасай алады, ол TSGoods.trs сияқты сол қалтаға жіберіледі. Бұл файлды жасау — пайдаланушы тиісті параметрмен шешеді.

Өрістер жиынтығы:

1. Т.А.Ә — Жол/String (100) 

2. e-mail — Жол/String (50)

3. Телефон нөмірі, ұялы — Жол/String (100)

4. Клиент жеңілдігі — Нақты/Float

5. Қалалық телефон — Жол/String (255)

6. Карта нөмірі (клиент штрих-коды) — Жол/String (16)

7. Индекс — Жол/String (15)

8. Ел — Жол/String (50)

9. Облыс — Жол/String (100)

10. Қала — Жол/String (50)

11. мекен-жайы — Жол/String (255)

12. Қосымша ақпарат — Жол/String белгісіз өрісі (максималды ұзындығы анықталмаған)

13. Жеңілдік сомасы — Нақты/Float

14. Жинақталған бонус сомасы — Нақты/Float

3. Тапсырысты файлға түрлендіру түрі

• Win-1251 немесе UTF-8 кодтамасымен sal кеңейтімі бар мәтіндік файл, дерекқордың 428 нұсқасынан бастап, синхрондау нысанының параметріне байланысты.

• UTF-8 кодтамасымен XML форматындағы файл, дерекқордың 493 нұсқасынан бастап.

• UTF-8 кодтамасымен JSON форматындағы файл, дерекқордың 493 нұсқасынан бастап.

  Тапсырыс файлының атауы ASCII таңбаларынан тұруы керек — латын әріптері, сандар және бөлгіштер.

  Өрістердің сипат тамасы

  Sal кеңейтімі бар мәтіндік файл

  [Client] — клиент туралы ақпарат блогы

  Name=Т.А.Ә (міндетті өріс)

  Mphone=0672356147

  CPhone=2568974

  ZIP=61072

  Ел=Қазақстан

  Облыс=Харківская облысы

  Қала=Харків

  Мекен-жайы=Тобольская көшесі 42-А

  EMail=info@torgsoft.ua

  [Options] — тапсырыс туралы ақпарат блогы

  OrderNumber=12/21 — міндетті өріс.

  Comment=Жеткізу 14-тен 18-ге дейін.

  DeliveryCondition=Нова Пошта — Жол/String (255), дерекқордың 390 нұсқасынан бастап.

  DeliveryAddress=Харків, Сумская көшесі, 124 (№33 бөлімше) — Жол/String (255), дерекқордың 505 нұсқасынан бастап.

  ReserveDate=28082013 — ddmmyyyyyy форматындағы резервтік күн, дерекқордың 392 нұсқасынан бастап.

  SaleType=1* — міндетті өріс.

  BonusPay=28,50 — Нақты/Float, тапсырыс бойынша клиенттің бонустармен төленген сомасы, дерекқордың 463 нұсқасынан бастап.

  GiftCertificate=9567200000106,9567200000182 — тапсырыс төлеу үшін клиент қолданған сыйлық сертификаттарының тізімі, дерекқордың 470 нұсқасынан бастап.

  OrderDate=2009-01-31 01:55:14 — тапсырыс күні (міндетті емес өріс) yyyy-mm-dd hh:mm:ss форматында, дерекқордың 470 нұсқасынан бастап.

  CurrencyInternationalCode=UAH — Жол/String (4) тапсырыс валютасының халықаралық коды (міндетті емес өріс; егер көрсетілмесе, тапсырыс ұлттық валютада өңделеді), дерекқордың 493 нұсқасынан бастап

  SaleForm=1 — сандық (1 мәні — көтерме сауда, 2 — бөлшек сауда), тапсырыс сауда түрі; егер өріс көрсетілмесе немесе дұрыс көрсетілмесе, тапсырыс бөлшек сауда түрінде өңделеді, дерекқордың 500 нұсқасынан бастап.

  [NewPostDeliveryOptions] — жаңа бөлім қосылды

  RecepientType=2 — алушы түрі: 1 — заңды тұлға, 2 — жеке тұлға.

  EGRPOU= — заңды тұлға үшін ЕДРПОУ коды көрсетіледі — 8 таңбалы сандық код.

  LastName=Петров — Жаңа пошта алушысының байланыс тұлғасының тегі.

  FirstName=Петр — Жаңа пошта алушысының байланыс тұлғасының аты.

  MiddleName=Петрович — Жаңа пошта алушысының байланыс тұлғасының әкесінің аты.

  Phone=0676758462 — Жаңа пошта алушысының байланыс тұлғасының ұялы телефоны.

  DeliveryType=2 — жеткізу түрі: 1 — алушыға мекен-жай бойынша жеткізу, 2 — Жаңа пошта қоймасына жеткізу.

  DeliveryCity=Заболотів — жеткізілетін қала және жеткізу мекен-жайын жасау үшін қандай қалаға немесе Жаңа пошта қоймасын іздеуді таңдау үшін DeliveryType= 1 таңдаңыз.

  WarehouseNumber=1 — Жаңа пошта бөлімшесінің нөмірі.

  WarehouseAddress=Грушевского көшесі, 3 — Жаңа пошта бөлімшесінің мекен-жайы (бөлімшенің дәлірек іздеу үшін, өйткені бөлімше нөмірі өте бірегей іздеу емес).

  StreetType= — мекен-жай бойынша жеткізген кезде көше түрі "көш", "пр" және т.б., қоймаға жеткізген кезде — бос болуы керек.

  StreetName= — алушыға мекен-жай бойынша жеткізген кезде көшенің атауы, Жаңа пошта қоймасына жеткізген кезде — бос болуы керек.

  BuildingNumber= — алушыға мекен-жай бойынша жеткізген кезде жеткізу мекен-жайын жасау үшін үй нөмірі.

  Flat= — Жаңа пошта алушысының мекен-жайын жасау үшін, егер болса, пәтер нөмірі.

  Адресні поля должны быть заполнены украинским языком, потому что при работе с API Новой Почты список улиц и отделений загружается на украинском языке. Это нужно для корректности поиска по переданным значениям на сервере Новой Почты и создания и добавления адреса.

  JSON және XML форматындағы файлдар үшін өрістердің сипаттамасы ұқсас болуы керек

  [1] — тапсырыстың бірінші өнімі туралы ақпарат блогы

  GoodID=201 — өнім кілті, (міндетті өріс),

  Price=120,05 — өнімнің сату бағасы, (міндетті өріс),

  Count=20 — тапсырыс берілген өнімнің саны, (міндетті өріс),

  [2] — тапсырыстың екінші өнімі туралы ақпарат блогы

  GoodID=20294

  Price=19,00

  Count=1

  ....

  [n] — тапсырыстың n-өнімі туралы ақпарат блогы

  GoodID=13854

  Price=63,00

  Count=5

  XML форматындағы файл, дерекқордың 493 нұсқасынан бастап

  <?xml version="1.0" encoding="UTF-8"?>

  <Order>

     <Client>

        <Name>Пупкин Иван Петрович</Name>

        <MPhone>0675746830</MPhone>

        <CPhone>7601828</CPhone>

        <ZIP>61072</ZIP>

        <Country>Украина</Country>

        <Регіон>Харківская</Регіон>

        <City>Харків</City>

        <Address>Тобольская көшесі 42-А</Address>

        <EMail>info@torgsoft.com.ua</EMail>

     </Client>

     <Options>

        <SaleType>1</SaleType>

        <Comment>Подъездің коды 1685</Comment>

        <OrderNumber>12</OrderNumber>

        <DeliveryCondition>Нова Пошта</DeliveryCondition&gt ;

        <DeliveryAddress>Харків, Сумская көшесі, 124 (№33 бөлімше)</DeliveryAddress>

        <ReserveDate>28082013</ReserveDate>

        <BonusPay>100.8</BonusPay>

        <GiftCertificate>9567200000106,9567200000182 </GiftCertificate>

        <DateOrderDate>2020-02-04 18:19:44 </DateOrderDate>

        <CurrencyInternationalCode>USD</CurrencyInternationalCode>

     </Options>

     <Goods>

        <Good_1>

           <GoodID>38280</GoodID>

           <Цена>145.33</Price>

           <Count>2</Count>

        </Good_1>

        <Good_2>

           <GoodID>38281</GoodID>

           <Price>131.61</Price>

           <Count>1</Count>

        </Good_2>

     </Goods>

  </Order>

  JSON форматындағы файл, дерекқордың 493 нұсқасынан бастап

  {

      "Client": {

          "Name": "Пупкин Иван Петрович",

          "MPhone": "0675746830",

          "CPhone": "7601828",

          "ZIP": "61072",

          "Country": "Украина",

          "Region": "Харківская",

          "Қала": "Харків",

          "Address": "Тобольская көшесі 42-А",

          "EMail": "info@torgsoft.com.ua"

      },

      "Options": {

          "SaleType": "1",

          "Comment": "Подъездің коды 1685",

          "OrderNumber": "12",

          "DeliveryCondition": "Нова Пошта",

          "DeliveryAddress": "Харків, Сумская көшесі, 124 (№33 бөлімше)",

          "ReserveDate": "28082013",

          "BonusPay": "100.8",

          "GiftCertificate": "9567200000106,9567200000182",

          "OrderDate": "2020-02-04 18:19:44",

          "CurrencyInternationalCode": "USD"

      },

      "Goods": [

          {

              "GoodID": "38280",

              "Price": "145.33",

              "Count": "2"

          },

          {

              "GoodID": "38281",

              "Price": "131.61",

              "Count": "1"

          }

      ]

  }* 

  *SaleType мәні 1-ден 5-ке дейін болуы мүмкін:

  1 — алдын ала тапсырыс: есепшот жасауға болатын тапсырыс жасалады,

  2 — жасалған сатылым: 100% алдын ала төлеммен шот жасалады,

  3 — жөнелтуімен бірге жасалған сатылым: 100% алдын ала төлеммен шот жасалады, тауар жөнелтіледі (шығыс шотын жасау),

  4 — алдын ала төлемсіз жөнелтуімен жасалған сатылым: төлемсіз шот жасалады, тауар жөнелтіледі (шығыс шотын жасау),

  5 — тек шот: тапсырыс жасалмайды, шот бірден жасалады.

  4. Көтерме баға саясатын экспорттау, дерекқордың 447 нұсқасынан бастап

  Қосымша функцияны қосқанда «Көтерме баға саясаты» көтерме баға саясатын xml файлға сақтауға және оны FTP серверіне жіберуге мүмкіндік бар.

  Xml файлдың мысалы

  <?xml version="1.0" encoding="UTF-8"?>

  <WholesalePrice>

    <Good GoodID="1378">

      <Price>

        <Quantity>2</Quantity>

        <QuantityPrice>33</QuantityPrice>

      </Price>

      <Price>

        <Quantity>3</Quantity>

        <QuantityPrice>32</QuantityPrice>

      </Price>

      <Price>

        <Quantity>5</Quantity>

        <QuantityPrice>30</QuantityPrice>

      </Price>

    </Good>

    <Good GoodID="42">

      <Price>

        <Quantity>2</Quantity>

        <QuantityPrice>6.5</QuantityPrice>

      </Price>

      <Price>

        <Quantity>3</Quantity>

        <QuantityPrice>6.3</QuantityPrice>

      </Price>

      <Price>

        <Quantity>5</Quantity>

        <QuantityPrice>6.1</QuantityPrice>

      </Price>

    </Good>

  </WholesalePrice>

  Тегтердің сипаттамасы

  • WholesalePrice — негізгі бөлім (түбірлік элемент).

  • Good — өнім бөлімі, бір параметрі бар GoodID — өнім кілті (іздеу), Бүтін сан/Integer.

  • Price — баға бөлімі.

  • Quantity — сан бөлімі, мәні — көшу саны, Нақты/Float.

  • QuantityPrice — баға бөлімі, мәні — көшу бағасы, Нақты/Float.

    5. Подарочные сертификаты экспорттау *.csv форматындағы TSGiftCertificate.trs файлына, дерекқордың 470 нұсқасынан бастап

    Бұл файлды жасау пайдаланушы тиісті параметрмен шешеді. Файл атауын өзгертуге болады. Файл TSGoods.trs сияқты сол қалтаға жіберіледі.

    Өрістер жиынтығы

    1. Сертификат штрих-коды — Жол/String (40).

    2. Сертификат сомасы — Нақты/Float.

    3. Сертификаттың жарамдылық мерзімінің аяқталу күні — ddmmyyyyyy форматындағы күн (болмаса, сертификаттың мерзімі жоқ немесе сатылған күннен бастап есептеледі, бірақ әлі сатылмаған).

    4. Сертификат түрі — 1 немесе 2 мәндерін қабылдауы мүмкін: 1 — шығарылған, сатуға болады, бірақ сатып алуға пайдалану мүмкін емес; 2 — сатып алынған, клиент сатып алған, сатып алуға пайдалану мүмкін.