贸易订单对应订单状态支持操作说明

操作说明：复制操作为将选择条数据进行复制一条新数据可根据查询详情接口获取选择条数据置空请求流水号调用创建贸易订单接口完成复制操作

状态	支持操作
草稿	编辑、复制、删除
待审核	复制
待补充	复制
更新待审核	复制
收款中	编辑、复制
已关闭	编辑、复制
驳回	复制、删除
已过期	复制、删除
已作废	复制、删除

创建贸易订单

创建贸易订单

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/insert
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/insert

字段说明

调用的特定输入参数

字段名	必填	类型	说明
tradeOrderReference	M	String	贸易订单请求流水号(唯一)
merchantId	M	Long	商户ID
tradeOrderType	M	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
businessId	O	Long	服务类型ID(服务类型必填)
foreignExchangeSettledFlag	M	Integer	是否需要结汇：0. 否；1. 是
tradeOrderName	M	String	订单名称
tradeOrderCode	M	String	订单编码
tradeOrderTotalAmount	M	Number	贸易订单总额
tradeOrderCurrency	M	String	贸易订单币种
partnerType	O	String	合作方官网（服务贸易必填）
tradeOrderDate	O	String	订单时间（货物贸易必填）格式：`yyyy-MM-dd`
fundNature	O	Integer	资金性质（货物贸易必填）：0. 物流费用；1. 一般贸易-代采 2.服务费用
buyerName	M	String	货物贸易：买家名称；服务贸易：合作方名称
buyerCountry	O	String	买家国家/地区（货物贸易必填）
storeUrl	O	String	店铺网址（货物贸易必填）
tradeOrderItemList	O	List<tradeOrderItemObject>	贸易订单商品信息（货物贸易必填）
isShipped	M	Integer	是否发货：0. 否；1. 是货物贸易：是否发货；服务贸易：是否需要物流
tradeOrderLogisticsList	O	List<tradeOrderLogisticsObject>	物流信息；isShipped=是：必填
remark	O	String	备注信息
autoPostFlag	M	Integer	是否自动入账：0. 否；1. 是
tradeOrderFileList	M	List<tradeOrderFileObject>	附件信息
tradeOrderStatus	M	Integer	贸易订单状态：0. 保存草稿；1. 立即创建
remitAccName	O	String	付款人名称
remitAccNo	O	String	付款人账号
deliveryEtaDate	O	String	预计发货时间（货物贸易是否发货=否必填）格式：`yyyy-MM-dd`
createPattern	M	Integer	创建方式:0.智能识别;1.手动填写;2.智能识别-复制;3.手动填写-复制;

tradeOrderItemObject字段结构

字段名	必填	类型	说明
tradeOrderItemReference	M	String	贸易订单商品请求流水号(唯一)
itemName	M	String	商品名称
quantity	M	String	数量
unit	M	Integer	单位：0. 个；1. 件；2. 套；3. 台；4. 箱；5. 千克

tradeOrderLogisticsObject字段结构

字段名	必填	类型	说明
tradeOrderLogisticsReference	M	String	贸易订单物流请求流水号(唯一)
logisticsMethod	M	Integer	物流方式：0. 国际快递；1. 海运；2. 空运；3. 陆运；4. 铁路；5. 专线运输；6. 其他；
logisticsNo	M	String	货物贸易：出境物流单号；服务贸易：运单号
logisticsCompany	M	String	货物贸易：物流公司；服务贸易：运输公司
consignedGoods	O	String	承运物品（服务贸易必填）
receivingCountry	O	String	收货地（服务贸易必填）
departureTime	O	Date	起运时间（服务贸易必填）格式：`yyyy-MM-dd`
tradeOrderFileList	O	List<tradeOrderFileObject>	物流附件信息(货物贸易必填)

tradeOrderFileObject字段结构

字段名	必填	类型	说明
tradeOrderFileReference	M	String	贸易订单附件请求流水号(唯一)
fileType	M	Integer	文件类型：0. 发票附件（PO/CI/PO附件）；1. 物流单附件；3. 其他材料附件；
fileName	M	String	文件名称
filePath	M	String	文件地址

响应data参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
merchantId	Long	商户ID
tradeOrderType	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
businessId	Long	服务类型ID
foreignExchangeSettledFlag	Integer	是否需要结汇：0. 否；1. 是
tradeOrderName	String	订单名称
tradeOrderCode	String	订单编码
tradeOrderTotalAmount	Number	贸易订单总额
tradeOrderCurrency	String	贸易订单币种
tradeOrderDate	String	订单时间
fundNature	Integer	资金性质
buyerName	String	货物贸易：买家名称；服务贸易：合作方名称
buyerCountry	String	买家国家/地区
partnerType	String	合作方官网
storeUrl	String	店铺网址
isShipped	Integer	是否发货：0. 否；1. 是
remark	String	备注信息
autoPostFlag	Integer	是否自动入账：0. 否；1. 是
relateOrderCount	Integer	已关联订单数量
relateOrderAmount	Number	已关联订单累计金额
tradeOrderStatus	Integer	贸易订单状态
remitAccName	String	付款人名称
remitAccNo	String	付款人账号
deliveryEtaDate	String	预计发货时间
createPattern	Integer	创建方式：0. 智能识别；1. 手动填写；2. 智能识别-复制；3. 手动填写-复制
createTime	String	创建时间
updateTime	String	修改时间
tradeOrderItemRepList	List<tradeOrderItemRepObject>	贸易订单商品信息列表
tradeOrderLogisticsRepList	List<tradeOrderLogisticsRepObject>	贸易订单物流信息列表
tradeOrderFileRepList	List<tradeOrderFileRepObject>	贸易订单附件信息列表

tradeOrderItemRepObject 字段结构

字段名	类型	说明
itemName	String	商品名称
quantity	String	数量
unit	Integer	单位
createTime	String	创建时间
updateTime	String	修改时间
tradeOrderItemReference	String	贸易订单商品请求流水号
tradeOrderReference	String	贸易订单请求流水号

tradeOrderLogisticsRepObject 字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
tradeOrderLogisticsReference	String	贸易订单物流请求流水号
logisticsMethod	Integer	物流方式：0. 国际快递；1. 海运；2. 空运；3. 陆运；4. 铁路；5. 专线运输；6. 其他
logisticsNo	String	物流单号
logisticsCompany	String	物流公司或运输公司
consignedGoods	String	承运物品
receivingCountry	String	收货地
departureTime	String	起运时间
createTime	String	创建时间
updateTime	String	修改时间
tradeOrderFileRepList	List<tradeOrderFileRepObject>	物流附件信息列表

tradeOrderFileRepObject 字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
businessReference	String	业务请求流水号
tradeOrderFileReference	String	贸易订单附件请求流水号
fileType	Integer	文件类型：0. 发票附件；1. 物流单附件；3. 其他材料附件
fileName	String	文件名称
filePath	String	文件地址
createTime	String	创建时间
updateTime	String	修改时间

