Danduola单多啦

单多啦接口平台简介
获取用户信息接口
获取单据信息接口
单据签收接口
单据补扫接口
消息通知接口
单据实物状态通知
获取打印文件接口
修改单多啦单据状态
单多啦接口平台简介

单多啦接口平台,里面详细的记载了单多啦智能收单机器人标准功能对接所需要的接口信息。每个接口均包含了接口的描述、使用场景以及调用方式,第一次采购单多啦智能收单机器人时,如果仅使用标准功能,可与现行的费控、OA、影像等系统,根据单多啦接口平台记录的接口出入参数沟通实际对接的工作量及工作难度。单多啦接口平台记录的接口信息可支持单多啦全部系列产品的对接工作,单多啦通过自身的软件实力,封装了绝大多数的工作,与客户系统的集成全部浓缩在了少数接口当中,从而实现客户应用的快速交付。如果客户对单多啦智能收单机器人有不同的使用需求,单多啦也可以根据客户的需要提供定制化开发服务。
获取用户信息接口

接口提供方与使用方   

提供方—客户系统 使用方—单多啦

接口实现方式

http post+json

接口功能描述
接口概述:用户操作设备前进行身份认证,从而记录当前操作人身份及权限。
请求参数  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

用户账号

 
 

userAccount

 
 

false

 
 

string

 
 

zhangsan03

 
 

登录人账号

 
 

用户密码

 
 

password

 
 

false

 
 

string

 
 

123456

 
 

登录人密码

 
 

IC卡号

 
 

icCardNo

 
 

false

 
 

string

 
 

0123456789

 
 

IC卡号

 
 

登录方式

 
 

loginType

 
 

true

 
 

bool

 
 

true

 
 

登录方式

1:账号密码登录

2:人脸识别登录

 


返回值
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明,如果不允许投递时,按照此消息提示

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 
 

返回数据

 
 

data

 
 

true

 
 

object

 
 

根据接口返回请求具体数据

 
 

用户状态

 
 

data>>userStatus

 
 

true

 
 

int

 
 

1

 
 

用户是否可以登录1:可登录;2:不可登录

 
 

用户账号

 
 

data>>userAccount

 
 

true

 
 

string

 
 

zhangsan03

 
 

用户账号

 
 

用户姓名

 
 

data>>userName

 
 

true

 
 

string

 
 

张三

 
 

用户姓名

 
 

组织编码

 
 

data>>orgCode

 
 

true

 
 

string

 
 

KH01

 
 

用户所属组织编号

 
 

组织名称

 
 

data>>orgName

 
 

true

 
 

string

 
 

客户01

 
 

用户所属组织名称

 


请求示例

{

   "userAccount":"zhangsan03",

   "password":"123456",

   "icCardNo":null,

   "loginType":

}

返回值示例

{

   "code": 200,

   "msg": "success",

   "data": {

   "userStatus": 1,

   "userAccount": "zhangsan03",

   "userName": "张三",

   "orgCode": "KH01",

   "orgName": "客户01"

   }

}


获取单据信息接口

接口提供方与使用方

提供方—客户系统 使用方—单多啦

接口实现方式

http post+json


接口功能描述
接口概述:通过封面条码查询单据信息,校验单据是否可投递,并获取单据初审等功能所需要的单据信息。
请求参数  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

单据编码

 
 

billCode

 
 

true

 
 

string

 
 

KH123456

 
 

识别条码

 


返回值  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 
 

返回数据

 
 

data

 
 

true

 
 

object

 
 

 
 

根据接口返回请求具体数据

 
 

单据状态

 
 

data>>billStatus

 
 

true

 
 

int

 
 

1

 
 

单据是否可以投递1:可投递;2:不可投递

 
 

单据编码

 
 

data>>billCode

 
 

true

 
 

string

 
 

KH123456

 
 

单据编码

 
 

单据类型

 
 

data>>billType

 
 

true

 
 

string

 
 

1

 
 

单据类型编号

 
 

制单人账号

 
 

data>>makerAccount

 
 

true

 
 

string

 
 

zhangsan03

 
 

制单人账号

 
 

制单人姓名

 
 

data>>makerName

 
 

true

 
 

string

 
 

张三

 
 

制单人姓名

 
 

单位主体编号

 
 

data>>comCode

 
 

true

 
 

string

 
 

0001

 
 

主体编号

 
 

单位主体名称

 
 

data>>comName

 
 

true

 
 

string

 
 

客户

 
 

主体名称

 
 

单位主体名称

 
 

