开发平台

电话咨询 400-000-7749

QQ咨询

1.货流说明



2.分页查询所有订货单(所有门店创建的订货单)


接口地址 http://host:port/pospal-api2/openapi/v1/stockFlowOpenApi/queryStockFlowDetailById
请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "startTime":"2013-01-01 00:00:00",//开始时间(包含)
  • "excludeEndTime": "2018-01-01 00:00:00",//结束时间(不包含)
  • "postBackParameter": {
  • "parameterType":"abcdef", 从返回结果中直接取出
  • "parameterValue": "abcdef", 从返回结果中直接取出
  • },
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    startTime String 格式为yyyy-MM-dd hh:mm:ss
    excludeEndTime String 格式为yyyy-MM-dd hh:mm:ss endTime - startTime <= 5天
    postBackParameter Json 查询首页时可以不传,之后的内容从返回结果中取出
    parameterType String 从返回结果中取出
    postBackParameter String 从返回结果中取出
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "postBackParameter": {
  • "parameterType": "abcdef从返回结果中直接取出",
  • "parameterValue": "abcdef从返回结果中直接取出"
  • },
  • "result": [
  • {
  • "items": [
  • {
  • "productUid": 832101480292933201,
  • "supplierUid": 0,
  • "quantity": 1,
  • "productUnitUid": 1457686229942839743
  • }
  • ],
  • "processItems": [
  • {
  • "supplierUid": 0,
  • "createdDatetime": "2016-08-30 17:52:26",
  • "status": 1,
  • "stockFlowId": 193483
  • }
  • ],
  • "id":14726234055,
  • "mergedId": 14726234058,
  • "targetUserAppId": "testAccountAppId",
  • "targetUserAccount": "testAccount",
  • "processUserAppId": "hanskang_appid",
  • "processUserAccount": "hanskang",
  • "createdDatetime": "2016-08-31 14:39:52",
  • "status": 2,
  • "alreadyPayAmount": 0,
  • "remarks": "备注信息",
  • "isFinished": 0,
  • "specifiedDeliveryTime": "2016-08-31 14:39:52",
  • "specifiedArriveTime": "2016-08-31 14:39:52",
  • "cashierUid": 1472623405529432999
  • }
  • ],
  • "pageSize": 100
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data List 实体信息
    postBackParameter Json 分页查询回传到服务器的参数结构从第二页开始必须回传,如果没传,每次查询都是第一页
    parameterType String 从返回结果中直接取出用于回传,不能变其值
    parameterValue String 从返回结果中直接取出用于回传,不能变其值
    result List 订货单情况—参考根据Id查询订货单返回字段

    3. 根据Id订货单


    接口地址 http://host:port/pospal-api2/openapi/v1/stockFlowOpenApi/queryProductRequestById
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "productReuestId":12429,
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    productReuestId Long 订货单ID
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "createUserAppId": "hanskang_appid",
  • "createUserAccount": "hanskang",
  • "items": [
  • {
  • "productUid": 832101480292933201,
  • "supplierUid": 0,
  • "quantity": 1,
  • "productUnitUid": 1457686229942839743
  • }
  • ],
  • "processItems": [
  • {
  • "supplierUid": 0,
  • "createdDatetime": "2016-08-30 17:52:26",
  • "status": 1,
  • "stockFlowId": 193483
  • }
  • ],
  • "id":14726234055,
  • "mergedId": 14726234058,
  • "targetUserAppId": "testAccountAppId",
  • "targetUserAccount": "testAccount",
  • "processUserAppId": "hanskang_appid",
  • "processUserAccount": "hanskang",
  • "createdDatetime": "2016-08-31 14:39:52",
  • "status": 2,
  • "alreadyPayAmount": 0,
  • "remarks": "备注信息",
  • "isFinished": 0,
  • "specifiedDeliveryTime": "2016-08-31 14:39:52",
  • "specifiedArriveTime": "2016-08-31 14:39:52",
  • "cashierUid": 1472623405529432999
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json
    id Long 订货单Id
    mergedId Long 并单时创建新订单的id
    targetUserAppId String A店向B店订货,这个字段表示B店的AppId
    targetUserAccount String A店向B店订货,这个字段表示B店的账号
    createdDatetime String 订货单创建时间
    status int 订货单状态:已拒绝 = -1, 待审核 = 0, 配货中 = 1, 已完成 = 2, 已作废 = 3,被合并 = -2
    alreadyPayAmount BigDecimal 预付款金额
    remarks String 备注信息
    isFinished int 是否已配货 0 - 未完成配货 1- 已配货
    specifiedDeliveryTime String 指定送货时间
    specifiedArriveTime String 指定到货时间
    cashierUid Long 收银员Uid
    items List 订货单中指定的订货商品
    productUid Long 订货商品Uid
    supplierUid Long 供应商Uid
    quantity BigDecimal 订货数量
    productUnitUid Long 商品单位定义Uid,如箱、包、吨quantity-productUnitUid 3箱、100包0或null表示默认基准单位
    pageSize Int 服务器想返回的条数。Result.size为实际返回条数Result.size = pageSzie时进行下一页查询
    processUserAppId String 进行拆单操作的用户APPID,拆单行成的多个配送进

    4. 分页查询所有货单(调货\进货\退货)(所有门店创建的贷流单)


    接口地址 http://host:port/pospal-api2/openapi/v1/stockFlowOpenApi/queryStockFlowPages
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "startTime": "2013-01-01 00:00:00", //开始时间(包含)
  • "excludeEndTime": "2018-01-01 00:00:00",//结束时间(不包含)
  • "postBackParameter": {
  • "parameterType":"abcdef", 从返回结果中直接取出
  • "parameterValue": "abcdef", 从返回结果中直接取出
  • },
  • "appId": "abcdefghijklmn",
  • }
  • }
    参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    startTime String 格式为yyyy-MM-dd hh:mm:ss
    excludeEndTime String 格式为yyyy-MM-dd hh:mm:ss
    postBackParameter Json 查询首页时可以不传,之后的内容从返回结果中取出
    parameterType String 从返回结果中取出
    parameterValue String 从返回结果中取出
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "postBackParameter": {
  • "parameterType": "abcdef从返回结果中直接取出",
  • "parameterValue": "abcdef从返回结果中直接取出"
  • },
  • "result": [
  • {
  • "toUserAppId": "lytest456_appId",
  • "toUserAccount": "lytest456",
  • "operatorUserAppId": "lytest456_appId",
  • "operatorUserAccount": "lytest456",
  • "nextStockFlowUserAppId": "lytest456_appId",
  • "nextStockFlowUserAccount": "lytest456",
  • "items": [
  • {
  • "productUid": 832101480292933201,
  • "categoryUid": 1496807057969574765,
  • "supplierUid": 0,
  • "productName": "橙子",
  • "barcode": "1496643727743",
  • "updateStock": 50,
  • "actualQuantity":49,
  • "buyPrice": 7,
  • "sellPrice": 15,
  • "remarks": "
  • }
  • ],
  • "id":195327,
  • "confirmationRequired": 1,
  • "createdDateTime": "2017-06-08 16:40:51",
  • "stockflowTypeNumber": 12,
  • "confirmed": 1,
  • "varianceConfirmation": 0,
  • "confirmedTime": "2017-06-08 16:41:01",
  • "remarks": "123",
  • "productRequestId": 13071,
  • "updateByCashierUid": 832101480292933201
  • }
  • ],
  • "pageSize": 100
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json
    postBackParameter Json 分页查询回传到服务器的参数结构从第二页开始必须回传,如果没传,每次查询都是第一页
    parameterType String 从返回结果中直接取出用于回传,不能变其值
    parameterValue String 从返回结果中直接取出用于回传,不能变其值
    result List 订货单情况—参考根据Id查询订货单返回字段

    5. 根据订货单id查询所有单(调货\进货\退货)


    接口地址 http://host:port/pospal-api2/openapi/v1/stockFlowOpenApi/queryStockFlowDetailByProductReuqestId
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "productRequestId": 13087,
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    productRequestId Long 订货单ID
    appId String Pospal配置的访问凭证
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data":[
  • {
  • "toUserAppId": "lytest456_appId",
  • "toUserAccount": "lytest456",
  • "operatorUserAppId": "lytest456_appId",
  • "operatorUserAccount": "lytest456",
  • "nextStockFlowUserAppId": "lytest456_appId",
  • "nextStockFlowUserAccount": "lytest456",
  • "items": [
  • {
  • "productUid": 832101480292933201,
  • "categoryUid": 1496807057969574765,
  • "supplierUid": 0,
  • "productName": "橙子",
  • "barcode": "1496643727743",
  • "updateStock": 50,
  • "actualQuantity":49,
  • "buyPrice": 7,
  • "sellPrice": 15,
  • "remarks": "
  • }
  • ],
  • "id":195327,
  • "confirmationRequired": 1,
  • "createdDateTime": "2017-06-08 16:40:51",
  • "stockflowTypeNumber": 12,
  • "confirmed": 1,
  • "varianceConfirmation": 0,
  • "confirmedTime": "2017-06-08 16:41:01",
  • "remarks": "123",
  • "productRequestId": 13071,
  • "updateByCashierUid": 832101480292933201
  • }
  • ],
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data List 详细字段参考根据Id查询调货\进货\退货单返回字段

    6. 根据货单id查询货单


    接口地址 http://host:port/pospal-api2/openapi/v1/stockFlowOpenApi/queryStockFlowDetailById
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "stockFlowId": 13087,
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    stockFlowId Long 货流单ID
    appId String Pospal配置的访问凭证,任何门店的AppId都可以查出所有用用过的核销码
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "toUserAppId": "lytest456_appId",
  • "toUserAccount": "lytest456",
  • "operatorUserAppId": "lytest456_appId",
  • "operatorUserAccount": "lytest456",
  • "nextStockFlowUserAppId": "lytest456_appId",
  • "nextStockFlowUserAccount": "lytest456",
  • "id":195327,
  • "confirmationRequired": 1,
  • "createdDateTime": "2017-06-08 16:40:51",
  • "stockflowTypeNumber": 12,
  • "confirmed": 1,
  • "varianceConfirmation": 0,
  • "confirmedTime": "2017-06-08 16:41:01",
  • "remarks": "123",
  • "productRequestId": 13071,
  • "updateByCashierUid": 832101480292933201
  • "items": [
  • {
  • "productUid": 832101480292933201,
  • "categoryUid": 1496807057969574765,
  • "supplierUid": 0,
  • "productName": "橙子",
  • "barcode": "1496643727743",
  • "updateStock": 50,
  • "actualQuantity":49,
  • "buyPrice": 7,
  • "sellPrice": 15,
  • "remarks": "
  • }
  • ]
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    result Json
    toUserAppId String 货单指向账号的appId
    toUserAccount String 货单指向账号的账号
    operatorUserAppId String 生成货单账号的appId
    operatorUserAccount String 生成货单账号的账号
    nextStockFlowUserAppId String 指定下一步货单的toUserAppId
    nextStockFlowUserAccount String 指定下一步货单的toUserAccount
    id Long 货单id
    confirmationRequired Int 是否需要确认货流,1:需要确认,0:不需要确认
    createdDateTime Date 货单创建时间,格式为yyyy-MM-dd hh:mm:ss
    stockflowTypeNumber Int 进货 = 12, 出货 = 13, 退货 = 14
    confirmed Int 0- 未确认,1- 已确认, 2- 拒绝进货/出货,3- 被拒绝收货
    varianceConfirmation Int 确认进货时,货流差异时,是否需要确认。出货单和退货单无效1:需要确认,0:不需要确认
    paid BigDecimal 已支付金额
    confirmedTime Date 确认货流时间,格式为yyyy-MM-dd hh:mm:ss
    remarks String 货单备注信息
    productRequestId Long 订货单id,从哪个订货单生成货(调货\进货)单
    updateByCashierUid Long 进行更新操作的收银员Uid
    items List 货单条目
    productUid Long 货单条目商品uid
    categoryUid Long 货单条目商品分类uid
    supplierUid Long 货单条目商品供应商uid
    productName String 货单条目商品名称
    barcode String 货单条目商品条码
    updateStock BigDecimal 按基准单位换算过的货量
    actualQuantity BigDecimal 实际进货量
    buyPrice BigDecimal 进货价
    sellPrice BigDecimal 销售价
    item-> remarks String 单品备注信息
    productUnitUid Long 货单条目商品单位Uid
    unitQuantity BigDecimal 按商品单位的货量
    unitQuantity BigDecimal 按商品单位的进货价