集成

创建贸易订单调用输入

{
    "tradeOrderType": "0",
    "foreignExchangeSettledFlag": "1",
    "merchantId": "2069620115141472256",
    "tradeOrderCurrency": "USD",
    "tradeOrderItemList": [
        {
            "itemName": "1",
            "quantity": "1",
            "unit": "0",
            "tradeOrderItemReference": "TRADE_ITEM_ad2983edca0c4b868ab7d6f176d8f5d62"
        }
    ],
    "isShipped": "0",
    "autoPostFlag": "1",
    "tradeOrderName": "20260903",
    "tradeOrderCode": "2026090322",
    "tradeOrderTotalAmount": 31000,
    "tradeOrderDate": "2026-08-01",
    "buyerName": "aertuluo",
    "buyerCountry": "US",
    "storeUrl": "https://merchant.futurepay-develop.com/trade/createOrder",
    "remark": null,
    "fundNature": 0,
    "remitAccName": null,
    "remitAccNo": null,
    "deliveryEtaDate": "2026-08-01",
    "tradeOrderReference": "TRADE_79a83d0bd7f0445ba7ba4b20ee9938e22",
    "tradeOrderSupplement": null,
    "tradeOrderLogisticsList": [
        {
            "logisticsMethod": "0",
            "logisticsNo": "984132132645",
            "logisticsCompany": "wuliugongsi",
            "tradeOrderLogisticsReference": "TRADE_LOGISTICS_0a417f0a8d784478b55eaf8b95e85ec82",
            "tradeOrderFileList": [
                {
                    "tradeOrderFileReference": "TRADE_FILE_0a417f0a83265478b55eaf8b95e85ec82",
                    "fileType": "0",
                    "fileName": "1.png",
                    "filePath": "business/acount/4616400be7334455918fdc7383ca0b7f.png"
                }
            ]
        }
    ],
    "tradeOrderFileList": [
        {
            "tradeOrderFileReference": "TRADE_FILE_0a417f0a83265478b55eaf8b95e85ec82",
            "fileType": "0",
            "fileName": "1.png",
            "filePath": "business/acount/4616400be7334455918fdc7383ca0b7f.png"
        }
    ],
    "tradeOrderStatus": 1,
    "createPattern": 1
}

创建贸易订单调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1788770345989,
    "data": {
        "tradeOrderReference": "TRADE_79a83d0bd7f0445ba7ba4b20ee9938e22",
        "merchantId": 2069620115141472256,
        "tradeOrderType": 0,
        "businessId": null,
        "foreignExchangeSettledFlag": 1,
        "tradeOrderName": "20260903",
        "tradeOrderCode": "2026090322",
        "tradeOrderTotalAmount": 31000.000000,
        "tradeOrderCurrency": "USD",
        "tradeOrderDate": "2026-08-01",
        "fundNature": 0,
        "buyerName": "aertuluo",
        "buyerCountry": "US",
        "partnerType": null,
        "storeUrl": "https://merchant.futurepay-develop.com/trade/createOrder",
        "isShipped": 0,
        "remark": null,
        "autoPostFlag": 1,
        "relateOrderCount": 0,
        "relateOrderAmount": 0.000000,
        "tradeOrderStatus": 1,
        "remitAccName": null,
        "remitAccNo": null,
        "deliveryEtaDate": "2026-08-01",
        "createPattern": 1,
        "createTime": "2026-09-07 08:39:06",
        "updateTime": "2026-09-07 08:39:05",
        "tradeOrderItemRepList": [
            {
                "itemName": "1",
                "quantity": "1",
                "unit": 0,
                "createTime": "2026-09-07 08:39:05",
                "updateTime": "2026-09-07 08:39:05",
                "tradeOrderItemReference": "TRADE_ITEM_ad2983edca0c4b868ab7d6f176d8f5d62",
                "tradeOrderReference": "TRADE_79a83d0bd7f0445ba7ba4b20ee9938e22"
            }
        ],
        "tradeOrderLogisticsRepList": [
            {
                "tradeOrderReference": "TRADE_79a83d0bd7f0445ba7ba4b20ee9938e22",
                "tradeOrderLogisticsReference": "TRADE_LOGISTICS_0a417f0a8d784478b55eaf8b95e85ec82",
                "logisticsMethod": 0,
                "logisticsNo": "984132132645",
                "logisticsCompany": "wuliugongsi",
                "consignedGoods": null,
                "receivingCountry": null,
                "departureTime": null,
                "createTime": "2026-09-07 08:39:05",
                "updateTime": "2026-09-07 08:39:05",
                "tradeOrderFileRepList": null
            }
        ],
        "tradeOrderFileRepList": [
            {
                "tradeOrderReference": "TRADE_79a83d0bd7f0445ba7ba4b20ee9938e22",
                "businessReference": null,
                "tradeOrderFileReference": "TRADE_FILE_0a417f0a83265478b55eaf8b95e85ec82",
                "fileType": 0,
                "fileName": "1.png",
                "filePath": "business/acount/4616400be7334455918fdc7383ca0b7f.png",
                "createTime": "2026-09-07 08:39:05",
                "updateTime": "2026-09-07 08:39:05"
            },
            {
                "tradeOrderReference": "TRADE_79a83d0bd7f0445ba7ba4b20ee9938e22",
                "businessReference": "TRADE_LOGISTICS_0a417f0a8d784478b55eaf8b95e85ec82",
                "tradeOrderFileReference": "TRADE_FILE_0a417f0a83265478b55eaf8b95e85ec82",
                "fileType": 0,
                "fileName": "1.png",
                "filePath": "business/acount/4616400be7334455918fdc7383ca0b7f.png",
                "createTime": "2026-09-07 08:39:05",
                "updateTime": "2026-09-07 08:39:05"
            }
        ]
    },
    "success": true
}

贸易订单系统自动识别填单

贸易订单系统自动识别填单

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/identify
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/identify

字段说明

调用的特定输入参数

字段名	必填	类型	说明
tradeOrderType	M	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
filePathList	M	List<String>	待识别文件路径列表
reqNo	M	String	唯一请求编码

集成

贸易订单系统自动识别填单调用输入

{
    "tradeOrderType": 0,
    "filePathList": [],
    "reqNo": "11111"
}

贸易订单系统自动识别填单调用输出

{
  "code": "",
  "msg": "",
  "serverTime": 0,
  "data": null
}

贸易订单列表查询

贸易订单列表查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/list
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/list

字段说明

调用的特定输入参数

