/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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认值0 |
| 2 | length | 分页大小 | integer | — | 可选 | 分页大小,默认20 |
| 3 | sids | 店铺id | array<any> | — | 可选 | 店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 4 | mids | 国家id | array<any> | — | 可选 | 国家id |
| 5 | ads_type | 广告类型 | array<any> | — | 可选 | 广告类型: SPONSORED PRODUCTS SPONSORED DISPLAY SPONSORED BRANDS SPONSORED BRANDS VIDEO |
| 6 | invoice_start_time | 开始时间【发票开具时间】 | string | — | 必填 | 开始时间【发票开具时间】 |
| 7 | invoice_end_time | 结束时间【发票开具时间】 | string | — | 必填 | 结束时间【发票开具时间】 |
| 8 | search_type | 搜索类型 | string | — | 可选 | 搜索类型: ads_campaign【对应页面广告活动】 invoice_id【对应发票编号】 msku asin |
| 9 | search_value | 搜索值 | string | — | 可选 | 搜索值 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 提示消息 | string | success | 必填 | 提示消息 |
| 3 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | 81CA6A9A-A5C4-8B5E-5FED-E1C2EC04753C | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2023-04-07 12:11:12 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 1 | 必填 | 总数 |
| 7 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 7.1 | invoice_id | 发票编号 | string | CDLPWKJPR-64 | 必填 | 发票编号 |
| 7.2 | status | 状态 | string | PAID_IN_FULL | 必填 | 状态 |
| 7.3 | payment_method | 付款类型 | string | UNIFIED_BILLING | 必填 | 付款类型 |
| 7.4 | from_date | 账单周期开始时间 | string | 2022-12-29 | 必填 | 账单周期开始时间 |
| 7.5 | to_date | 账单周期结束时间 | string | 2023-01-03 | 必填 | 账单周期结束时间 |
| 7.6 | currency_icon | 币种符号 | string | € | 必填 | 币种符号 |
| 7.7 | amount | 账单金额 | number | 420.65 | 必填 | 账单金额 |
| 7.8 | cost_amount | 花费 | number | 422.76 | 必填 | 花费 |
| 7.9 | tax_amount | 税费 | number | 0 | 必填 | 税费 |
| 7.10 | other_allocation_fee | 调整费 | number | -2.11 | 必填 | 调整费 |
| 7.11 | invoice_date | 开具时间 | string | 2023-01-02 | 必填 | 开具时间 |
| 7.12 | sid | 店铺id | integer | 9 | 必填 | 店铺id |
| 7.13 | store_name | 店铺名称 | string | JHL-DE-1 | 必填 | 店铺名称 |
| 7.14 | country | 国家名称 | string | 德国 | 必填 | 国家名称 |
领星ERP的接口:查询广告发票列表(/bd/profit/report/open/report/ads/invoice/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。