Lingxing
切换旧版

查询广告发票列表

POST/bd/profit/report/open/report/ads/invoice/list

基本信息

API Path请求协议请求方式令牌桶容量
/bd/profit/report/open/report/ads/invoice/listHTTPSPOST10

请求参数

offsetinteger
分页偏移量,默认值0
lengthinteger
分页大小,默认20
sidsarray<any>
店铺id ,对应查询亚马逊店铺列表接口对应字段【sid】
midsarray<any>
国家id
ads_typearray<any>
广告类型:
SPONSORED PRODUCTS
SPONSORED DISPLAY
SPONSORED BRANDS
SPONSORED BRANDS VIDEO
invoice_start_timestring必填
开始时间【发票开具时间】
invoice_end_timestring必填
结束时间【发票开具时间】
search_typestring
搜索类型:
ads_campaign【对应页面广告活动】
invoice_id【对应发票编号】
msku
asin
search_valuestring
搜索值

请求示例

{
    "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"
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
提示消息
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 81CA6A9A-A5C4-8B5E-5FED-E1C2EC04753C
response_timestring必填
响应时间
示例 2023-04-07 12:11:12
totalinteger必填
总数
示例 1
dataarray<object>必填
响应数据
隐藏子属性
invoice_idstring必填
发票编号
示例 CDLPWKJPR-64
statusstring必填
状态
示例 PAID_IN_FULL
payment_methodstring必填
付款类型
示例 UNIFIED_BILLING
from_datestring必填
账单周期开始时间
示例 2022-12-29
to_datestring必填
账单周期结束时间
示例 2023-01-03
currency_iconstring必填
币种符号
示例 €
amountnumber必填
账单金额
示例 420.65
cost_amountnumber必填
花费
示例 422.76
tax_amountnumber必填
税费
示例 0
other_allocation_feenumber必填
调整费
示例 -2.11
invoice_datestring必填
开具时间
示例 2023-01-02
sidinteger必填
店铺id
示例 9
store_namestring必填
店铺名称
示例 JHL-DE-1
countrystring必填
国家名称
示例 德国

返回成功示例

{
    "code": 0,
    "message": null,
    "data": [
        {
            "status": "ISSUED",
            "amount": 1.9400,
            "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.9400,
            "tax_amount": 0.0000,
            "other_allocation_fee": 0.0000,
            "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
}