JAR Computers FEED XML

Интеграция с JAR Computers Информационна Система

За пълна интеграция е необходимо да са реализирани следните функционалности:

Пълен XML feed на ценовите листи — с цени към ЖАР, препоръчителни крайно-клиентски цени, актуални наличности, продукт код, снимки, характеристики и всичко необходимо за продажбата.

Ще се извиква 2–3 пъти дневно: сутрин 8:00–12:00, следобед 12:00–15:00, и ако има тежки снимки — след 19:00.
Съкратен feed — продукт код (или ваше ID), наличност, евентуално цени към ЖАР. Извиква се на 15 минути и актуализира наличностите.
Автоматично поръчване — API интерфейс за подаване на поръчка с ваше ID на продукт и бройки. Резултатът трябва да покаже какво може да бъде изпълнено, ако продуктът или количеството е недостатъчно.
JAR API: POST /order
Документ Складова разписка (Гаранционна карта / Приемо-предавателен протокол):
1. а) Списък на издадените документи за период (от дата — до дата):
  <pid> Номер <edate> Дата <status> Тип <address> За кой офис <total> Обща сума <enote> Забележка <reference> Референтен номер
  JAR API: GET /documents
2. б) Детайлна информация за конкретен документ:
  <product_id> Ваше ID <cnt> Бройки <serials> Серийни номера <price> Единична цена <warranty> Гаранция
  JAR API: GET /document
Документ Фактура — като т.4, с допълнения:
1. а) Списък фактури за период + свързани складови разписки. Важи и за Кредитни/Дебитни известия. Добре е да има информация платена ли е фактурата.
  JAR API: GET /invoices
2. б) Детайлна информация на фактура — не е необходимо серийни номера и гаранционен срок.
  JAR API: GET /invoice
3. г) Списък неплатени фактури:
  <invoice_id> <edate> <document_type> <total> <payment_date> (падеж) <status> <paid_amount>
API с обща информация:
- Общо задължение към фирмата
- Таргети и тяхното изпълнение (текущо)
- Промоционални кампании (ако не са в продуктовия feed)
- Друга полезна информация по ваша преценка
JAR API: GET /charge

Може да започнем с реализирането на т.1 — пълния XML feed.
Идеята е всички Ваши продукти да се листват на нашия сайт и чрез него и нашите дистрибутори.
Структурата направете така, както ви е удобно — имаме система за обработка, която ще я трансформира.

Списък с необходими полета на продукта

Полетата не са задължителни — каквато и информация да имате ще е от полза. За правилното функциониране са необходими поне: <dealer_price> <sale_price> <product_id>

#	XML таг	Описание
1	<product_name>	Ime на продукта
2	<product_brand>	Марка на продукта
3	<category>	Продуктова група — CPU, MB, …
3а	<category_path>	Продуктов път (Периферия \| Принтери \| …)
4	<product_id>	Уникален код от вашата система
5	<product_code>	Продуктов код на производителя
5а	<product_gtin>	Баркод (GTIN), EAN, UPC, ISBN
6	<dealer_price>	Цена към ЖАР
7	<dealer_currency>	Валута — EUR, USD, BGN
8	<rate>	Курс към BGN
9	<sale_price>	Препоръчителна крайно-клиентска цена
9а	<sale_currency>	Валута на крайноклиентската цена
10	<available>	Наличност — статус
10а	<available_count>	Точно количество на склад
11	<description>	Кратко описание
11а	<full_description>	Пълно описание (може HTML)
12	<warranty>	Гаранционен срок
13	<characteristics>	Характеристики; <filter> <group_name>
14	<weight>	Тегло
15	<pictures> / <picture_url>	URL към снимки
15а	<picture_order>	Ред на показване
15б	<picture_last_change>	Дата на последна промяна
15в	<picture_text>	Текстово описание
16	<documents> / <document_url>	Прикачени документи
17	<brand_url>	Страница на производителя
18	<promotion>	В промоция ли е
18а	<campaign_text>	Промоционален текст
18б	<campaign_start> / <campaign_end>	Валидност на промоцията
19	<product_last_change>	Дата на последна промяна
20	<product_created>	Дата на добавяне
21	<linked_products>	Свързани продукти
22	<bundle> / <product_id>	Бъндел продукти
23	<gifts> / <gift>	Продукт с подарък
24	<product_url>	URL към страницата при вас

