获取磅单接口

接口说明

接口地址:

获取正常收料磅单: /gys/inspection-api-service/integrate-v2/getSLlist?projectId=1458773&beginTimestamp=20160319101010000
获取正常发料磅单: /gys/inspection-api-service/integrate-v2/getFLlist?projectId=1458773&beginTimestamp=20160319101010000
获取作废收料磅单: /gys/inspection-api-service/integrate-v2/getSLDeletelist?projectId=1458773&beginTimestamp=20160319101010000
获取作废发料磅单: /gys/inspection-api-service/integrate-v2/getFLDeletelist?projectId=1458773&beginTimestamp=20160319101010000

请求方式: GET

请求参数: projectId、beginTimestamp、hasPicture

重点说明

时间过滤条件是数据库每条记录的时间戳，不是单据的业务时间。
每次查询最多包含3个月内的数据，比如beginTimestamp=20160301101010000，则查询范围为20160301~20160601的数据，如果期间无数据，调用方需要将返回值中的 MaxTimestamp的值20160601101010000，作为下一次请求链接中的beginTimestamp，继续循环请求，直至当前时间。所以beginTimestamp需要根据项目实际发生业务的时间传值，不易过小。
每次查询默认查出满足条件的前200条数据，如果第201条及之后的数据的时间戳与第200条相同，则一同查出，一次查询一般是200条数据，最多3000条数据。
数据不包含开始时间但包含结束时间。
默认不包含图片，当hasPicture为true时，则返回磅单图片列表
由于磅单种类分为收料、发料，每类磅单又包含正常状态和作废状态，为方便第三方系统快速获取相对应的磅单数据，我们为磅单提供了6个查询接口。

最佳实践

[info] 最佳实践

由于云端数据量较大，三方系统在通过接口请求数据时，我们建议项目ID(projectId)尽量传值，以项目为单位去请求数据。项目ID获取方式详见“获取集成项目接口”。

我们提供的磅单数据是按GYS系统记录的时间戳增量式批量给出，第三方在调用的按照下图所示的流程进行增量式多次获取。

请求参数属性说明

参数	类型	必须	描述
projectId	Long	N	项目ID，可为空；若使用租户层授权文件时，projectId为空查询全部项目数据，不为空时只查询对应项目的数据；若使用项目层授权文件时，为空则查询授权文件所属项目及下属拌合站的数据；不为空时只查询对应项目的数据；此项目ID获取方式详见获取集成项目
beginTimestamp	String	Y	开始时间, 字符串,时间包含毫秒，格式为yyyyMMddHHmmssSSS, 不能为空，如 20160319101010000，2016年3月19号10点10分10秒000毫秒
hasPicture	Boolean	N	true：包含磅单图片，false：不包含磅单图片

响应结果字段说明

字段名	字段类型	必须	默认值	描述
success	Boolen	Y		状态。true成功，false失败
data	Object	Y		磅单信息
errMsg	String	N	“”	如果有错误，错误信息

data字段说明

字段名	字段类型	必须	描述
BeginTimestamp	String	Y	本次数据的开始时间
EndTimestamp	String	Y	本次数据的结束时间
MaxTimestamp	String	Y	本次数据的最大时间
PageSize	Number	Y	每页条数
Bills	Array	Y	本次请求响应的数据

Bills字段说明（data -> Bills）

