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_nameY
INT
VARCHAR(
4
50)产品英文名
product_name_cnYVARCHAR(
100
50)产品中文名
client_refYVARCHAR(255)客户sku
brandNVARCHAR(50)品牌
price_customs_exportYVARCHAR(100)
地址行1
产品报关价(单位为美元)
sales_priceNfloat(‘%.2f’)销售价格(单位为美元)
weightYfloat(‘%.2f’)产品重量(目前系统以g为单位,保留两位小数四舍五入)
product_customs_property[]YINT(4)产品属性(可传多个属性)获取产品属性
quantityY
VARCHAR(100)地址行2
INT(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//订单id
consignmentAgent-Direct-Consignment-Product/
 
api_key=a0366845436b4775e6c5caef5ebc0d0d&company_id=190929002000000336
 //产品英文名称

consignment_id=2011250360000309&product_name=1apple29
//产品中文名称
cola&product_name_cn=1苹果29
//客户sku
可乐&client_ref=1apple29
//品牌(非必填)
brand=ASC
//报关价 美元
47-1&price_customs_export=3
//重量 g(随系统设置)
weight=100
//数量
quantity=1
//海关属性ID, 可以有多个属性
14&weight=10&quantity=1&product_customs_property[]=17
9&product_customs_property[]=9
//图片URL(不能传本地的图片,只能传存在网上的)
attachment-url=http://www.qqma.com/imgpic2/cpimagenew/2018/4/5/6e1de60ce43d4bf4b9671d7661024e7a.jpg

...

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

请求返回示例:

Code Block
collapsetrue
{
    "data": {
        "id": 30776847667871,
        "consignment_id": 19092900200000032011250360000309,
        "product_name": "1apple29cola",
        "product_name_cn": "1苹果29可乐",
        "client_ref": "1apple2947-1",
        "brand": null,
		"country_of_origin": "CN",
		"hs_code": "12345",
        "quantity": "1",
        "weight": "10010.00",
        "price_customs_export": "14.000",
        "price_customs_export_internal": "3 "14.000",
        "price_customs_export_origin": "0.000",
        "price_customs_export_internal_origin": "3.000",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产品内部出口报关价