四川省汽车维修电子健康档案系统对接规范

全国汽车电子健康档案系统

2019年3月

前言

四川省汽车维修电子健康档案平台面向全国维修软件供应商提供免费接口对接服务，请各ERP软件供应商仔细阅读对接规范，对接前需获取开发ApplicationID，获取ApplicationID请发送邮件到：cedk@qq.com 并抄送42362647@qq.com，邮件内容包括：营业执照号码、企业名称、ERP软件名称、联系电话、联系人、法人、地址。其中企业名称、ERP软件名称、联系电话、营业执照号码、详细地址会在对接成功后更新到ERP供应商列表。

第一章 接入要求

1、本规范说明适用于ERP企业对全国汽车维修电子健康档案系统的接入。

2、根据汽车维修电子健康档案系统建设标准（JT/T 1132-2017）、《交通运输部办公厅关于开展汽车维修电子健康档案系统建设工作的通知》（交办运〔2017〕69号）的要求，维修企业应实时、全部、自动上传维修记录数据。由ERP企业为维修企业提供的上传工具必须满足实时、全部、自动上传维修记录数据的功能要求。

第二章 接入指引

2.1 接入需知

请严格按照文档规范内容进行数据请求。

2.2 更新说明

第三章 接入规范

本章规定了请求接口过程中需要遵守规范要求，包括数据接口规范、安全规范以及接口详细信息，对接ERP需按照本章的接入规范开发符合规范要求的应用服务，保证符合汽车电子健康档案系统的接口要求。

3.1 数据接口规范

3.1.1 接口调用方法

POST

文档内示例地址结尾测试地址，正式启用请将http://git.96515.cc:11000/替换为https://archive.12328.tv/

3.1.2 接口请求内容格式

JSON

3.1.3 接口样例(仅作样例示范)

3.1.3.1 维修记录结构图（13个数据元）

3.1.3.2 erp对省级接口(该接口已弃用)

3.1.3.2.1：维修企业注册

接口返回参数：

                    {
                        "applicationid": "vvcc8ss86a31fa0e4ffc9e3ce7df0af2",
                        "companyname":"测试维修企业",
                        "password":"123456789",
                        "licenseno":"wx13565243355",
                        "road_transportation_license":"322669514283X",
                        "address":"前进街办事处江汉路206号",
                        "zip_code":"310006",
                        "economic_category":"100",
                        "category":"1",
                        "link_man":"王大柱",
                        "link_man_tel":"13857225229",
                        "super_intendent_name":"李安",
                        "super_intendent_tel":"13887266396",
                        "business_scope":"周边区域",
                        "road_transportation_license_start":"2016-05-20",
                        "road_transportation_license_end":"2018-09-20",
                        "operation_state":"1",
                        "areacode":"330101",
                        "email":"123456767@qq.com"
                    }
                

                {
                    "status":"注册成功！请上传营业执照图片",
                    "code":"1",
                    "companycode":"330105000235911"
                }
                

3.1.3.2.2 ：获取接口调用凭证

接口URL：

http://git.96515.cc:11000/archive/login

接口参数示例：

            {
                "companycode":"310000006066001" ,
                "password":"88668866",
                "applicationid": "2E46CB08864DC027"
            }
        

接口返回示例：

            {
                "code":"1",
                "status":"登陆成功。",
                "access_token":"3303ce5b02bdb08447f086fcdc5920f9",
                "companycode":"010"
            }
            

3.1.3.2.4 ：新增维修记录

接口返回参数：

接口URL：

http://git.96515.cc:11000/archive/save

接口参数示例：

 
                {
                    "access_token": "17e70e6649cfdbe4bda73278186e293f",
                    "basicInfo": {
                        "platenumber": "川A11231",
                        "platetype": 0,
                        "vin": "3de69a7dc137",
                        "repairdate": "2016-01-01",
                        "miles": "7",
                        "settledate": "2017-01-01",
                        "faultdescription": "后车车灯损坏",
                        "costcode": "0012201010000001",
                        "fueltype":"A",
                        "vehicleusecharacter":"01",
                        "vehicleowner":"XXX运输有限公司",
                        "senduser":"张三",
                        "senduserphone":"13111111111",
                        "brandname":"解放",
                        "enginecode":"000111",
                        "settlemiles":"10"
                    },
                    "stufflist": [{"code":"233","quantity":"2","stuff":"大灯","price":"50.3",
                    "priceunit":"10.2","brand":"sb1","isself":1,"attribute":"原厂"}],
                    "repairitemlist": [{"item":"测试","hours":"20.5","price":"13.1","priceunit":"10.2"}]
                }
            

接口返回示例：

                {
                "code":"1",
                "status":"新增成功"
                }
            

3.1.3.3 代码表

3.1.3.3.1 燃料类型

3.1.3.3.2 企业经营业务类别

3.1.3.3.3 企业经营状态

3.1.3.3.4 企业经济类型

3.1.3.3.5 车牌颜色代码

3.1.3.3.6 车辆使用性质

3.1.3.4 流程图

1：维修企业注册；

2：获取接口调用凭证（调用凭证有效期为2小时，如已获取并在有效期内可以直接执行第3步）；

3：上传营运证件图片，完成注册流程。

4：新增维修记录

3.1.3.5 关于测试

由本平台提供测试ApplicationID，用于ERP开发接口，调用测试接口完成测试后再切换为正式接口即可。

第四章 联系方式

邮箱：twtxxh@qq.com

电话：13688319281(徐)

沟通交流群： 694596478