字段名	字段类型	必须	默认值	描述
projectId	Number	Y		项目ID（物料验收云端项目ID）
BDBH	String	Y		单据编号
id	Number	Y		云端单据主键ID
GUID	String	Y		单据GUID
ZHXGSJ	String	Y		最后修改时间
CPH	String	Y		车牌号
DJLY	String	Y		单据来源;有四种类型：“称重”、“补录”、“移动验收”、“移动发料”
GSGYSID	Number	Y		供应商ID（物料验收系统中ID，收料磅单/直入直出磅单的发料单位，发料磅单/内部调拨的收料单位）
GYSBM	String	Y		供应商编码（收料磅单/直入直出磅单的发料单位，发料磅单/内部调拨的收料单位）
GYSMC	String	Y		供应商名称
DSFGYSID	String	N		第三方供应商ID（三方系统中的供应商ID）
DYCS	Number	Y		打印次数
GBDW	String	Y		过磅单位; 固定值：吨
GBY	String	Y		过磅员
LX	Number	Y		类型，0 收料，1 发料
LX_YT	String	Y		子类型;收料（采购、调入、甲供、退货、租赁），发料（发料、废旧物资、调出、售出、退租），直入直出（直入直出）；其中租赁/退租属于个性版字段详见磅单子类型说明
sendOnReceive	Boolean	Y		是否直入直出单：true 是，false 否（1、当LX=0&sendOnReceive=false收料磅单，锁定磅单时billType=0 2、当LX=0&sendOnReceive=true直入直出磅单，锁定磅单时billType=2）
billTypeId	Number	Y		单据子类型id 1采购，4废旧物资，5售出，6甲供，7调入，8调出，9发料，16退货，64其他磅单，租赁100，退租256，1024直入直出；其中租赁/退租属于个性版字段详见磅单子类型说明
STATUS	Number	Y		磅单状态；1 正常，0 作废
SingleMaterial	Boolean	Y		是否单物资; 是 true ，否 false
Timestamp	String	Y		时间戳(数据库级时间戳，无业务意义)
billUrl	String	Y		单据短地址（物料验收云端链接地址若为作废单据那么此地址无效）
globalStatus	Number	Y		业务状态：1 未确认/待确认，2 已确认，4 已对账，6 已对账确认，8 部分入库，16只读，8+32 已入库，64 预警审批中，128 已拒单，256 预警审批通过（实际返回值与上值位运算，例如判断否已入库锁定: globalStatus&8>0）
CJSJ	String	Y		创建时间
LASTUPDATETIME	Date	Y		最后修改时间,2019-02-02 02:02:02形式的lastModifyTime
BDCL	Array	Y		单据材料。属性详见【BDCL字段说明】
BDImgs	Array	N		单据图片。属性详见【BDImgs字段说明】
YSYJ	Array	N		单据引用关系。属性详见【YSYJ字段说明】
projectCode	String	N		项目编码;一般与三方系统中的项目编码相同三方系统中同步编码有值，此编码才能拿到值
BFBM	String	N		磅房编码
BZ	String	N		备注
CCSJ	String	N		出厂时间
CMSJ	String	N		称毛时间
CPSJ	String	N		称皮时间
PZ	Number	N		皮重
MZ	Number	N		毛重
JZ	Number	N		净重
DWGC	String	N		单位工程
PCJG	Number	N		偏差结果，0 正常，1 超正差，-1 超负差
SJZLHJ	Number	N		实际重量合计
JD	Number	N		经度
WD	Number	N		纬度
SYBW	String	N		使用部位
SYBWID	Long	N		使用部位id
usePositionUnitId	String	N		使用部位三方id
YDXCZLHJ	Number	N		运单下差重量合计
YDZLHJ	Number	N		运单重量合计
YSDJBH	String	N		原始单据编号
ZDHP	Boolean	N		是否自动回皮；是 true，否 false
KFBM	String	N		库房编码
KFMC	String	N		库房名称
warehouseUnitId	String	N		第三方库房集成编码
TYSHXXDM	String	N		统一社会信用代码
ANOTHER_GSGYSID	Number	N		直入直出的收料/内部调拨的发料的供应商ID
ANOTHER_GYSBM	String	N		直入直出的收料/内部调拨的发料的供应商编码
ANOTHER_GYSMC	String	N		直入直出的收料/内部调拨的发料的供应商名称
ANOTHER_GYSLX	Integer	N		直入直出的收料/内部调拨的发料的供应商类型
ANOTHER_DSFGYSID	String	N		直入直出的收料/内部调拨的发料的第三方供应商ID
ANOTHER_TYSHXXDM	String	N		直入直出的收料/内部调拨的发料的供应商统一社会信用代码
KZSX	String	N		扩展属性
transportCompanyValue	String	N		运输单位id
transportCompanyName	String	N		运输单位名称
transportCompanyExtraId	String	N		运输单位三方id
PZPC	Number	N	0.0	车皮重量偏差
CLPCBL	Number	N	0.0	偏差值
IsHaveImage	Boolean	N		是否包含图片
DSFHTID	String	N		第三方合同ID
HTID	Long	N		合同ID
HTBM	String	N		合同编码
HTMC	String	N		合同名称
COMMIT	Boolean	N		是否提交
EFFECT	Boolean	N		生效标识
CCCPH	String	N		车牌号_出场
JCCPH	String	N		车牌号_进场
CJRID	Long	N		创建人id
CPSBCPH	String	N		车牌识别车牌号
CPSBCPTPLJ	String	N		车牌识别车牌图片路径
CPSBL	Double	N		车牌识别率
JBRCC	String	N		经办人_出场
JBRJC	String	N		经办人_进场
completionTime	Date	N		出场时间
SXBS	Boolean	N		生效标识

