开发平台

电话咨询 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 业务处理的错误代码,参见错误代码表

    6.根据单号查询订单


    接口地址 http://host:port/pospal-api2/openapi/v1/orderOpenApi/queryOrderByNo
    请求头
  • 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配置的访问凭证
    orderNo String 订单号
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data":{
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json 订单实体数据
    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 联系人电话
    state Int 订单状态
    NULL = 0; //定单创建时的状态
    SYNCED = 1; //定单已同步到客户端的状态
    SHIPPED = 2; //定单已发货状态
    CANCELED = 3; //定单取消状态
    COMPLETED = 4; //定单结束状态
    items List 商品列表
    productUid Long 商品在银豹系统的唯一标识
    productName String 商品名称
    productBarcode String 商品条码
    eshopSellPrice BigDecimal 网店网店销售价
    productQuantity BigDecimal 数量
    productBuyPrice BigDecimal 商品进货价
    productSellPrice BigDecimal 商品销售价
    isCustomerDiscount Boolean 是否开启会员折扣
    customerDiscount BigDecimal 会员折扣率
    customerPrice BigDecimal 会员价
    comment String 针对商品条目的备注