|
The URL for sending a request
|
https://api.digiseller.com/api/seller-sells/v2?token={token} |
|
Method:
|
POST |
|
Request headers:
|
<![CDATA[Content-Type: "text/xml" | "text/json" | "application/json" Request format
Accept: "text/xml" | "text/json" | "application/json" - Response format
]]>
|
|
Request format:
|
xml
json
<![CDATA[<digiseller.request>
<product_ids>
<id>1954830</id>
<id>2080515</id>
</product_ids>
<date_start>2017-01-01 00:00:00</date_start>
<date_finish>2017-12-04 23:59:59</date_finish>
<returned>0</returned>
<page>1</page>
<rows>10</rows>
</digiseller.request>]]>
<![CDATA[{
"product_ids": [1954830,2080515],
"date_start": "2017-01-01 00:00:00",
"date_finish": "2017-12-04 23:59:59",
"returned": 0,
"page": 1,
"rows": 10
}]]>
|
|
Request parameters
|
| Name |
Use |
Comment |
| token |
Access token,
min. permission: [ Statistics ]: Sales statistics |
Method for creating access token |
| product_ids |
Items ids |
Array of integers; if not specified, then returns the statistics for all products |
| date_start |
Date start |
Data format: 'yyyy-MM-dd HH:mm:ss'
time zone: Moscow Time UTC+03:00 |
| date_finish |
Date finish |
Data format: 'yyyy-MM-dd HH:mm:ss'
time zone: Moscow Time UTC+03:00 |
| returned |
Refunds |
0 - Include refunds; 1 - Exclude refunds; 2 - Only refunds |
| page |
Page number |
Integer |
| rows |
Count of rows per page |
Integer (10 by default, 1000 max) |
|
|
Request encoding:
|
UTF-8 |
|
Response format:
|
xml
json
<![CDATA[<digiseller.response>
<retval>0</retval>
<total_rows>62</total_rows>
<pages>7</pages>
<page>1</page>
<rows cnt="10">
<row>
<invoice_id>60056190</invoice_id>
<product_id>1954830</product_id>
<product_name>
<![CDATA[Unique code]]]]><![CDATA[>
</product_name>
<product_entry_id>41609385</product_entry_id>
<product_entry>
<![CDATA[****]]]]><![CDATA[>
</product_entry>
<date_put>2016-11-24 19:29:16</date_put>
<date_pay>2017-03-09 13:53:19</date_pay>
<email>email@example.com</email>
<wmid>000000000000</wmid>
<amount_in>9.99</amount_in>
<amount_out>9.69</amount_out>
<amount_currency>WMR</amount_currency>
<method_pay>Merchant</method_pay>
<aggregator_pay>WebMoney</aggregator_pay>
<ip>127.0.0.1</ip>
<partner_id>0</partner_id>
<lang>ru-RU</lang>
<returned>0</returned>
<owner>0</owner>
</row>
...
</rows>
</digiseller.response>]]>
<![CDATA[{
"retval": 0,
"retdesc": null,
"total_rows": 62,
"pages": 7,
"page": 1,
"rows": [
{
"invoice_id": 60056190,
"product_id": 1954830,
"product_name": "Unique code",
"product_entry_id": 41609385,
"product_entry": "****",
"date_put": "2016-11-24 19:29:16",
"date_pay": "2017-03-09 13:53:19",
"email": "email@example.com",
"wmid": "000000000000",
"amount_in": 9.99,
"amount_out": 9.69,
"amount_currency": "WMR",
"method_pay": "Merchant",
"aggregator_pay": "WebMoney",
"ip": "127.0.0.1",
"partner_id": "0",
"lang": "ru-RU",
"returned": 0,
"owner": 0
},
...
]
}]]>
|
|
Response parameters:
|
| Name |
Use |
Comment |
| retval |
result code |
0 - success
request validation error codes:
1 - id_seller parameter is invalid
2 - page parameter is invalid
3 - rows parameter is invalid
9 - returned parameter is invalid
10 - sign parameter is invalid
11 - date_start parameter is invalid
12 - date_finish parameter is invalid
|
| retdesc |
decryption of the request execution code |
|
| id_seller |
seller ID |
|
| total_rows |
total rows |
|
| pages |
total pages num |
|
| page |
page number |
|
| rows |
list of sales |
cnt - rows count |
| rows\row |
sales parameters |
|
| rows\row\invoice_id |
order ID |
|
| rows\row\product_id |
item id |
|
| rows\row\product_name |
item name |
CDATA |
| rows\row\product_entry_id |
item content id |
|
| rows\row\product_entry |
content of the item |
CDATA;
This parameter is inaccessible by default.
To get the value of the parameter, the token must have the permission
[ Content ]: View. |
| rows\row\date_put |
the date the content was added |
data format: 'yyyy-MM-dd HH:mm:ss'
time zone: Moscow Time UTC+03:00 |
| rows\row\date_pay |
date of sale |
data format: 'yyyy-MM-dd HH:mm:ss'
time zone: Moscow Time UTC+03:00 |
| rows\row\email |
customer's email |
|
| rows\row\wmid |
buyer's WMID |
|
| rows\row\amount_in |
paid amount |
|
| rows\row\amount_out |
credited amount |
|
| rows\row\amount_currency |
currency of crediting funds from the sale |
WMZ | WMR | WME | WMU | WMX |
| rows\row\method_pay |
payment method |
|
| rows\row\aggregator_pay |
payment integrator |
|
| rows\row\ip |
customer IP address |
|
| rows\row\partner_id |
affiliate partner ID |
|
| rows\row\lang |
buyer's language |
ru-RU or en-US |
| rows\row\returned |
refunded |
0|1 |
| rows\row\owner |
marketplace identifier |
0 - own shop
1 - plati.market
1271 - ggesel
9295 - wmcenter.net |
|
РУС
ENG