发货单创建接口
简要描述
请求URL
  • https://ctctest.yanzhiwu.com/api/ERP/InvoiceCreationinterface
请求方式
  • Post
调用方向
  • 第三方发起
Header
header 必填 类型 说明
Authorization 是 varchar 授权accessToken，由Token接口返回
Sign 是 varchar 参数签名
Timespan 是 varchar 时间戳
请求参数
参数名 必填 类型 说明
↳ sourcePlatformName 否 varchar 订单来源平台名称
↳ zipCode 否 varchar 邮编
↳ insurance 否 array 保险信息
↳ mobile 是 varchar 移动电话
↳ retailPrice 否 varchar 零售价,零售价=实际成交价+单件商品折扣金额
↳ header 否 varchar 发票抬头(填写的条件是：invoiceFlag为Y)
↳ buyerMessage 否 varchar 买家留言
↳ amount 否 varchar 发票总金额,,发票抬头(填写的条件是：invoiceFlag为Y)
↳ city 是 varchar 城市
↳ inventoryType 否 varchar 库存类型,ZP=正品，CC=残次,JS=机损，XS=?箱损，ZT=在途库存，DJ=冻结，默认为ZP?font?color=red>注：暂不支持DJ
↳ invoices 否 array 发票信息
↳ planQty 是 number 应发商品数量
↳ warehouseCode 是 varchar 仓库编码
↳ heduleType 否 number 1=工作日,2=节假日,101=当日达,102=次晨达,103=次日达，104=预约达
↳ deliveryType 否 varchar 发货服务类型，PTPS(普通配送)，LLPS(冷链配送)，HBP(环保配)
↳ receiverInfo 是 array 收货人信息
↳ price 否 varchar 商品单价
↳ itemAmount 否 varchar 商品总金额(元)
↳ operateTime 是 varchar 操作(审核)时间?YYYY-MM-DD?HH：MM：SS
↳ deliveryRequirements 否 array 发货要求列表
↳ area 否 varchar 区域
↳ sourceOrderCode 否 varchar 交易平台订单。注：需要加解密的订单，sourceOrderCode和oaidOrderSourceCode必须二选一有值，否则会解密失败导致无法发货。
↳ placeOrderTime 是 varchar 前台订单(店铺订单)创建时间(下单时间)YYYY-MM-DD?HH：MM：SS
↳ senderinfo 否 array 发货人信息
↳ operatorName 否 varchar 操作员(审核员)名称
↳ payNo 否 varchar 支付平台交易号,淘系订单传支付宝交易号
↳ discountAmount 否 varchar 订单折扣金额(元)
↳ idType 否 varchar 收件人证件类型(1-身份证、2-军官证、3-护照、4-其他)
↳ operatorCode 否 varchar 操作员(审核员)编码
↳ insuranceFlag 否 varchar 是否需要保险，Y/N，默认为N
↳ itemCode 是 varchar 商品编码
↳ amount 否 varchar 金额
↳ email 否 varchar 电子邮箱
↳ mobile 是 varchar 移动电话
↳ detail 否 array 发票信息
↳ quantity 否 number 数量
↳ name 是 varchar 姓名
↳ logisticsName 否 varchar 物流公司名称
deliveryOrder 是 array 出库单信息
↳ orderLineNo 否 varchar 单据行号
↳ countryCode 否 varchar 国家二字码
↳ province 是 varchar 省份
↳ oaid 否 varchar 收件人地址ID/解密id需要加解密的订单必填。
↳ zipCode 否 varchar 邮编
↳ freight 否 varchar 快递费用(元)
↳ invoiceFlag 否 varchar 是否需要发票，Y/N，默认为N
↳ sourcePlatformCode 是 varchar 订单来源平台编码,TB=?淘宝?、TM=天猫?、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、DY/DYXD=抖音、KS=快手、YZ=有赞、OTHERS=其他
↳ expireDate 否 varchar 过期日期?YYYY-MM-DD
↳ province 是 varchar 省份
↳ company 否 varchar 公司名称
↳ scheduleStartTime 否 varchar 投递时间范围要求(开始时间);HH：MM：SS
↳ extCode 否 varchar 交易平台商品编码,
↳ oaidOrderSourceCode 否 varchar 交易平台订单注：需要加解密的订单，sourceOrderCode和oaidOrderSourceCode必须二选一有值，否则会加解密失败导致无法发货。
↳ itemId 否 varchar 仓储系统商品编码,条件必填
↳ detailAddress 是 varchar 详细地址
↳ type 否 varchar 保险类型
↳ payNo 否 varchar 支付平台交易号,淘系订单传支付宝交易号
↳ buyerNick 否 varchar 买家昵称
↳ sellerNick 否 varchar 卖家名称
↳ sellerMessage 否 varchar 卖家留言
↳ preDeliveryOrderCode 否 varchar 原出库单号(ERP分配),条件必填,条件为换货出库
↳ idType 否 varchar 收件人证件类型(1-身份证、2-军官证、3-护照、4-其他)
↳ oaid 否 varchar 收件人地址ID/解密id。 淘系订单： 如果密文下发，oaid必选。 如果ERP自己解密，那么oaid不需要下发，否则会导致erp改过地址，但是菜鸟还是使用oaid取号使用淘天地址。
↳ area 否 varchar 区域
↳ tel 否 varchar 固定电话
↳ scheduleDay 否 varchar >要求送达日期?YYYY-MM-DD
↳ type 否 varchar 发票类型(INVOICE=普通发票;VINVOICE=增值税普通发票;EVINVOICE=电子增票);?条件必填(条件为invoiceFlag为Y)
↳ logisticsAreaCode 否 varchar 快递区域编码，大头笔信息
↳ town 否 varchar 村镇
↳ temName 否 varchar 商品名称
↳ expressCode 否 varchar 运单号
↳ payTime 否 varchar 订单支付时间，YYYY-MM-DD?HH：MM：SS
↳ taxNumber 否 varchar 税号
↳ town 否 varchar 村镇。对于淘宝/天猫//抖音等加密的订单，必填。
↳ orderFlag 否 varchar 订单标记?，用字符串格式来表示订单标记列表：?比如COD，中间用“^”来隔开，COD?=货到付款?，LIMIT=限时配送?，PRESELL=预售?，COMPLAIN=已投诉?，SPLIT=拆单，EXCHANGE=换货，VISIT=上门?，MODIFYTRANSPORT=是否可改配送方式，默认可更改，CONSIGN?=物流宝代理发货，自动更改发货状态?SELLER_AFFORD?=是否卖家承担运费，默认是，即没?，FENXIAO=分销订单
↳ actualPrice 是 varchar 实际成交价
↳ extendProps 否 number 明细扩展属性,K/V形式
↳ serviceFee 否 varchar COD服务费
↳ content 否 varchar 发票内容,不推荐使用
↳ tel 否 varchar 固定电话
↳ ownerCode 是 varchar 货主编码
↳ itemName 否 varchar 商品名称
↳ preDeliveryOrderId 否 varchar 原出库单号(WMS分配)，条件必填,条件为换货出库
↳ discountAmount 否 varchar 单件商品折扣金额
↳ email 否 varchar 电子邮箱
↳ idNumber 否 varchar 收件人证件号码
↳ company 否 varchar 公司名称
↳ shopNick 是 varchar 店铺名称
↳ subSourceOrderCode 否 varchar 交易平台子订单编码
↳ city 是 varchar 城市
↳ produceCode 否 varchar 生产批号
↳ scheduleEndTime 否 varchar 投递时间范围要求(结束时间);HH：MM：SS
↳ isUrgency 否 varchar 是否紧急，Y/N，默认为N
↳ latestCollectionTime 否 varchar 最晚揽收时间，string(19)?，YYYY-MM-DD?HH：MM：SS
↳ items 否 array 发票信息
↳ gotAmount 否 varchar 已收金额(元)，消费者已经支付多少
↳ detailAddress 是 varchar 详细地址
↳ productDate 否 varchar 生产日期?YYYY-MM-DD
↳ createTime 是 varchar 发货单创建时间?YYYY-MM-DD?HH：MM：SS
orderLines 是 array 单据信息
↳ name 是 varchar 姓名
↳ countryCode 否 varchar 国家二字码
↳ idNumber 否 varchar 收件人证件号码
↳ amount 否 varchar 保险金额
↳ totalAmount 否 varchar 订单总金额(元),订单总金额=应收金额+已收金额=商品总金额-订单折扣金额+快递费用
↳ erCode 是 varchar 出库单号
↳ arAmount 否 varchar 应收金额(元)，消费者还需要支付多少(货到付款时消费者还需要支付多少约定使用这个字段),
↳ latestDeliveryTime 否 varchar 最晚发货时间，string(19)?，YYYY-MM-DD?HH：MM：SS
↳ extendProps 否 number 扩展属性,K/V形式
↳ orderType 是 varchar 出库单类型=JYCK
↳ remark 否 varchar 备注
↳ logisticsCode 是 varchar 物流公司编码,SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通?、ZTO=中通(ZTO)?、HTKY=百世汇通、BSKY=百世快运、BSKY=百世快运、UC=优速、STO=申通、TTKDEX=天天快递?、QFKD=全峰、FAST=快捷、POSTB=邮政小包?、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、DBWL=德邦物流、DBKD=德邦快递、DBKY=德邦快运、RRS=日日顺、OTHER=其他，(只传英文编码)
↳ batchCode 否 varchar 批次编码
↳ unit 否 varchar 商品单位
响应参数
参数名 必填 类型 说明
↳ itemCode 否 varchar ERP商品编码
↳ createTime 否 varchar 订单创建时间?YYYY-MM-DD?HH：MM：SS
deliveryOrderId 否 varchar 出库单仓储系统编码
logisticsCode 否 varchar 物流公司编码
↳ orderLines 否 array 货品明细
↳ deliveryOrderId 否 varchar 出库单仓储系统编码
message 否 varchar 错误描述
↳ warehouseCode 否 varchar 仓库编码
deliveryOrders 否 array
↳ extendProps 否 number 扩展属性,K/V形式
↳ orderLineNo 否 varchar 行号
↳ logisticsCode 否 varchar 物流公司编码
code 否 varchar 错误码
warehouseCode 否 varchar 仓库编码
createTime 否 varchar 订单创建时间?YYYY-MM-DD?HH：MM：SS
↳ itemId 否 varchar 菜鸟商品Id
flag 是 varchar 状态码(success|failure)
↳ quantity 否 varchar 数量