Itlook 1c API (1.0)
Misha Serenkov: [email protected] URL: https://github.com/miserenkov
Создание или обновление акции
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
Request Body schema: application/json
| id required | integer ID акции, если новая акция - поле не передавать |
| document_id required | string ID документа в 1с, для возможности публикации нескольких документов в 1 акцию |
| published_at required | string <YYYY-MM-DD> Дата начала акции |
| expires_at required | string <YYYY-MM-DD HH:MM:SS> Дата окончания акции |
| is_termless required | boolean Признак бессрочной акции |
| group_id required | integer ID группы акции |
| image required | string Путь к картинке через 1с |
required | object |
required | Array of objects Акционные цены товаров |
Responses
Request samples
- Payload
Content type
application/json
{- "id": 0,
- "document_id": "string",
- "published_at": "2020-12-01",
- "expires_at": "2020-12-30 15:20:00",
- "is_termless": false,
- "group_id": 0,
- "image": "string",
- "ru": {
- "name": "string",
- "status": true,
- "text": "string"
}, - "products": [
- {
- "product_id": 0,
- "cost": 0,
- "old_cost": 0
}
]
}Response samples
- 200
- 400
Content type
application/json
{- "success": true,
- "response": {
- "id": 0
}
}Отправка СМС клиенту
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
Request Body schema: application/json
| order_id | integer ID заказа |
| message | string Текст сообщения |
Responses
Request samples
- Payload
Content type
application/json
{- "order_id": 0,
- "message": "string"
}Response samples
- 200
- 400
Content type
application/json
{- "success": true
}Response samples
- 200
Content type
application/json
{- "success": true,
- "message": "string",
- "data": {
- "delivery_types": [
- {
- "key": "string",
- "name": "string"
}
], - "delivery_methods": [
- {
- "id": 0,
- "type": "string",
- "sort": 0,
- "status": 0,
- "name": "string"
}
], - "payed_modes": [
- {
- "key": "string",
- "name": "string"
}
], - "payments": [
- {
- "id": 0,
- "sort": 0,
- "status": 0,
- "name": "string"
}
], - "delivery_payments": [
- {
- "delivery_id": 0,
- "payment_id": 0
}
], - "statuses": [
- {
- "id": 0,
- "sort": 0,
- "status": 0,
- "name": "string"
}
], - "sources": [
- {
- "id": 0,
- "status": 0,
- "is_default": true,
- "name": "string"
}
]
}
}Получение заказа с сервера 1С
Authorizations:
query Parameters
| id required | number ID заказа |
Request Body schema: application/json
Данные заказа
| id required | integer ID заказа |
| delivery_type required | string Enum: "pickup - Самовывоз" "postal - Почтовое отделение" "courier - Адресная доставка" Способ доставки |
| delivery_id required | integer ID доставки |
| delivery_address required | string Адрес доставки |
| payment_id required | integer ID способа оплаты |
| status_id required | integer ID статуса заказа |
| payed | boolean Оплачен заказ или нет |
| dont_call_back | boolean Не перезванивать |
| payed_mode | string Enum: "manual - Вручную" "auto - Автоматически" Режим проведения оплаты |
| payed_at | string <YYYY-MM-DD HH:ii::ss> Дата отплаты |
| ttn | string Номер ТТН |
| is_deleted | boolean Заказ удален |
| deleted_at | string <YYYY-MM-DD HH:ii::ss> Дата удаления заказа |
| updated_at required | string <YYYY-MM-DD HH:ii::ss> Дата обновления заказа |
required | object (Client) Информация о клиенте |
| comment | string Комментарий клиента к заказу |
required | Array of objects (ProductItem) Позиции заказа |
Responses
Request samples
- Payload
Content type
application/json
{- "id": 0,
- "delivery_type": "pickup",
- "delivery_id": 0,
- "delivery_address": "string",
- "payment_id": 0,
- "status_id": 0,
- "payed": true,
- "dont_call_back": true,
- "payed_mode": "manual - Вручную",
- "payed_at": "2020-01-01 15:05:05",
- "ttn": "string",
- "is_deleted": true,
- "deleted_at": "2020-01-01 15:05:05",
- "updated_at": "2020-01-01 15:05:05",
- "client": {
- "id": 0,
- "name": "string",
- "surname": "string",
- "email": "string",
- "phone": "string"
}, - "comment": "string",
- "items": [
- {
- "product_id": 0,
- "quantity": 0,
- "price": 0,
- "purchase_price": 0
}
]
}Response samples
- 200
Content type
application/json
{- "success": true,
- "message": "string"
}Отправление заказа на сервер 1С
Authorizations:
Request Body schema: application/json
Данные заказа
| id required | integer ID заказа |
| delivery_type required | string Enum: "pickup - Самовывоз" "postal - Почтовое отделение" "courier - Адресная доставка" Способ доставки |
| delivery_id required | integer ID доставки |
| delivery_address required | string Адрес доставки |
| payment_id required | integer ID способа оплаты |
| status_id required | integer ID статуса заказа |
| source_id | integer ID источника заказа |
| payed | boolean Оплачен заказ или нет |
| dont_call_back | boolean Не перезванивать |
| payed_mode | string Enum: "manual - Вручную" "auto - Автоматически" Режим проведения оплаты |
| payed_at | string <YYYY-MM-DD HH:ii::ss> Дата отплаты |
| ttn | string Номер ТТН |
| is_deleted | boolean Заказ удален |
| deleted_at | string <YYYY-MM-DD HH:ii::ss> Дата удаления заказа |
| created_at required | string <YYYY-MM-DD HH:ii::ss> Дата создания заказа |
| updated_at required | string <YYYY-MM-DD HH:ii::ss> Дата обновления заказа |
required | object (Client) Информация о клиенте |
| comment | string Комментарий клиента к заказу |
required | Array of objects (ProductItem) Позиции заказа |
Array of objects (StatusHistory) История изменения статусов | |
object (PaymentStatus) Статус оплаты заказа (если онлайн-оплата) |
Responses
Request samples
- Payload
Content type
application/json
{- "id": 0,
- "delivery_type": "pickup",
- "delivery_id": 0,
- "delivery_address": "string",
- "payment_id": 0,
- "status_id": 0,
- "source_id": 0,
- "payed": true,
- "dont_call_back": true,
- "payed_mode": "manual - Вручную",
- "payed_at": "2020-01-01 15:05:05",
- "ttn": "string",
- "is_deleted": true,
- "deleted_at": "2020-01-01 15:05:05",
- "created_at": "2020-01-01 15:05:05",
- "updated_at": "2020-01-01 15:05:05",
- "client": {
- "id": 0,
- "name": "string",
- "surname": "string",
- "email": "string",
- "phone": "string"
}, - "comment": "string",
- "items": [
- {
- "product_id": 0,
- "quantity": 0,
- "price": 0,
- "purchase_price": 0
}
], - "status_history": [
- {
- "status_id": 0,
- "updated_at": "2020-01-01 15:05:05"
}
], - "payment_status": {
- "status": "failed",
- "description": "У получателя не установлена карта для приема платежей",
- "updated_at": "2019-12-23 09:26:11"
}
}Response samples
- 200
Content type
application/json
{- "success": true,
- "message": "string"
}Добавить объекты в очередь на синхронизацию
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
Request Body schema: application/json
ID объектов для синхронизации по типам
| specifications | Array of integers |
| categories | Array of integers |
| products | Array of integers |
Responses
Request samples
- Payload
Content type
application/json
{- "specifications": [
- 12,
- 5,
- 9
], - "categories": [
- 856,
- 8965,
- 23231
], - "products": [
- 27585,
- 89645,
- 80566
]
}Response samples
- 200
Content type
application/json
{- "success": true,
- "response": {
- "message": "string",
- "errors": { }
}
}Получение данных характеристики и ее значений
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
| id required | number ID характеристики |
Responses
Response samples
- 200
Content type
application/json
{- "success": true,
- "data": {
- "id": 9,
- "status": true,
- "collapse": true,
- "use_in_filter": true,
- "show_on_product_card": true,
- "sort": 2,
- "lang": {
- "ru": {
- "name": "Текст перевода наименования на русском"
}, - "ua": {
- "name": "Текст перевода наименования на украинском"
}, - "en": {
- "name": "Текст перевода наименования на английском"
}
}, - "spec_values": [
- {
- "id": 1253,
- "status": true,
- "sort": 2,
- "color": "#ffffff",
- "secondary_color": "#ff0000",
- "lang": {
- "ru": {
- "name": "Текст перевода наименования на русском"
}, - "ua": {
- "name": "Текст перевода наименования на украинском"
}, - "en": {
- "name": "Текст перевода наименования на английском"
}
}
}
]
}
}Получение данных категории
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
| id required | number ID категории |
Responses
Response samples
- 200
Content type
application/json
{- "success": true,
- "data": {
- "id": 23273,
- "parent_id": 23270,
- "status": true,
- "show_on_main": false,
- "is_top": false,
- "sort": 10,
- "last_updated_at": "2020-07-20 15:08:50",
- "lang": {
- "ru": {
- "name": "Текст перевода наименования на русском"
}, - "ua": {
- "name": "Текст перевода наименования на украинском"
}, - "en": {
- "name": "Текст перевода наименования на английском"
}
}, - "image": "besprovodnie_naushniki.jpg",
- "menu_image": "chehli_i_glass_260x440.jpg",
- "spec_filters": [
- {
- "id": 258,
- "sort": 10
}
]
}
}Получение данных товара
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
| id required | number ID товара |
Responses
Response samples
- 200
Content type
application/json
{- "success": true,
- "data": {
- "id": 98596,
- "status": true,
- "cost": 2589.52,
- "old_cost": 0,
- "available": true,
- "supplier": "MMA",
- "supplier_price": 2005.25,
- "supplier_code": "ЦУ-00027921",
- "category_id": 23270,
- "expires_at": "2020-08-09 21:00:05",
- "barcode": "4820024700016",
- "flags": {
- "novelty": false,
- "popular": false,
- "sale": true
}, - "color_id": 589,
- "lang": {
- "ru": {
- "name": "Текст перевода наименования на русском",
- "text": "Текст перевода описания на русском"
}, - "ua": {
- "name": "Текст перевода наименования на украинском",
- "text": "Текст перевода наименования на украинском"
}, - "en": {
- "name": "Текст перевода наименования на английском",
- "text": "Текст перевода наименования на английском"
}
}, - "images_changed": "2020-07-08 15:08:15",
- "images": [
- {
- "main": false,
- "path": "45148.jpg"
}
], - "specifications": [
- {
- "id": 10,
- "values": [
- 589
]
}
]
}
}Изменение статуса синхронизации характеристики
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
| id required | number ID характеристики |
| status required | string Enum: "in-progress - \"Синхронизируется\"" "successful - \"Успешно синхронизировано\"" "failed - \"Ошибка синхронизации\"" |
Responses
Response samples
- 200
Content type
application/json
{- "success": true
}Изменение статуса синхронизации категории
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
| id required | number ID категории |
| status required | string Enum: "in-progress - \"Синхронизируется\"" "successful - \"Успешно синхронизировано\"" "failed - \"Ошибка синхронизации\"" |
Responses
Response samples
- 200
Content type
application/json
{- "success": true
}Изменение статуса синхронизации товара
Authorizations:
query Parameters
| token | any Для авторизации используется md5 хэш от строки "{СЕКРЕТНАЯ СТРОКА}:{ТЕКУЩАЯ ДАТА В ФОРМАТЕ ГГГГ-ММ-ДД}" |
| id required | number ID товара |
| status required | string Enum: "in-progress - \"Синхронизируется\"" "successful - \"Успешно синхронизировано\"" "failed - \"Ошибка синхронизации\"" |
Responses
Response samples
- 200
Content type
application/json
{- "success": true
}