BDCL字段说明（data -> Bills -> BDCL）

字段名	字段类型	必须	描述
id	Number	Y	云端磅单材料表行id
tenantId	Number	Y	租户ID
projectId	Number	Y	项目ID
GSCLZDID	Number	Y	云端材料字典ID
CLMC	String	Y	材料名称
CLBM	String	Y	材料编码
GGXH	String	Y	规格型号
BDCLID	Number	Y	项目端磅单材料ID 磅单内唯一
JLDW	String	Y	计量单位(验收时使用的单位，不一定与字典单位相同)
CLLBBM	String	Y	材料类别编码
CLLBID	Number	Y	材料类别ID
CLLBMC	String	Y	材料类别名称
globalStatus	Number	Y	业务状态；1 未确认/待确认，2 已确认，4 已对账，6 已对账确认，8 部分入库，16只读，8+32 已入库，64 预警审批中，128 已拒单，256 预警审批通过（实际返回值与上值位运算，例如判断否已入库锁定: globalStatus&8>0）
DSFCLID	String	N	三方系统材料ID
HSXS	Number	N	换算系数（验收时使用的单位与重量单位“吨”的换算关系）
KL	Number	N	扣量
PCJG	Number	N	偏差结果；0 正常， 1 超正差， -1 超负差
PCLX	String	N	偏差类型；比例偏差（%）、范围偏差（吨）
SJSL	Number	N	实际数量
SJWC	Number	N	实际偏差
SJZL	Number	N	实际重量
QRL	Number	N	确认量
QRLLX	Number	N	确认量类型； -1 无，0 运单量， 1 实际量， 2 较小值， 3输入量
SYHSXS	String	N	使用换算系数
YDSL	Number	N	运单数量
YDZL	Number	N	运单重量
PCH	String	N	批次编号
DSFSQDID	String	N	第三方日计划id
SQDID	Number	N	物料系统申请单id
SQDBM	String	N	申请单编码
JHSL	Number	N	计划数量
KZSX	String	N	扩展属性
BDCLYSYJ	Array	N	磅单材料引用关系(跟磅单材料相关的引用 )。属性详见【BDCLYSYJ字段说明】
surcharges	Array	N	附加费。属性详见【surcharges字段说明】
deductionName	String	N	材料扣数名称
deductionValue	String	N	材料扣数量
deductionExtraId	String	N	材料扣数三方id
SSLLSL	Double	N	实收理论数量
manufacturerValue	String	N	生产厂家物料侧id
manufacturerName	String	N	生产厂家名称
manufacturerExtraId	String	N	生产厂家三方id
ZC	Number	N	正差
FC	Number	N	负差
PCLX	String	N	偏差类型, 为%时为比例值, 为吨时为范围值
aiMaterialInfo	Object	N	ai材料信息。属性详见【aiMaterialInfo字段说明】
aiRecords	Array	N	ai点根图片记录。属性详见【aiRecords字段说明】
remark	String	N	备注

BDImgs字段说明（data -> Bills -> BDImgs）

字段名	字段类型	必须	描述
id	Number	Y	主键id
projectId	Number	Y	项目ID
tenantId	Number	Y	租户ID
FL	Number	Y	图片分类0:称毛(磅房、顶部、后部、前部); 1:称皮(磅房、顶部、后部、前部); 2:运单; 5:报表; 8: 称毛车牌图片; 16: 称毛车图片; 32: 称皮车牌图片; 64: 称皮车图片; -1:历史图片;128:出门条;256施工方授权人签名图片; （当单据来源是移动验收时：32: 移动验收/移动发料图片; 64: 电子签名图片;）
ReadKey	String	Y	上传oss上图片唯一标识，更新唯一标识
billId	Number	Y	磅单主键id
MS	String	N	描述
extensionName	String	N	扩展名

YSYJ字段说明（data -> Bills -> YSYJ）