字段名	类型	说明
searchValue	String	搜索值（贸易订单号、订单名称、买家名称、合作方名称）
buyerCountryList	List<String>	买家国家/地区
tradeOrderCurrencyList	List<String>	贸易订单币种
tradeOrderStatusList	List<String>	贸易订单状态：0. 草稿；1. 待审核；2. 待补充；3. 收款中；4. 更新待审核；5. 驳回；6. 已关闭；7. 已过期；8. 已作废
isShipped	Integer	是否发货：0. 未发货；1. 已发货
createStartTime	Date	创建开始时间，格式：`yyyy-MM-dd HH:mm:ss`
createEndTime	Date	创建结束时间，格式：`yyyy-MM-dd HH:mm:ss`
pageNum	int	当前页码
pageSize	int	每页显示条数（页大小）

调用的特定输出参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
merchantId	Long	商户ID
tradeOrderType	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
businessId	Long	服务类型ID
foreignExchangeSettledFlag	Integer	是否需要结汇：0. 否；1. 是
tradeOrderName	String	订单名称
tradeOrderCode	String	订单编码
tradeOrderTotalAmount	BigDecimal	贸易订单总额
tradeOrderCurrency	String	贸易订单币种
tradeOrderDate	LocalDate	订单时间，格式：`yyyy-MM-dd`
fundNature	Integer	资金性质：0. 物流费用；1. 一般贸易-代采；2. 服务费用
buyerName	String	货物贸易：买家名称；服务贸易：合作方名称
buyerCountry	String	买家国家/地区
partnerType	String	合作方官网
storeUrl	String	店铺网址
isShipped	Integer	是否发货：0. 否；1. 是
remark	String	备注信息
autoPostFlag	Integer	是否自动入账：0. 否；1. 是
relateOrderCount	Integer	已关联订单数量
relateOrderAmount	BigDecimal	已关联订单累计金额
tradeOrderStatus	Integer	贸易订单状态：0. 草稿；1. 待审核；2. 待补充；3. 收款中；4. 更新待审核；5. 驳回；6. 已关闭；7. 已过期；8. 已作废
remitAccName	String	付款人名称
remitAccNo	String	付款人账号
deliveryEtaDate	Date	预计发货时间，格式：`yyyy-MM-dd`
createPattern	Integer	创建方式：0. 智能识别；1. 手动填写；2. 智能识别-复制；3. 手动填写-复制
createTime	Date	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	Date	修改时间，格式：`yyyy-MM-dd HH:mm:ss`

集成

贸易订单列表查询调用输入

{
    "pageNum":1,
    "pageSize": 10,
    "searchValue": null,
    "buyerCountryList": [],
    "tradeOrderCurrencyList": [],
    "tradeOrderStatusList": [],
    "isShipped": 1,
    "createStartTime": "2024-05-03 14:22:00",
    "createEndTime": "2024-05-03 14:22:00"
}

贸易订单列表查询调用输出

{
  "code": "",
  "msg": "",
  "serverTime": 0,
  "data": {
    "total": 0,
    "list": [
        {
          "tradeOrderReference": "",
          "merchantId": 0,
          "tradeOrderType": 0,
          "businessId": null,
          "foreignExchangeSettledFlag": 0,
          "tradeOrderName": "",
          "tradeOrderCode": "",
          "tradeOrderTotalAmount": 0,
          "tradeOrderCurrency": "",
          "tradeOrderDate": "",
          "fundNature": null,
          "buyerName": "",
          "buyerCountry": "",
          "partnerType": null,
          "storeUrl": "",
          "isShipped": 0,
          "remark": "",
          "autoPostFlag": 0,
          "relateOrderCount": 0,
          "relateOrderAmount": 0,
          "tradeOrderStatus": 0,
          "remitAccName": null,
          "remitAccNo": null,
          "deliveryEtaDate": null,
          "createPattern": 0,
          "createTime": "",
          "updateTime": ""
        }
    ],
    "pageNum": 0,
    "pageSize": 0,
    "size": 0,
    "startRow": 0,
    "endRow": 0,
    "pages": 0,
    "prePage": 0,
    "nextPage": 0,
    "isFirstPage": "false",
    "isLastPage": "false",
    "hasPreviousPage": "false",
    "hasNextPage": "false",
    "navigatePages": 0,
    "navigatepageNums": [
      0
    ],
    "navigateFirstPage": 0,
    "navigateLastPage": 0
  }
}

贸易订单列表Total查询

贸易订单列表Total查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/queryTradeOrderStatusCount
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/queryTradeOrderStatusCount

字段说明

调用的特定输入参数

字段名	类型	说明
searchValue	String	搜索值（贸易订单号、订单名称、买家名称、合作方名称）
buyerCountryList	List<String>	买家国家/地区
tradeOrderCurrencyList	List<String>	贸易订单币种
tradeOrderStatusList	List<String>	贸易订单状态：0. 草稿；1. 待审核；2. 待补充；3. 收款中；4. 更新待审核；5. 驳回；6. 已关闭；7. 已过期；8. 已作废
isShipped	Integer	是否发货：0. 未发货；1. 已发货
createStartTime	Date	创建开始时间，格式：`yyyy-MM-dd HH:mm:ss`
createEndTime	Date	创建结束时间，格式：`yyyy-MM-dd HH:mm:ss`

调用的特定输出参数

字段名	必填	类型	说明
status		Integer	贸易订单状态：0. 草稿；1. 待审核；2. 待补充；3. 收款中；4. 更新待审核；5. 驳回；6. 已关闭；7. 已过期；8. 已作废；
count		Long	订单数量

集成

贸易订单列表Total查询调用输入

{
    "searchValue": null,
    "buyerCountryList": [],
    "tradeOrderCurrencyList": [],
    "tradeOrderStatusList": [],
    "isShipped": 1,
    "createStartTime": "2024-05-03 14:22:00",
    "createEndTime": "2024-05-03 14:22:00"
}

贸易订单列表Total查询调用输出

{
  "code": "",
  "msg": "",
  "serverTime": 0,
  "data": [
    {
      "status": 0,
      "count": 0
    }
  ]
}

贸易订单详情查询

贸易订单详情查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/detail
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/detail

字段说明

调用的特定输入参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号

