Различия

Здесь показаны различия между двумя версиями данной страницы.

--- doc:dev:api:inflow [23.10.2019 17:05]
dlebedev [Параметры запроса]
+++ doc:dev:api:inflow [07.11.2025 16:28] (текущий)
rlysov
@@ Строка 9: / Строка 9: @@
 Пример запроса на получение данных о документах "Поступление":
- http://mycompany.virtpos.ru/api/inflow?apikey=MySecret&format=xml
+ https://[company].myvirtualpos.ru/api/inflow?apikey=MySecret&format=xml
 ==== Параметры запроса на получение данных ====
@@ Строка 253: / Строка 253: @@
 Пример запроса на обновление данных о поступлении:
- http://mycompany.virtpos.ru/api/inflow/update/?apikey=MySecret&format=xml&id=1&comment=NewComment
+ https://[company].myvirtualpos.ru/api/inflow/update/?apikey=MySecret&format=xml&id=1&comment=NewComment
 ==== Параметры запроса ====
@@ Строка 369: / Строка 369: @@
 Пример запроса на удаление поступления:
- http://mycompany.virtpos.ru/api/inflow/delete/?apikey=MySecret&format=xml&id=1
+ https://[company].myvirtualpos.ru/api/inflow/delete/?apikey=MySecret&format=xml&id=1
 ==== Параметры запроса ====
@@ Строка 404: / Строка 404: @@
 Пример запроса на принятие накладной на поступление:
- http://mycompany.virtpos.ru/api/inflow/accepting/?apikey=MySecret&format=xml&id=1
+ https://[company].myvirtualpos.ru/api/inflow/accepting/?apikey=MySecret&format=xml&id=1
 ==== Параметры запроса ====
@@ Строка 437: / Строка 437: @@
 Пример запроса на откат принятия накладной на поступление (накладная откатывается в состояние "Черновик"):
- http://mycompany.virtpos.ru/api/inflow/rollback/?apikey=MySecret&format=xml&id=1
+ https://[company].myvirtualpos.ru/api/inflow/rollback/?apikey=MySecret&format=xml&id=1
 ==== Параметры запроса ====
@@ Строка 471: / Строка 471: @@
 Пример запроса на обновление данных о товарной позиции в поступлении:
- http://mycompany.virtpos.ru/api/inflow/updateItems/?apikey=MySecret&format=xml&id=1&quantity=2
+ https://[company].myvirtualpos.ru/api/inflow/updateItems/?apikey=MySecret&format=xml&id=1&quantity=2
 ==== Параметры запроса ====
@@ Строка 513: / Строка 513: @@
 Пример запроса на удаление товарной строки из документа поступления:
- http://mycompany.virtpos.ru/api/inflow/deleteItems/?apikey=MySecret&format=xml&id=1
+ https://[company].myvirtualpos.ru/api/inflow/deleteItems/?apikey=MySecret&format=xml&id=1
 ==== Параметры запроса ====
@@ Строка 544: / Строка 544: @@
-===== Пример запроса для загрузки файла Поступления =====
+===== Загрузка Поступлений в виде файлов =====
-Пример запроса для загрузки поступления:
+Есть возможность загружать поступления в виде готовых файлов в csv-формате. К http-запросу можно приложить несколько файлов с поступлениями. Они будут разобраны и сохранены в системе. Для загрузки файлов используйте стандартные механизмы протокола http, enctype: "multipart/form-data"
-http://virtualpos.loc/api/inflow/upload?apikey=MySecret&format=xml&encoding=utf8&waybill=123123123&warehouse_id=6&supplier_id=8&unique=false
+Пример запроса для загрузки поступлений из файлов:
+http://mycompany.myvirtualpos.ru/api/inflow/upload?apikey=MySecret&format=xml&encoding=utf8&waybill=123123123&warehouse_id=6&supplier_id=8&unique=false
 ==== Параметры запроса ====
@@ Строка 558: / Строка 560: @@
   * **waybill** - товарная накладная. Обязательный параметр.
-  * **docdate** - дата документа. Необязательный параметр. По умолчанию используется текущая дата.
+  * **docdate** - дата документа в формате YYYYMMDD. Необязательный параметр. По умолчанию используется текущая дата.
   * **encoding** - кодировка файла. Необязательный параметр. Может принимать значения "cp1251" и "utf8". По умолчанию "cp1251".
@@ Строка 570: / Строка 572: @@
   * **warehouse_external_id** - ID Магазина во внешней системе. Может быть использован вместо **warehouse_id**.
-  * **phone** - код Магазина во внешней системе
+  * **phone** - телефон клиента. Необязательный параметр. Необходим, если из Поступления планируется создать заказ.
-  * **order** - код Магазина во внешней системе
+  * **order** - номер заказа. Необязательный параметр. Необходим, если из Поступления планируется создать заказ.
-  * **unique** - код Магазина во внешней системе
+  * **unique** - Если равен true, то будет проверено, что такое Поступление еще не загружалось в систему. Если false - проверки не будет. Необязательный параметр. По умолчанию равен true.
+==== Пример файла для загрузки Поступления в csv-формате ====
+<code>
+Количество;Количество ожидаемое;Цена закупки;Цена закупки без НДС;Сумма закупки;Штрихкод;Серия;Годен до;ID товара у Поставщика;Название товара у поставщика;Ставка НДС;Сумма НДС;Сумма без НДС;Цена Производителя без НДС;Цена оптовика;Цена гос.реестра;Пр-ль Поставщика;Barcode Поставщика;Номер интернет-заказа;Телефон клиента из интернет-заказа;Цена заказа;Серия ориг;Дата прихода накладной;Цена оптовика без НДС;Маркировка;GTIN Поставщика;GTIN;Серийный номер;itemMarks
+;1;;506.31;556.94;5000456022453;ACAT;01.11.2023;10735;НАЗВАНИЕ ТОВАРА N1;10;50.63;506.31;460.67;556.94;460.94;ПРОИЗВОДИТЕЛЬ 1;5000456022453;MI-73593673;9252641193;584;ACAT;05.04.2022;506.31;1;05000456022453;05000456022453;1874636963757;0105000456022453211874636963757(29)91EE06(29)92b0VLuAZIufzxLiq2UNfuj3nv1s5etmPKVW9qAYLn+bM=
+;1;;371.8;408.98;5000456022460;ABBV;01.11.2023;10734;НАЗВАНИЕ ТОВАРА N2;10;37.18;371.8;338.16;408.98;338.65;ПРОИЗВОДИТЕЛЬ 2;5000456022460;MI-73593673;9252641193;432;ABBV;05.04.2022;371.8;0;05000456022460;05000456022460;;
+</code>
 ==== Ответ сервера ====
@@ Строка 581: / Строка 590: @@
 Также возвращается имя временного файла, в который было сохранено загруженное поступление. В дальнейшем из него будет создано поступление в системе.
 ==== Пример ответа сервера ====