/bd/profit/report/open/report/ads/invoice/list{
"operation": {
"method": "POST",
"path": "/bd/profit/report/open/report/ads/invoice/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 10,
"text": ""
},
"requestExample": {
"offset": 0,
"length": 20,
"sid": [
1,
2,
136,
139
],
"mid": [
1,
2
],
"ads_type": [
"SPONSORED PRODUCTS"
],
"invoice_start_time": "2024-06-01",
"invoice_end_time": "2024-07-20",
"search_type": "invoice_id",
"search_value": "TRF6K4FJN-1"
},
"responseExample": {
"code": 0,
"message": null,
"data": [
{
"status": "ISSUED",
"amount": 1.94,
"sid": 136,
"country": "美国",
"invoice_id": "TRF6K4FJN-1",
"payment_method": "UNIFIED_BILLING",
"from_date": "2024-06-03",
"to_date": "2024-06-04",
"currency_icon": "$",
"cost_amount": 1.94,
"tax_amount": 0,
"other_allocation_fee": 0,
"invoice_date": "2024-06-03",
"store_name": "renxiao-US"
}
],
"error_details": null,
"request_id": "cf4c5e99-1fbb-42d4-98fc-6a5697dd7f9d.1721879115549",
"response_time": "2024-07-25 11:45:15",
"total": 1
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,默认值0 |
| 2 | length | 分页大小 | integer | — | Optional | 分页大小,默认20 |
| 3 | sids | 店铺id | array<any> | — | Optional | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 4 | mids | 国家id | array<any> | — | Optional | 国家id |
| 5 | ads_type | 广告类型 | array<any> | — | Optional | 广告类型: SPONSORED PRODUCTS SPONSORED DISPLAY SPONSORED BRANDS SPONSORED BRANDS VIDEO |
| 6 | invoice_start_time | 开始时间【发票开具时间】 | string | — | Required | 开始时间【发票开具时间】 |
| 7 | invoice_end_time | 结束时间【发票开具时间】 | string | — | Required | 结束时间【发票开具时间】 |
| 8 | search_type | 搜索类型 | string | — | Optional | 搜索类型: ads_campaign【对应页面广告活动】 invoice_id【对应发票编号】 msku asin |
| 9 | search_value | 搜索值 | string | — | Optional | 搜索值 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 提示消息 | string | success | Required | 提示消息 |
| 3 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | 81CA6A9A-A5C4-8B5E-5FED-E1C2EC04753C | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2023-04-07 12:11:12 | Required | 响应时间 |
| 6 | total | 总数 | integer | 1 | Required | 总数 |
| 7 | data | 响应数据 | array<object> | — | Required | 响应数据 |
| 7.1 | invoice_id | 发票编号 | string | CDLPWKJPR-64 | Required | 发票编号 |
| 7.2 | status | 状态 | string | PAID_IN_FULL | Required | 状态 |
| 7.3 | payment_method | 付款类型 | string | UNIFIED_BILLING | Required | 付款类型 |
| 7.4 | from_date | 账单周期开始时间 | string | 2022-12-29 | Required | 账单周期开始时间 |
| 7.5 | to_date | 账单周期结束时间 | string | 2023-01-03 | Required | 账单周期结束时间 |
| 7.6 | currency_icon | 币种符号 | string | € | Required | 币种符号 |
| 7.7 | amount | 账单金额 | number | 420.65 | Required | 账单金额 |
| 7.8 | cost_amount | 花费 | number | 422.76 | Required | 花费 |
| 7.9 | tax_amount | 税费 | number | 0 | Required | 税费 |
| 7.10 | other_allocation_fee | 调整费 | number | -2.11 | Required | 调整费 |
| 7.11 | invoice_date | 开具时间 | string | 2023-01-02 | Required | 开具时间 |
| 7.12 | sid | 店铺id | integer | 9 | Required | 店铺id |
| 7.13 | store_name | 店铺名称 | string | JHL-DE-1 | Required | 店铺名称 |
| 7.14 | country | 国家名称 | string | 德国 | Required | 国家名称 |
The 查询广告发票列表 API (/bd/profit/report/open/report/ads/invoice/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.