Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: 从版本29恢复

...

...

...

接口说明:

urlhttp://test.birdsystem.com/client/Agent-Direct-Consignment-Product/
接口功能添加产品
支持格式JSON开发人员
请求方式POST发布日期

参数说明:

参数

必选

类型

说明

consignment_idYBINGINT(16)订单ID
product_nameYVARCHAR(50)产品英文名
product_name_cnYVARCHAR(50)产品中文名
client_refYVARCHAR(255)客户sku
brandNVARCHAR(50)品牌
price_customs_exportYVARCHAR(100)产品报关价(单位为美元)
weightquantity
sales_price
YINT(4)产品重量(目前系统以g为单位)
Nfloat(‘%.2f’)销售价格(单位为美元)
weightY
INT(4)产品数量
float(‘%.2f’)产品重量(目前系统以g为单位,保留两位小数四舍五入)
product_customs_property[]YINT(4)产品属性(可传多个属性)获取产品属性
quantityYINT(4)产品数量
attachment-url-VARCHAR(100)

图片URL

新产品图片URL为必填,已存在的产品不用传图片URL(只能传网上的图片,不能传本地的)

country_of_origin

NCHAR(2)国家二字码,如 CN, GB

hs_code

NVARCHAR(50)海关编码

ebay_transaction_id

NVARCHAR(50)

eBay订单交易号

ebay_item_no

NVARCHAR(50)

eBay产品ID

请求示例:

...

接口请求示例:

Code Block
title添加产品请求示例
collapsetrue
http://test.birdsystem.com/client/Agent-Direct-Consignment-Product/
 
api_key=a0366845436b4775e6c5caef5ebc0d0d&company_id=36
 
consignment_id

...

=2011250360000309

...

&product_name

...

=cola

...

&product_name_cn

...

=可乐

...

&client_ref

...

=47-1

...

&price_customs_export

...

=14

...

&weight

...

=10

...

&quantity

...

=1

...

&product_customs_property[]

...

=9

...

&product_customs_property[]

...

=7&sales_price=5.5&country_of_origin=CN&hs_code=12345

请求返回示例:

Code Block
collapsetrue
{
    "data": {
        "id": 7667871,
        "consignment_id": 2011250360000309,
        "product_name": "cola",
        "product_name_cn": "可乐",
        "client_ref": "47-1",
        "brand": null,
		"country_of_origin": "CN",
		"hs_code": "12345",
        "quantity": "1",
        "weight": "10.00",
        "price_customs_export": "14.000",
        "price_customs_export_internal": "14.000",
        "price_customs_export_origin": "0.000",
        "price_customs_export_internal_origin": "0.000",
		"sales_price": "5.5",
		"ebay_transaction_id":"ID",
		"ebay_item_no":"PRODUCT_ID"
        "primary_keys": [
            "id"
        ]
    },
    "success": true,
    "moduleName": "client"
}

获取预置信息

往代理专线订单添加产品的时候, 需要产品海关属性, 可以预存到你们系统里, 不经常改变, 不需要每次都请求.

获取可用的海关属性

...

返回字段:

字段名说明
id
consignment_id订单ID
product_name产品英文名
product_name_cn产品中文名
client_ref客户sku
quantity数量
weight重量
price_customs_export产品出口报关价(单位为美元)
price_customs_export_internal产品内部出口报关价