京东大客户开发平台 VOP 对接
作者：xiaoyukarl 来源：https://learnku.com/articles/39729
京东 VOP 文档链接 https://vop.jd.com/doc/api
使用方法
github github.com/xiaoyukarl/jd_biz
下载 composer 包
composer require xiaoyukarl/jd_biz
修改配置文件 config.php
调用接口方法
//使用地址接口$address = new \jd\biz\request\AddressRequest();//获取省份列表var_dump($address->getProvinces());exit;
config.php 配置文件说明
return ['client_id' => '', //对接client_id'client_secret' => '',//对接账号密码'username' => '',//京东用户名,可能是中文'password' => '',//京东的密码'jdBaseUrl' => 'https://bizapi.jd.com/',
];
说明
接口返回数据格式
['code' => 0, //当code等于0时,代表接口请求成功'message' => 'success', //当接口请求发生错误时, 显示错误信息'data' => [],//具体返回参数,
]
接口提供方法
AddressRequest.php 地址API包含方法
[查询一级地址 getProvinces()查询二级地址 getCity($provinceId)查询三级地址 getCounty($cityId)查询四级地址 getTown($countyId)验证地址有效性 checkArea($address)地址详情转换京东地址编码 getJDAddressFromAddress($address)
]
ProductRequest.php 商品API包含方法
[查询所有商品池编号，商品池编号将用于获取池内商品编号 getProductPool()查询单个商品池下的商品列表 getSkuByPage($pageNum, $pageNo)查询单个商品的详细信息 getDetail($sku, $queryExts)查询单个商品的主图、轮播图 getImage($skuIds)查询商品的上下架状态 saleStatus($skuIds)查询商品可售性、是否支持专票等影响销售的重要属性 checkProduct($skuIds)查询商品在特定区域是否可售 checkProductAreaLimit($skuIds, $province, $city, $county, $town)根据此接口查询主商品附带的赠品 getSkuGift($skuId, $province, $city, $county, $town)根据此接口查询可随主商品一并购买的延保等服务商品 getYanbaoSku($skuIds, $province, $city, $county, $town)验证商品在指定区域是否可使用货到付款 checkCashOnDelivery($skuIds, $province, $city, $county, $town)批量验证商品在指定区域是否可使用货到付款 atchCheckCashOnDelivery($skuIds, $province, $city, $county, $town)根据搜索条件查询符合要求的商品列表 searchProduct($params)查询被指定为同一类的商品 getSimilarProduct($skuId)根据分类id查询对应分类信息 getProductCategory($categoryId)
]StockRequest.php 库存API包含方法
[批量获取库存接口 getNewStockById($skuNums, $area)
]PriceRequest.php 商品价格API包含方法
[批量查询商品售卖价 getSellPrice($skuIds, $queryExts)
]BalanceRequest.php 余额支付API包含方法
[查询金采和预存款余额的余额 getUnionBalance($pin, $type)仅支持预存款余额明细查询，不支持金采余额明细查询 getBalanceDetail($pageNum = 1, $pageSize = 20, $orderNum = '', $startDate = '', $endDate = '')下单成功支付失败的情况，可以调用此接口重新支付 payOrder($jdOrderNum)
]OrderRequest.php 订单API包含方法
[查询准备提交的订单的运费 getOrderFreight($skuNums, $paymentType, $province, $city, $county, $town)获取京东预约日历 promiseCalendarNew($skuNums, $paymentType, $province, $city, $county, $town)提交订单信息，生成京东订单 submitOrder(array $order)订单反查接口，根据第三方订单号反查京东的订单号 getJDOrder($orderNum)确认预占库存订单接口 confirmOrder($jdOrderNum)取消未确认订单接口 cancelOrder($jdOrderNum)查询京东订单信息接口 orderDetail($jdOrderNum, $queryExts = [])查询配送信息 orderTrack($jdOrderNum, $waybillCode = 1)确认收货 confirmReceivedOrder($jdOrderNum)更新采购单号 saveOrUpdatePoNo($jdOrderNum, $poNo)查询所有新建的订单列表。可用于核对订单 orderList($startDate, $pageNo = 1, $pageSize = 20, $endDate = '', $jdOrderIdIndex = '')查询所有妥投的订单列表。可用于核对订单 checkDeliveredOrder($startDate, $pageNo = 1, $pageSize = 20, $endDate = '', $jdOrderIdIndex = '')查询所有拒收的订单列表。可用于核对订单 checkRefuseOrder($startDate, $pageNo = 1, $pageSize = 20, $endDate = '', $jdOrderIdIndex = '')查询所有完成的订单列表。可用于核对订单 checkCompleteOrder($startDate, $pageNo = 1, $pageSize = 20, $endDate = '', $jdOrderIdIndex = '')查询配送预计送达时间 getPromiseTips($skuId, $num, $province, $city, $county, $town = 0)
]AfterSaleRequest.php 售后服务API
[校验某订单中某商品是否可以提交售后服务 getAvailableNumberComp($jdOrderNum, $skuId)根据订单号、商品编号查询支持的服务类型 getCustomerExpectComp($jdOrderNum, $skuId)根据订单号、商品编号查询支持的商品返回京东方式 getWareReturnJdComp($jdOrderNum, $skuId)发起售后申请 createAfsApply($params)填写发运信息 updateSendSku($afsServiceId, $expressCompany, $deliverDate, $expressCode, $freightMoney = 0.0)查询订单下服务单汇总信息 getServiceListPage($jdOrderNum, $pageIndex = 1, $pageSize = 20)查询服务单明细信息。 getServiceDetailInfo($afsServiceId, $appendInfoSteps = [1,2,3,4,5])取消已经生成的服务单 auditCancel(array $serviceIdList, $approveNotes)确认服务单 confirmAfsOrder($customerName, $username, $afsServiceId)查询订单下服务单汇总列表信息。 getAfsServiceListPage(array $query = ['pageIndex' => 1, 'pageSize' => 20])
]InvoiceRequest.php 发票API
[申请开票 createInvoice(array $invoice)通过的订单号查询对应的第三方申请单号 queryThrApplyNo($jdOrderNum)查询第三方申请单号下的发票概要信息 queryInvoiceDesc($markId)查询发票明细信息。目前只支持纸质发票 queryInvoiceItem($invoiceId, $invoiceCode)查询电子发票明细信息 getInvoiceList($jdOrderNum, $invoiceType, $queryExts = ['prefixZero', 'electronicVAT'])纸质发票如果需要邮寄，使用此接口查询配送单号 getInvoiceWaybill($markId)查询发票物流消息信息 queryDeliveryNo($jdOrderNum)取消已经提交的开票申请 cancelInvoice($markId)
]MessageRequest.php 消息服务API
[获取推送信息接口 getMessage($type)根据推送id，删除推送信息接口 delMessage( array $ids)
]
目录结构
jd_biz
├─ README.md
├─ composer.json
├─ composer.lock
├─ src
│ ├─ configs
│ │ └─ config.php 配置文件
│ ├─ lib
│ │ ├─ ConfigLib.php 获取配置文件
│ │ ├─ CurlLib.php curl
│ │ ├─ HelperLib.php 帮助类
│ │ ├─ QueryTools.php curl工具类
│ │ └─ TokenLib.php 获取token工具类
│ ├─ request
│ │ ├─ AddressRequest.php 地址接口请求
│ │ ├─ AfterSaleRequest.php 售后接口请求
│ │ ├─ BalanceRequest.php 余额和支付接口请求
│ │ ├─ InvoiceRequest.php 发票接口请求
│ │ ├─ MessageRequest.php 信息接口请求
│ │ ├─ OrderRequest.php 订单接口请求
│ │ ├─ PriceRequest.php 商品价格接口请求
│ │ ├─ ProductRequest.php 产品接口请求
│ │ ├─ StockRequest.php 库存接口请求
│ │ └─ Request.php 接口请求父类
│ └─ storage token缓存目录
├─ test
│ └─ test.php 测试文件
└─ vendor 自动加载目录