开发平台

电话咨询 400-000-7749

QQ咨询

1.网单流程图



2.新增在线订单


接口地址 http://host:port/pospal-api2/openapi/v1/orderOpenApi/addOnLineOrder
请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn",
  • "payMethod": "Cash",
  • "customerNumber": "001",
  • "shippingFee":15.00,
  • "orderRemark": "addOnLineOrder",
  • "orderDateTime": "2015-12-04 10:05:01",
  • "contactAddress": "测试测试。。。。",
  • "contactName": "张三",
  • "contactTel": "1360097865",
  • "items": [
  • {
  • "productUid": 102066793346170331,
  • "comment": "测试添加",
  • "quantity": 1.2,
  • "manualSellPrice":30.2
  • }
  • ]
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    payMethod String 两种支付方式二选一:
    Cash,表示现金支付;
    CustomerBalance,表示用会员余额支付,接口会根据customerNumber去扣除对应会员的余额;
    customerNumber String 会员号,订单是哪个会员下的。
    如果payMethod= CustomerBalance,参数customerNumber不能为空
    shippingFee BigDecimal 运费
    orderRemark String 订单备注
    orderDateTime String 订单产生的时间,格式为yyyy-MM-dd hh:mm:ss
    contactAddress String 送货地址,联系地址
    contactName String 联系人姓名
    contactTel String 联系人电话
    items List 商品列表
    productUid Long 商品在银豹系统的唯一标识
    comment String 针对商品条目的备注
    quantity BigDecimal 数量
    manualSellPrice BigDecimal 商品单价,如果为空,以银商品在银豹系统的单价为准
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "orderNo": "20151207112323296104",
  • "orderCreateDateTime": "2015-12-04 10:05:01",
  • "customerNumber": "001"
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json 实体信息
    orderNo String 订单序列号
    orderCreateDateTime String 下单时间
    customerNumber String 订单会员号

    3.取消在线订单


    接口地址 http://host:port/pospal-api2/openapi/v1/orderOpenApi/cancleOrder
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn",
  • "orderNo": "189098765432"
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表

    4.在线订单发货


    接口地址 http://host:port/pospal-api2/openapi/v1/orderOpenApi/shipOrder
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn",
  • "orderNo": "189098765432"
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表

    5.完成在线订单


    接口地址 http://localhost:8080/pospal-api2/openapi/v1/orderOpenApi/completeOrder
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn",
  • "orderNo": "189098765432"
  • shouldAddTicket: true
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    shouldAddTicket Boolean 是否在银豹收银系统生成流水单据
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表