调用的特定输出参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
merchantId	Long	商户ID
tradeOrderType	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
businessId	Long	服务类型ID
foreignExchangeSettledFlag	Integer	是否需要结汇：0. 否；1. 是
tradeOrderName	String	订单名称
tradeOrderCode	String	订单编码
tradeOrderTotalAmount	BigDecimal	贸易订单总额
tradeOrderCurrency	String	贸易订单币种
tradeOrderDate	String	订单时间，格式：`yyyy-MM-dd`
fundNature	Integer	资金性质：0. 物流费用；1. 一般贸易-代采；2. 服务费用
buyerName	String	货物贸易：买家名称；服务贸易：合作方名称
buyerCountry	String	买家国家/地区
partnerType	String	合作方官网
storeUrl	String	店铺网址
isShipped	Integer	是否发货：0. 否；1. 是
remark	String	备注信息
autoPostFlag	Integer	是否自动入账：0. 否；1. 是
relateOrderCount	Integer	已关联订单数量
relateOrderAmount	BigDecimal	已关联订单累计金额
tradeOrderStatus	Integer	贸易订单状态：0. 草稿；1. 待审核；2. 待补充；3. 收款中；4. 更新待审核；5. 驳回；6. 已关闭；7. 已过期；8. 已作废
remitAccName	String	付款人名称
remitAccNo	String	付款人账号
deliveryEtaDate	String	预计发货时间，格式：`yyyy-MM-dd`
createPattern	Integer	创建方式：0. 智能识别；1. 手动填写；2. 智能识别-复制；3. 手动填写-复制
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
tradeOrderItemRepList	List<tradeOrderItemRepObject>	贸易订单商品信息列表
tradeOrderLogisticsRepList	List<tradeOrderLogisticsRepObject>	贸易订单物流信息列表
tradeOrderFileRepList	List<tradeOrderFileRepObject>	贸易订单附件信息列表

tradeOrderItemObject字段结构

字段名	类型	说明
itemName	String	商品名称
quantity	String	数量
unit	Integer	单位：0. 个；1. 件；2. 套；3. 台；4. 箱；5. 千克
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
tradeOrderItemReference	String	贸易订单商品请求流水号
tradeOrderReference	String	贸易订单请求流水号

tradeOrderLogisticsObject字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
tradeOrderLogisticsReference	String	贸易订单物流请求流水号
logisticsMethod	Integer	物流方式：0. 国际快递；1. 海运；2. 空运；3. 陆运；4. 铁路；5. 专线运输；6. 其他
logisticsNo	String	物流单号
logisticsCompany	String	物流公司或运输公司
consignedGoods	String	承运物品
receivingCountry	String	收货地
departureTime	String	起运时间，格式：`yyyy-MM-dd`
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
tradeOrderFileRepList	List<tradeOrderFileRepObject>	物流附件信息列表

