---
# System prepended metadata

title: Сакура. Импорт и экспорт.
tags: [Tutorial]

---

# Сакура. Импорт и экспорт.
**Экспорт** - выгрузка продукции и остатков из 1С на Сайт
**Импорт** - выгрузка заказов из Сайта в 1С
Кодировка файлов: UTF-8
Товары в 1С и на Сайте соотносятся по полю УИН (UUID товара). Если в выгрузке присутствует товар с уже существующим на сайте УИН - информация о нем обновляется, если такого товара нет, он создается.
## Ссылки
* `ссылка_1` - ссылка для экспорта продукции и остатков из 1С на Сайт
* `ссылка_2` - ссылка для обновления остатков по имеющейся продукции из 1С на Сайт
* `ссылка_3` - ссылка для импорта заказов из Сайта в 1С

## Формат
Пример формата файла экспорта с товарными позициями
```javascript
{
    {
        "НаименованиеПолное": "Имбирь маринованный \"Сингари\"бел.ый  160 гр. 1/10(Япония)",
        "Наименование": "Имбирь маринованный \"Сингари\"бел.ый  160 гр. 1/10(Япония)",
        "Артикул": "",
        "ВидНоменклатуры": "Товар",
        "ЕдиницаИзмерения": "шт",
        "Код": "РТ-00000059",
        "УИН": "01b769f0-a2cd-11e8-b8dc-7085c25bb0c7",
        "Группа": "Готовая продукция, полуфабрикаты/Япония/Продукты/Названия для сайта",
        "СтавкаНДС": "Без НДС",
        "ТипНоменклатуры": "Товар",
        "Описание": "Если Вы искали классный белый имбирь японского производства, то вы его нашли! Имбирь маринованный белый Сингари имеет неповторимый острый вкус. Белый имбирь такой же вкусный и хрустящий, как розовый. Натуральный, он не содержит искусственных красителей, чтобы Вы могли насладиться чистым природным цветом этого продукты.\nОсвежающие, терпкие ломтики маринованного имбиря подают к суши вместе с васаби и соевым соусом. Достаточно пожевать небольшой кусочек, чтобы снять послевкусие от одной порции суши и перейти к следующей.",
        "СтранаПроисхождения": "",
        "Производитель": "Япония",
        "ФайлКартинки": "фото1019",
        "УИНКартинки": "b6398cd5-4750-11ea-b90e-7085c25bb0c7",
        "Штрихкод": "4978438020012",
        "Цена": "191",
        "РезервОстаток": "0",
        "Остаток": "1",
        "Дата": "27.02.2020 13:26:36",
        "Наименование_для_сайта": "Имбирь маринованный белый, Сингари",
        "Вес": "160гр.",
        "Состав": "Имбирь, соль, уксус, аминокислоты, медовая трава, лимонная кислота, сорбит, краситель натуральный"
    },
    ...
}
```

## Процесс обмена
### Авторизация
Проходит по стандартной схеме, в заголовок каждого HTTP запроса должно быть включено:

```Authorization: Basic {TOKEN}```

### FTP и структура файлов
#### Изображения
Складываются в папку `images`. Изображения имеют имя файла `7c9be365-3b63-11ea-b90e-7085c25bb0c7.jpg` (UUID взят из поля `УИНКартинки`) или `фото914.jpg` (взято из поля `ФайлКартинки`), но только при загрузке файлов фотографий с названиями файлов в UTF-8. Очень желательно оградиться от кириллицы, поэтому рекомендую использовать UUID.
#### Файлы экспорта (из 1С на Сайт)
Складываются в корневую папку. Имеют произвольное название. Рекомендую использовать дату. Можно иметь только один файл и перезаписывать его, это не принципиально.

### Экспорт (из 1С на Сайт)
1. По ФТП загружаются необходимые файлы (файл каталога в корень и изображения в `images`);
2. После загрузки отправляется HTTP запрос на `ссылку_1`, содержащий имя загруженного файла.

### Импорт (заказы с Сайта в 1С)
Осуществляется HTTP запросом на `ссылку_3`. Количество заказов, получаемых по запросу нужно обговорить дополнительно.
Рекомендуемый формат ответа:
```javascript
{
    {
        "ИД": "Численный идентификатор заказа на Сайте",
        "Имя": "Имя клиента",
        "Фамилия": "Фамилия клиента",
        "Телефон": "Номер телефона клиента",
        "Email": "Электронная почта клиента",
        "Город": "Город проживания клиента",
        "Адрес": "Адрес клиента",
        "Сумма": "Общая сумма по всей корзине",
        "Время": "Дата и время заказа",
        "СпособДоставки": "Один из: Нижний Новгород, Самовывоз, Доставка",
        "СпособОплаты": "Online"
        "Товары": {
            {
                "УИН": "UUID товара",
                "Код": "РТ-00000059",
                "Количество": "Количество данного товара в заказе",
                "СтоимостьЕдиницы": "Стоимость единицы данного товара",
                "Стоимость": "Общая стоимость всех единиц данного товара в заказе"
            },
            ...
        }
    },
    ...
}
```

### Обновление остатков
Осуществляется HTTP запросом на `ссылку_2` с указанием имени файла с остатками. Рекомендуемый формат файла остатков:
```javascript
{
    {
        "УИН": "UUID товара",
        "Остаток": "Количество товара"
    },
    ...
}
```
Для обновления остатков так же можно использовать формат файла экспорта.

###### tags: `Tutorial`