diff --git a/docs/sheji/汇融接口文档(旧).docx b/docs/sheji/汇融接口文档(旧).docx new file mode 100644 index 0000000..0660123 --- /dev/null +++ b/docs/sheji/汇融接口文档(旧).docx @@ -0,0 +1,2673 @@ + 汇融接口文档 +一.接口接入方式 +本文档中涉及到的所有接口都是采用 HTTP GET/POST 方式。每个请求HEADER需要RSA加密。 + +测试地址域名:http://hf-service.tiefaos.com + + +公钥 +-----BEGIN PUBLIC KEY----- +MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1Z/+Bslu203UtutmzMW/ +FqS9bQvaMXQHgvU+ilNR5Hm2IZZalBWPoSbCGzlCUA19C3X6T17X09OMa6aDPKBm +F6yXvUI7E/nWM9qUJ5hj4zVO/9GoH03WUyCWSBQg4f+LcnLS75v8nI6moOJ5ILkH +mg2KNbEdx55UWjSqBatEopnLWtMFDGZswEbKBH3e2yalK6ddh2kUrtcuQGqFYm/u +ViAOV+KoptwY2MCNSRLKYE4pCA2BCit7nr3EqNZRqqhKaOE44iyv45zCFrllx3nn +wF3X/l+rR4G7Vc7HZwiqKF3RXl9PqmTLJkzhdpAdQX/Kr3SRRHsv/DzKjAZr/2jK +rQIDAQAB +-----END PUBLIC KEY----- + +RSA的测试key值为: +$key = sJI8PuGweKztQ6nLgp3dqcwljdKGFjPBD3XyUqCFsVG8rYhAIbD2AkNIKaefbjOB + +以下每个接口都需携带header参数; +Header参数示例 +data = jiq07RIXsX/YwIkXCK4VdhIZcnuFHd+ERekZzMdZT7yxGAyON4s/qtJeJcG9z6uJMtqSUKWTvREc4CNsyuStXacJ2bGgKCzFcUTwwBUJ7AQ2ybhedpkA7JWqJ1UjooLGUYZfoTduygH2r7LG0qRgigQGD3WdB53WLuC11kT5wAzMnFtbBDHpH78oNjGhvmWpaR6meDCI2OM0GtCWwBxOagCYt8V5DfD47VyNHYn0xFRva4GFBF6K19061h1cu68eXxfIZj+clMweGlICgeXhktq8Z1T0XmbahFjhyTmdXuRxZBeQkLsot00XJHwQ48B6Z/VdOPpqoD95NTngRdV3+A== (加密参数 规则为 $key拼接时间戳拼接md5($key) ) +date = 1683516744 ( 时间戳 11位 时间参数) +测试暂时未做时间验证当前两个参数即可请求所有接口; + + +二.加密方式(RSA) +平台: +名称 +英文 +说明 +提供方 +key + +妥善保存 +山海系统开放平台 +公钥 + +妥善保存 +山海系统开放平台 + + +请求报文示例:{ + "name": "*****", + "area_code": "*****", + "appid": "*****", + .............................. +} + +1.待配货列表 + (1)接口描述 +接口名称 +备货列表 +功能描述 +查看备货信息 +接口地址 +/api/system/apply_material/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +apply_no + +false +7400736700760759034 +申请单号 +username + +false +王玉 +客户姓名 +agent_id + +false +10 +代理商id +status + +false +5 +状态 待库管确认信息-0,库管已确认-1,已撤回-2,待出库审核-3,待提货-4,已交货-5,待交货审核-6 + +search_create_time + +false +2023-05-09 +2023-05-10 +申请日期 +search_check_time + +false +2023-05-09 +2023-05-10 +审核日期 + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +array + +data>>list>>id +备货申请id +string + +data>>list>>apply_no +备货申请编号 +string + +data>>list>>agent_id +代理商id +string + +data>>list>>order_id +所属订单 +string + +data>>list>>storehouse_id +仓库id +string + +data>>list>>status +状态 +string + +data>>list>>create_time +创建时间 +string + +data>>list>>confirm_time +确认备货申请时间 +string + +data>>list>>cancel_time +撤回时间 +string + +data>>list>>workflow_unique +订单标识 +string + +data>>list>>agent_name +代理商名称 +string + +data>>list>>create_time_text +创建时间明文 +string + +data>>list>>confirm_time_text +确认备货申请时间明文 +string + +data>>list>>cancel_time_text +撤回明文 +string + +data>>list>>status_text +状态明文 +string + +data>>list>>storehouse_info +仓库地址 +string + +data>>count +数据条数 +string + + + 2.查看物料实发 + (1)接口描述 +接口名称 +物料实发 +功能描述 +查看物料实发 +接口地址 +/api/system/apply_material/get_actual_order_material +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +备货申请id + + 响应参数 + +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data + +array + +data>>username +名称 +string + +data>>order_no +电站编号 +string + +data>>order_id +电站id +string + +data>>list>>id +电站id +string + +data>>list>>apply_id +申请id +string + +data>>list>>materiel_id +物料id +string + +data>>list>>materiel_no +物料编码 +string + +data>>list>>answer_price +应付价格 +string + +data>>list>>answer_num +应发数量 +string + +data>>list>>actual_price +实际价格 +string + +data>>list>>actual_num +实际数量 +string + +data>>list>>frozen_agent_stock_num +冻结代理商库存数量 +string + +data>>list>>brand_name +品牌 +string + +data>>list>>note +备注说明 +string + +data>>list>>status +状态 +string + +data>>list>>remark +备注 +string + +data>>list>>materiel_group_text +物料分组说明 + + +data>>list>>materiel_name +物料名称 + + +data>>list>>agent_name +代理商名称 + + +data>>list>>apply_no +申请唯一编码 + + +data>>list>>inventory_num +申请数量 + + + + 统计物料 + (1)接口描述 +接口名称 +统计物料 +功能描述 +查看物料 +接口地址 +/api/system/stock_record/get_material_stat +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 + +Null + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data + +array + +data>>materiel_no +物料编号 +string + +data>>name +物料名称 +string + +data>>out_num +出库数量 +string + +data>>inp_num +入库数量 +string + +data>>purchase +采购入库数量 +string + +data>>returninc +退换货入库 +string + +data>>allocationinc +调拨入库 +string + +data>>buyinc +备货下单入库 +string + +data>>sale +销售出库 +string + +data>>returndec +退换货出库 +string + +data>>allocationdec +调拨出库 +string + +data>>buydec +备货下单出库 +string + + + 导出物料 + (1)接口描述 +接口名称 +导出 +功能描述 +导出物料 +接口地址 +/api/system/stock_record/export_data +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 + +Null + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + 导出物料统计 + (1)接口描述 +接口名称 +导出 +功能描述 +导出物料统计 +接口地址 +/api/system/stock_record/material_stat_export +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 + +Null + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + +/api/system/inventory/index + 库存管理 + (1)接口描述 +接口名称 +库存列表 +功能描述 +库存列表 +接口地址 +/api/system/inventory/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +materiel_group + +false +1 +物料组id +materiel_no + +false +1001000045 +物料编号 +materiel_name + +false +逆变器-20 +物料名称 +storehouse_name + +false +山东曲阜 +仓库名称 + + 响应参数 + +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +array + +data>>list>>num +库存数量 +string + +data>>list>>storehouse_name +仓库名称 +string + +data>>list>>materiel_no +物料编号 +string + +data>>list>>materiel_group +物料组id +string + +data>>list>>brand_name +物料品牌 +string + +data>>list>>materiel_name +物料名称 +string + +data>>list>>price +物料单价(成本价) +string + +data>>list>>update_time +最后更新时间 +string + +data>>list>>materiel_group_text +物料组明文 +string + +data>>list>>update_time_text +最后更新时间明文 +string + +data>>count +数据条数 +string + + 出库申请 + (1)接口描述 +接口名称 +出库申请详情 +功能描述 +出库申请详情 +接口地址 +/api/system/out_stock/get_info +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +申请id + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>id +申请id +array + +data>>storehouse_id +入库id +string + +data>>storehouse_name +仓库名称 +string + +data>>batch_number +批次编号 +string + +data>>type +入库类型 +string + +data>>type_text +入库类型明文 +string + +data>>happen_time +入库时间 +string + +data>>admin_name +审核人名称 +string + +data>>supplier_name +供应商名称 +string + +data>>supplier_id +供应商id +string + +data>>create_time +创建时间 +string + +data>>status +审核状态 +string + +data>>opinion_time +审核时间 +string + +data>>link_batch_number +关联批次号 +string + +data>>note +备注 +string + +data>>examine +审核次数 +string + +data>>current_examine +当前审核次数 +string + +data>>maeriel +物料信息 +array + +data>>maeriel>>id + +string + +data>>maeriel>>inventory_record_id +所属申请记录id +string + +data>>maeriel>>batch_number +批次号 +string + +data>>maeriel>>materiel_id +物料id +string + +data>>maeriel>>materiel_no +物料编号 +string + +data>>maeriel>>materiel_name +物料名称 +string + +data>>maeriel>>num +入库数量 +string + +data>>maeriel>>orig_num +原数量 +string + +data>>maeriel>>new_num +更新后数量 +string + +data>>maeriel>>materiel_group +物料组 +string + +data>>maeriel>>update_time +更新时间 +string + +data>>maeriel>>create_time +创建时间 +string + +data>>maeriel>>price +单价 +string + +data>>maeriel>>materiel_group_text +物料组名称 +string + +data>>file +附件文件 +array + +data>>file>>id + +string + +data>>file>>inventory_record_id +其他附件 +string + +data>>file>>voucher +合同id +string + +data>>file>>contract_id +钉钉审批图片 +string + +data>>file>>ding +出货单/供货单 +string + +data>>file>>bill +创建时间 +string + +data>>file>>create_time +合同图片 +string + +data>>file>>contract_pic + +string + +data>>file>>create_time_text +审核 +string + +data>>auth + +array + +data>>auth>>id +审核人id +string + +data>>auth>>inventory_record_id +审核状态 1为通过 ,2为拒绝 +string + +data>>auth>>audit_admin_id +审核说明 +string + +data>>auth>>audit_status +审核次数 +string + +data>>auth>>audit_remark +审核时间 +string + +data>>auth>>type +审核人姓名 +string + +data>>auth>>fin_time +审核时间明文 +string + +data>>auth>>audit_admin_name +审核状态明文 +string + +data>>auth>>fin_time_text +申请id +string + +data>>auth>>audit_status_text +入库id +string + + + 出库审核 + (1)接口描述 +接口名称 +出库审核 +功能描述 +出库审核 +接口地址 +/api/system/out_stock/examine +请求方式 +POST +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +申请id +examine + +true +1 +审核次数 +status + +true +1 +审核状态 +remark + +true +备注 +备注 + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + 出库记录导出 + (1)接口描述 +接口名称 +出库记录导出 +功能描述 +出库记录导出 +接口地址 +/api/system/out_stock/export_data +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +start_happen_time + +false +2023-05-11 +出库开始时间 +end_happen_time + +false +2023-05-13 +出库结束时间 +batch_number + +false +2023050400001 +批次号 +materiel_no + +false +1004000047 +物料编号 +materiel_name + +false +晶科475 +物料名称 +type + +false +220 +出库类型 +out_storehouse_id + +false +10000 +出库仓库 +target_id + +false +1 +提货方id +target_type + +false +1 +提货方类型 + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + 导出出库单 + (1)接口描述 +接口名称 +出库导出 +功能描述 +出库导出 +接口地址 +/api/system/out_stock/export_bill +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true + +记录id + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + + 出库申请记录 + (1)接口描述 +接口名称 +出库申请记录 +功能描述 +出库申请记录 +接口地址 +/api/system/out_stock/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +storehouse_id + +false +10004 +出库仓库id +batch_number + +false +2023050600001 +批次号 +type + +false +200 +出库类型 +happen_time + +false +2023-05-11 +2023-05-19 +发生时间 +target_id + +false +1 +目标id +target_type + +false +agent +-------------------------------------------------------------------------------- +目前类型(agent=代理商类型,agent_stock=代理商库存,customer=用户,storehouse=仓库,supplier=供应商) 目标id不为空时此项必填写 + +admin_id + +false +1 +审核人id +opinion_time + +false +2023-05-11 +审核时间 +status + +false +1 +审核状态1为审核通过,2为审核拒绝,0为待审核 + +current_examine + +false +1 +审核级别1为初审核,2为复审 ,0为无需审核 + + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +Array + +data>>list>>id +审核记录id +string + +data>>list>>storehouse_id +入库仓库id +string + +data>>list>>storehouse_name +入库仓库名称 +string + +data>>list>>batch_number +批次号 +string + +data>>list>>type +入库类型 +string + +data>>list>>type_text +入库类型明文 +string + +data>>list>>happen_time +发生时间 +string + +data>>list>>admin_name +操作人姓名 +string + +data>>list>>supplier_name +供应商名称 +string + +data>>list>>supplier_id +供应商id +string + +data>>list>>create_time +创建记录时间 +string + +data>>list>>status +审核状态 +string + +data>>list>>opinion_time +审核时间 +string + +data>>list>>link_batch_number +关联批次号 +string + +data>>list>>note +备注 +string + +data>>list>>examine +审核次数 +string + +data>>list>>current_examine +当前审核次数 +string + +data>>list>>count +数据条数 +string + + + 出库记录列表 + (1)接口描述 +接口名称 +出库导出 +功能描述 +出库导出 +接口地址 +/api/system/out_stock/get_record_materiel_list +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +storehouse_id + +false +10004 +仓库id +batch_number + +false +2023050600001 +批次号 +start_happen_time + +false +2023-05-09 +开始时间 +end_happen_time + +false +2023-05-11 +解决时间 +materiel_no + +false +1004000047 +物料编码 +materiel_name + +false +晶科475 +物料名称 +type + +false +1 +类型 +target_id + +false +1 +目标id +target_type + +false +agent +目标类型 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + 入库申请 + (1)接口描述 +接口名称 +入库申请详情 +功能描述 +入库申请详情 +接口地址 +/api/system/in_stock/get_info +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +申请id + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>id +申请id +array + +data>>storehouse_id +入库id +string + +data>>storehouse_name +仓库名称 +string + +data>>batch_number +批次编号 +string + +data>>type +入库类型 +string + +data>>type_text +入库类型明文 +string + +data>>happen_time +入库时间 +string + +data>>admin_name +审核人名称 +string + +data>>supplier_name +供应商名称 +string + +data>>supplier_id +供应商id +string + +data>>create_time +创建时间 +string + +data>>status +审核状态 +string + +data>>opinion_time +审核时间 +string + +data>>link_batch_number +关联批次号 +string + +data>>note +备注 +string + +data>>examine +审核次数 +string + +data>>current_examine +当前审核次数 +string + +data>>maeriel +物料信息 +array + +data>>maeriel>>id + +string + +data>>maeriel>>inventory_record_id +所属申请记录id +string + +data>>maeriel>>batch_number +批次号 +string + +data>>maeriel>>materiel_id +物料id +string + +data>>maeriel>>materiel_no +物料编号 +string + +data>>maeriel>>materiel_name +物料名称 +string + +data>>maeriel>>num +入库数量 +string + +data>>maeriel>>orig_num +原数量 +string + +data>>maeriel>>new_num +更新后数量 +string + +data>>maeriel>>materiel_group +物料组 +string + +data>>maeriel>>update_time +更新时间 +string + +data>>maeriel>>create_time +创建时间 +string + +data>>maeriel>>price +单价 +string + +data>>maeriel>>materiel_group_text +物料组名称 +string + +data>>file +附件文件 +array + +data>>file>>id + +string + +data>>file>>inventory_record_id +其他附件 +string + +data>>file>>voucher +合同id +string + +data>>file>>contract_id +钉钉审批图片 +string + +data>>file>>ding +出货单/供货单 +string + +data>>file>>bill +创建时间 +string + +data>>file>>create_time +合同图片 +string + +data>>file>>contract_pic + +string + +data>>file>>create_time_text +审核 +string + +data>>auth + +array + +data>>auth>>id +审核人id +string + +data>>auth>>inventory_record_id +审核状态 1为通过 ,2为拒绝 +string + +data>>auth>>audit_admin_id +审核说明 +string + +data>>auth>>audit_status +审核次数 +string + +data>>auth>>audit_remark +审核时间 +string + +data>>auth>>type +审核人姓名 +string + +data>>auth>>fin_time +审核时间明文 +string + +data>>auth>>audit_admin_name +审核状态明文 +string + +data>>auth>>fin_time_text +申请id +string + +data>>auth>>audit_status_text +入库id +string + + + 入库导出 + (1)接口描述 +接口名称 +入库导出 +功能描述 +入库导出 +接口地址 +/api/system/in_stock/export_data +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +start_happen_time + +false +2023-05-09 +入库开始时间 +end_happen_time + +false +2023-05-11 +入库结束时间 +batch_number + +false +2023040400007 +批次号 +materiel_no + +false +1001000055 +物料编号 +materiel_name + +false +天合660 +物料名称 +type + +false +10 +入库类型 +inp_storehouse_id + +false +20 +入库仓库 +target_id + +false +1 +来源id +target_type + +false +agent +来源类型 + + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + 入库单导出 + (1)接口描述 +接口名称 +入库单导出 +功能描述 +入库单导出 +接口地址 +/api/system/in_stock/export_bill +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +申请id + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + 入库申请 + (1)接口描述 +接口名称 +入库申请 +功能描述 +入库申请 +接口地址 +/api/system/in_stock/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +storehouse_id + +false +10004 +入库仓库id +batch_number + +false +2023040400007 +批次号 +type + +false +10 +入库类型(参考入库类型接口) +happen_time + +false +2023-05-09 +2023-05-11 +发生时间 +target_id + +false +1 +目标id +target_type + +false +agent +目标类型 +admin_id + +false +1 +审核人id +opinion_time + +false +2023-05-1 +审核时间 +status + +false +1 +审核状态 1为审核通过,2为审核拒绝,0为待审核 +current_examine + +False +1 +审核级别 1为初审核,2为复审 ,0为无需审核 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +array + +data>>list>>id +审核记录id +string + +data>>list>>storehouse_id +入库仓库id +string + +data>>list>>storehouse_name +入库仓库名称 +string + +data>>list>>batch_number +批次号 +string + +data>>list>>type +入库类型 +string + +data>>list>>type_text +入库类型明文 +string + +data>>list>>happen_time +发生时间 +string + +data>>list>>admin_name +操作人姓名 +string + +data>>list>>supplier_name +供应商名称 +string + +data>>list>>supplier_id +供应商id +string + +data>>list>>create_time +创建记录时间 +string + +data>>list>>status +审核状态 +string + +data>>list>>opinion_time +审核时间 +string + +data>>list>>link_batch_number +关联批次号 +string + +data>>list>>note +备注 +string + +data>>list>>examine +审核次数 +string + +data>>list>>current_examine +当前审核次数 +array + +data>>count +数据条数 +string + + 入库审核 + (1)接口描述 +接口名称 +入库审核 +功能描述 +入库审核 +接口地址 +/api/system/in_stock/examine +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +记录id +examine + +true +1 +审核次数 +status + +true +1 +审核状态 +remark + +true +备注 +备注 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + + + 入库记录 + (1)接口描述 +接口名称 +入库记录列表 +功能描述 +入库记录列表 +接口地址 +/api/system/in_stock/get_record_materiel_list +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +storehouse_id + +false +1 +仓库id +batch_number + +false +2023040400007 +批次号 +start_happen_time + +false +2023-05-09 +开始时间 +end_happen_time + +false +2023-05-11 +解决时间 +materiel_no + +false +1001000055 +物料编码 +materiel_name + +false +天合660 +物料名称 +type + +false +1 +类型 +target_id + +false +1 +目标id +target_type + +false +agent +目标类型 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list +数据 +array + +data>>list>>actual_price +批次总金额 +string + +data>>list>>admin_name +经办人 +string + +data>>list>>batch_number +批次号 +string + +data>>list>>brand_name +品牌 +string + +data>>list>>create_time +创建时间 +string + +data>>list>>happen_time +申请时间 +string + +data>>list>>materiel_group_text +物料组 +string + +data>>list>>materiel_name +物料名称 +string + +data>>list>>materiel_no +物料编号 +string + +data>>list>>new_num +更新后的数量 +string + +data>>list>>num +本次操作数量 +string + +data>>list>>orig_num +原数量 +string + +data>>list>>price +单价 +string + +data>>list>>status +审核状态 +string + +data>>list>>type +类型 +string + +data>>list>>storehouse_name +仓库名称 +string + +data>>list>>unit +物料单位 +string + +data>>list>>source_name +来源名称 +array + +data>>list>>source_type +来源类型 +string + + + 出入库记录 + (1)接口描述 +接口名称 +出入库记录列表 +功能描述 +出入库记录列表 +接口地址 +/api/system/stock_record/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +record_type + +false +1 +1为出库 2为入库 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list +数据 +array + +data>>list>>materiel_name +批次总金额 +string + +data>>list>>brand_name +经办人 +string + +data>>list>>materiel_no +批次号 +string + +data>>list>>batch_number +品牌 +string + +data>>list>>materiel_group_text +创建时间 +string + +data>>list>>num +申请时间 +string + +data>>list>>price +物料组 +string + +data>>list>>actual_price +物料名称 +string + +data>>list>>unit +物料编号 +string + +data>>list>>admin_name +更新后的数量 +string + +data>>list>>storehouse_name +本次操作数量 +string + +data>>list>>happen_time +原数量 +string + +data>>list>>type +单价 +string + +data>>list>>status +审核状态 +string + +data>>list>>orig_num +类型 +string + +data>>list>>new_num +仓库名称 +string + +data>>list>>create_time +物料单位 +string + +data>>list>>source_name +来源名称 +string + +data>>list>>source_type +来源类型 +string + +data>>count +数据条数 +string + + + 出入库合同详情 + (1)接口描述 +接口名称 +出入库合同详情 +功能描述 +出入库合同详情 +接口地址 +/api/system/purchase_contract/get_info +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +id + +true +1 +合同id + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>id +合同id +string + +data>>type +合同类型 1为代理商授权运维合同 2采购合同 3电站销售合同 +string + +data>>contract_name +名称 +string + +data>>contract_date +批次合同签订的时间 Y-m-d +string + +data>>pic +文件地址 +string + +data>>create_time +创建时间 +string + +data>>ident_id +关联id +string + +data>>ident_type +关联类型 (supplier=供应商,agent=代理商,customer=客户) +string + +data>>contract_no +合同编号 +string + + + 预付款仓库 + (1)接口描述 +接口名称 +预付款仓库 +功能描述 +预付款仓库 +接口地址 +api/system/stock_record/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +storehouse_type + +true +1 +仓库类型 必须为1 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list +数据 +array + +data>>list>>materiel_name +批次总金额 +string + +data>>list>>brand_name +经办人 +string + +data>>list>>materiel_no +批次号 +string + +data>>list>>batch_number +品牌 +string + +data>>list>>materiel_group_text +创建时间 +string + +data>>list>>num +申请时间 +string + +data>>list>>price +物料组 +string + +data>>list>>actual_price +物料名称 +string + +data>>list>>unit +物料编号 +string + +data>>list>>admin_name +更新后的数量 +string + +data>>list>>storehouse_name +本次操作数量 +string + +data>>list>>happen_time +原数量 +string + +data>>list>>type +单价 +string + +data>>list>>status +审核状态 +string + +data>>list>>orig_num +类型 +string + +data>>list>>new_num +仓库名称 +string + +data>>list>>create_time +物料单位 +string + +data>>list>>source_name +来源名称 +string + +data>>list>>source_type +来源类型 +string + +data>>count +数据条数 +string + + 仓库列表 + (1)接口描述 +接口名称 +仓库列表 +功能描述 +仓库列表 +接口地址 +/api/system/storehouse/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +字段 +类型 +必须 +参数示例 +说明 +storehouse_code + +false +1 +仓库编号搜索 +storehouse_name + +false +安阳山海库 +仓库名称 + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +array + +data>>list>>id +仓库id +string + +data>>list>>storehouse_code +仓库编码 +string + +data>>list>>storehouse_name +仓库名称 +string + +data>>list>>area_id +区域id +string + +data>>list>>address +详细地址 +string + +data>>list>>status +仓库状态 +string + +data>>list>>remarks +仓库备注 +string + +data>>list>>storehouse_type +仓库类型 +string + +data>>list>>create_time +创建时间 +string + +data>>list>>data_id +数据分组 +string + +data>>list>>examine +审核次数(进销存审核次数) +string + +data>>list>>delivery_examine +是否交货审核 1为审核,2为不审核 +string + +data>>list>>area_list +地区数组 +array + +data>>list>>area_list>>id +地区id +string + +data>>list>>area_list>>name +地区名称 +string + +data>>list>>area_list>>level +地区级别 +string + +data>>list>>area_list>>parent_code +地区父级唯一编码 +string + +data>>list>>area_list>>area_code +地区唯一编码 +string + +data>>list>>area_list>>lng +经度 +string + +data>>list>>area_list>>lat +纬度 +string + +data>>list>>area_text +地区说明 +string + +data>>list>>create_time_text +创建时间说明 +string + +data>>count +数据条数 +string + + 获取供应商 + (1)接口描述 +接口名称 +供应商列表 +功能描述 +供应商列表 +接口地址 +/api/system/supplier/index +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +Null + 响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +array + +data>>list>>id +供应商id +string + +data>>list>>supplier_name +供应商名称 +string + +data>>list>>supplie_grade +供应商星级 +string + +data>>list>>materiel_group +物料组 +string + +data>>list>>link_man +联系人 +string + +data>>list>>link_phone +联系方式 +string + +data>>list>>create_time +创建时间 +string + +data>>list>>update_time +修改时间 +string + +data>>list>>data_id +数据分组 +string + +data>>list>>c_t +创建时间 +string + +data>>list>>group_name +分组名称 +string + +data>>count +数据条数 +string + + + diff --git a/docs/sheji/汇融接口文档.docx b/docs/sheji/汇融接口文档.docx index 0660123..cb6102f 100644 --- a/docs/sheji/汇融接口文档.docx +++ b/docs/sheji/汇融接口文档.docx @@ -2670,4 +2670,554 @@ data>>count string + 电站列表 + (1)接口描述 +接口名称 +电站列表 +功能描述 +电站列表 +接口地址 +/api/system/order/index +请求方式 +-------------------------------------------------------------------------------- +POST + +参数格式 + +返回数据格式 +JSON +备注 + + (2)请求参数 +字段 +类型 +必须 +参数示例 +说明 +order_id + +false +105274/20230812155957143430056 + +电站ID/编号搜索 +phone + +false +13502112853 + +用户手机号 +username + +false +李文龙 +用户名 +agent_id + +false +9 +代理商ID +详情见接口 +【/api/system/search/get_agent_list】 +product_id + +false +3 +产品筛选 +详情见接口 +【/api/system/search/get_product】 +search_time + +false +["2023-11-08", "2023-11-17"] +录单日期【时间范围】 +area_list + +false +[ + 360760, + 373191, + 373752 +] +地区搜索【省市县id】 +详情见接口 +【/api/system/cnarea/get_info】 +witch_data + +false +26 +区域项目搜索 +详情见接口 +【/api/system/statistic/group_dataid】 +workflow + + +false +"2_3_0_95_1,1_8_0_95_1" +流程状态 +详情见接口【/api/system/search/get_workflow】 + (3)响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>list + +array + +data>>list>>id +电站id +int + +data>>list>>order_no +电站编码 +string + +data>>list>>admin_id +创建人id +int + +data>>list>>customer_id +客户id +int + +data>>list>>agent_id +代理商id +int + +data>>list>>product_id +产品id +int + +data>>list>>create_time +创建时间 +string + +data>>list>>data_id +数据分组 +string + +data>>list>>workflow_unique +当前流程 +string + +data>>list>>prototype_id +产品id +int + +data>>list>>remain_unique + +string + +data>>list>>is_best +是否为标杆电站 +string + +data>>list>>order_type +电站类型 +int + +data>>list>>update_time +修改时间 +string + +data>>list>>company_id +公司id +int + +data>>list>>dg_name +数据分组说明 +string + +data>>list>>contract_life +合同年限 +string + +data>>list>>contract_group +合同组 +string + +data>>list>>agent_name +代理商名称 +string + +data>>list>>area_id +地区id +int + +data>>list>>address +详细地址 +string + +data>>list>>component_number +光伏板块数 +int + +data>>list>>component_power +组件安装功率 +int + +data>>list>>admin_name +业务员姓名 +string + +data>>list>>admin_phone +业务员手机号 +int + +data>>list>>user_name +用户名 +string + +data>>list>>user_phone +用户手机号 +int + +data>>list>>id_card +用户身份证号 +int + +data>>list>>product_name +产品名称 +string + +data>>list>>workflow_name +流程名称 +string + +data>>list>>node_id +nodeID +int + +data>>list>>is_agree +审核是否通过 +string + +data>>list>>group_id +产品ID +int + +data>>list>>sign +是否签署合同,1已签署,2未签署 +int + +data>>list>>uplode_contract +手动上传-合同 +string + +data>>list>>company_name +所属公司名称 +string + +data>>list>>province_name +省 +string + +data>>list>>city_name +市 +string + +data>>list>>area_name +区/县 +string + +data>>list>>assets_no +资产编号 +int + +data>>list>>change_order_id +电站变更id +int + +data>>list>>p_agent_name +代理商名称 +string + +data>>list>>operation_id +运维id +int + +data>>list>>operation_name +运维名称 +string + +data>>list>>all_power +总功率 +int + +data>>list>>order_type_text +产品说明 +string + +data>>list>>is_save +是否可编辑 +int + +count +总条数 +int + + + + 流程状态 + (1)接口描述 +接口名称 +流程状态 +功能描述 +流程状态 +接口地址 +/api/system/search/get_workflow +请求方式 +-------------------------------------------------------------------------------- +POST + +参数格式 + +返回数据格式 +JSON +备注 + + (2)请求参数 +Null + (3)响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>name + +流程状态名称 +string + +data>>unique_name + +value +string + + + + 地区接口 + (1)接口描述 +接口名称 +地区列表 +功能描述 +地区列表 +接口地址 +/api/system/cnarea/get_info?area_code=0 +请求方式 +GET +参数格式 + +返回数据格式 +JSON +备注 + + (2)请求参数 +字段 +类型 +必须 +参数示例 +说明 +area_code + +false +0 +地区编码 + (3)响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>id +地区id +int + +data>>name +地区名称 +string + +data>>area_code +地区编码 三级联动需要参数 +string + + + + 区域接口 + (1)接口描述 +接口名称 +区域列表 +功能描述 +区域列表 +接口地址 +/api/system/statistic/group_dataid +请求方式 +POST +参数格式 + +返回数据格式 +JSON +备注 + + (2)请求参数 +字段 +类型 +必须 +参数示例 +说明 +group_id + + +false +0 + + (3)响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>data_id +区域id +int + +data>>name +区域名称 +string + + + + + 产品接口 + (1)接口描述 +接口名称 +产品列表 +功能描述 +产品列表 +接口地址 +/api/system/search/get_product +请求方式 +POST +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 +null + (3)响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>id +产品id +int + +data>>name +产品名称 +string + + + 代理商列表 + (1)接口描述 +接口名称 +代理商列表 +功能描述 +代理商列表 +接口地址 +/api/system/search/get_agent_list +请求方式 +POST +参数格式 + +返回数据格式 +JSON +备注 + + 请求参数 + null + (3)响应参数 +参数名称 +参数说明 +类型 +备注 +code +200代表成功 203代表缺少参数 400代表失败 302代表加密数据错误 +integer(int32) + +msg +处理消息 +string + +data +数据 +object + +data>>id +代理商id +int + +data>>name +代理商名称 +string +