Это старая версия документа.


API :: WarehouseEncashment. Инкассации

В системе реализован программный интерфейс для получения данных об инкассации из главной кассы магазина. Данные выгружаются по http протоколу. Формат на выбор - xml или json.

Пример запроса на получение данных

Пример запроса на получение данных об инкассации:

http://mycompany.virtpos.ru/api/warehouseEncashment?apikey=MySecret&format=xml

Параметры запроса

Параметры, которые не отмечены как get only, могут быть переданы как get- или как post-параметры.

  • apikey - Секретный ключ для доступа к данным. Обязательный параметр.
  • format (get only) - формат, в котором сервер отдаст данные. Может принимать значения «xml» или «json». Необязательный параметр.
  • id (get only) - ID инкассации, для которой надо вернуть данные. Необязательный параметр.
  • warehouse_id (get only) - ID точки продаж, для которой надо вернуть данные. Необязательный параметр.
  • ext_warehouse_id (get only) - код точки продаж во внешней системе. Необязательный параметр.
  • date (get only) - получение данных на определенную дату. Формат: ГГГГММДД. Необязательный параметр.
  • date_from (get only) - получение данных начиная с определенной даты. Формат: ГГГГММДД. Необязательный параметр.
  • date_to (get only) - получение данных начиная до определенной даты. Формат: ГГГГММДД. Необязательный параметр.

Ответ сервера

В ответ получаем XML или JSON. В ответе обязательно присутствует поле success. Если success=1, то операция выполнена успешно. Если success=0, то произошла ошибка. Дополнительная информация об ошибке содержится в поле info

Пример ответа сервера

Ниже приведен пример ответа сервера в формате XML

<root>
  <success>1</success>
  <type>warehouseEncashment</type>
  <count>1</count>
  <warehouseEncashment>
    <id>1</id>
    <warehouse_id>12</warehouse_id>
    <amount>12000.00</amount>
    <bag_number/>
    <org_name>ИП Иванов И.И.</org_name>
    <warehouse_name>Владимирская</warehouse_name>
    <warehouse_address>Санкт Петербург</warehouse_address>
    <warehouse_inn>123123123123</warehouse_inn>
    <bank_account_num/>
    <org_account_num/>
    <agent_bank_name/>
    <agent_bank_bik/>
    <recipient_bank_name/>
    <recipient_bank_bik/>
    <source_text>Поступления от продажи товаров</source_text>
    <warehouse_safebox_transaction_id>1234</warehouse_safebox_transaction_id>
    <note1/>
    <note2/>
    <note3/>
    <note4/>
    <note5/>
    <note6/>
    <note7/>
    <note8/>
    <note9/>
    <note10/>
    <note11/>
    <note12/>
    <note13/>
    <note14/>
    <note15/>
    <note16/>
    <note17/>
    <note18/>
    <note19/>
    <note20/>
    <attribute1/>
    <attribute2/>
    <attribute3/>
    <attribute4/>
    <attribute5/>
    <attribute6/>
    <attribute7/>
    <attribute8/>
    <attribute9/>
    <attribute10/>
    <attribute11/>
    <attribute12/>
    <attribute13/>
    <attribute14/>
    <attribute15/>
    <created_date>2019-10-25 14:02:37</created_date>
    <created_by>123</created_by>
    <last_update_date>2019-10-25 14:02:37</last_update_date>
    <last_update_by>123</last_update_by>
    <agent_bank_id/>
    <agent_bank_external_id/>
    <recipient_bank_id/>
    <recipient_bank_external_id/>
    <created_at>2019-10-25 00:00:00</created_at>
    <creator_name>Петров П. П.</creator_name>
    <updater_name>Петров П. П.</updater_name>
  </warehouseEncashment>
</root>