Обновление - из 1С¶
- Header
-
key value Content-Typeapplication/json apiKey{твой api ключ} - Статусы ответов
-
Status Description 200обработано без ошибок 202принято, но еще не обработано 401ошибка аутентификации. apiKey отсутствует или не разрешен 500непредусмотренная ошибка на сервере. разработчику стыдно - Ключи
-
Магазин - 331@{domain}.xz
- email: 331@{domain}.xz
- цифры@ - номер региона и порядковый номер магазина в регионе
@домен - присвается для сети магазинов
.zx - любой домен первого уровня
Можно взять уже существующую почту магазина. Или придумать новую исходя из навазния магазинов
Продавец - Фамилия Имя Отчетство
- user: Фамилия Имя Отчество
- важен порядок, сначала фамилия
можно без отчества
Обратите внимание, часто в 1С имена продавцов пишутся не по шаблону
Покупатель - 'номер телефона'
- barcode: 89109999999
- Для корректного расчета чеков в рамках одного дня. Для NPS
Номенклатура - 'уникальный артикул' и 'GUID'
-
- article: артикул номенклатуры
- GUID: UUID номенклатуры
- Должен быть уникальным
- Ключи для полного функционала
-
Тип номенклатуры - например 'Обои'
- category: тип номенклатуры
Производитель - 'производитель товара'
- vendor: наименование производителя
Коллекция - 'коллекция товара'
- collection: наименование коллекции
API - методы¶
POST /goods - номенклатура¶
Кривые остатки
Если кол-во номенклатуры с положительными остатками
>= 4000 позиций.
Выгружать имеет смысл только по ночам один раз в сутки. Исправить эту проблему поможет инвентаризация.
- в одном запросе один магазин (склад).
- номенклатура с остатками > 0.
- каждые 6 часов.
{"request": [
{
"email": "765@shopstenova.ru", 🔑 ключ магазина
"GUID": "6d0a3a5e-af57-11ec-2b96-520836f27387", 🔑 ключ1 товара
"article": "281852", 🔑 ключ2 товара
"category": "Обои", категория товара
"vendor": "Victoria Stenova", производитель товара
"collection": "Владивосток", коллекция
"goodsname": "281852 Владивосток мотив (6)", наименование
"balance": 30, остаток товара на складе
"costprice": 1612.7356, себестоимость
"price": 2550, базовая стоимость
"size": "1,06*10", размер товара
"barcode": "40000000000", штрихкод товара
}
]
}
POST /sale - продажи и возвраты¶
Warning
Если в товар задублирован несколькими строками, то его необходимо сложить. При этом стоимость товара и скидка должны быть рассчитаны для единицы товара - как среднее значение
Info
Выбранный интервал перезапишет документы одного типа. И удалит документы, которые не встречаются в выгрузке
- в одном запросе один магазин (склад)
- в одном запросе один тип документа
- для чеков:
-
- интервал выборки - 3 дня.
-
- каждые 10 минут.
- для реализаций:
-
- интервал выборки - 30 дней.
-
- каждые 60 минут.
{"request": [
{
"email": "765@shopstenova.ru", 🔑 ключ магазина
"user": "Иванов Иван Иванович", 🔑 ключ продавца
"GUID": "6d0a3a5e-af57-11ec-2b96-520836f27387", 🔑 ключ1 товара
"article": "281852", 🔑 ключ2 товара
"vendor": "Victoria Stenova", производитель товара
"goodsname": "281852 Владивосток мотив (6)", наименование
"balance": 30, остаток товара на складе
"price": 1980.47, цена одной шт. товара в документе
"discountSum": 33.12, скидка на единицу товара
"quantity": 2, кол-во товара в документе
"document": "00АА-000111", номер документа
"date": "2023-03-02T16:20:26", дата документа - тип ISO
"documentType": "реализация", тип документа. для чеков не указывается
"barcode": "8910*******", клиент - карта скидок (телефон клиента)
}
]
}
Поступления¶
- в одном запросе один магазин (склад)
- интервал выборки - 3 дня.
- каждые 60 минут.
{"request": [
{
"email": "765@shopstenova.ru", 🔑 ключ магазина
"GUID": "6d0a3a5e-af57-11ec-2b96-520836f27387", 🔑 ключ1 товара
"article": "281852", 🔑 ключ2 товара
"category": "Обои", категория товара
"price": 2550, базовая стоимость
"costprice": 1612.7356, себестоимость
"quantity": 2, кол-во товара в документе
"document": "00АА-000111", номер документа поступления
"date": "2023-03-02T16:20:26", дата документа - тип ISO
}
]
}