POST api/agent-sales

Продажи продавца в роле партнера

Request Information

URI Parameters

None.

Body Parameters

SalesRequest

PartnerSalesRequest
NameDescriptionTypeAdditional information
id_partner

идентификатор партнера

integer

None.

product_ids

идентификаторы товаров в виде массива. если не указаны, возвращается статистика по всем товарам

Collection of integer

None.

date_start

начальная дата yyyy-MM-dd HH:mm:ss

string

None.

date_finish

конечная дата yyyy-MM-dd HH:mm:ss

string

None.

returned

возвраты 0 - включить возвраты; 1 - исключить возвраты; 2 - только возвраты

integer

None.

page

номер страницы (если не указывать номер страницы, то отображается первая страница)

integer

None.

rows

количество записей на странице (по умолчанию 10, не более 5000)

integer

None.

sign

подпись sha256({id_partner}{product_ids}{date_start}{date_finish}{returned}{page}{rows}{seller_secret}) lowcase

string

None.

Request Formats

application/json, text/json

Sample:
{
  "id_partner": 1,
  "product_ids": [
    1,
    2
  ],
  "date_start": "sample string 2",
  "date_finish": "sample string 3",
  "returned": 4,
  "page": 5,
  "rows": 6,
  "sign": "sample string 7"
}

application/x-www-form-urlencoded

Sample:

Sample not available.

application/xml, text/xml

Sample:
<digiseller.request>
  <id_partner>1</id_partner>
  <product_ids>
    <id>1</id>
    <id>2</id>
  </product_ids>
  <date_start>sample string 2</date_start>
  <date_finish>sample string 3</date_finish>
  <returned>4</returned>
  <page>5</page>
  <rows>6</rows>
  <sign>sample string 7</sign>
</digiseller.request>

Response Information

Resource Description

SalesResponse

SalesResponse
NameDescriptionTypeAdditional information
retval

код выполнения запроса 0 — запрос успешно отработан коды ошибок валидации запроса: 1 - неверно задан параметр id_seller; 2 - неверно задан параметр page; 3 - неверно задан параметр rows; 9 - неверно задан параметр returned; 10 - неверно задан параметр sign; 11 - неверно задан параметр date_start; 12 - неверно задан параметр date_finish.

integer

None.

retdesc

описание кода выполнения

string

None.

total_rows

общее кол-во записей

integer

None.

pages

всего страниц

integer

None.

page

номер страницы

integer

None.

Rows

перечень продаж

SalesRows

None.

Response Formats

application/json, text/json

Sample:
{
  "retval": 1,
  "retdesc": "sample string 2",
  "total_rows": 3,
  "pages": 4,
  "page": 5,
  "rows": [
    {
      "id_seller": 1,
      "invoice_id": 2,
      "product_id": 3,
      "product_name": "",
      "product_entry_id": 4,
      "date_pay": "sample string 6",
      "email": "sample string 7",
      "wmid": "sample string 8",
      "amount_in": 9.0,
      "amount_currency": "sample string 11",
      "amount_in_usd": 12.0,
      "method_pay": "sample string 13",
      "aggregator_pay": "sample string 14",
      "ip": "sample string 15",
      "partner_percent": 17.0,
      "partner_amount": 18.0,
      "lang": "sample string 19",
      "returned": 20,
      "referer": "sample string 21",
      "owner": 22
    },
    {
      "id_seller": 1,
      "invoice_id": 2,
      "product_id": 3,
      "product_name": "",
      "product_entry_id": 4,
      "date_pay": "sample string 6",
      "email": "sample string 7",
      "wmid": "sample string 8",
      "amount_in": 9.0,
      "amount_currency": "sample string 11",
      "amount_in_usd": 12.0,
      "method_pay": "sample string 13",
      "aggregator_pay": "sample string 14",
      "ip": "sample string 15",
      "partner_percent": 17.0,
      "partner_amount": 18.0,
      "lang": "sample string 19",
      "returned": 20,
      "referer": "sample string 21",
      "owner": 22
    }
  ]
}

application/xml, text/xml

Sample:
<digiseller.response>
  <retval>1</retval>
  <retdesc>sample string 2</retdesc>
  <total_rows>3</total_rows>
  <pages>4</pages>
  <page>5</page>
  <rows cnt="2">
    <row>
      <id_seller>1</id_seller>
      <invoice_id>2</invoice_id>
      <product_id>3</product_id>
      <product_name><![CDATA[]]></product_name>
      <product_entry_id>4</product_entry_id>
      <date_pay>sample string 6</date_pay>
      <email>sample string 7</email>
      <wmid>sample string 8</wmid>
      <amount_in>9</amount_in>
      <amount_currency>sample string 11</amount_currency>
      <amount_in_usd>12</amount_in_usd>
      <method_pay>sample string 13</method_pay>
      <aggregator_pay>sample string 14</aggregator_pay>
      <ip>sample string 15</ip>
      <partner_percent>17</partner_percent>
      <partner_amount>18</partner_amount>
      <lang>sample string 19</lang>
      <returned>20</returned>
      <referer>sample string 21</referer>
      <owner>22</owner>
    </row>
    <row>
      <id_seller>1</id_seller>
      <invoice_id>2</invoice_id>
      <product_id>3</product_id>
      <product_name><![CDATA[]]></product_name>
      <product_entry_id>4</product_entry_id>
      <date_pay>sample string 6</date_pay>
      <email>sample string 7</email>
      <wmid>sample string 8</wmid>
      <amount_in>9</amount_in>
      <amount_currency>sample string 11</amount_currency>
      <amount_in_usd>12</amount_in_usd>
      <method_pay>sample string 13</method_pay>
      <aggregator_pay>sample string 14</aggregator_pay>
      <ip>sample string 15</ip>
      <partner_percent>17</partner_percent>
      <partner_amount>18</partner_amount>
      <lang>sample string 19</lang>
      <returned>20</returned>
      <referer>sample string 21</referer>
      <owner>22</owner>
    </row>
  </rows>
</digiseller.response>