接口说明

商家收集完国补订单的发票、物流及3C商品信息后，调用该接口上送履约及发票信息用于国补报销
新增/修改都是这个接口，全量新增/更新字段，如果是更新也需要赋值全部字段
修改时，只允许审核结果一级状态（audit_main_status）为待核验（30）或者审核失败（11）或者核验失败（32）时修改

使用限制

SLA：支持的最大QPS:10;PCT99承诺值:5000ms;

基本信息

名称	描述
HTTP URL	https://open.douyin.com/goodlife/v1/homed/trade/govsubsidy/upsert/
HTTP Method	POST
Scope	life.capacity.homed.trade.govsubsidy.upsert
权限要求	开发者需要申请权限：国补报销能力开放平台路径：抖音开放平台 > 控制台 > 应用详情 > 解决方案商家授权路径：抖音来客 > 店铺管理 > 第三方应用授权

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

固定值"application/json"

Rpc-Transit-Life-AccountString

来客商户根账户ID

Body展开全部子属性

account_id必填String

商家ID，跟开发者账号绑定的商家ID必须一致，否则会校验失败

delivery_type必填Int32

提货方式

填写规则：1-配送，2-自提

invoice_info必填Struct

发票信息

展开子属性

logistics_info必填Struct

物流信息

展开子属性

order_id必填String

抖音平台的订单号

会校验这个订单是否为传入商家（account_id）的
根据这个订单号校验是否为是国补订单

新增&修改

如果不存在国补报销数据，会新增为国补报销单数据
如果已经存在国补报销数据，会更新替换原报销单数据

custom_fieldsStruct

家电SN码和新家电购买支付凭证

展开子属性

logistics_codeArray<String>

物流代码

other_pic_listArray<String>

额外补充照片，最多4个

three_c_infoStruct

3C产品信息

展开子属性

请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/homed/trade/govsubsidy/upsert/' \
--header 'access-token: 0801121846735352506a356a6' \
--header 'content-type: application/json' \
--header 'Rpc-Transit-Life-Account: 6OqTVdN8yt' \
--data '{"account_id":"Q0xNNYgeqw","custom_fields":{"appliances_box_sn_pic_url":"Xn3CklfJrH","efficiency_grade_pic_url":"VQ6gaVmSY4","payment_pic_url":"OrPYB4Ctcj","sn_codes":["G2ISTJTpuB"]},"delivery_type":7823490579598382942,"invoice_info":{"invoice_ck_cd":"ZHHgFKxOdh","invoice_code":"au3shB8nDR","invoice_date":"NjpZyaJUID","invoice_img_url":"jie3Ez3ZDM","invoice_no":"cooh6evugx","invoice_tax_amt":"GKLUryi0ST","invoice_type":6489528729778405383,"name":"41KyDku7bW","number":5695653624617618161,"sales_ent_name":"jxonKLVbb5","service_name":"cOGh9rcaSw","tax":"V2GJAPA2tP","tax_payer":"RBdNxVajPk"},"logistics_code":["JhvbeALXo7"],"logistics_info":{"logistics_company":"akXZ50GCCA","logistics_img_url":"cjd8VXyZ2V","logistics_trace_url":"Au0qZD3YYT","logistics_type":7509773465537154477,"self_pick_img_url":"Qb6YyW062X","shipping_addr":"OrDGBnRusD","sign_time":"SzG1bYnuIw","usr_addr":"9qiilRmeT0","usr_area":"aChJxcApKB","usr_city":"Rx2o9f2MQu","usr_name":"lwnQKWQz7o","usr_province":"PmySuJE14s"},"order_id":"bckaylIXb6","other_pic_list":["60w5YnXsZb"],"three_c_info":{"activation_box_phone_url":"NVd1TZuuMX","activation_box_url":"CxPvMsziTK","activation_phone_url":"BomWWFBQAZ","imei1":"irboR2RsDO","imei2":"ore2xQSvaz","is_ai_product":false,"pc_type":4499487260700394328}}'

响应参数

Body展开全部子属性

data必填Struct

展开子属性

extra必填Struct

扩展信息

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202602041107121041A8DBEE5E2AC38B23",
    "now": 1770174434
  },
  "data": {
    "error_code": 0,
    "description": ""
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	2100001	未知错误	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2100004	系统繁忙，此时请开发者稍候再试	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2119001	参数不合法	请根据接口错误返回信息调整参数
200	2119002	系统繁忙，请稍候再试	重试
200	2119003	请求太过频繁，请稍后再试	重试
200	2119005	应用未获商家授权	联系合作商家在商家后台发起授权，并在服务商后台同意授权
200	2119010	接口已下线	接口已下线
200	2190002	access_token无效	调用接口重新生成access_token
200	2190004	应用未获得该能力, 请去https://open.douyin.com/申请	应用申请接口权限
200	2190008	access_token过期,请刷新或重新授权	规范token刷新机制，检查是否有测试环境在同步刷新token
200	3000001	根据实际业务错误返回	对照接口文档规范参数并重试
200	5000001	根据实际业务错误返回	联系抖音处理
200	3000002	参数校验不通过，请填写完整必填参数并确保格式正确	补充参数，检查各个参数格式是否正确
200	5000001	系统错误，请重试	多次重试失败请联系抖音处理
200	3000009	当前订单状态不支持国补报销	请核对订单状态，如已取消，已退款等状态不可提交国补报销
200	3000006	3C数码产品尚未绑定SN码，请先绑定SN码	请先调用SN码绑定接口绑定SN码
200	3000007	订单号不存在	请核对确认订单号
200	3000003	订单不是国补订单	请确认订单是否是国补订单
200	3000004	当前报销单状态不允许修改	请确认报销单状态，非可修改状态不支持修改报销单，可等到审核驳回后再修改
200	3000004	当前报销单状态不允许修改	请确认报销单状态，非可修改状态不支持修改报销单，可等到审核驳回后再修改
200	3000001	以实际错误信息为准	联系抖音
200	5000001	服务器打瞌睡了，请稍后再试。	联系抖音
200	3000011	图片无法上上传或者上传超时	请核检查图片url是否正确
200	3000010	发票日期不在国补支持范围内	请核对发票时间是否符合国补政策
200	3000002	以实际错误信息为准	补充参数，检查各个参数格式是否正确

开发者文档

国补报销单新增或修改

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

国补报销单新增或修改在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

国补报销单新增或修改