open-api
首页
open-api
  • 快速开始
  • 授权登录
  • 客户
  • 销售订单
  • 采购订单
  • 产品
  • 回款登记
  • 回款单
  • 付款单
  • 费用单
  • 报价单
  • 供应商
  • 商机
  • 用户
  • 销售出库单
    • 销售出库单
    • 销售出库单列表GET
    • 销售出库单详情GET
    • 销售出库单字段GET
    • 销售出库单删除POST
    • 新增/编辑销售出库单POST
  • 库存
  • 线索
  • 资金
  • 采购入库单
  • 采购退货单
  • 统计分析
  • 示例接口(勿用)
  • 阿里账号信息GET
  • 阿里资金账户信息GET
亮色模式
  1. 销售出库单

新增/编辑销售出库单

POST/v1/invoices/outbound/push
异常码 异常消息 异常解决方案
404 ‘xxx’ cannot be empty 查看字段说明为“如果传入不能为空”,是否有字段传入了并且是空值

请求参数

Body 参数application/json
status
integer 
销售出库单状态:1-待出库,2-已出库
可选
outbound_invoice_id
integer 
销售出库单id
可选

编辑时必传 值来自/v1/invoices/outbound/list

discount_rate
integer 
整单折扣率(%)
可选
currency
string 
币种
可选
exchange_rate
number 
汇率,100单位单据币种(兑CNY)
可选
exchange_rate_usd
number 
汇率,100单位单据币种汇率(兑USD)
可选
source_type
integer 
出库来源:1-从采购中分配,2-从存货中分配
可选
invoice_warehouse_id
integer 
仓库ID
可选

值来自于/v1/warehouse/list

company_id
integer 
关联客户ID
可选

值来自于/v1/company/list

handler
array[string]
处理人
必需

值来自于/v1/user/list

record_list
array [object {11}] 
必需
3405725756
string 
自定义字段
可选
outbound_record_id
integer 
销售出库单明细ID
可选

编辑指定明细时必填,否则认为是新的明细

sku_id
integer 
产品SKU ID
必需
product_id
integer 
产品ID
必需
outbound_count
integer 
出库数量
必需
sale_price
integer 
销售单价(单据币种)
必需
order_id
integer 
关联销售订单ID
可选

选传,一个销售出库单中至少有一个产品有关联订单信息

order_record_id
integer 
关联销售订单明细ID,即订单明细的 unique_id
可选

选传,一个销售出库单中至少有一个产品有关联订单信息,编辑辑是不传入则会更新为0

cost_unit_price_rmb
number 
成本单价(CNY)
可选
moment_enable_count
number 
即时可用库存
可选
remove
integer 
是否删除该记录
可选

最简单的实现删除时传入值为1和outbound_record_id即可

serial_id
string 
销售出库单号
可选

值来自/v1/invoices/outbound/list

示例
{
  "status": 2,
  "discount_rate": 22,
  "currency": "CNY",
  "exchange_rate": 100,
  "exchange_rate_usd": 14,
  "source_type": 1,
  "invoice_warehouse_id": 831160953591,
  "warehouse_invoice_time": "2023-04-12 00:00:00",
  "company_id": 10142656515495,
  "handler": [
    "55938259"
  ],
  "record_list": [
    {
      "sku_id": 400568893973,
      "product_id": 16457955610,
      "outbound_count": 1,
      "sale_price": 0,
      "order_id": 10156012890355,
      "order_record_id": 10156012890350
    }
  ]
}

示例代码

返回响应

成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
code
integer 
必需
message
string 
必需
now
string 
必需
data
object 
必需
outbound_invoice_id
integer 
销售出库单id
必需

销售出库单唯一id

serial_id
string 
销售出库单编号
必需
record_list
array [object {8}] 
必需
示例
{
  "code": 200,
  "message": "success",
  "now": "2025-04-29 10:52:40",
  "data": {
    "outbound_invoice_id": 45704320657171,
    "serial_id": "XSCK2504290429",
    "record_list": [
      {
        "outbound_record_id": 45704320657283,
        "product_id": 17223257988,
        "sku_id": 488389862593,
        "outbound_count": "12.0000000000",
        "sale_price": "0.0000",
        "warehouse_id": 5910974587910,
        "order_id": 43533982576405,
        "order_record_id": 43534215764206
      }
    ]
  }
}
最后修改时间: 2 个月前