一龄-创建物流订单

# 创建物流订单

## 支持场景
>创建入库单、创建出库单、创建退货入库单、创建调拨出库单

## API描述
>创建物流单据

## 请求流程
> 参阅 [API开放平台接入指南](https://developers.yesno.com.cn/doc/56/)

## 请求信息
>域名：请参阅 [环境信息](https://developers.yesno.com.cn/doc/56/)

## 公共参数
**通用请求头**
>请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/)

## 传入参数
| 参数名称 | 参数类型 | 是否必填 | 数据范围 | 参数说明 | 示例值 |
| --- | --- | --- | --- | --- | --- |
| businessGroup | String | 是 |  | 业务分类，见[溯源应用平台物流业务分类](https://developers.yesno.com.cn/doc/47/ "溯源应用平台物流业务分类") | OUT |
| receiptType | String | 是 |  | 单据类型，见[溯源应用平台物流订单类型](https://developers.yesno.com.cn/doc/46/ "溯源应用平台物流订单类型") | 196720 |
| receiptNo | String | 是 | 长度6~30 | 单据编号 |  |
| remark | String | 否 | 长度0~256 | 备注 |  |
| shipmentMethod | String | 否 |  | 物流方式，见[溯源应用平台物流方式](https://developers.yesno.com.cn/doc/49/ "溯源应用平台物流方式") | 1 |
| shipmentCompany | String | 物流方式是1时必填 |  | 物流公司 |  |
| shipmentNo | String | 物流方式是1时必填  | 长度4~30 | 运输单号 |  |
| contact | String | 否 | 长度2~30 | 联系人 |  |
| cellphone | String | 否 | 手机号码格式 | 手机号码 |  |
| telephone | String | 否 | 固定电话格式 | 固定电话 |  |
| address | String | 否 | 长度0~256 | 联系地址 |  |
| receiptSenders | List | 是 |  | 发送方列表，入库单支持多个发送方 |  |
| ├─ orgNo | String | 是 |  | 组织编号 |  |
| ├─ orgType | Long | 是 |  | [组织类型](https://developers.yesno.com.cn/doc/66/) |  |
| receiptReceiver | Object | 是 |  | 接收方 |  |
| ├─ orgNo | String | 是 |  | 组织编号 |  |
| ├─ orgType | Long | 是 |  | [组织类型](https://developers.yesno.com.cn/doc/66/) |  |
| products | List | 是 |  | 商品列表 |  |
| ├─ productNo | String | 是 |  | 商品编号 |  |
| ├─ planQuantity | Long | 是 | 范围0~999999999 | 计划数量 |  |
| f1 | String | 否 |  | 扩展字段1 |  |
| f2 | String | 否 |  | 扩展字段2 |  |
| f3 | String | 否 |  | 扩展字段3 |  |
| f4 | String | 否 |  | 下游客户单位，必须是存在的经销商编号 |  |
| f5 | String | 否 |  | 扩展字段5 |  |
| f6 | String | 否 |  | 扩展字段6 |  |
| f7 | String | 否 |  | 扩展字段7 |  |
| f8 | String | 否 |  | 扩展字段8 |  |
| f9 | String | 否 |  | 扩展字段9 |  |
| f10 | String | 否 |  | 扩展字段10 |  |

## 传出参数
| 参数名称  | 参数类型 | 参数说明 |
| --- | --- | --- |
| code      | Integer | 状态：200-成功，其他状态见[溯源应用平台错误代码](https://developers.yesno.com.cn/doc/44/ "溯源应用平台错误代码") |
| message   | String | 信息 |
| timestamp | Long | 时间戳 |
| traceId   | String | 追踪ID |
| data   | Object | 返回信息 |
| ├─ id   | String | 订单ID |

## 请求示例
```json
{
    "businessGroup":"OUT",
    "receiptType": "196720",
    "receiptNo": "ceshi123456789",
    "remark": "备注",
    "shipmentCompany": "Aplus物流",
    "shipmentMethod": "1",
    "shipmentNo": "a123456",
    "contact": "联系人",
    "cellphone": "18888888888",
    "telephone": "0888-88888888",
    "address": "收货地址",
    "receiptSenders": [
        {
            "orgNo": "warehouse_001",
            "orgType": 14
        }
    ],
    "receiptReceiver": {
        "orgNo": "202301061531",
        "orgType": 16
    },
    "products": [
        {
            "planQuantity": "10",
            "productNo": "sp003"
        }
    ]
}
```
## 出参示例
```json
{
    "code": 200,
    "message": "success",
    "timestamp": 1679023142523,
    "traceId": "7074a316-3f60-462d-9e24-46f9780898b6",
    "data": {
        "id":"1538786107065200640"
    }
}
```