字段名	字段类型	必须	描述
LX	String	Y	类型； PURCHASEWAYBILL 运单， PROJECT_ORDER 订单， MATERIAL_REQUISITION 申请单， PURCHASECONTRACT 采购合同
BM	String	Y	业务单据编号（如：合同编号，订单编号）
DJID	Number	Y	业务来源主键id（如：合同id，订单id）
DSFDJID	String	N	引用主表三方id

同一笔磅单可以支持多种验收依据，比如同时根据合同和订单验收，则返回的YSYJ数组中包含2条数据

举例说明(YSYJ)：
  1、根据合同验收磅单
      {
          "LX": "PURCHASEWAYBILL", // 类型  PURCHASECONTRACT：采购合同
          "BM": "CWTHT20210517341T", // 合同编号
          "DJID": 535197949432320, //合同id
          "DSFDJID": "535197902893568" // 第三方合同ID
      }
  2、根据订单验收磅单
      {
          "LX": "PURCHASEWAYBILL", // 类型  PROJECT_ORDER：订单 
          "BM": "CWTHT20210517341T", // 订单编号
          "DJID": 535197949432320, // 订单id
          "DSFDJID": "535197902893568" // 第三方订单ID(非必填，若非集成订单则此字段无值)
      }
  3、根据运单验收磅单
      {
          "LX": "PURCHASEWAYBILL", // 类型  PURCHASEWAYBILL：运单
          "BM": "CWTHT20210517341T", // 运单编号
          "DJID": 535197949432320, // 运单id 
          "DSFDJID": "535197902893568" // 第三方运单ID(非必填，若非集成运单则此字段无值)
      }
  4、根据申请单验收磅单
      {
          "LX": "PURCHASEWAYBILL", // 类型  MATERIAL_REQUISITION：申请单
          "BM": "CWTHT20210517341T", // 申请单编号
          "DJID": 535197949432320, // 申请单id 
          "DSFDJID": "535197902893568" // 第三方申请单(非必填，若非集成订单则此字段无值)
      }

BDCLYSYJ字段说明(data -> Bills -> BDCL -> BDCLYSYJ)

字段名	字段类型	必须	描述
LX	String	Y	类型；PURCHASEWAYBILL 运单， PROJECT_ORDER 订单， MATERIAL_REQUISITION 申请单， PURCHASECONTRACT 采购合同
BM	String	Y	业务单据编号（如：合同编号，订单编号）
DJID	Number	Y	业务来源主键id（如：合同id，订单id）
DJMXID	Number	Y	业务来源材料主键id（如：合同材料行id，订单材料行id）
DSFDJID	String	N	引用主表三方id
DSFDJMXID	String	N	引用材料表三方id

同一笔磅单可以支持多种验收依据，比如同时根据合同材料和订单材料验收，则返回的BDCLYSYJ数组中包含2条数据

举例说明(BDCLYSYJ)：
  1、根据合同验收磅单,选择的是合同下的材料
      {
          "LX": "PURCHASEWAYBILL", // 类型  PURCHASECONTRACT：采购合同
          "BM": "CWTHT20210517341T", // 合同编号
          "DJID": 535197949432320, //合同id
          "DSFDJID": "535197902893568" // 第三方合同ID
          "DJMXID": 535197950972417, // 合同材料行id
          "DSFDJMXID": "535154169925632" // 第三方合同材料表行id    
      }
  2、根据订单验收磅单,选择的是订单下的材料
      {
          "LX": "PURCHASEWAYBILL", // 类型  PROJECT_ORDER：订单 
          "BM": "CWTHT20210517341T", // 订单编号
          "DJID": 535197949432320, // 订单id
          "DSFDJID": "535197902893568" // 第三方订单ID(非必填，若非集成订单则此字段无值)
          "DJMXID": 535197950972417, // 订单材料行id(非必填，若非集成订单则此字段无值)
          "DSFDJMXID": "535154169925632" // 第三方订单材料表行id (非必填，若非集成订单则此字段无值)
      }
  3、根据运单验收磅单,选择的是订单下的材料
      {
          "LX": "PURCHASEWAYBILL", // 类型  PURCHASEWAYBILL：运单
          "BM": "CWTHT20210517341T", // 运单编号
          "DJID": 535197949432320, // 运单id 
          "DSFDJID": "535197902893568" // 第三方运单ID(非必填，若非集成运单则此字段无值)
          "DJMXID": 535197950972417, // 运单材料行id(非必填，若非集成订单则此字段无值)
          "DSFDJMXID": "535154169925632" // 第三方运单材料表行id (非必填，若非集成订单则此字段无值)  
      }
  4、根据申请单验收磅单,选择的是申请单下的材料
      {
          "LX": "PURCHASEWAYBILL", // 类型  MATERIAL_REQUISITION：申请单
          "BM": "CWTHT20210517341T", // 申请单编号
          "DJID": 535197949432320, // 申请单id 
          "DSFDJID": "535197902893568" // 第三方申请单(非必填，若非集成订单则此字段无值)
          "DJMXID": 535197950972417, // 申请单材料行id(非必填，若非集成订单则此字段无值)
          "DSFDJMXID": "535154169925632" // 第三方申请单材料表行id  (非必填，若非集成订单则此字段无值) 
      }