tradeOrderFileObject字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
businessReference	String	业务请求流水号；物流附件关联物流请求流水号，订单附件时可能返回 `null`
tradeOrderFileReference	String	贸易订单附件请求流水号
fileType	Integer	文件类型：0. 发票附件；1. 物流单附件；3. 其他材料附件
fileName	String	文件名称
filePath	String	文件地址
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`

集成

贸易订单详情查询调用输出

{
  "code": "",
  "msg": "",
  "serverTime": null,
  "data": {
    "tradeOrderReference": "",
    "merchantId": null,
    "tradeOrderType": null,
    "businessId": null,
    "foreignExchangeSettledFlag": null,
    "tradeOrderName": "",
    "tradeOrderCode": "",
    "tradeOrderTotalAmount": null,
    "tradeOrderCurrency": "",
    "tradeOrderDate": "",
    "fundNature": null,
    "buyerName": "",
    "buyerCountry": "",
    "partnerType": null,
    "storeUrl": "",
    "isShipped": null,
    "remark": "",
    "autoPostFlag": null,
    "relateOrderCount": null,
    "relateOrderAmount": null,
    "tradeOrderStatus": null,
    "remitAccName": null,
    "remitAccNo": null,
    "deliveryEtaDate": null,
    "createPattern": null,
    "createTime": "",
    "updateTime": "",
    "tradeOrderItemRepList": [
      {
        "itemName": "",
        "quantity": "",
        "unit": null,
        "createTime": "",
        "updateTime": "",
        "tradeOrderItemReference": "",
        "tradeOrderReference": ""
      }
    ],
    "tradeOrderLogisticsRepList": [
      {
        "tradeOrderReference": "",
        "tradeOrderLogisticsReference": "",
        "logisticsMethod": null,
        "logisticsNo": "",
        "logisticsCompany": "",
        "consignedGoods": null,
        "receivingCountry": null,
        "departureTime": null,
        "createTime": "",
        "updateTime": "",
        "tradeOrderFileRepList": null
      }
    ],
    "tradeOrderFileRepList": [
      {
        "tradeOrderReference": "",
        "businessReference": null,
        "tradeOrderFileReference": "",
        "fileType": null,
        "fileName": "",
        "filePath": "",
        "createTime": "",
        "updateTime": ""
      }
    ]
  },
  "success": true
}

编辑贸易订单

编辑贸易订单

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/update
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/update

字段说明

调用的特定输入参数

字段名	必填	类型	说明
tradeOrderReference	M	String	贸易订单请求流水号(唯一)
merchantId	M	Long	商户ID
tradeOrderType	M	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
businessId	O	Long	服务类型ID(服务类型必填)
foreignExchangeSettledFlag	M	Integer	是否需要结汇：0. 否；1. 是
tradeOrderName	M	String	订单名称
tradeOrderCode	M	String	订单编码
tradeOrderTotalAmount	M	Number	贸易订单总额
tradeOrderCurrency	M	String	贸易订单币种
partnerType	O	String	合作方官网（服务贸易必填）
tradeOrderDate	O	String	订单时间（货物贸易必填）格式：`yyyy-MM-dd`
fundNature	O	Integer	资金性质（货物贸易必填）：0. 物流费用；1. 一般贸易-代采 2.服务费用
buyerName	M	String	货物贸易：买家名称；服务贸易：合作方名称
buyerCountry	O	String	买家国家/地区（货物贸易必填）
storeUrl	O	String	店铺网址（货物贸易必填）
tradeOrderItemList	O	List<tradeOrderItemObject>	贸易订单商品信息（货物贸易必填）
isShipped	M	Integer	是否发货：0. 否；1. 是货物贸易：是否发货；服务贸易：是否需要物流
tradeOrderLogisticsList	O	List<tradeOrderLogisticsObject>	物流信息；isShipped=是：必填
remark	O	String	备注信息
autoPostFlag	M	Integer	是否自动入账：0. 否；1. 是
tradeOrderFileList	M	List<tradeOrderFileObject>	附件信息
tradeOrderStatus	M	Integer	贸易订单状态：0. 保存草稿；1. 立即创建
remitAccName	O	String	付款人名称
remitAccNo	O	String	付款人账号
deliveryEtaDate	O	String	预计发货时间（货物贸易是否发货=否必填）格式：`yyyy-MM-dd`

tradeOrderItemObject字段结构

字段名	必填	类型	说明
tradeOrderItemReference	M	String	贸易订单商品请求流水号(唯一)
tradeOrderReference	M	String	贸易订单请求流水号(唯一)
itemName	M	String	商品名称
quantity	M	String	数量
unit	M	Integer	单位：0. 个；1. 件；2. 套；3. 台；4. 箱；5. 千克

tradeOrderLogisticsObject字段结构

字段名	必填	类型	说明
tradeOrderLogisticsReference	M	String	贸易订单物流请求流水号(唯一)
tradeOrderReference	M	String	贸易订单请求流水号(唯一)
logisticsMethod	M	Integer	物流方式：0. 国际快递；1. 海运；2. 空运；3. 陆运；4. 铁路；5. 专线运输；6. 其他；
logisticsNo	M	String	货物贸易：出境物流单号；服务贸易：运单号
logisticsCompany	M	String	货物贸易：物流公司；服务贸易：运输公司
consignedGoods	O	String	承运物品（服务贸易必填）
receivingCountry	O	String	收货地（服务贸易必填）
departureTime	O	Date	起运时间（服务贸易必填）格式：`yyyy-MM-dd`
tradeOrderFileList	O	List<tradeOrderFileObject>	物流附件信息(货物贸易必填)

tradeOrderFileObject字段结构

字段名	必填	类型	说明
tradeOrderFileReference	M	String	贸易订单附件请求流水号(唯一)
tradeOrderReference	M	String	贸易订单请求流水号(唯一)
businessReference	M	Long	业务请求流水号（根据文件类型存储对应的请求流水号）
fileType	M	Integer	文件类型：0. 发票附件（PO/CI/PO附件）；1. 物流单附件；3. 其他材料附件；
fileName	M	String	文件名称
filePath	M	String	文件地址

响应data参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
merchantId	Long	商户ID
tradeOrderType	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
businessId	Long	服务类型ID
foreignExchangeSettledFlag	Integer	是否需要结汇：0. 否；1. 是
tradeOrderName	String	订单名称
tradeOrderCode	String	订单编码
tradeOrderTotalAmount	Number	贸易订单总额
tradeOrderCurrency	String	贸易订单币种
tradeOrderDate	String	订单时间
fundNature	Integer	资金性质
buyerName	String	货物贸易：买家名称；服务贸易：合作方名称
buyerCountry	String	买家国家/地区
partnerType	String	合作方官网
storeUrl	String	店铺网址
isShipped	Integer	是否发货：0. 否；1. 是
remark	String	备注信息
autoPostFlag	Integer	是否自动入账：0. 否；1. 是
relateOrderCount	Integer	已关联订单数量
relateOrderAmount	Number	已关联订单累计金额
tradeOrderStatus	Integer	贸易订单状态
remitAccName	String	付款人名称
remitAccNo	String	付款人账号
deliveryEtaDate	String	预计发货时间
createPattern	Integer	创建方式：0. 智能识别；1. 手动填写；2. 智能识别-复制；3. 手动填写-复制
createTime	String	创建时间
updateTime	String	修改时间
tradeOrderItemRepList	List<tradeOrderItemRepObject>	贸易订单商品信息列表
tradeOrderLogisticsRepList	List<tradeOrderLogisticsRepObject>	贸易订单物流信息列表
tradeOrderFileRepList	List<tradeOrderFileRepObject>	贸易订单附件信息列表

tradeOrderItemRepObject 字段结构

字段名	类型	说明
itemName	String	商品名称
quantity	String	数量
unit	Integer	单位
createTime	String	创建时间
updateTime	String	修改时间
tradeOrderItemReference	String	贸易订单商品请求流水号
tradeOrderReference	String	贸易订单请求流水号

tradeOrderLogisticsRepObject 字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
tradeOrderLogisticsReference	String	贸易订单物流请求流水号
logisticsMethod	Integer	物流方式：0. 国际快递；1. 海运；2. 空运；3. 陆运；4. 铁路；5. 专线运输；6. 其他
logisticsNo	String	物流单号
logisticsCompany	String	物流公司或运输公司
consignedGoods	String	承运物品
receivingCountry	String	收货地
departureTime	String	起运时间
createTime	String	创建时间
updateTime	String	修改时间
tradeOrderFileRepList	List<tradeOrderFileRepObject>	物流附件信息列表

tradeOrderFileRepObject 字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
businessReference	String	业务请求流水号
tradeOrderFileReference	String	贸易订单附件请求流水号
fileType	Integer	文件类型：0. 发票附件；1. 物流单附件；3. 其他材料附件
fileName	String	文件名称
filePath	String	文件地址
createTime	String	创建时间
updateTime	String	修改时间

集成

编辑贸易订单调用输入

{
  "tradeOrderReference": "",
  "merchantId": 0,
  "tradeOrderType": 0,
  "businessId": null,
  "foreignExchangeSettledFlag": 0,
  "tradeOrderName": "",
  "tradeOrderCode": "",
  "tradeOrderTotalAmount": 0,
  "tradeOrderCurrency": "",
  "partnerType": null,
  "tradeOrderDate": null,
  "fundNature": null,
  "buyerName": "",
  "buyerCountry": null,
  "storeUrl": null,
  "tradeOrderItemList": [
    {
      "tradeOrderItemReference": "",
      "tradeOrderReference": "",
      "itemName": "",
      "quantity": "",
      "unit": 0
    }
  ],
  "isShipped": 0,
  "tradeOrderLogisticsList": [
    {
      "tradeOrderLogisticsReference": "",
      "tradeOrderReference": "",
      "logisticsMethod": 0,
      "logisticsNo": "",
      "logisticsCompany": "",
      "consignedGoods": null,
      "receivingCountry": null,
      "departureTime": null,
      "tradeOrderFileList": [
        {
          "tradeOrderFileReference": "",
          "tradeOrderReference": "",
          "businessReference":"" ,
          "fileType": 0,
          "fileName": "",
          "filePath": ""
        }
      ]
    }
  ],
  "remark": null,
  "autoPostFlag": 0,
  "tradeOrderFileList": [
    {
      "tradeOrderFileReference": "",
      "tradeOrderReference": "",
      "businessReference": 0,
      "fileType": 0,
      "fileName": "",
      "filePath": ""
    }
  ],
  "tradeOrderStatus": 0,
  "remitAccName": null,
  "remitAccNo": null,
  "deliveryEtaDate": null
}

编辑贸易订单调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": null,
    "data": {
        "tradeOrderReference": "",
        "merchantId": null,
        "tradeOrderType": null,
        "businessId": null,
        "foreignExchangeSettledFlag": null,
        "tradeOrderName": "",
        "tradeOrderCode": "",
        "tradeOrderTotalAmount": null,
        "tradeOrderCurrency": "",
        "tradeOrderDate": "",
        "fundNature": null,
        "buyerName": "",
        "buyerCountry": "",
        "partnerType": null,
        "storeUrl": "",
        "isShipped": null,
        "remark": "",
        "autoPostFlag": null,
        "relateOrderCount": null,
        "relateOrderAmount": null,
        "tradeOrderStatus": null,
        "remitAccName": null,
        "remitAccNo": null,
        "deliveryEtaDate": "",
        "createPattern": null,
        "createTime": "",
        "updateTime": "",
        "tradeOrderItemRepList": [
            {
                "itemName": "",
                "quantity": null,
                "unit": null,
                "createTime": "",
                "updateTime": "",
                "tradeOrderItemReference": "",
                "tradeOrderReference": ""
            }
        ],
        "tradeOrderLogisticsRepList": [
            {
                "tradeOrderReference": "",
                "tradeOrderLogisticsReference": "",
                "logisticsMethod": null,
                "logisticsNo": "",
                "logisticsCompany": "",
                "consignedGoods": null,
                "receivingCountry": "",
                "departureTime": "",
                "createTime": "",
                "updateTime": "",
                "tradeOrderFileRepList": [
                    {
                        "tradeOrderReference": "",
                        "businessReference": "",
                        "tradeOrderFileReference": "",
                        "fileType": null,
                        "fileName": "",
                        "filePath": "",
                        "createTime": "",
                        "updateTime": ""
                    }
                ]
            }
        ],
        "tradeOrderFileRepList": [
            {
                "tradeOrderReference": "",
                "businessReference": "",
                "tradeOrderFileReference": "",
                "fileType": null,
                "fileName": "",
                "filePath": "",
                "createTime": "",
                "updateTime": ""
            },
            {
                "tradeOrderReference": "",
                "businessReference": "",
                "tradeOrderFileReference": "",
                "fileType": null,
                "fileName": "",
                "filePath": "",
                "createTime": "",
                "updateTime": ""
            }
        ]
    },
    "success": true
}

作废贸易订单

作废贸易订单

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/canceled
生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/canceled

字段说明

调用的特定输入参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号

集成

作废调用输出

{
  "code": "",
  "msg": "",
  "serverTime": 0,
  "data": null
}

删除贸易订单

删除贸易订单

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order/delete

生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order/delete

字段说明

调用的特定输入参数

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号

集成

删除贸易订单调用输出

{
  "code": "",
  "msg": "",
  "serverTime": 0,
  "data": null
}

关联贸易订单信息查询

关联贸易订单信息查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/transaction/queryRelateTradeOrderDetail

生产环境请求地址：POST https://api.futurepay.global/api/v1/transaction/queryRelateTradeOrderDetail

字段说明

调用的特定输入参数

字段名	类型	说明
tradeNo	String	收款订单编号
searchValue	String	搜索值（支持贸易订单编号、订单名称、买家名称模糊查询）

调用的特定输出参数

字段名	类型	说明
remitAccName	String	付款人名称
remitAccNo	String	付款人账号
relateAmount	BigDecimal	本次最大可关联金额
tradeNo	String	收款交易编号
userReqNo	String	用户请求流水号
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
arrivalTime	String	到账时间
ccy	String	币种
relateTradeOrderDetailReps	List<relateTradeOrderDetailObject>	可关联贸易订单信息列表

relateTradeOrderDetailObject字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
remitAccName	String	付款人名称
remitAccNo	String	付款人账号
buyerName	String	买家名称或合作方名称
relateAmount	BigDecimal	可关联金额
relateOrderAmount	BigDecimal	已关联金额
approvedAmount	BigDecimal	订单金额
tradeOrderCurrency	String	贸易订单币种
relateOrderCount	Integer	已关联订单数
tradeOrderCode	String	贸易订单编号
consFlag	Integer	对比规则是否符合：0. 否；1. 是符合则无需提供材料可直接关联

集成

关联贸易订单信息查询调用输入

{
    "tradeNo": null,
    "searchValue": ""
}

关联贸易订单信息查询调用输出

{
  "code": "",
  "msg": "",
  "serverTime": null,
  "data": {
    "remitAccName": "",
    "remitAccNo": "",
    "relateAmount": null,
    "tradeNo": "",
    "userReqNo": "",
    "createTime": "",
    "arrivalTime": null,
    "ccy": "",
    "relateTradeOrderDetailReps": [
      {
        "tradeOrderReference": "",
        "remitAccName": null,
        "remitAccNo": null,
        "buyerName": "",
        "relateAmount": null,
        "relateOrderAmount": null,
        "approvedAmount": null,
        "tradeOrderCurrency": "",
        "relateOrderCount": null,
        "tradeOrderCode": "",
        "consFlag": null
      }
    ]
  },
  "success": true
}

关联贸易订单

关联贸易订单

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order-transaction-rel/associateTradeOrders

生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order-transaction-rel/associateTradeOrders

字段说明

调用的特定输入参数

字段名	类型	说明
associateTradeOrderReqs	List<associateTradeOrderReqObject>	关联贸易订单请求列表

associateTradeOrderReqObject 字段结构

字段名	类型	说明
tradeOrderReference	String	贸易订单请求流水号
relateAmount	BigDecimal	关联金额
tradeNo	String	收款交易编号
merchantId	Long	商户ID
remark	String	备注
fileStr	String	附件信息，JSON 字符串格式
consFlag	Integer	对比规则是否符合：0. 否
tradeOrderTransactionRelReference	String	贸易订单与收款交易关联请求流水号

集成

关联贸易订单调用输入

{
    "associateTradeOrderReqs": [
        {
            "tradeOrderReference": "TRADE_00aa3d0bd7f0445ba7ba4b20ee9938e2678",
            "relateAmount": "1000",
            "tradeNo": "RO884712857751650304",
            "merchantId": "2069620115141472256",
            "fileStr": "[{\"fileName\":\"3.png\",\"fileUrl\":\"business/acount/bcfce23f822a40d7a1077101a981392b.png\"}]",
            "consFlag": "0",
            "tradeOrderTransactionRelReference": "132132"
        }
    ]
}

关联贸易订单调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1787652654734,
    "success": true
}

贸易订单补充材料查询信息

贸易订单补充材料查询信息

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order-supplement/selectNewestVersion

生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order-supplement/selectNewestVersion

字段说明

调用的特定输入参数

字段名	类型	说明
businessReference	String	业务请求流水号（贸易订单请求号）
businessType	Integer	业务类型，固定传0

调用的特定输出参数

字段名	类型	说明
tradeOrderSupplementReference	String	贸易订单补充信息请求流水号
businessType	Integer	业务类型
merchantId	Long	商户ID
version	Integer	版本号
noticeMethod	String	通知方式
keepHistoricalFlag	Integer	是否保留历史问题：0. 是；1. 否
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
businessReference	String	业务请求流水号
tradeOrderSupplementMaterialList	List<tradeOrderSupplementMaterialObject>	补充材料问题列表

tradeOrderSupplementMaterialObject 字段结构

字段名	类型	说明
tradeOrderSupplementMaterialReference	String	贸易订单补充材料请求流水号
question	String	补充材料问题；值为包含多语言内容的 JSON 字符串
questionType	Integer	问题类型：0. 文本；1. 文件
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
tradeOrderSupplementReference	String	贸易订单补充信息请求流水号

集成

贸易订单补充材料查询信息调用输入

{
    "businessReference": "111",
    "businessType": 0
}

贸易订单补充材料查询信息调用输出

{
  "code": "",
  "msg": "",
  "serverTime": null,
  "data": {
    "tradeOrderSupplementReference": null,
    "businessType": null,
    "merchantId": null,
    "version": null,
    "noticeMethod": null,
    "keepHistoricalFlag": null,
    "createTime": "",
    "updateTime": "",
    "businessReference": "",
    "tradeOrderSupplementMaterialList": [
      {
        "tradeOrderSupplementMaterialReference": "",
        "question": "",
        "questionType": null,
        "createTime": "",
        "updateTime": "",
        "tradeOrderSupplementReference": ""
      }
    ]
  },
  "success": true
}

关联贸易订单补充材料查询信息

关联贸易订单补充材料查询信息

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order-supplement/selectBatchNewestVersion

生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order-supplement/selectBatchNewestVersion

字段说明

调用的特定输入参数

字段名	类型	说明
businessReferences	List	贸易订单请求号集合(用webhook中的tradeOrderTransactionRelReference)
businessType	Integer	业务类型，固定传1

调用的特定输出参数

字段名	类型	说明
tradeOrderSupplementReference	String	贸易订单补充信息请求流水号
businessType	Integer	业务类型
merchantId	Long	商户ID
version	Integer	版本号
noticeMethod	String	通知方式
keepHistoricalFlag	Integer	是否保留历史问题：0. 是；1. 否
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
businessReference	String	业务请求流水号
tradeOrderSupplementMaterialList	List<tradeOrderSupplementMaterialObject>	补充材料问题列表

tradeOrderSupplementMaterialObject 字段结构

字段名	类型	说明
tradeOrderSupplementMaterialReference	String	贸易订单补充材料请求流水号
question	String	补充材料问题；值为包含多语言内容的 JSON 字符串
questionType	Integer	问题类型：0. 文本；1. 文件
createTime	String	创建时间，格式：`yyyy-MM-dd HH:mm:ss`
updateTime	String	修改时间，格式：`yyyy-MM-dd HH:mm:ss`
tradeOrderSupplementReference	String	贸易订单补充信息请求流水号

集成

关联贸易订单补充材料查询信息调用输入

{
    "businessReferences": [],
    "businessType": 1
}

关联贸易订单补充材料查询信息调用输出

{
  "code": "",
  "msg": "",
  "serverTime": null,
  "data": {
    "tradeOrderSupplementReference": null,
    "businessType": null,
    "merchantId": null,
    "version": null,
    "noticeMethod": null,
    "keepHistoricalFlag": null,
    "createTime": "",
    "updateTime": "",
    "businessReference": "",
    "tradeOrderSupplementMaterialList": [
      {
        "tradeOrderSupplementMaterialReference": "",
        "question": "",
        "questionType": null,
        "createTime": "",
        "updateTime": "",
        "tradeOrderSupplementReference": ""
      }
    ]
  },
  "success": true
}

贸易订单补充材料回复

贸易订单补充材料回复

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order-supplement-detail/insert

生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order-supplement-detail/insert

字段说明

调用的特定输入参数

字段名	类型	说明
businessReference	String	业务请求号(贸易订单请求号)
businessType	Integer	业务类型,固定传0
supleMenterialDetailReqs	List<supleMenterialDetailObject>	补充材料集合

supleMenterialDetailObject字段结构

字段名	类型	说明
tradeOrderSupplementMaterialDetailReference	String	回复请求流水号
tradeOrderSupplementMaterialReference	String	补充材料请求流水号
questionReply	String	补充回复内容传参说明：文本格式：1111 文件格式："[{"fileName":"1.pdf","fileUrl":"xxxxxx.pdf"}]"

集成

贸易订单补充材料回复调用输入

{
  "businessReference":"TRADE_79a83d0bd7f0445ba7ba4b20ee9938e21" ,
  "businessType": 0,
  "supleMenterialDetailReqs": [
    {
      "tradeOrderSupplementMaterialDetailReference": "qqwer",
      "tradeOrderSupplementMaterialReference": "TSUM_fa4eba4600504429b92cab1f93d63045",
      "questionReply": "文本问题回复"
    },
    {
      "tradeOrderSupplementMaterialDetailReference": "uoiuo",
      "tradeOrderSupplementMaterialReference": "TSUM_8c97e0e1f70a46ed8a3c4e4bdb1d8fe5",
      "questionReply": "[{\"fileName\":\"3.png\",\"fileUrl\":\"business/acount/bcfce23f822a40d7a1077101a981392b.png\"}]"
    }
  ]
}

贸易订单补充材料回复调用输出

{
  "code": "",
  "msg": "",
  "serverTime": 0,
  "data": null
}

关联贸易订单补充材料回复

关联贸易订单补充材料回复

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/trade-order-supplement-detail/batchInsert

生产环境请求地址：POST https://api.futurepay.global/api/v1/trade-order-supplement-detail/batchInsert

字段说明

调用的特定输入参数

tradeOrderSupplementMaterialDetailObject 字段结构

字段名	类型	说明
businessReference	String	业务请求号（用webhook中的tradeOrderTransactionRelReference）
businessType	Integer	业务类型，固定传 `1`
supleMenterialDetailReqs	List<supleMenterialDetailObject>	补充材料集合

supleMenterialDetailObject 字段结构

字段名	类型	说明
tradeOrderSupplementMaterialDetailReference	String	回复请求流水号
tradeOrderSupplementMaterialReference	Long	补充材料请求流水号
questionReply	String	补充回复内容传参说明：文本格式：1111 文件格式："[`{"fileName":"1.pdf","fileUrl":"xxxxxx.pdf"}`]"

集成

关联贸易订单补充材料回复调用输入

{
    "tradeOrderSupplementMaterialDetails": [
        {
            "businessReference": "TRADE_REL_951aad039ad34430b7b37e3cfc828f70",
            "businessType": 1,
            "supleMenterialDetailReqs": [
                {
                    "tradeOrderSupplementMaterialDetailReference": "qoe12312utoiuo",
                    "tradeOrderSupplementMaterialReference": "TSUM_06bed454fff24f5aa4b7ebd689e10744",
                    "questionReply": "文本问题回答"
                },
                {
                    "tradeOrderSupplementMaterialDetailReference": "123411afsadf2341",
                    "tradeOrderSupplementMaterialReference": "TSUM_5a4b48b45d1b4ffc8cb0707584e3b8d5",
                    "questionReply": "[{\"fileName\":\"3.png\",\"fileUrl\":\"business/acount/bcfce23f822a40d7a1077101a981392b.png\"}]"
                }
            ]
        }
    ]
}

关联贸易订单补充材料回复调用输出

{
  "tradeOrderSupplementMaterialDetails": [
    {
      "businessReference": null,
      "businessType": null,
      "supleMenterialDetailReqs": [
        {
          "tradeOrderSupplementMaterialDetailReference": "",
          "tradeOrderSupplementMaterialReference": null,
          "questionReply": ""
        }
      ]
    }
  ]
}

Webhook

贸易订单

说明：在贸易订单发生变化时进行推送

字段名	类型	说明
autoPostFlag	Integer	是否自动入账：0. 否；1. 是
tradeOrderItemRepList	List<tradeOrderItemRepObject>	贸易订单商品信息列表
tradeOrderTotalAmount	Number	贸易订单总额
relateOrderCount	Integer	已关联订单数量
remark	String	备注信息
tradeOrderFileRepList	List<tradeOrderFileRepObject>	贸易订单附件信息列表
tradeOrderLogisticsRepList	List<tradeOrderLogisticsRepObject>	贸易订单物流信息列表
tradeOrderCurrency	String	贸易订单币种
tradeOrderDate	String	订单时间，格式：`yyyy-MM-dd`
merchantId	Long	商户ID
storeUrl	String	店铺网址
isShipped	Integer	是否发货：0. 否；1. 是
tradeOrderCode	String	订单编码
tradeOrderReference	String	贸易订单请求流水号
updateTime	Long	修改时间
buyerName	String	货物贸易：买家名称；服务贸易：合作方名称
relateOrderAmount	Number	已关联订单累计金额
foreignExchangeSettledFlag	Integer	是否需要结汇：0. 否；1. 是
buyerCountry	String	买家国家/地区
eventCode	String	事件编码，固定值：`TRADE_ORDER_NOTIFY`
tradeOrderStatus	Integer	贸易订单状态：0. 草稿；1. 待审核；2. 待补充；3. 收款中；4. 更新待审核；5. 驳回；6. 已关闭；7. 已过期；8. 已作废
createPattern	Integer	创建方式：0. 智能识别；1. 手动填写；2. 智能识别-复制；3. 手动填写-复制
createTime	Long	创建时间
tradeOrderType	Integer	贸易订单类型：0. 货物贸易；1. 服务贸易
tradeOrderName	String	订单名称
eventDate	Long	事件发生时间

tradeOrderItemRepObject 字段结构

字段名	类型	说明
itemName	String	商品名称
unit	Integer	单位：0. 个；1. 件；2. 套；3. 台；4. 箱；5. 千克
quantity	String	数量
tradeOrderItemReference	String	贸易订单商品请求流水号
createTime	Long	创建时间
updateTime	Long	修改时间
tradeOrderReference	String	贸易订单请求流水号

tradeOrderLogisticsRepObject 字段结构

字段名	类型	说明
logisticsMethod	Integer	物流方式：0. 国际快递；1. 海运；2. 空运；3. 陆运；4. 铁路；5. 专线运输；6. 其他
createTime	Long	创建时间
logisticsCompany	String	物流公司或运输公司
logisticsNo	String	物流单号
tradeOrderLogisticsReference	String	贸易订单物流请求流水号
updateTime	Long	修改时间
tradeOrderFileRepList	List<tradeOrderFileRepObject>	物流附件信息列表
tradeOrderReference	String	贸易订单请求流水号

tradeOrderFileRepObject 字段结构

字段名	类型	说明
fileName	String	文件名称
tradeOrderFileReference	String	贸易订单附件请求流水号
createTime	Long	创建时间
filePath	String	文件地址
updateTime	Long	修改时间
fileType	Integer	文件类型：0. 发票附件；1. 物流单附件；3. 其他材料附件
businessReference	String	业务请求流水号；物流附件关联物流请求流水号
tradeOrderReference	String	贸易订单请求流水号

输出

{
  "appId": "",
  "merchantId": "",
  "notificationItems": [
    {
      "autoPostFlag": null,
      "tradeOrderItemRepList": [
        {
          "itemName": "",
          "unit": null,
          "quantity": "",
          "tradeOrderItemReference": "",
          "createTime": null,
          "updateTime": null,
          "tradeOrderReference": ""
        }
      ],
      "tradeOrderTotalAmount": null,
      "relateOrderCount": null,
      "remark": "",
      "tradeOrderFileRepList": [
        {
          "fileName": "",
          "tradeOrderFileReference": "",
          "createTime": null,
          "filePath": "",
          "updateTime": null,
          "fileType": null,
          "businessReference": null,
          "tradeOrderReference": ""
        }
      ],
      "tradeOrderLogisticsRepList": [
        {
          "logisticsMethod": null,
          "createTime": null,
          "logisticsCompany": "",
          "logisticsNo": "",
          "tradeOrderLogisticsReference": "",
          "updateTime": null,
          "tradeOrderFileRepList": [
            {
              "fileName": "",
              "tradeOrderFileReference": "",
              "createTime": null,
              "filePath": "",
              "updateTime": null,
              "fileType": null,
              "businessReference": "",
              "tradeOrderReference": ""
            }
          ],
          "tradeOrderReference": ""
        }
      ],
      "tradeOrderCurrency": "",
      "tradeOrderDate": "",
      "merchantId": null,
      "storeUrl": "",
      "isShipped": null,
      "tradeOrderCode": "",
      "tradeOrderReference": "",
      "updateTime": null,
      "buyerName": "",
      "relateOrderAmount": null,
      "foreignExchangeSettledFlag": null,
      "buyerCountry": "",
      "eventCode": "TRADE_ORDER_NOTIFY",
      "tradeOrderStatus": null,
      "createPattern": null,
      "createTime": null,
      "tradeOrderType": null,
      "tradeOrderName": "",
      "eventDate": null
    }
  ]
}

关联订单

说明：在关联订单发生变化时进行推送

字段名	类型	说明
eventCode	String	事件编码，固定值：`TRADE_ORDER_ASSOCIATE_NOTIFY`
tradeNo	String	收款交易编号
merchantId	Long	商户ID
relateStatus	Integer	关联状态(0:自动关联；1:手动关联； 5: 补充待审核)
relateAmount	BigDecimal	关联金额
relateTime	Long	关联时间
tradeOrderCurrency	String	贸易订单币种
tradeOrderReference	String	贸易订单请求流水号
eventDate	Long	事件发生时间

输出

{
    "appId": "2069620115158228992",
    "merchantId": "2069620115141472256",
    "notificationItems": [
        {
            "eventCode": "TRADE_ORDER_ASSOCIATE_NOTIFY",
            "tradeOrderTransactionRelReference": "TRADE_REL_0d61a3431a5246f29888777d99deb086",
            "tradeNo": "RO884712857751650304",
            "merchantId": 2069620115141472256,
            "relateStatus": 2,
            "relateAmount": 1000,
            "relateTime": 1788768876626,
            "tradeOrderCurrency": "NGN",
            "tradeOrderReference": "TRADE_00aa3d0bd7f0445ba7ba4b20ee9938e2678",
            "eventDate": 1788768876629
        }
    ]
}