海王星辰iPAAS对外通用接口

第三方对接 开放接口


5.1 创建订单接口

<p>[TOC]</p> <h3>5.1 创建订单接口</h3> <p>&gt; - Url路径:{appKey}/orders</p> <h4>5.1.1 接口请求模型</h4> <p><code>V1.5版本 新增优惠金额字段 满足以下计算:</code> &gt; 顾客自付金额(含医保及自费)[customerPrice] = sum((单品原价[originalPrice] - 单品(海王方)折让金额 V1.5版本加入platformDiscountAmt - 单品(接入方)折让金额 V1.5版本加入[appDiscountAmt ])*商品数量[quantity]) - 海王方运费优惠金额 V1.5版本加入[platformFreightDiscount] - 商家方运费优惠金额 V1.5版本加入[appFreightDiscount] + 运费(不传默认0)[orderShippingInclTax] <code>简述:</code>用户实付金额 = 商品总价 - 海王运费优惠 - 平台运费优惠 - 海王商品优惠 - 平台商品优惠</p> <table> <thead> <tr> <th>参数代码                    </th> <th>参数类型参数类型              </th> <th>参数长度</th> <th>代码标识说明</th> <th>是否非空</th> <th>说明                                          </th> </tr> </thead> <tbody> <tr> <td>onlineOrderId              </td> <td>string                        </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>平台订单号                                    </td> </tr> <tr> <td>createTime                  </td> <td>string                        </td> <td>19      </td> <td>             </td> <td>         </td> <td>订单创建时间(yyyy-MM-dd HH:mm:ss)默认当前时间</td> </tr> <tr> <td>orderType                  </td> <td>int                          </td> <td>2        </td> <td>Y            </td> <td>Y        </td> <td>订单类型(详情orderTypeEnum)                  </td> </tr> <tr> <td>pharmacyCode                </td> <td>stringshippingProvince        </td> <td>4        </td> <td>             </td> <td>         </td> <td>发货门店(非B2C订单必传)                      </td> </tr> <tr> <td>orderOriginTotal            </td> <td>number                        </td> <td>10,4    </td> <td>             </td> <td>Y        </td> <td>原始订单价格(商品原价总金额)                  </td> </tr> <tr> <td>orderShippingInclTax        </td> <td>number                        </td> <td>10,4    </td> <td>             </td> <td>         </td> <td>运费(不传默认0)                              </td> </tr> <tr> <td><strong>platformFreightDiscount</strong></td> <td><strong>number</strong>                    </td> <td><strong>10,4</strong></td> <td>             </td> <td>         </td> <td><strong>海王方运费优惠金额 V1.5版本加入</strong>          </td> </tr> <tr> <td><strong>appFreightDiscount</strong>      </td> <td><strong>number</strong>                    </td> <td><strong>10,4</strong></td> <td>             </td> <td>         </td> <td><strong>商家方运费优惠金额 V1.5版本加入</strong>          </td> </tr> <tr> <td>platformOffers              </td> <td>number                        </td> <td>10,4    </td> <td>             </td> <td>         </td> <td>海王方优惠金额                                </td> </tr> <tr> <td>appOffers                  </td> <td>number                        </td> <td>10,4    </td> <td>             </td> <td>         </td> <td>商家方优惠金额                                </td> </tr> <tr> <td>customerPrice              </td> <td>number                        </td> <td>10,4    </td> <td>             </td> <td>Y        </td> <td>顾客自付金额(含医保及自费)                    </td> </tr> <tr> <td>customerName                </td> <td>string                        </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>收件人姓名                                    </td> </tr> <tr> <td>pickCode                    </td> <td>string                        </td> <td>10      </td> <td>             </td> <td>         </td> <td>自提码                                        </td> </tr> <tr> <td>sensitivePhone              </td> <td>string                        </td> <td>50      </td> <td>             </td> <td>         </td> <td>收件人脱敏手机                                </td> </tr> <tr> <td>customerPhone              </td> <td>string                        </td> <td>50      </td> <td>             </td> <td>Y        </td> <td>收件人电话                                    </td> </tr> <tr> <td>customerAddress            </td> <td>string                        </td> <td>200      </td> <td>             </td> <td>Y        </td> <td>收件人地址                                    </td> </tr> <tr> <td>shippingProvince            </td> <td>string                        </td> <td>20      </td> <td>             </td> <td>Y        </td> <td>收件省份                                      </td> </tr> <tr> <td>shippingCity                </td> <td>string                        </td> <td>20      </td> <td>             </td> <td>Y        </td> <td>收件城市                                      </td> </tr> <tr> <td>shippingDistrict            </td> <td>string                        </td> <td>20      </td> <td>             </td> <td>Y        </td> <td>收件区县                                      </td> </tr> <tr> <td>note                        </td> <td>string                        </td> <td>400      </td> <td>             </td> <td>         </td> <td>顾客留言                                      </td> </tr> <tr> <td>mapType                    </td> <td>int                          </td> <td>1        </td> <td>Y            </td> <td>         </td> <td>经纬度类型(默认0:高德,1:百度)                </td> </tr> <tr> <td>longitude                  </td> <td>number                        </td> <td>9,5      </td> <td>             </td> <td>         </td> <td>收件经度(O2O必传)                            </td> </tr> <tr> <td>latitude                    </td> <td>number                        </td> <td>9,5      </td> <td>             </td> <td>         </td> <td>收件纬度(O2O必传)                            </td> </tr> <tr> <td>productList                </td> <td>List&lt;ordersProductModel&gt;      </td> <td>         </td> <td>             </td> <td>Y        </td> <td>商品集合                                      </td> </tr> <tr> <td>prescription                </td> <td>List&lt;ordersPrescriptionModel&gt;</td> <td>         </td> <td>             </td> <td>         </td> <td>订单处方                                      </td> </tr> <tr> <td>payList                    </td> <td>List&lt;ordersPayModel&gt;          </td> <td>         </td> <td>             </td> <td>Y        </td> <td>支付集合                                      </td> </tr> </tbody> </table> <p>ordersProductModel                      </p> <table> <thead> <tr> <th>参数代码                </th> <th>参数类型参数类型</th> <th>参数长度</th> <th>代码标识说明</th> <th>是否非空</th> <th>说明                                  </th> </tr> </thead> <tbody> <tr> <td>barcode                </td> <td>string          </td> <td>10      </td> <td>             </td> <td>Y        </td> <td>海王方商品编码                        </td> </tr> <tr> <td>quantity                </td> <td>int              </td> <td>5        </td> <td>             </td> <td>Y        </td> <td>商品数量                              </td> </tr> <tr> <td>originalPrice          </td> <td>number          </td> <td>16,2    </td> <td>             </td> <td>Y        </td> <td>单品原价                              </td> </tr> <tr> <td><del>unitPrice</del>          </td> <td><del>number</del>      </td> <td><del>10,4</del></td> <td>             </td> <td><del>Y</del>    </td> <td><del>单品支付价 V1.5版本删除</del>          </td> </tr> <tr> <td><strong>platformDiscountAmt</strong></td> <td><strong>number</strong>      </td> <td><strong>16,2</strong></td> <td>             </td> <td><strong>Y</strong>    </td> <td><strong>单品(海王方)折让金额 V1.5版本加入</strong></td> </tr> <tr> <td><strong>appDiscountAmt</strong>      </td> <td><strong>number</strong>      </td> <td><strong>16,2</strong></td> <td>             </td> <td><strong>Y</strong>    </td> <td><strong>单品(接入方)折让金额 V1.5版本加入</strong></td> </tr> </tbody> </table> <p>ordersPrescriptionModel</p> <table> <thead> <tr> <th>参数代码      </th> <th>参数类型参数类型                      </th> <th>参数长度</th> <th>代码标识说明</th> <th>是否非空</th> <th>说明                    </th> </tr> </thead> <tbody> <tr> <td>patientName    </td> <td>string                                </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>姓名                    </td> </tr> <tr> <td>patientSex    </td> <td>int                                  </td> <td>1        </td> <td>Y            </td> <td>Y        </td> <td>性别(默认0:男,1:女)    </td> </tr> <tr> <td>patientAge    </td> <td>int                                  </td> <td>3        </td> <td>             </td> <td>Y        </td> <td>年龄                    </td> </tr> <tr> <td>idCard        </td> <td>string                                </td> <td>18      </td> <td>             </td> <td>         </td> <td>身份证                  </td> </tr> <tr> <td>rxId          </td> <td>string                                </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>处方ID                  </td> </tr> <tr> <td>patientDisease</td> <td>string                                </td> <td>50      </td> <td>             </td> <td>Y        </td> <td>患者(诊断)病症          </td> </tr> <tr> <td>patientAllergy</td> <td>string                                </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>药物过敏史              </td> </tr> <tr> <td>fstdiag        </td> <td>int                                  </td> <td>1        </td> <td>Y            </td> <td>         </td> <td>是否初诊(默认0:是,1:否)</td> </tr> <tr> <td>rxCode        </td> <td>string                                </td> <td>50      </td> <td>             </td> <td>         </td> <td>处方标识Code            </td> </tr> <tr> <td>picUrl        </td> <td>string                                </td> <td>200      </td> <td>             </td> <td>Y        </td> <td>处方图片URL            </td> </tr> <tr> <td>hospital      </td> <td>string                                </td> <td>50      </td> <td>             </td> <td>Y        </td> <td>开方医院                </td> </tr> <tr> <td>department    </td> <td>string                                </td> <td>50      </td> <td>             </td> <td>         </td> <td>开方科室                </td> </tr> <tr> <td>doctor        </td> <td>string                                </td> <td>50      </td> <td>             </td> <td>         </td> <td>开方医生                </td> </tr> <tr> <td>doctorCode    </td> <td>string                                </td> <td>100      </td> <td>             </td> <td>         </td> <td>开方医生资格证号        </td> </tr> <tr> <td>rxProductList  </td> <td>List&lt;ordersPrescriptionProductsModel&gt;</td> <td>         </td> <td>             </td> <td>         </td> <td>处方商品列表            </td> </tr> </tbody> </table> <p>ordersPrescriptionProductsModel                     </p> <table> <thead> <tr> <th>参数代码</th> <th>参数类型参数类型</th> <th>参数长度</th> <th>代码标识说明</th> <th>是否非空</th> <th>说明          </th> </tr> </thead> <tbody> <tr> <td>barcode  </td> <td>string          </td> <td>10      </td> <td>             </td> <td>         </td> <td>海王方商品编码</td> </tr> <tr> <td>name    </td> <td>string          </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>药品名称      </td> </tr> <tr> <td>spce    </td> <td>string          </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>药品规格      </td> </tr> <tr> <td>unitUse  </td> <td>string          </td> <td>100      </td> <td>             </td> <td>         </td> <td>用法用量      </td> </tr> </tbody> </table> <p>ordersPayModel                      </p> <table> <thead> <tr> <th>参数代码        </th> <th>参数类型参数类型</th> <th>参数长度</th> <th>代码标识说明</th> <th>是否非空</th> <th>说明                                    </th> </tr> </thead> <tbody> <tr> <td>paymentNo      </td> <td>string          </td> <td>100      </td> <td>             </td> <td>Y        </td> <td>支付流水号                              </td> </tr> <tr> <td>paymentMethodID</td> <td>int              </td> <td>1        </td> <td>Y            </td> <td>Y        </td> <td>线上支付类型(默认0:平台支付,1:医保支付)</td> </tr> <tr> <td>paymentAmount  </td> <td>number          </td> <td>10,4    </td> <td>             </td> <td>Y        </td> <td>付款金额                                </td> </tr> <tr> <td>paymentNumber  </td> <td>string          </td> <td>100      </td> <td>             </td> <td>         </td> <td>支付商户号                              </td> </tr> </tbody> </table> <h4>5.1.2 接口返回模型</h4> <table> <thead> <tr> <th>参数名称</th> <th>参数类型</th> <th>必填</th> <th>说明        </th> </tr> </thead> <tbody> <tr> <td>orderNo  </td> <td>string  </td> <td>Y    </td> <td>生成订单编号</td> </tr> </tbody> </table> <h4>5.1.3 Demo:</h4> <p>Request:</p> <pre><code>{     &amp;quot;appKey&amp;quot;: &amp;quot;NepHealth&amp;quot;,     &amp;quot;nonce&amp;quot;: &amp;quot;793d4171-183b-4a80-8c00-fd8d70954a38&amp;quot;,     &amp;quot;timestamp&amp;quot;: 1639121594,     &amp;quot;sign&amp;quot;: &amp;quot;45e3cc54d144e513ef3999a06e4cf22aae9782a4&amp;quot;,     &amp;quot;input&amp;quot;: {         &amp;quot;onlineOrderId&amp;quot;: &amp;quot;1231231313&amp;quot;,         &amp;quot;createTime&amp;quot;: &amp;quot;2021-12-10 16:16:50&amp;quot;,         &amp;quot;orderType&amp;quot;: 2,         &amp;quot;pharmacyCode&amp;quot;: &amp;quot;S222&amp;quot;,         &amp;quot;orderOriginTotal&amp;quot;: 1.01,         &amp;quot;orderShippingInclTax&amp;quot;: 0,         &amp;quot;customerPrice&amp;quot;: 1.01,         &amp;quot;customerName&amp;quot;: &amp;quot;王五&amp;quot;,         &amp;quot;sensitivePhone&amp;quot;: &amp;quot;138****5161&amp;quot;,         &amp;quot;customerPhone&amp;quot;: &amp;quot;13822525161&amp;quot;,         &amp;quot;customerAddress&amp;quot;: &amp;quot;广东省深圳市南山区粤海街道海王星辰总部大厦7楼&amp;quot;,         &amp;quot;shippingProvince&amp;quot;: &amp;quot;广东省&amp;quot;,         &amp;quot;shippingCity&amp;quot;: &amp;quot;深圳市&amp;quot;,         &amp;quot;shippingDistrict&amp;quot;: &amp;quot;南山区&amp;quot;,         &amp;quot;note&amp;quot;: &amp;quot;就是个留言&amp;quot;,         &amp;quot;mapType&amp;quot;: 0,         &amp;quot;longitude&amp;quot;: 113.942,         &amp;quot;latitude&amp;quot;: 22.51546,         &amp;quot;productList&amp;quot;: [{                 &amp;quot;barcode&amp;quot;: &amp;quot;8024499&amp;quot;,                 &amp;quot;quantity&amp;quot;: 1,                 &amp;quot;originalPrice&amp;quot;: 100,                 &amp;quot;unitPrice&amp;quot;: 0.01             },             {                 &amp;quot;barcode&amp;quot;: &amp;quot;0101001&amp;quot;,                 &amp;quot;quantity&amp;quot;: 1,                 &amp;quot;originalPrice&amp;quot;: 50,                 &amp;quot;unitPrice&amp;quot;: 1.00             }         ],         &amp;quot;prescription&amp;quot;: [{             &amp;quot;patientName&amp;quot;: &amp;quot;王五&amp;quot;,             &amp;quot;patientSex&amp;quot;: 0,             &amp;quot;patientAge&amp;quot;: 31,             &amp;quot;idCard&amp;quot;: &amp;quot;123456789123456789&amp;quot;,             &amp;quot;rxId&amp;quot;: &amp;quot;SD123456778&amp;quot;,             &amp;quot;patientDisease&amp;quot;: &amp;quot;腰间盘突出&amp;quot;,             &amp;quot;patientAllergy&amp;quot;: &amp;quot;阿莫西林&amp;quot;,             &amp;quot;fstdiag&amp;quot;: 0,             &amp;quot;rxCode&amp;quot;: &amp;quot;mm1232584312&amp;quot;,             &amp;quot;picUrl&amp;quot;: &amp;quot;&amp;quot;,             &amp;quot;hospital&amp;quot;: &amp;quot;南山蛇口医院&amp;quot;,             &amp;quot;department&amp;quot;: &amp;quot;骨科&amp;quot;,             &amp;quot;doctor&amp;quot;: &amp;quot;罗大佑&amp;quot;,             &amp;quot;doctorCode&amp;quot;: &amp;quot;myld658954642x&amp;quot;,             &amp;quot;rxProductList&amp;quot;: [{                     &amp;quot;barcode&amp;quot;: &amp;quot;0101001&amp;quot;,                     &amp;quot;name&amp;quot;: &amp;quot;蛇龙药膏&amp;quot;,                     &amp;quot;spce&amp;quot;: &amp;quot;3片/盒&amp;quot;,                     &amp;quot;unitUse&amp;quot;: &amp;quot;一日三次,一次1片&amp;quot;                 },                 {                     &amp;quot;barcode&amp;quot;: &amp;quot;&amp;quot;,                     &amp;quot;name&amp;quot;: &amp;quot;辅助贴&amp;quot;,                     &amp;quot;spce&amp;quot;: &amp;quot;片&amp;quot;,                     &amp;quot;unitUse&amp;quot;: &amp;quot;辅助使用&amp;quot;                 }             ]         }],         &amp;quot;payList&amp;quot;: [{                 &amp;quot;paymentNo&amp;quot;: &amp;quot;YB010011123132&amp;quot;,                 &amp;quot;paymentMethodID&amp;quot;: 1,                 &amp;quot;paymentAmount&amp;quot;: 1,                 &amp;quot;paymentNumber&amp;quot;: &amp;quot;POSYB12155411&amp;quot;             },             {                 &amp;quot;paymentNo&amp;quot;: &amp;quot;ZFB2021121016301000157&amp;quot;,                 &amp;quot;paymentMethodID&amp;quot;: 0,                 &amp;quot;paymentAmount&amp;quot;: 0.01,                 &amp;quot;paymentNumber&amp;quot;: &amp;quot;ZFBNO092&amp;quot;             }         ]     } }</code></pre> <p>Response:</p> <pre><code>{     &amp;quot;code&amp;quot;: 200,     &amp;quot;msg&amp;quot;: &amp;quot;ok&amp;quot;,     &amp;quot;nonce&amp;quot;: &amp;quot;793d4171-183b-4a80-8c00-fd8d70954a38&amp;quot;,     &amp;quot;output&amp;quot;: {         &amp;quot;orderNo&amp;quot;: &amp;quot;02000002057467745&amp;quot;     } }</code></pre>

页面列表

ITEM_HTML