т.1 — Примерен пълен XML Feed

XML

<?xml version="1.0" encoding="utf-8"?>
<products>
  <product>
    <product_id>82266</product_id>
    <product_code>N1508ICDR32N4G</product_code>
    <product_name><![CDATA[ Лаптоп Inspiron 5559, Intel Core i7-6500U 2.5/3.1GHz,
      Full HD LED & AMD Radeon R5 M335 4GB, 8GB RAM, 1TB HDD, Linux ]]></product_name>
    <product_brand>DELL</product_brand>
    <product_model>Inspiron 5559</product_model>
    <product_gtin>9876437218723</product_gtin>
    <category_path>Компютри и Таблети | Лаптопи</category_path>
    <category>Лаптопи</category>
    <description><![CDATA[ Dell Inspiron 5559 Black 15.6" Full HD ... ]]></description>
    <available>на склад</available>
    <available_count>23</available_count>
    <warranty>24</warranty>
    <weight>4500</weight>
    <sale_price>1267.53</sale_price>
    <sale_currency>BGN</sale_currency>
    <dealer_price>1296.00</dealer_price>
    <dealer_currency>BGN</dealer_currency>
    <product_created>2016-07-28 14:54:36</product_created>
    <product_last_change>2016-07-29 16:12:06</product_last_change>
    <product_url>https://www.jarcomputers.com/...?ref=prod</product_url>
    <linked_products/>
    <pictures>
      <picture>
        <picture_url>https://p.jarcomputers.com/680x680/N1508ICDR32N4G_680x680.jpg</picture_url>
        <picture_order>1</picture_order>
        <picture_text>основна снимка 194866976.jpg</picture_text>
        <picture_last_change>2016-07-29 16:17:45</picture_last_change>
      </picture>
    </pictures>
    <characteristics>
      <characteristic>
        <name>Серия</name>
        <value>Inspiron</value>
        <filter>0</filter>
      </characteristic>
    </characteristics>
    <documents>
      <document>
        <document_url>https://www.jarcomputers.com/docs/.../manual.doc</document_url>
        <document_description>Техническа документация</document_description>
      </document>
    </documents>
    <promotion>
      <campaign_name>Национална промоция</campaign_name>
      <campaign_start>2014-09-01</campaign_start>
      <campaign_end>2014-09-30</campaign_end>
      <campaign_text>Хайде на училище</campaign_text>
    </promotion>
    <gifts>
      <gift>
        <product_id>81232</product_id>
        <description>Подарък чанта JAR Computers</description>
        <picture>https://p.jarcomputers.com/680x680/N1508ICDR32N4G_680x680.jpg</picture>
      </gift>
    </gifts>
    <bundle/>
  </product>
  ...
</products>

Може някои от полетата да се пуснат като атрибути за намаляване на обема:

XML — атрибути (pictures)

<pictures>
  <picture picture_text="основна снимка.jpg"
           picture_last_change="2016-07-29 16:17:45"
           picture_order="1">https://p.jarcomputers.com/680x680/N1508ICDR32N4G_680x680.jpg</picture>
</pictures>

XML — атрибути (characteristics)

<characteristics>
  <characteristic name="Серия" filter="0">Inspiron</characteristic>
</characteristics>

XML — атрибути (documents)

<documents>
  <document document_description="Техническа документация">
    https://www.jarcomputers.com/docs/.../manual.doc
  </document>
</documents>

т.2 — Примерен XML Feed за наличности

XML — стандартен

<?xml version="1.0" encoding="utf-8"?>
<products>
  <product>
    <product_id>56382</product_id>
    <available>На склад</available>
    <sale_price>498.23</sale_price>
  </product>
</products>

XML — атрибути (по-кратък)

<?xml version="1.0" encoding="utf-8"?>
<products>
  <product id="56382" avail="На склад">498.23</product>
  ...
</products>

Примерен feed: jarcomputers.com/export/jar/jar_avail.xml

Форматът може да бъде XML, JSON или CSV — каквото ви е лесно. Файлът може да е архивиран като zip или gzip. Методът на авторизация няма значение — просто го опишете.

Данните за наличност е добре да идват директно от складовата Ви програма за да са актуални.

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

Моля при въпроси свържете се без притеснение: [email protected]