data>>comTaxNo

 
 

true

 
 

string

 
 

abc123

 
 

主体税号

 
 

发票信息列表

 
 

data>>invoiceInfoList

 
 

false

 
 

array

 
 

 
 

 
 

发票代码

 
 

data>>invoiceInfoList>>invoiceCode

 
 

false

 
 

string

 
 

031001900211

 
 

发票代码

 
 

发票号码

 
 

data>>invoiceInfoList>>invoiceNumber

 
 

false

 
 

string

 
 

24576116

 
 

发票号码

 
 

不可投递原因

 
 

data>>errorInfo

 
 

false

 
 

string

 
 

 
 

不可投递原因

 


请求示例

{

   "billCode": " KH123456"

}

返回值示例

{

  "code": 200,

"msg": "success",

"data": {  

"billStatus": 1,  

"billCode": "KH123456",  

"billType": "1",  

"makerAccount": "zhangsan03",  

"makerName": "张三",  

"comCode": "0001",  

"comName": "客户",  

"comTaxNo": "abc123",  

"invoiceInfoList": [

   {

   “invoiceCode”:”031001900211”,

   “invoiceNumber”:”24576116

   },

   {

   “invoiceCode”:”031001900211

   “invoiceNumber”:”24576116

   }  

           ]  

              "errorInfo": null

   }

}

单据签收接口

提供方—客户系统 使用方—单多啦  

接口实现方式

http post + json

接口功能描述
接口概述:通过该接口通知客户系统单据的签收状态,并传递影像及其他相关信息

请求参数


 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

单据条码

 
 

billCode

 
 

true

 
 

string

 
 

KH123456

 
 

单据唯一值

 
 

审核结果

 
 

checkResurt

 
 

true

 
 

int

 
 

1

 
 

初审是否通过

 

0:未通过

 

1:通过

 
 

影像列表

 
 

imageList

 
 

true

 
 

array

 
 

 
 

影像列表

 
 

影像链接

 
 

imageList>>imageurl

 
 

true

 
 

string

 
 

http://  image1.jpg

 
 

影像文件下载地址

 
 

OCR数据

 
 

imageList>>ocrDataList

 
 

false

 
 

array

 
 

 
 

OCR数据列表

 
 

发票代码

 
 

imageList>>ocrDataList>>invoicecode

 
 

false

 
 

string

 
 

1100194131

 
 

发票代码

 
 

发票号码

 
 

imageList>>ocrDataList>>invoicenum

 
 

false

 
 

string

 
 

17461575

 
 

发票号码

 
 

OCR其余字段

 
 

imageList>>ocrDataList>>……

 
 

false

 
 

string

 
 

OCR其余字段(内容过多,不一一列举,具体参照OCR文档)

 
 

OCR其余字段(内容过多,不一一列举,具体参照OCR文档)

 
 

错误消息列表

 
 

imageList>>  ocrDataList>>errorMessageList

 
 

false

 
 

array

 
 

[“该发票重复”,”该发票验真错误”]

 
 

错误消息列表

 


返回值
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 


请求示例

{

"billCode": "KH123456",

"checkResurt ": 1,

"imageList": [  

{  

"imageurl": "http://image1.jpg",  

"ocrDataList": [

   {

   "invoicecode": "1100194131",

   "invoicenum": "17461575",

   ......,

   "errorMessageList": [“该发票重复”,”该发票验真错误”]

   },

   {

   "invoicecode": "1100194132",

   "invoicenum": "17461576",

   ...... ,

      "errorMessageList": [“该发票重复”,”该发票验真错误”]

   }  

]  

},  

{  

"imageurl": "http://image2.jpg",  

"ocrDataList": null

}

  ]

}

返回示例

{

  "code": 200,

"msg": "success"

}

单据补扫接口

提供方—客户系统
使用方—单多啦


接口实现方式

http post + json


接口功能描述
接口概述:通过该接口通知客户系统单据的签收状态,并传递影像及其他相关信息。
请求参数
 
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

单据编号

 
 

billCode

 
 

true

 
 

string

 
 

KH123456

 
 

单据唯一值

 
 

影像链接列表

 
 

imageUrlList

 
 

true

 
 

array

 
 

["http://image1.jpg","http://image2.jpg"]

 
 

影像列表

 
返回值  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 
请求示例

{

"billCode": "KH123456",

"imageList": ["imageurl": "http://image1.jpg","http://image2.jpg"]

}

返回示例

{

  "code": 200,

"msg": "success"

}

消息通知接口

接口提供方与使用方

