79 lines
3.6 KiB
Markdown
79 lines
3.6 KiB
Markdown
|
# tiu-client
|
|||
|
|
|
|||
|
|
Клиент для выгрузки заказов из [tiu.ru](http://tiu.ru) в [retailCRM](http://retailcrm.ru)
|
|||
|
|
|
|||
|
|
Данный клиент также подойдет для работы с площадками [prom.ua](http://prom.ua), [deal.by](http://deal.by), [satu.kz](http://satu.kz)
|
|||
|
|
|
|||
|
|
##Установка
|
|||
|
|
|
|||
|
|
Выполните следующие команды в терминале
|
|||
|
|
```sh
|
|||
|
|
git clone https://github.com/retailcrm/tiu-client.git
|
|||
|
|
cd tiu-client
|
|||
|
|
curl -sS https://getcomposer.org/installer | php
|
|||
|
|
php composer.phar require retailcrm/api-client-php ~3.0.0
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Создайте и отредактируйте конфигурационный файл config/config.php аналогично примеру /config/config-dist.php
|
|||
|
|
|
|||
|
|
##Использование
|
|||
|
|
|
|||
|
|
Добавьте в крон задание
|
|||
|
|
|
|||
|
|
```sh
|
|||
|
|
*.10 * * * * /usr/bin/php /path/to/tiu-client/run.php
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
##Структура данных
|
|||
|
|
|
|||
|
|
tiu.ru выгружает заказы в XML-файл доступный по ссылке вида
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
https://my.tiu.ru/cabinet/export_orders/xml/2372403?hash_tag=47158ffb1af38cb31f1c521dc8a1e1208
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Ссылку можно получить в [личном кабинете](https://my.tiu.ru/cabinet/order/export_orders)
|
|||
|
|
|
|||
|
|
```xml
|
|||
|
|
<orders date="2015-08-31 17:32">
|
|||
|
|
<order id="2803303" state="new">
|
|||
|
|
<name>Иван Петров</name>
|
|||
|
|
<phone>+79111111111</phone>
|
|||
|
|
<email>test@example.org</email>
|
|||
|
|
<date>22.07.15 19:24</date>
|
|||
|
|
<address>Новокузнецк, ул. Тестовая 71</address>
|
|||
|
|
<paymentType>Наличными</paymentType>
|
|||
|
|
<deliveryType>Доставка курьером</deliveryType>
|
|||
|
|
<priceRUB>691.00</priceRUB>
|
|||
|
|
<items>
|
|||
|
|
<item id="68534240">
|
|||
|
|
<external_id>717432</external_id>
|
|||
|
|
<name>Hama H-74229 hdmi 1.3 a-c (mini)</name>
|
|||
|
|
<quantity>1.00</quantity>
|
|||
|
|
<currency>RUB</currency>
|
|||
|
|
<image>http://images.ru.prom.st/hama-h-74229.jpg</image>
|
|||
|
|
<url>http://example-shop.tiu.ru/hama-h-74229</url>
|
|||
|
|
<price>366.00</price>
|
|||
|
|
<sku/>
|
|||
|
|
</item>
|
|||
|
|
<item id="68534241">
|
|||
|
|
<external_id>717436</external_id>
|
|||
|
|
<name>Hama H-74237 hdmi 1.3 a-c (mini)</name>
|
|||
|
|
<quantity>1.00</quantity>
|
|||
|
|
<currency>RUB</currency>
|
|||
|
|
<image>http://images.ru.prom.st/hama-h-74237.jpg</image>
|
|||
|
|
<url>http://example-shop.tiu.ru/hama-h-74237</url>
|
|||
|
|
<price>325.00</price>
|
|||
|
|
<sku/>
|
|||
|
|
</item>
|
|||
|
|
</items>
|
|||
|
|
</order>
|
|||
|
|
</orders>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
####Поля:
|
|||
|
|
* атрибут `state` поля order - статус заказа. По умолчанию есть 4 статуса 'opened' - новый, 'accepted' - принят, 'declined' - отменен, 'closed' - выполнен. Также возможно [добавление своих статусов](https://my.tiu.ru/cabinet/order_v2)
|
|||
|
|
* address - если поле не было заполнено клиентом, в нем будет строка "Адрес неизвестен."
|
|||
|
|
* paymentType - список всех типов оплат можно увидеть по ссылке [https://my.tiu.ru/cabinet/shop_settings/payment_options](https://my.tiu.ru/cabinet/shop_settings/payment_options)
|
|||
|
|
* deliveryType - список всех доставок можно увидеть по ссылке [https://my.tiu.ru/cabinet/shop_settings/delivery_options](https://my.tiu.ru/cabinet/shop_settings/delivery_options)
|