aiMaterialInfo字段说明(data -> Bills -> BDCL ->aiMaterialInfo)

字段名	字段类型	必须	描述
realWeightType	Number	Y	实际理重类型( 0:手输， 1：运单理重 2：已点理重)
lengthPerMeter	Number	Y	单根米长
realWeight	Number	Y	实际理重
checkWeight	Number	Y	已点理重
materialId	Number	Y	材料id
totalBundle	Number	Y	总捆数
billId	Number	Y	磅单ID
billMaterialId	Number	Y	云端磅单材料表行id
billWeight	Number	Y	运单理重
diam	Number	Y	直径
manufacturer	String	N	生产厂家

aiRecords字段说明(data -> Bills -> BDCL ->aiRecords)

字段名	字段类型	必须	描述
id	Number	Y	ai记录行id
aiImgKey	Number	Y	ai识别图片key
aiDistinguishNumber	Number	Y	ai 点根数量
materialId	Number	Y	材料id
aiRealWeight	Number	Y	ai实际理重
aiCqblNumber	Number	Y	ai查缺补漏根数
billId	Number	Y	磅单ID
billMaterialId	Number	Y	云端磅单材料表行id
aiRealNumber	Number	Y	ai实际根数

surcharges字段说明（data -> Bills -> BDCL -> surcharges）

字段名	字段类型	必须	描述
code	String	Y	附加费编码
id	Number	Y	主键id
name	String	Y	附加费名称
source	Number	Y	附加费来源； 1 本项目附加费，2 合同附加费
unit	String	N	附加费单位
unitId	String	N	附加费三方id

返回结果格式