提供方—客户系统 使用方—单多啦

接口实现方式

http post + json


接口功能描述
接口概述:发送设备预警、单据驳回等消息给用户。
请求参数  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

收件人账号

 
 

userAccount

 
 

true

 
 

array

 
 

[“zhangsan03”]

 
 

消息接收人账号列表

 
 

发送人账号

 
 

sendAccount

 
 

true

 
 

string

 
 

danduola

 
 

消息发送人账号

 
 

消息标题

 
 

title

 
 

true

 
 

string

 
 

单多啦退单通知

 
 

消息通知标题

 
 

消息内容

 
 

message

 
 

true

 
 

string

 
 

您的单据被退回

 
 

消息通知内容

 


返回值  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 


请求示例

{

"userAccount": ["zhangsan03"],

  "sendAccount": “danduola”,

"title": "单多啦退单通知",

"message": "您的单据被退回"

}

返回示例

{

  "code": 200,

"msg": "success"

}

单据实物状态通知

接口提供方与使用方

提供方—客户系统 使用方—单多啦  

接口实现方式

http post + json

接口功能描述
接口概述:调用此接口通知客户系统单据实物状态发生变化。


请求参数  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

单据条码

 
 

billCode

 
 

true

 
 

string

 
 

KH123456

 
 

单据唯一编号

 
 

单据状态

 
 

billStatus

 
 

true

 
 

int

 
 

1

 
 

单据实物状态  1:取退件 2:归档 3:取归档件  4:取逾期件

 
 

操作人账号

 
 

userAccount

 
 

true

 
 

string

 
 

zhangsan03

 
 

操作人账号

 
返回值  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 


请求示例

{

"billCode": “KH123456”,

"billStatus": 1,

  “userAccount”: “zhangsan03

}

返回示例

{

  "code": 200,

"msg": "success"

}

获取打印文件接口

接口提供方与使用方     

提供方—客户系统 使用方—单多啦

接口实现方式

http post+json

接口功能描述
接口概述:单据归档时,获取需要打印的pdf文件链接(不包含凭证)。

请求参数  
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

单据编码

 
 

billCode

 
 

true

 
 

string

 
 

KH123456

 
 

识别条码

 


返回值
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明,如果不允许投递时,按照此消息提示

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 
 

返回数据

 
 

data

 
 

true

 
 

array

 
 

根据接口返回请求具体数据

 
 

用户账号

 
 

data>>fileType

 
 

true

 
 

string

 
 

pdf

 
 

打印文件类型

 
 

用户姓名

 
 

data>>fileUrl

 
 

true

 
 

string

 
 

http://acb/1.pdf

 
 

打印文件链接

 


请求示例

{

   " billCode ":"KH123456"

}

返回值示例

{

   "code": 200,

   "msg": "success",

   "data": [

   {

   " fileType ": “pdf”,

   " fileUrl ": “http://acb/1.pdf

   },

   {

   " fileType ": “pdf”,

   " fileUrl ": “http://acb/2.pdf

   }

   ]

}

修改单多啦单据状态

接口提供方与使用方

提供方—单多啦 使用方—客户系统

接口实现方式

http post + json

接口功能描述
接口概述:通知单多啦单据审批通过或驳回并传递凭证文件链接。

请求参数
 
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

单据唯一码

 
 

billCode

 
 

true

 
 

array

 
 

KH123456

 
 

投递单据的封面条码或单据ID,多单据一凭证时同时调用

 
 

单据状态

 
 

billStatus

 
 

true

 
 

int

 
 

1

 
 

1:审核通过(归档)2单据驳回(退单)

 
 

退单原因

 
 

reason

 
 

false

 
 

string

 
 

 
 

单据被驳回的原因

 


返回值
 

名称

 
 

变量名

 
 

必填

 
 

类型

 
 

示例值

 
 

描述

 
 

返回码对应信息

 
 

msg

 
 

true

 
 

string

 
 

请求成功

 
 

返回码对应的文字说明,会提示给用户,返回中文

 
 

返回码

 
 

code

 
 

true

 
 

int

 
 

200

 
 

200:成功;其它:失败

 


请求示例

[{

   "billCode": KH123456",

   "billStatus": 1,

   "reason": null

}]

返回值示例

{

"code": 200,   "msg": "success"

}

首页            产品             价格             关于客户             合作伙伴             新闻资讯             联系我们             试用             产品动态
联系人:宋经理                            联系电话:18363052026                            联系邮箱:yupeng.song@danduola.com                           联系地址:北京市东城区前永康胡同11号