Различия
Показаны различия между двумя версиями страницы.
| public:api:returns [25.09.2026 18:17] – создано - внешнее изменение | public:api:returns [27.09.2026 01:08] (текущий) – удалено - внешнее изменение (Дата неизвестна) | ||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| - | ====== Returns. Возвраты поставщику ====== | ||
| - | |||
| - | В системе реализован программный интерфейс для получения данных о документах " | ||
| - | |||
| - | Глубина запроса по умолчанию - последние 30 дней. Для изменения глубины необходимо использовать параметр **days**. | ||
| - | |||
| - | ===== Пример запроса на получение данных ===== | ||
| - | |||
| - | Пример запроса на получение данных о документах " | ||
| - | |||
| - | | ||
| - | |||
| - | ==== Параметры запроса на получение данных ==== | ||
| - | Параметры, | ||
| - | * **apikey** - Секретный ключ для доступа к данным. Обязательный параметр. | ||
| - | |||
| - | * **format** (get only) - формат, | ||
| - | |||
| - | * **date** - получение Возвратов на определенную дату. Формат: | ||
| - | |||
| - | * **datefrom** - получение Возвратов начиная с определенной даты. Формат: | ||
| - | |||
| - | * **dateto** - получение Возвратов до определенной даты. Формат: | ||
| - | |||
| - | * **cdatefrom** - получение Возвратов, | ||
| - | |||
| - | * **cdateto** - получение Возвратов, | ||
| - | |||
| - | * **last_update_date** - получение Возвратов, | ||
| - | |||
| - | * **warehouse_id** - код магазина. для которого надо вернуть поступления. Если не указан, | ||
| - | |||
| - | * **ext_warehouse_id** - код магазина во внешней системе (например, | ||
| - | |||
| - | * **id** - ID документа Возврата. Необязательный параметр. Если не указан, | ||
| - | |||
| - | * **external_id** - код Возврата во внешней системе (например, | ||
| - | |||
| - | * **last_id** - Необязательный параметр. Используется для получения новых документов с момента последнего обмена. Если параметр указан, | ||
| - | |||
| - | * **days** - задает глубину поиска. Определяет, | ||
| - | |||
| - | * **withitems** - принимает значение " | ||
| - | |||
| - | |||
| - | ==== Ответ сервера ==== | ||
| - | |||
| - | В ответ получаем XML или JSON. В ответе обязательно присутствует поле success. Если success=1, то операция выполнена успешно. Если success=0, то произошла ошибка. Дополнительная информация об ошибке содержится в поле info | ||
| - | |||
| - | ==== Пример ответа сервера ==== | ||
| - | |||
| - | Ниже приведен пример ответа сервера в формате XML | ||
| - | |||
| - | <file xml> | ||
| - | <?xml version=" | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | |||
| - | ==== Структура ответа сервера ==== | ||
| - | |||
| - | **Шапка документа** | ||
| - | |||
| - | * **id** - ID документа Возврат | ||
| - | |||
| - | * **external_id** - код Возврата во внешней системе (например, | ||
| - | |||
| - | * **warehouse_id** - ID магазина, | ||
| - | |||
| - | * **docdate** - дата документа Возврата | ||
| - | |||
| - | * **docnum** - номер документа Возврата | ||
| - | |||
| - | * **supplier_id** - ID Поставщика | ||
| - | |||
| - | * **supplier_name** - название Поставщика | ||
| - | |||
| - | * **supplier_type** - код типа Поставщика | ||
| - | |||
| - | * **supplier_type_name** - название типа Поставщика | ||
| - | |||
| - | * **amount** - сумма поставки | ||
| - | |||
| - | * **status** - статус документа поставки (accept – возврат отгружен, | ||
| - | |||
| - | * **comment** - комментарий | ||
| - | |||
| - | * **guid** - GUID документа | ||
| - | |||
| - | * **supplier_external_id** - код Поставщика во внешней системе учета (например, | ||
| - | |||
| - | * **warehouse_external_id** - код Магазина во внешней системе учета (например, | ||
| - | |||
| - | * **created_date** - дата создания документа Возврата (может не совпадать с датой документа Возврат) | ||
| - | |||
| - | * **created_by** - ID пользователя, | ||
| - | |||
| - | * **last_update_date** - дата и время последнего изменения в документе | ||
| - | |||
| - | * **last_update_by** - ID пользователя, | ||
| - | |||
| - | |||
| - | Содержание документа (зависит от настройки загружаемых полей и гибких полей на товарный остаток) | ||
| - | |||
| - | * **line_id** - сквозной ID строки в транзакциях Возврата | ||
| - | |||
| - | * **item_id** - ID товарной позиции по номенклатурному справочнику | ||
| - | |||
| - | * **item_name** - наименование позиции | ||
| - | |||
| - | * **quantity** - количество | ||
| - | |||
| - | * **barcode** - штрих-код товара | ||
| - | |||
| - | * **price** - цена товара в Возврате | ||
| - | |||
| - | * **amount** - сумма по строке | ||
| - | |||
| - | * **lot_number** - характеристика (серия, | ||
| - | |||
| - | * **manuf_date** - дата производства товара | ||
| - | |||
| - | * **expir_date** - срок годности товара | ||
| - | |||
| - | * **guid** - GUID строки | ||
| - | |||
| - | |||