{
    "success": true, // 状态 （必填）
    "errMsg": "", //如果有错误，错误信息 （非必填）
    "data": {
        "BeginTimestamp": "20170228000000000", //本次数据的开始时间 （必填）
        "Bills": [ //本次请求的数据（必填）
            {
                "BDBH": "BL-20170228-YHXMJBZ1-01-0001", //单据编号 不唯一 （必填）
                "BDCL": [ //单据材料（必填）
                    {
                        "BDCLID": 400001, //项目端磅单材料ID 磅单内唯一（必填）
                        "CLBM": "181801180103180103001", //材料编码（必填）
                        "CLLBBM": "18.1801.180103", //材料类别编码（必填）
                        "CLLBID": 2201205, //材料类别ID（必填）
                        "CLLBMC": "挂篮", //材料类别名称 （必填）
                        "CLMC": "挂篮模板", //材料名称（必填）
                        "DSFCLID": "1798817949", //三方系统材料ID （非必填）
                        "GGXH": "12", //规格型号 （必填）
                        "GSCLZDID": 1695050, //物料验收云端材料字典ID（必填）
                        "HSXS": 0.05, //换算系数（过磅时使用的单位与重量单位“吨”的换算关系）（非必填）
                        "JLDW": "匹", //计量单位(过磅时使用的单位，不一定与字典单位相同) （必填）
                        "KL": 0, //扣量 （非必填）
                        "PCJG": 0, //偏差结果，0正常 1超正差 -1 超负差（非必填）
                        "PCLX": "%", //偏差类型（%或吨）（非必填）
                        "SJSL": 200, //实际数量（非必填）
                        "SJWC": -9.09, //实际偏差（非必填）
                        "SJZL": 10, //实际重量（非必填）
                        "QRL": 10, //确认量（非必填）
                        "QRLLX": 1, //确认量类型 -1无 0运单量 1实际量 2较小值  3输入量  （非必填）
                        "SYHSXS": "1匹=0.05吨", //使用换算系数（非必填）
                        "YDSL": 220, //运单数量（非必填）
                        "YDZL": 11, //运单重量（非必填）
                        "PCH": "GP314C0203-05214C02A07", //批次编号（非必填）
                        "DSFSQDID":"146897",//第三方日计划id （非必填）
                        "SQDID":1645978,//物料系统申请单id（非必填）
                        "SQDBM":"SQD-2021-01-001",//申请单编码（非必填）
                        "JHSL":22,//计划数量（非必填）
                        "globalStatus": 0, //业务状态（必填）
                        "KZSX": "", //扩展属性（非必填）
                        "projectId": 1459807, //项目ID（必填）
                        "tenantId": 1454160, //租户ID（必填）
                        "BDCLYSYJ": [//磅单材料引用关系(跟磅单材料相关的引用 非必填)
                          {
                            "LX": "PURCHASEWAYBILL", // 类型  "PURCHASEWAYBILL：运单 PROJECT_ORDER：订单 MATERIAL_REQUISITION：申请单 PURCHASECONTRACT：采购合同"
                            "BM": "CWTHT20210517341T", // 业务单据编号（如：合同编号，订单编号） 
                            "DJID": 535197949432320, // 业务来源主键id（如：合同id，订单id） 
                            "DSFDJID": "535197902893568", // 引用主表三方id(非必填)
                            "DJMXID": 535197950972417, // 业务来源材料主键id（如：合同材料行id，订单材料行id）
                            "DSFDJMXID": "535154169925632" // 引用材料表三方id (非必填)                  
                           }
                        ],
                        "surcharges": [ //附加费（非必填）
                          {
                            "code": "",//附加费编码
                            "id": 497012551827968,//主键id
                            "name": "附加费3",//附加费名称
                            "source": 1,//附加费来源 1：本项目附加费，2合同附加费
                            "unit": "",//附加费单位（非必填）
                            "unitId":""//附加费三方id（非必填）
                          }
                        ],
                        "deductionName": "扣数", //材料扣数名称（非必填）
                        "deductionValue": "22.7", //材料扣数量（非必填）
                        "SSLLSL": 0.0,//实收理论数量（非必填）,
                        "manufacturerName": "上海中首建筑劳务有限公司", //生产厂家名称（非必填）
                        "manufacturerExtraId": "2BEAD54E4BB64C2C", //生产厂家三方id（非必填）
                        "manufacturerValue": "1439705",//生产厂家物料侧id（非必填）,
                        "providerId": "354897841987454187", //供应商id（非必填）
                        "providerName": "北京金杰混凝土有限公司", //供应商名称（非必填）
                        "providerCode": "BJJJHNT",//供应商编码（非必填）,
                        "providerUnitId": "2D824FSD911",//供应商三方id（非必填）,
                        "PCLX": "吨", //偏差类型（非必填）
                        "ZC": "2.0",//正差（非必填）,
                        "FC": "-2.0",//负差（非必填）,
                        "aiMaterialInfo": { //ai材料信息
                            "realWeightType": 0,// 实际理重类型( 0:手输， 1：运单理重 2：已点理重)
                            "lengthPerMeter": 10.0,// 单根米长
                            "realWeight": 1.741,// 实际理重
                            "checkWeight": 1.741,// 已点理重
                            "materialId": 342975111211520,// 材料id
                            "manufacturer": "",//生产厂家
                            "totalBundle": 1,//总捆数
                            "createTime": 1678156521000,
                            "billId": 741112652820992,//磅单ID
                            "rowTimestamp": 1678156521000,
                            "billMaterialId": 741112652673537,// 云端磅单材料表行id
                            "billWeight": 1.7,// 运单理重
                            "id": 741112652820994,
                            "diam": 28.0//直径
                        }, 
                      "aiRecords": [ //ai点根图片记录
                            {
                                "aiImgKey": "DYD/E23F5B57-FB3B-44D9.jpg",// ai识别图片key
                                "aiDistinguishNumber": 36,// ai 点根数量
                                "materialId": 342975111211520,//材料id
                                "aiRealWeight": 1.741,// ai实际理重
                                "aiCqblNumber": 36,// ai查缺补漏根数
                                "createTime": 1678156521000,
                                "billId": 741112652820992,//磅单ID
                                "rowTimestamp": 1678156521000,
                                "billMaterialId": 741112652673537,//云端磅单材料表行id
                                "id": 741112652820995,//记录id
                                "aiRealNumber": 36// ai实际根数
                            }
                        ]
                    }
                ],
                "BDImgs": [ //（非必填）
                    {
                        "FL": 32, // 图片分类0:称毛(磅房、顶部、后部、前部); 1:称皮(磅房、顶部、后部、前部); 2:运单; 5:报表; 8: 称毛车牌图片; 16: 称毛车图片; 32: 称皮车牌图片; 64: 称皮车图片; -1:历史图片;128:出门条;256施工方授权人签名图片; （当单据来源是移动验收时：32: 移动验收/移动发料图片; 64: 电子签名图片;）            
                        "MS": "验收单", // 描述 （非必填）
                        "ReadKey": "DYD/e5b99cbf-4362-4964-98bc-afc7b5ceb3aa.jpg", // 图片KEY （必填）
                        "billId": 307318752133120, // 磅单ID （必填）
                        "extensionName": ".jpg", // 扩展名 （非必填）
                        "id": 307318752133122, // 主键 （必填）
                        "projectId": 1456353, // 项目ID （必填）
                        "tenantId": 1454006 // 租户ID （必填）
                    }
                ],
                "YSYJ": [ //（非必填）
                    {
                        "LX": "PURCHASEWAYBILL", // 类型  "PURCHASEWAYBILL：运单 PROJECT_ORDER：订单 MATERIAL_REQUISITION：申请单 PURCHASECONTRACT：采购合同"
                        "BM": "CWTHT20210517341T", // 业务单据编号（如：合同编号，订单编号）
                        "DJID": 535197949432320, // 业务来源主键id（如：合同id，订单id） 
                        "DSFDJID": "535197902893568" // 引用主表三方id(非必填)
                    }],
                "id": 2035585, //云端材料表单据主键ID （必填）
                "GUID": "2ddff2d9-050d-4fc9-97e4-36f95d4bf316", //单据GUID 唯一 （必填）
                "projectCode": "110603090000*1#", //项目编码 （非必填，重要 一般与三方系统中的项目编码相同 三方系统中同步编码有值，此编码才能拿到值）
                "projectId": 1459807, //项目ID（物料验收云端项目ID）（必填）
                "BFBM": "", //磅房编码(非必填)
                "BZ": "", //备注(非必填)
                "CCSJ": "20170228100645", //出厂时间(非必填)
                "CMSJ": "20170228100645", //称毛时间(非必填)
                "CPSJ": "20170228100645", //称皮时间  自动回皮时，cpsj为空(非必填)
                "ZHXGSJ": "20170228102027", //最后修改时间（必填）
                "PZ": 1, //皮重(非必填)
                "MZ": 11, //毛重(非必填)
                "JZ": 10, //净重(非必填)
                "CPH": "鲁123138", //车牌号 （必填）
                "DJLY": "补录", //单据来源 有四种类型：“称重”、“补录”、“移动验收”、“移动发料”（必填）
                "DSFGYSID": "1854594100", //第三方供应商ID（重要 三方系统中的供应商ID）（非必填）
                "GSGYSID": 1538150, //供应商ID（物料验收系统中ID）（必填）
                "GYSBM": " C1016097", //供应商编码（必填）
                "GYSMC": "贵州晟东南物资有限公司", //供应商名称（必填）
                "DWGC": "", // 单位工程 （非必填）
                "DYCS": 0, //打印次数（必填）
                "GBDW": "吨",//过磅单位  （必填）
                "GBY": "系统管理员", //过磅员（必填）
                "LX": 0, // 类型，0收料，1发料（必填）
                "LX_YT": "采购", // 子类型，收料（采购、调入、甲供、退货、直入直出），发料（发料、废旧物资、调出、售出） （必填）
                "billTypeId": 1, //单据子类型id  1：采购 7：调入 6：甲供 16：退货 1024：直入直出；4：废旧物资 8：调出 5：售出 9：发料 64：其他磅单 （必填）
                "sendOnReceive": false, //是否直入直出单； 是  true， 否  false
                "PCJG": 0, // 偏差结果，0正常 1超正差 -1 超负差（必填）
                "SJZLHJ": 10, //实际重量合计(非必填)
                "STATUS": 1, // 1正常 0 作废 （必填）
                "JD": 116.288654,  //经度（非必填）
                "WD": 40.050890,  //纬度（非必填）
                "SYBW": "笔架山隧道横洞", //使用部位 （非必填）
                "SYBW": 323545900234, //使用部位ID （非必填）
                "usePositionUnitId": "adbddeggdadeceeds001", //使用部位三方id （非必填）
                "SingleMaterial": true, //是否单物资   是：true 否：false  （必填）
                "Timestamp": "20170228102055000", //时间戳(数据库级时间戳，无业务意义)
                "YDXCZLHJ": 10, //运单下差重量合计 (非必填)
                "YDZLHJ": 11, //运单重量合计 (非必填)
                "YSDJBH": "12312313", //原始单据编号 （非必填）
                "ZDHP": false, //是否自动回皮 是：true 否：false (非必填)
                "billUrl": "/inspection/page/bill.html?billId=2035585&idType=1&billType=0", //单据短地址 （物料验收云端链接地址 若为作废单据那么此地址无效） （必填）
                "KFBM": "08", //库房编码（非必填）
                "KFMC": "3#生产库房", //库房名称  （非必填）
                "warehouseUnitId": "6267CFDF20000001186415422222", //第三方库房集成编码 （非必填）
                "TYSHXXDM": "tyshxydm1997iso9001", //统一社会信用代码   （非必填）
                "ANOTHER_TYSHXXDM": "tyshxydm1997iso9001", //直入直出中的收料供应商统一社会信用代码 (非必填)
                "globalStatus": 0, //业务状态：1未确认/待确认,2已确认,4已对账,6已对账确认,8已入库，32部分入库（必填）
                "KZSX": "",    //扩展属性 (非必填)
                "transportCompanyValue":"534161978617856",//运输单位id(非必填)
                "transportCompanyName":"中铁十七局物资有限公司",//运输单位名称(非必填)
                "CJSJ": "20201106195345",//创建时间（非必填）
                "PZPC": 0.0,  // 车皮重量偏差(非必填)
                "CLPCBL": 0.0,// 车辆偏差比例（非必填）
                "IsHaveImage":true,//是否包含图片（非必填）
                "DSFHTID": "20300",//第三方合同id(非必填)
                "HTID": 232056848171008,//合同id(非必填)
                "HTBM": "WTHT20171024001-050",//合同编码(非必填)
                "HTMC": "配砖合同（旭明）",//合同名称(非必填)
                "COMMIT": false,//是否提交(非必填)
                "EFFECT": true,//生效标识(非必填)
                "LASTUPDATETIME": "2021-02-05 09:29:10",//最后修改时间(必填)
                "CCCPH": "京C44444",//出场车牌号(非必填)
                "JCCPH": "京C44444",//进场车牌号(非必填)
                "CJRID": 1440723,//创建人id(非必填)
                "CPSBCPH": "粤A44444",//车牌识别车牌号(非必填)
                "CPSBCPTPLJ": "DYD/265AE796-59DD-41B7-A3F1-6E4040D216B7.jpg",//车牌识别车牌图片路径(非必填)
                "CPSBL": 0.98693,//车牌识别率(非必填)
                "JBRCC": "物料验收测试专用管理员",// 进场经办人(非必填)
                "JBRJC":"物料验收测试专用管理员",//出场经办人(非必填)
                "completionTime": 1597929123000,//出场时间(非必填)
                "SXBS": true//生效标识(非必填)
            }
        ],
        "EndTimestamp": "20170228232323000", //本次数据的结束时间（必填）
        "MaxTimestamp": "20190228232323000", //本次数据的最大时间（必填）
        "PageSize": 2 //（必填）
    }
}

获取磅单数据接口

获取磅单接口

接口说明

重点说明

最佳实践

请求参数属性说明

响应结果字段说明

data字段说明

Bills字段说明（data -> Bills）

BDCL字段说明（data -> Bills -> BDCL）

BDImgs字段说明（data -> Bills -> BDImgs）

YSYJ字段说明（data -> Bills -> YSYJ）

BDCLYSYJ字段说明(data -> Bills -> BDCL -> BDCLYSYJ)

aiMaterialInfo字段说明(data -> Bills -> BDCL ->aiMaterialInfo)

aiRecords字段说明(data -> Bills -> BDCL ->aiRecords)

surcharges字段说明（data -> Bills -> BDCL -> surcharges）

返回结果格式

results matching ""

No results matching ""