码上放心-码上传接口开通指南

发布时间 2023-12-28 14:23:46作者: 一贴灵

码上放心-码上传接口开通指南(相关技术问题可进群咨询,钉钉群号:67685003096)

平台技术对接支持阿里钉钉群:群号:67685003096
一、什么是码上传服务?
向有开发需求的经营(批发/物流)企业提供码上传接口开发包,企业通过码上接口实现码上放心平台与企业ERP、WMS等信息系统数据对接,实现追溯入出库的自动录入及上传,通过追溯码助力业务管理系统的效率提升;
企业需要有程序开发能力(最好有java语言开发能力),将之前手工做的部分工作由程序完成。主要操作过程是将过去通过客户端上传单据改为由程序读单据文件,并由程序设置往来单位,然后调用我们接口进行上传。
二、开通流程及使用说明
请注意:
(1)请与贵司负责实施的软件商(ERP或WMS、硬件商或信息部门)确认具备对接能力后,再发起开通流程。
(2)本流程仅针对商业公司,若生产企业接口需求,请联系大区负责人联系确认需求场景。
申请APPKEY
接口调用
权限绑定
下载SDK
及权限包
APPKEY
image.png

1、申请appKey及对应的权限包
appkey申请过程请按照下面链接操作指南文档进行操作:
https://qg6r2i.yuque.com/qg6r2i/csvggm/ikhmztw15ig5nxsb?singleDoc# 《码上放心-申请appKey及对应的权限包过程(码上传)》
2、企业appKey(8位数字)权限绑定
企业获取appkey后,请将企业名称和appkey8位数字发给对应大区负责人开通接口权限。负责人联系方式如下:
IXIAOHUANLXH@ALIBABA-INC.COM
ANYEXUE.FYX@ALIBABA-INC.COM
江西,云南,贵州,重庆
陕西,山西,广西,新疆,西藏,青海,宁夏
WANGYICHENG.WYC@ALIBABA-INC.COM
SL160384@ALIBABA-INC.COM
CHENXUEJIAO.CXJ@ALIBABA-INC.COM
湖北,湖南,天津,北凉
HY260647@ALIBABA-INC.COM
吉林,内蒙古,上海
LIRUICHAO.LRC@ALIBABA-INC.COM
IUCHENGEN.LCE@ALIBABA-INC.COM
YISHI.ZJ@ALIBABA-INC.COM
15757115816
广东,海南香港
电话及钉钉号码
5901030572
13018998376
HUIZI.WJGQALIBABAINC.COM
ANPING.XZPGALIBABAINC.COM
甘肃,河南,辽宁
13761868015
15957151960
15726689729
18810996829
四川,黑龙江
18610773205
江苏,福建,台湾
安徽,浙江
13588831269
18611682540
18258231747
陈雪娇
李小欢
范业雪
王佳奇
负责区域
张静
办公邮箱
柳承恩
孙龙
韩颖
负责人
李睿超
王一澄
河北
徐赞平
山山东
976f59b1bf3a5f4de946d6448793495b.png

备注:技术开发人员一定要按下面步骤进行开发练习,细读每一行说明,阅读每一行示例代码
相关技术问题可进群咨询:平台技术对接支持阿里钉钉群:群号:67685003096
注意:
1)若企业信息部门自行对接,请按照上面申请过程文档申请APPKEY;
2)若企业委托第三方软件公司或集团对接,第三方软件公司或集团为首次对接,请按照上面申请过程文档申请APPKEY,若第三方软件公司或集团已有APPKEY,请直接联系表格中的大区负责人绑定;
3、得到appKey和app Secret,下载SDK包。
1)首先进入淘宝开放平台首页:https://open.taobao.com/使用申请appkey的淘宝帐号进行登陆,点“控制台”。
商家与生态伙伴大会
2023淘宝天猫
新机
共进
技术变更|商品接口支持非达尔文类目绑定属性数据更新2023.11.17
规则变更|电商业财管理类目开放接入2023.11.09
引领
THEWAY
淘宝开放平台
首页解决方案开放版图文档中心平台服务
OPPORTUNTY
TOGETHER
观看回放
LEADING
THRIVING
台服务商业合作
进入控制台
NEW
9388
更多>
登录
image.png
2)进入以下页面,可以看到这个appkey所拥有的应用。下面我们示例中是叫做“测试企业码上放心接口对接”。
审核通过ISV申请API权限包流程-应用APPKEY:测试
商品接口支持非达尔文类目绑定属性...
过ISV申请APL权限包流程-应用APPKEY:测试..
2023年双11大促个性化定制商品订单..
2023年好价节大促API服务调整公告..
公告|2023年好价节大促AP服
电商业财管理类目开放接入
审核通过ISV申请API权限包流程-应用AP
务调整公告[12月5日更新)
测试企业码上放心接口对
申请AP1权限包2022-02-11
申请AP权限包2022-02-11
搜索应用名称&APPK
企业追溯码开发平台
申请AP权限包2022-02-11
98158张张
的应用
选择代开发公司
最新审批流程
阿里生态AP开放
仑首页
息服务
选择店铺名称
Q支持
用管理
白聚石货
最新公告
PPKEY:32937056
开放平台
口文档
淘宝
Q工具
量中心
应用名称
开发
全部>
所在类目
O能力
-应用APPKEY:测试..
创建应用
ES
据推送
财务
设置
控告警
操作
单..12/11
状态
连接平台
工单
我的应
奇门
12/川1
云托管
image.png

3)点击“管理”,如下图,在左上角部分,有一个appKey及app Secret,点查看,记录下appKey和app Secret。后面在程序中会使用到这两个值。在功能场景中可以看到您申请的权限包。点击场景介绍中的“详情”按钮,可以看到该权限包的相应接口。
App Key和App Secret作为与阿里开放平台对接的“用户密码”,需要严格保密,不能提供给任何人和其它企业,更不能在联调过程中将Secret发送到人员较多的沟通群中,该“用户密码”应该只出现在系统的服务端,不能出现在客户端系统的代码及配置文件中。调用接口的程序应该放到服务器端,不应该是客户端调用,如果客户端调用,appkey自然就需要放到客户端,这是不行的。
权限包已获得权限包(1)|申请中权限包(0)|可申请权限包(0)|未满足条件权限包(0)
证书流量1000,000次/天预警配置重置流量控制0流量自助申请
提供单据列表以及查询单据详情(包含码)详情
ADDSECRET太大大大大大大大大大大大大*大大太大宣看里置
码上放心开发平台,对ISV提供一组开放API详
授权时长4320.0/小时
码上放心-零售数据下行
试企业码上放心接
码上放心-WES详情
PKEY32937056
上架服务市场否
应用授权等级3级
码上放心-一码上传
节大促API服务
公告|2023年好
务调整公告[12月5日更新
码上放心-WES
码上放心-RDC
码上放心-RDC详
仑云托管
消息服务
Q能力
APP证书
表中心
28314
国财务
凹文档
全中心
@设置
Q工具
Q支持
权限包I
用设置
聚石塔
功能场景
公共场景
全部状态
面开发
30213
淘生
DK下载
8158张张
对接
30157
场景介经
淘宝开放平台
仑首页
已获得
30203
已获得
放平
概览
名称
分类
5返回应用列表
获得
image.png

权限包的名称以您所申请的权限包名称为准:
1、码上传权限包名称为“码上放心-码上传
点击左侧“SDK下载”,选择您要开发时使用的开发语言,点击生成,等待10分钟后重新刷新页面,当生成时间为当前最新时间时,点击下载,可下载到最新的SDK。(本文以java开发语言为例,您在开发时以您实际使用的开发语言进行开发)
NETCORESDK
METADATA
NET
PHPSDK
NETCORE
PHP
PHP7
JAVASDK
整公告[12月5日更新]
NET
PYTHON3SDK
NODC
PHP7SDK
NODEJSSDK
NETSDK
PYTHONSDK
AVABSDK
试企业码上放心接口
公告|2023年好
2023-12-15下载
重新生成
GOSDK
8158张张
5返回应用列表
METADATA
了聚石塔
价节大促API服
重新生成
2023-12-15
023-12-15
GO
CSDK
白文档
SDK下载
淘宝
仑首页
开放平台
2023-12-15
2023-12-15
2023-12-15
重新生成
用设管
Q工具
023-12-15
重新生成
重新生成
O能力
仑云托管
全中心
论设置
表中心
SDK下载
下载
C
息服务
重新生成
对接
19:25:41
服务调整公告
下载
下载
下载
下载
财务
开发
支持
新生成
下载
新生成
新生成
开放平台
image.png

4、接口调用说明
获取自己企业id的方式:进入钉钉群(67685003096),@服务小密 /查询企业ID XXXXXXXX,具体如下所示:
您查询的信息如下:
63B6B977E4B070
查询企业ID测试
ENTLD:63B6B977E4B07O7
NETWORKTYPE:200
@服务小蜜心
14人未读
色机器人
服务小蜜
REFENTLD:
image.png

(1)开始第一个接口调用,得到一个企业的唯一标识接口。
1、  找到这个接口的文档alibaba.alihealth.drug.msc.getentinfo( 根据企业名称查询企业唯一标识【ref_ent_id】和企业ID【ent_id】)
ENT_ID与REF_ENT_ID的说明及区别,当一个企业初次入网时,都会授予一个REF_ENT_ID,初次入网时ENT_ID与REF_ENT_ID相同,当一个企业进行修改企业名称时,企业的REF_ENT_ID不变,但ENT_ID会变为一个新值。也就是说一个企业的REF_ENT_ID是不会变化的,代表一个企业的唯一标识,但ENT_ID会随着企业改名而发生变化,代表一个企业“临时用的标识“。ENT_ID与REF_ENT_ID会用在后面每个接口中。
为什么收发货企业会用ent_id,而不用ref_ent_id,因为业务上有可能上传上个月的出库单据,如果企业在本月改名了,就有了新ent_id,但因为是上传上个月的单据,所以收货企业还要写改名之前的旧ent_id。ref_ent_id对一个企业来说,改名前后是一直不变的,如果收货企业写ref_ent_id,是无法区分收货人是显示旧名称还是新名称。
已获得权限包(11)|申请中权限包(0)|可申请权限包(0)|未满足
证书流量1,000,000次/天预警配置重查流量控制流量自助申请
据列表以及查询单据详情(包含码)详情
码上放心开发平台,对ISV提伴
码上放心-零售数据下
生成环节集成的接口详情
码上放心-RDC详
码上放心-WES详
调整公告[12月5日更新]
授权时长4320.0/
试企业码上放心接
码上放心-码上
上架服务市场否
码上放心-WES
上放心-RDC
5返回应用列表
APPKEY32937056
应用授权等级3级
好价节大促
仑云托管
淘宝开放平台
能场景
支持
30213
应用设置
30157
码上放心-生产环节集
场景介绍
8158张张
聚石塔
安全中心
全部状态
仑首页
淘宝
APPSECRET
大大大大太大大大大大大大太大方大大水宣看重置
限包I
已获得
28314
APP证书
30203
API服务调整公
SDK下载
报表中心
提供单据列表以及查询单
操作
面开发
@设置
国财务
O能力
公共场景
已获得
已获得
消息服务
已获得
文档
分类
概览
Q
电工具
ISV提供一组开放
名称
image.png

找到你想调用的接口:
LIBABA.ALIHEALTH.DRUGMSC.GETENTINFO
AIBABA.ALIHEALTH.DRUG.MSC.G..
据企业名称查询企业唯一标识[REF_ENTID]和企业ID[ENT_ID])
接口名称,例如:ALIBABA.ALIHEALTH.DRUG.MSC-GETENTINFO
ALIBABA.ALIHEALTH.DRUGMSC.S..
LIBABA.ALIHEALTH.DRUG.MSC.U
ALIBABA.ALIHEALTH.DRUG.MSC.D
通过时间段批量查询入出库单信息
LIBABAALIHEALTHDRUGMSC.G.
ALIBABA.ALIHEALTH.DRUG.MS
生产批发企业上传入出库单据接口
IBABA.ALIHEALTH.DRUG.MSC.
2淘宝开放平台
AP输入参数签名结果,签名算法介绍请点击这里
,格式为YYYY-MM-DDHH:MM:SS,时区为GMT+8,例如:2
LIBABA.ALIHEALTH.DRUG.MSC.LI.
码上放心-码上传
公共参数
公共请求参数:
根据企业
户登录授权成功后,T
注明:"需要授权",则此参数必传;"不需要授权",则此参
平台文档中心.API文档
查询单据详情
求地址:
何获得此AP
查询往来单位列表
否采用精简JSON返回格式,仅当FORMATJSOR
TOP分配给应用的APPKEY,例如:123456
MESTAMP
8158张张V
PP_KEY
误码解转
HTTP地址
TPS地址
SIGN_METHOD
STRING
HTTP://GW.API.TAOBAO.COM/ROUTE
第元
BOOLEAN
ETHOD
STRING
STRING
STRING
STRING
STRING
STRING
要传;"可选授权",则此参数为可选
工A具
SIGN
APL接口名称,例如:ALI
(根据企业名称查询企业唯一标
image.png


2、点击您使用的开发语言示例,并将示例代码复制。
ALIBABAALIHEALTHDRUGSCGETENTINFOREQUESTREQ=NEWALIBABAALIHEALTHDRUGMSCGET
ALIBABAALIHEALTHDRUGMSCGETENTINFORESPONSERSP=CLIENT.EXECUTE(
CRET-ENT_ID>320000000000127971</REF_ENT_ID
AOBAOCLIENTCLIENT=NEWDEFAULTTAOBAOCLIENT(URL,APPKEY,SECRET);
根据企业主EAH.DRUG.MSC.G..
EAANEATNDRUGMSOR
</ALIBABA_ALIHEALTH_DRUG_MSC_GETENTINFO_RESP
物流企业音海袋空ATNDRUG.MSC.S..
根据企MAHEALTH.DRUG.MSC
AIBABA.ALIHEALTH.DRUG.MSC.D..
LIBABAALIHEALTH.DRUG.MSC.U
单据外USNEALTH.DRUG.MSC.BI.
<ENT_ID>320000000008127971</ENT_ID>
JAVAPHP.NETCURLPYTHONNODEJS
<NETWORK_TYPE>G9</NETWORK_TYPE>
正业各称营询企业唯一标识89
<MSG_INFO>SUCCESS</MSG_INFO>
REQSETREFENTID("320000000000127G71");
SYSTEMOUT.PRINTLN(RSP.GETBODY());
LIBABA_ALIHEALTH_DRUG_MSC
LIBABA.ALIHEALTH.DRUG.MSC.S..
通过时间段批量查询入出库单信息
REQ,SETENTNAME("测试企业U):
ABABA.ALIHEALTH.DRUGNS
DABA.ALIHEALTH.DRUOM
常示例
询往来单位列表U9.SC.I..
<MSG_CODE>调用成功</MSG_CODE>
<RESPONSE_SUCCESS>TRUE</RESPO
码上放心-码上传
LIBABA.ALIHEALTH.DRUGMSC.S..
,年标识喜看企业详细信意9.
SCGETENTINFORESPONSES
响应参数
应示例
查询单据详情
求示例
</RESULT>
<RESULT>
何获得此AF
误码解释
AP工具
SULTMODE
/MODEL>
异常示例
求示例
应示9
共参
UERESPONSESUCCESSS
EE
XMLJS
回结果
决会型
贷美企业信息安S..
类型
image.png

3、将示例代码复制到开发工具中,并将第三步中得到的appKeyapp Secret,下载SDK包引入到开发工程中,如下:
urlhttps://eco.taobao.com/router/rest所有测试过程,都使用正式环境,不要使用沙箱环境
如果不想使用自已正式企业做测试,可以先和业务同学联系,让业务同学给出测试用的企业名称并授权。
ALIBABALIHEALTHDRUGNSCGETENTINFOREQUVESTREQ=NEWALIBABALIHEATHDRUGMSCETENTINFOREQUEST()
米**太太太水水米欢米大*太水水水水光大大这部分是直接将开放平台的示例代码复制到这里***水***水***水
ALIBABAALIHEALTHDRUGMSCGETENTINFORESPONSERSPCLIENT.EXECUTE
TAOBAOCIENTCLIENTNEWDEFAUTTAOBAOCLIENT(URL,APPKEY,SECRET);
OUT.PRINTLN("接口异常:"+E.GETERRCODE()+"-"+E.GETERRMSG
REQ.SETREFENTID("320000000000127970");
STRINGURL=HTTPS://ECO.TAOBAOCOM/ROUTER/REST"
UBLICSTATICVOIDMAIN(STRINGL]ARGS){
SYSTEM.OUT.PRINTLN(RSP.GETBODY())
>图COMMONS-LOGGING-1.2JARLIBRARYROOT
CMAVER:COMMONS-LOGGING:COMMONS-LOGGINC
[G18>LIBRARY/JAVA/JAVAVIRTUALMACHINES/J
CATCHAPIEXCEPTIONE)
REG.SETENTNAME("测试企业")
PUBLICCLASSTEST
SCRATCHESANDCONSOLES
AOBAO-SDK-JAVA-AUTO_1701765666106-2
STRINGSECRET="FCC59
</3-SELLOUT-0716_01.XML
STRINGAPPKEY="3;
MSCDEMO~/MSCDER
EXTERNALLIBRARIES
VBGETENTINFO
呈RESOURCES
NOUSAGES
TARGET
EXTENSIONS
MPOM.XML
BBILUPLOAD
TEST>MAIN()
>图TAOBAO
OXMLUTIL
59--.-.-2145";
TY
口SRC
.IDEA
NOUSAGES
GMAIN
口JAVA
EMS
口IB
TEST
TOP
OTEST
QAEVG
PUBICSTATICV
OTEST
CMSCDEM
13
28
AAEAV0EWECE93
image.png


4、执行代码,得到请求结果。见下面红圈部分:
,/N,AAUENNNHTUN:TPANSPARTETSOCKET,ADURESS=127.0.0.1:49426,SUSPENDEYSERVER0JAVAGNT:/USERS/2IANGLE/LN
ALIBABALIHEALTHDRUGNSCGETENTINFOREQUESTREQ=NEWALIBABAAIHEALTHDRUGMSCGETENTINFOREQUEST
/欢大大太太水水大大大大水大大大太大大大这部分是直接将开放平台的示例代码复制到这里大太太水水水水水水次次
AYA/JAYAVIRTUALMACHINES/JDK-18.0.1.1.JDK/CONTENTS/HOME/B1N/JAVA-AGENT
ALIBABAALIHEALTHDRUGMSCGETENTINFORESPONSERSPCLIENT.EXECUTEREQ)
ALIHEALTHDPUA_MSC_QETENTINFO,RESPONSE":{"RESULT":{"MODE1":"ENT_ID":"1LC758D69CF074A6291628E4DFD85ET
SYSTEM,OUT,PRINTLN("接口异常:"+E.GETERRCODEQ)+-"+E.GETERRMSGL)
TAOBAOCLIENTCLIENTENEWDEFAUTAOBAOCLIENT(URL,APPKEY,SECRET)
EDFROMTHETARGETVN,ADDRESS:127.0.0.1:49426,TRANSPORT:'SOCKET
TOTHETARGETVM,ADDRESS:127.0.0.1:49426',TRANSPORT:'SOCKET
STRINGURLHTTPS://ECOTAOBAOCOM/ROUTER/REST"
REQ.SETREFENTD("320000000000127970)
PUBLICSTATICVOIDMAIN(STRING[]ARGS)
STRINGSECRETE"FCC861FLED445
SYSTEMOUT.PRINTLNRSP.GETBODY))
DEBUGTHREADS&VARIABLESCONSOLECD
>3COMMONS-LOGGING-1.2JARLIBRARYROOT
REG.SETENTNAME"测试企业"
L场MAVEN:COMMONS-LOGGING:COMMONS-LOGGIN
CATCHAPIEXCEPTIONE
>图TAOBAO-SDK-JAVA-AUTO_1701765666106-2
NISHEDWITHEXITCODE
318>/LIBRARY/JAVA/JAVAVIRTUALMACHINES
PUBLICCLASSTEST
STRINGAPNKEYE"3295"
SCRATCHESANDCONSOLES
</3-SELOUT-0716_01.XML
9426TASP:AM.1758D69CF074
C3MSCDEMO~/MSCDE
BLLUPLOAD
ST>MAIN
HEXTERNALLIBRARIES
回GETENTINFO
MPOM.XML
EXTENSIONS
VRESOURCES
MAIN
V口JAVA
NOUSAGES
OTEST
OXMLUIL
OTEST
口JAVA
V白TOP
TARGET
,2.A.0.1:626,TRANPART:SACETCCPTNKTYPE.280EFENT.JU:C75300T5AS0A
TEST
GMSC
ACOM
NOUSAGES
口SRC
IDEA
口IB
image.png

5、接口有统一的返回格式,具体说明如下
返回对像为alibaba_alihealth_XXX_XXX_XXX,例如下面格式
{
"alibaba_alihealth_drug_msc_xxxx_response": {
"model":""
"msg_code": "",
"msg_info": "",
"response_success": true,
"request_id": "5z317d85s34z"
}
}
解析返回值的说明:
response_success为true时,说明接口调用成功,如果msg_code为SUCCESS说明完全正确直接解析model即可。如果msg_code为WARN开头(比如WARN_SYS、WARN_BIZ),说明有需要注意的信息,此时除了解析model还需要解析msg_info查看具体的告警信息。response_success为false时,说明接口调用失败,此时msg_code以FAIL开头,细分为FAIL_SYS(系统错误)和 FAIL_BIZ(业务错误)等。
6、 上述执行代码示例,示例使用IDEA开发(下面示例双击可以打开)。
码上传示例代码工程-idea.zip(1.1 MB)

7、每个接口,都可以通过一个网页版的测试工具进行调试,强烈建议每个接口都先在这个地方调用测试完成通过后,再进行程序调用
开发者大复
支付宝小程
2023高校季:年轻科技力
淘宝开放平台
开放版图
平台服务
AP文档
平台简介
文档中心
商业合
商家应用
聚石塔
image.png

选择文档中心》》平台简介
空开故平台1IBDA:CPAMRATAM)是基于调宝签类电子骨务业务的月放平台,提供外都含作伙伴参与接务赛宝用产的各块原材料,如业务AR,贴号件系,数偿维选,街门们网关等,它是大海宝电子核务基磁据务的
要开的造径,将准过各行各业定制,创新,进化,并最终促成新简业文调注方围的提立,我们的使宗是把宽室网的离品,用户,交易,物流等一系列电于带务基时接务,像水,电,体一样输进给有需要的顶家,开2
和各项垂直业务的主要流程,日均AP调用量超白亿.无比定从业分开吸的发及,"
淘宝开放平台为外部合作伙伴提供了极大的尚业惩家工问日"...,.,
.2646E以生7吸断均因候式如亦用硝售分成,演空路成交法情,湾宝者上其分队,*"向力以市,7日42"
,L..EAMIUF4,向对罗使开分空台码式自由一不限选高,不限开台(反用然见底,果图,1网如A
国内开放业务规模最大的开放平台.回的,周主
一,什么是淘宝开放平台
平台简介
宝开放平台为各类应用提供了清晰的盈利式,如业
淘宝开放平台所依托的大淘宝,拥有注册用户数以亿
开放规模大,程度深,限制少
文档中心.开放平台
,到TOP能做什么?
一,什么是淘宝开放平台
二,平台特点
开放业务
,社区媒体和各行各业.如何接入,点我了解详情
更新时间:2023-05-16
利模式清晰
开放平台
业务强大,商机无限
.商家自研-商家后台系统
内容创作工具
.商家运营服务
2.商家经营工具
开放业务
常用工具
1.购物小程序
平台简介
.商家自研-小程序
基础技术
石塔云产品
商家应用
,平台特点
开放业务
接入指南
创意小游戏
和淘宝业务需求的多样性为各类合作伙伴提供了
台规则
合作形式丰备
分成,P4P广告分成等,并且还会根据合作伙伴反馈,不断提供更多更灵活的盈利模式,全力支持各合作伙伴不断地成长
和壮大.
.店铺动态卡片(LIVECAR
常见问题
奇门
淘宝,拥有注册用户数以亿级的买家和百方级买家,淘主式见而少的中"一
API文档
淘宝开放平台(TAOBAOOPENPLATFORM)是基于淘宝
image.png


添写相应的入参点“提交测试”:
注:系统分配APPKEY只能调用基础API
JSONOXMLOSIMPITYJSO
PI测试工具(新
PP访问日志工!
品属性工具
P收费查询
2淘宝开放平
用工具说明
户授权工具
误码排查工具
制台工具
PI测试工具
I需要填入自己申请的APPKEY
聚石塔云产品
常用工具
开放业务
APPKEY:
返回格式:
基础技术
用工具
常见间题
.开放平台
提交测试
AP文档
API名称:
ONINE
台规则
不填则厚
奇门
环境:
Q接
文档中心.
image.png

8、日常问题可以通过“码上放心小蜜”进行查询:
地址:https://links.alipay.com/app/room/61541e0582326505a2f41a84/
输入问题关键字,点回车:
码上放心
新淘
问题咨询
可以快速解答你的任何问题
top
企业系统接口对接一TOP文档-快易通接口...
企业系统接口对接-TOP文档*快易通对接...
企业系统接口对接一-TOP文档接口对接错...
企业系统接口对接一TOP文档-申请appkey...
image.png
top
语雀文档
百科
会话
全部
互企业系统接口对接一TOP文档-快易通对接文档
https:qg6r2iyuque.comdocsshar7-
86cd7510?#
来源:码上放心
百科企业系统接口对接一TOP文档-快易通接口说明文档
https:open.taobao.comapihtmdocld410318doclype-2&scopel
d-15614
宗源:码上放心
五企业系统接口对接一TOP文档接口对接错误说明指南
httpsqg6r2iyuque.comdocshde-9140079c4dda
c3d1764a?#
来源:码上放心
百科企业系统接口对接一TOP文档-申请appkey及对应的权限包过程
httpsqg6rziyuque.comdocsshareea9d87e-9e482-91d9
50110fae?#
宗源:码上放心
会适我自己申请的top接口,测试通过后,在客户处上线是需要客户再...
问题类型:TOP接口企业名称:ds问题描述:我自己申请的top接口,测
试通过后,在客户处上线是需要客户再去申请一个app吗?接口名:接口
参数:接口返回:紧急程度:一股联系人姓名:手机号:.
来源:码上放心
会话企业系统接口对接一top文档快易通对接文档
企业名称:国药控股山西有限公司接口参数:紧急程度:较重问题类型:
TOP接口接口返回:接口名:手机号:问题述:最近的快易通接口怎么
更新联系人姓名:...
亲源:码上放心
会drugtrace.toplsyduploadinoutbill上传的这个接口一次上传...
问题类型:入出库单据企业名称:成都任我行千方百剂软件有限公司问
题荷述:alibaba.alihealth.drugtrace.toplsyduploadinoutbill上传的
接入在线支持
image.png

(2)开始第二个接口的调用,完成一个单据上传接口的调用。
A.什么是单据:记录一次企业与企业(个人)之间进行药品收发货信息的记录。每次收货及发货都应该形成一条单据记录。本接口是一个企业出库的单据示例。
B.什么是单据号:是每个单据必须有的一个属性值,在同一个企业每条单据号是唯一的,不能出现两条单据使用同一个单据号,已上传过的单据号再次上传将提示错误信息。
C.单据文件:一般由扫码枪生成,是一个xml类型的文件,详细可以见“单据模板示例”附件。单据文件格式的详细描述可以访问:https://files.alicdn.com/tpsservice/aa3e9a993338a0028549a6d2f67e4ac7.pdf?spm=a21f6.8078399.0.0.7bfa6857QbPT0o&file=aa3e9a993338a0028549a6d2f67e4ac7.pdf
上述文档中,大多数属性是用于客户端上传的。
在接口对接开发时,单据文件只关注Name属性和Code属性(WareHouseOut、CorpOrderID、ActDate属性需要存在,但属性值以接口入参为准),其它属性可以不关注。
version-"1.0"encoding"utt-8">
?xml
日日日日
<Document>
<Events>
ainAction-"WareHouseOut">
EventName-"WholesalewareHouseut"
<Datafield>
code-"83689060000001555528"
CoRPOdeID"3-供应出库07160ACtDate202007
"
<Data
code-83689060000001542589"
OPORdID"-伙应出07160ACtDate*2020-076
Data
</Datarield>
</Event>
/EveNtS>
K/Document>
image.png

单据收发货企业、单据号等是在接口调用时以入参形式上传的。
单据类型字典:
101, "生产入库"102, "采购入库"103, "退货入库"104, "调拨入库"106, "零头入库"107, "供应入库"108, "召回入库"110,"赠品入库"111,"盘盈入库"112,"报废入库"113,"其他入库"
201, "销售出库"202, "退货出库"203, "调拨出库"204, "返工出库"205, "销毁出库"206, "抽检出库"207, "直调出库"208, "生产出库"209, "供应出库"211, "召回出库"212,"赠品出库"214,"盘亏出库"215,"损坏出库"216,"报废出库"217,"其他出库"237, "直调退货"

1、通过第三步的1)2)找到要调用的接口,如下图:
ALIBABA.ALHEALTH.DRUG.MSC.UPLOADCIRCUBLL
调拨出库";204,返工出库";205,"制段出库";206,"抽检出库";207,"重调出库";20,"生产出库";209,"供应出库";21召固出库":212,赠品出库"1
AHAHAALHEAHCL
户登录授权成功后,,TOP预发给应用的授权后司,,详超增出
112:00:00.淘宝AP服务端允许客户端请求最大时间误差为10分钟
AAAC
AIPAPAALINEATH.DRUG.MSCR
AP接口名称,例如:ALIBABA.ALIHEALTH.DRUG.MSC.UPLOADCIRCUBILL
淘宝开放平台文档中心API文
ALIBABA.ALIHEALTH.DRUGMSC.BI...
ALIBABA.ALIHEALTH.DRUG.MSC.G...
响应格式.默认为XML格式,可选值:XML,JSON.
ALIBABAALIHEALTHDRUG.MSC.S...
ALIBABA.ALIHEALTH.DRUGMSC.S.
(生产批发企业上传入出库单据接口)
TOP分配给应用的APPKEY,例如:12345678
ALIBABA.ALIHEALTH.DRUG.MSC.S..
ALIBABA.ALIHEALTH.DRUG.MSC.LI...
通过时间段批量查询入出库单信息
ALIBABA.ALIHEALTH.DRUG.MSC.D...
AP输入参数签名结果,签名算法介绍请点击这里
需要传;"可选授权",则此参数为可选
HTTP://GW.API.TAOBAO.COM/ROUTE
HTTPS://ECO.TAOBAO.COM/ROUTER/RES
物流企业意询货主企业信息
库";113,"其他入库"201,"销售出库";202,"退货出库";203,"调拨出库";204
公共请求参数:
签名的摘要算法,可选值为:HMAC,MD5,HMAC-S
公共参数
单据处理状态宣询
98158张张
码上放心-码上传
¥免费不需用户授权
SIAN_METHOD
生产批发单据上传(非零售企业使用),包括101,"生产入库:
何获得此AP
请求地址:
询药品目录信息
TIMESTAM
宣询单据详情
误码解释
间戳,格式为YYYY-MM-DDHH:MM:SS,时区为
STRING
正式环境
STRING
HTTPS地址
METHOD
SIGN
STRING
名称
类型
P工具
STRING
常示例
7.其他出库";237,"直调退货".
STRING
STRING
此AP的标签上注明:需要授权",则此参数必传;"不
应示例
应参数
Q搜
STING
必须
image.png

复制代码示例:
ALIBABAALIHEALTHDRUGMSCUPLOADCIRCUBILLREQUESTREQ=NEWALIBABAALIHEALTHD
REQ,SETBILLTIME(STRINGUTILS.PARSEDATETIME("2023-10-1016:57:15"));
REG,SETFILECONTENT("添写单据文件XML的加密事,加密过程看文档.XMLU
TAOBAOCLIENTCLIENTNEWDEFAULTTAOBAOCLIENT(URL,APPKEY,SECRET);
REG,SETDISREFENTID("5069452C34B94A778ABAA26C2B40B305"
REQ.SETDRUGLISTJSON("[("CODECOUNT":100,"COMMDRUGID":"TESTCOMM
REG,SETTOUSERID("D5F5F05C6AF04E52BA7894D9BBF8E757)
REG.SETDESTUSERID("D5F5F05C6AF04E52BA7894D9BBF8E757
REQ,.SETDISENTID("5069452C34B94A778ABAA26C2B40B305");
REQSETASSENTID("5069452C34B94A778ABAA26C2B40B305");
ALIBABAALIHEALTHDRUGMSCUPLOADCIRCUB1LLRESPONSER
REG,SETUPLOADFILENAME("单据文件00001.XML");
REQ,SETXTCHECKCODEDESC("未通过原因描述");
REQ.SETREFUSERID("320000000000127971");
SYSTEMOUTPRINTLN(RSPGETBODY());
ALIDABAALIHEALTH.DRUG.MSC.S...
REQ,SETASSREFENTID("5069452C34B94A778ABAA26C2B40B305");
REG.SETFROMUSERID("00000000000020671792)
MEAEALLDRUG-MSCU
BAALIHEALTHDRUGMSCUPLOADCIRCUBILLRE
喷正业名称查询企业唯1SC.9..
REQ,SETFROMADDRESS("发货地址XXX");
ALIBABA.ALIHEALTH.DRUG.MSC.D...
REQ.SET0RDERCODE("123456");
REQ.SET0PERICCODE("21208834S");
REG.SETFROMPERSON("张菜");
REQ,SETBILLCODE("MSC_BC0GS");
ALIBABA.ALIHEALTHDRUG.MSC.G...
REQSETTOPERSON("享某");
TANEALTH.DRUG.MSC.S..
REQ.SETXTCHECKCODE(OL);
G询往E.AIHEALTH.DRUG.MSC.LI.
REG,SETXTISCHECK("未验证通过原因");
根据企业主键查看企业详细信息
REQ,SETQURECEIVABLE(1OL);
APABA.ALIHEALTH.DRUO
ALIBABAALIHEALTH.DRUGMSC.G...
ADA.ALIHEALTH.DRUGMS
REG.SETCLIENTTYPE("2");
REQ.SETIGNORECHECK("II
GRAOAALIHEALTH.DRUG.MSE
零关出入库单据上传771SCR...
根据企业唯一标识宣看企业详细信息
码上放心-码上传
单据处理状态宣询91SC.DI..
REQ,SETTOADDRESS("收货地址BXXX");
请求示例
询药品目录信息
ALBABA.ALIHEALTH.DRUGME
如何获得此AP
其询单据详情9.711SC.S...
UBILLRESPONSERSP=CLIENT,EXECUTE(REQ)
REQ.SETOPERICNAME("张三");
API工具
异常示例
错误码解释
REQ.SETFROMBILLCODE("1234S6");
响应示例
响应参数
公共参数
请求示例
ETCURLPYTHON
请求参数
REQ.SETBILLTYPE(2OL);
UBILLREQUEST();
PYTHON3
NODEJS
JAVA8
CJC++
image.png

2、复制示例代码到您的开发工具中,如下图:
{'ALIBABAALIHEALTH,DRUGNSC.UPLOADCIRCUBI11,RESPONSE"MODEL1""51161F84245BD845BEF76FECFC6D3'N59.CBDE-SU
LIBABALIHEALTNORUQNSCUPLOADCIRCUBILLREQUESTEQ=NEWAIBABALIHEALTHORUGNSCUPLOADCIRCUTILREQUEST()
++MUYBO65OZM8QZGSGPAE4AGAC0WMJAYAGPOPGBPBGRPAEGRGQYTKGWWB6VDS0NDNAGJPAUFLAZUR/XPICYHQXSBIITAKXN
++WFUVUJK3ZA1FXZN6ERZKHNOGSQMPECNS5KZL66RVJPS2ZQUHZK9NYLFNPI..Z2X0Q(ODSCN6-LA2SS6J0ANF4Y1FQR/5PCNP
REQ.SETB1LLTIME(STRINGUTIL.S.P0RSE0ATETIME(STR"2023-10-1016:57:15"));//单据时间
+/QULSGG+IZ15JSKLYENRZTBMJ.ZYKUMLM5GRANMARN0+STAIHYIZSWVSDCWNDQXHDQZMS.STXV0BFLJA50KCDZLXKINTESEYQ*6
DISCONNECTEDFROMTHETARGETVM,ADRESS:127.0.0.1:6403',TRANSPORT:SOCKET
CONNECTEDTOTHETARGETVM,ADRESS:127.0.0.1:64033',TRANSPORT:SOCKET
REQ.SETT0USERID("D5F5F05C6AF04E52BA7894D9BBF8E757);
TAOBAOCUIENTCLIENTNEWDEFAUTTAOBAOCUIENT(URL,APPKEY,SEORET)
+"+SJGEAA-=");//添加单据XML文件的加密串,调用XMLUTI类的CREATEFILEZIPCONTENT方法生成
REQ.SETDISREFENTID("5069452C34B94A778ABAA26C2B40B305"
REQ,SETBI11C0DE("MSC_BC005");/单据号,不要使用默认的
REQ.SETDESTUSERID("D5F5F05C6AF04E52BA7894D9BBF8E757");
REQSETD1SENTID(5069452C34B94A778ABAA26C2B40B305")
REQ.SETFR0MUSERD("3E8CB88E9E04465781F7DB1A7441C275");
CAUAUUUUOOAOOGIAOOAOGINVUOOOUI
REQ.SETBIL1TYPE(201L);//单据类型-销售出库
REG.SETUPLOADFILENAME("单据文件00001.XM");
REQ.SETFLECONTENTH4SIAAAAAAAA/3U/E7"
REQ.SETREFUSERID("320000000000127970")
LMAVEN:COMMONS-LOGGING:COMMONS-LOGGIN43
REQ.SETXTISCHECK("未验证通过原因");
PROCESSFINISHEDWITHEXITCODEB
REQ.SETFROMADDRESS("发货地址XXX");
REGSETCLIENTTYPE"2"//默I
DEBUGTHREADS&VARIABLESCONSOLECDL
REQ,SET0PERICNAME("张三");//单据上传人
REG.SETFROMBI1LCODE("123456");
REQ.SETTOPERSON("李某");
REQ.SET0RDERCODE("123456");
AAAAA有AAAAAAAAAAAAA不不本刀定国货付以们小阳题创到达至不东不A不不不不不不不不不不不A不A
REQ.SETTOADDRESS("收货地池址XXX");
REQ.SETQURECEIVABLE1L)
>图COMMONS-LOGGING-1.2JARLIBRARYROOT
REQ.SET0PERICCODE"212000345")
</3-SELLOUT-0716_01.XML
REQ.SETFROMPERSON("张某");
LMSCDEMO~/MSCDER
EXTERNALLIBRARIES
SCRATCHESANDCONSOLES
3TAOBAO-SDKJAVA-
CRESOURCES
LEGETENTINFO
G<18>LIBRARYJAVA/J
AVA-AUTO17017A
SCRATCHES
当EXTENSIONS
企O元
65666106
MPOM.XML
口TARGET
白MAIN
OTEST
OXMLUTIL
ABILLUPLOAD
TEST
.IDEA
PROJECTV
CODE":"SUCCESS","MSG_INFO":"调用成功",
口SRC
VQCOM
丫口JAVE
口JAVA
OTEST
44
合PROCES
image.png

所有接口需要关注ref_user_id/ref_ent_id字段,如果你是服务商,您为哪家企业服务,这个字段就写哪家企业。如果您做为企业的IT部门为本企业开发接口服务,这个字段则填写本企业的ref_ent_id。
3、当出现以下提示时,说明接口调试已通,只是您的appkey没有操作企业的权限。
{"alibaba_alihealth_drug_msc_uploadcircubill_response":{"msg_code":"FAIL_BIZ_AUTH_ERROR","msg_info":"(25465001)没有操作权限:(320000000000127971)(MSCBillUploadCircuServiceImpl.uploadCircuBillInfo)","response_success":false,"request_id":"10ixyzdqzv4rb"}}
该返回值说明这个appkey没有与相应企业绑定,请联系阿里业务人员,请将您的返回串给到阿里人员,进行权限赋予。
4、当出现以下提示时,说明您的调用已经成功,单据已经传上到码上放心平台。
{"alibaba_alihealth_drug_msc_uploadcircubill_response":{"model":"76368a4de28446c481d91e85c53871b5","msg_code":"SUCCESS","msg_info":"调用成功","response_success":true,"request_id":"saem4c6fhq17"}}
5、接口有统一的返回格式,具体说明如下
返回对像为alibaba_alihealth_XXX_XXX_XXX,例如下面格式
{
"alibaba_alihealth_drug_msc_xxxx_response": {
"model":""
"msg_code": "",
"msg_info": "",
"response_success": true,
"request_id": "5z317d85s34z"
}
}
解析返回值的说明:
response_success为true时,说明接口调用成功,如果msg_code为SUCCESS说明完全正确直接解析model即可。如果msg_code为WARN开头(比如WARN_SYS、WARN_BIZ),说明有需要注意的信息,此时除了解析model还需要解析msg_info查看具体的告警信息。response_success为false时,说明接口调用失败,此时msg_code以FAIL开头,细分为FAIL_SYS(系统错误)和 FAIL_BIZ(业务错误)等。
6、上述执行代码示例,示例使用IEDA开发(下面示例双击可以打开)。
码上传示例代码工程-idea.zip(1.1 MB)

单据模板示例20201211.rar(7 KB)

Net加密.txt(1 KB)
使用C#开发时,单据文件的加密过程示例代码。
XmlUtil.java(3 KB)
使用java(jdk8版本以下)开发时,单据文件的加密过程示例代码。
XmlUtil.java(3 KB)
使用java(含jdk8及更高版本以上)开发时,单据文件的加密过程示例代码。

注:由于单据上传是异步处理的,接口返回成功不等于处理成功,需要获取处理状态判断是否成功,平台提供两种方法判断处理是否成功:
第一种,通过接口查询单据是否处理成功,调用alibaba.alihealth.drug.msc.searchstatus 接口实时查询单据处理状态,详见3.4中「通过接口获取单据处理状态」
第二种,通过消息接口方式,方法是在调用单据上传接口时,入参client_type 填写为8,系统处理完成后会将处理结果通过消息的方式发送给调用方,详见第3.4中「通过消息方式接收单据处理状态」
(3)开始第三个接口的调用,查询一个出入库单据上传后是否处理成功。
所有单据上传是一个异步过程,单据上传成功后,并不代表单据已入到系统中,而是有一个5秒左右的延时处理,只有单据处理成功后,才代表单据正式上传到了系统中。如果单据处理失败,在入出库单查询中,是查不到单据信息的。可以通过三种方式获取处理状态信息。
一、通过接口获取单据处理状态
1、接口名称:alibaba.alihealth.drug.msc.searchstatus ( 上传单据后处理状态查询 )
ALIBABAALIHEALTH.DRUGMSC.BILL.SEARCHSTATUS单理S)
SAAMEAN.DRUGMSC.L..
MCANTEATDRU9MSCG
间戳,格式为YYYY-MM-DDHH:MM:SS,时区为GMT+8,例如:2015-
ALIBABA.ALIHEALTH.DRUGMSC.G...
AAAACRL
AP的标签上注明:"需要授权",则此参数必传;"不需要授权",则此参数
TTP:LGWAPITAOBAO.COMLROUTERIREST
TOP分配给应用的APPKEY,例如:12345678
ALBABA.ALIHEALTH.DRUG.MSC.BI..
ALIBABA.ALIHEALTH.DRUG.MSC.D..
ALIBABA.ALIHEALTH.DRUGMSC.S..
ALIBABA.ALIHEALTH.DRUG.MSC.R...
很据企业名称查询企业唯一标识
物流企业宣询货主企业信91SC.S...
TTPS:LLECO.TAOBAO.COMLROUTERFREST
¥免费不需用户授权
ALIBABA.ALIHEALTH.DRUG.MSC.G...
之淘宝开放平台
文档中心.API文档V
响应格式.默认为XML格式,可选值:XML,JSON.
AP接口名称,例如:ALIBABAALIHEALTH.DRUG.MSC.BILLSEAN
码上放心-码上传
P输入参数签名结果,签名算法介绍请点击这里
公共参数
共请求参数:
API协议版本,可选值:2.0
请求地址:
需要传;"可选授权",则此参数为可选
SIGN_METHOD
98158张张
HTTPS地址
查询药品目录信息
单据处理状态查询
正式环境
HTTP地址
TIMESTAMP
APP_KEY
何获得此AF
环境
响应示例
STRING
STING
STRING
STING
错误码解释
STRING
STRING
STRING
STRING
异常示例
求示例
户登录授权成功后,TOP颁发给
ETHOD
12:0000.淘宝AP1服务端允许客户烤
image.png

2、复制示例代码到您的开发工具中,按请求描述修改参数,如下:
物AOA-AEATHDRUG.MSC.S..
ALIBABAALIHEALTHDRUGMSCBILLSEARCHSTATUSREQUESTREQ=NEWALIB
根据企业多称GATHDRUG.MSCG..
生产发EA.IRUGMSC.U..
零头出入库鱼提AILN.DRUG.MSC.R...
通过时间段ESDRU9MSC.S..
ALIBABAALIHEALTHDRUGMSCBILLSEARCHSTATUSRESPONSERSP=CLIENT.EXECUTE(REQ)
查询往SAIMNEALTH.DRUG.MSC.I..
单据处理状柔EALTH.DRUGMSC,BI..
G.SETBILLCODE("BC001_1123566
EQ.SETAGENTREFUSERID("320000000000127971
SYSTEMOUT,PRINTLN(RSP,GETBODY());
CLIENT=NEWDEFAULTTAOBAOCLIENT(URL,APPKEY,SECRE
ALIBABAAIHEALTH.DRUG.MSC.G...
A.AINEALTH.DRUG.MSC.S
LIBABA.ALIHEALTH.DRUG.MSC.G...
LIBABA.ALIHEALTH.DRUG.MSC.D...
EG.SETREFENTID("320000000000127971");
G.SETDRUGTYPE("2")
EG.SETPAGESIZE(2OL);
LSEARCHSTATUSREQUEST();
Q,SETDEALSTATUS("3");
EG.SETBILLTYPE("A");
码上放心-码上传
EG,SETFROMUSERID("3200OOO00000127
EQ.SETPAGE(IL);
REG=NEWALIBABAALIHEALTHDRUGMSCBILL
求示例
宣询单据详情
EQ.SETTOUSERID("320000000000127G71");
宣询药品目录信息
如何获得此AP
TAOBAOCLIENTCLIENT
响应参数
错误码解释
EQ,SETENDDATE("2023-12-15");
API工具
处理成功
请求示例
异常示例
公共参线
响应结果
响应示例
YTHON3
请求参数
PPKEY,SECRET);
PYTHON
G,SETBEGINDATE("2023-10-01");
CURL
RUGMSCBILLSEARCHSTE
NET6
NODEJS
JAVA8
image.png

3、执行示例代码,返回如下结果,则表示上传成功,如遇“没有操作权限”同上解决
result:
model:
resultlist:
billdealstatussearchdo:
*billcode:"B2C2018110617375430002
billtime:2017-05-1016:57:15
*billtype:*326,
crtdate:2020-11-0219:30:10
"fromrefuserid:*320000000000127971"
"fromuserid:45637fe075194c988b7a53a3cb344cd2
"fromusername:"'香港测试108改名2
"iccode:~23313615
physictype:*3,
33.png

4、接口有统一的返回格式,具体说明如下
返回对像为alibaba_alihealth_XXX_XXX_XXX,例如下面格式
{
"alibaba_alihealth_drug_msc_xxxx_response": {
"model":""
"msg_code": "",
"msg_info": "",
"response_success": true,
"request_id": "5z317d85s34z"
}
}
解析返回值的说明:
response_success为true时,说明接口调用成功,如果msg_code为SUCCESS说明完全正确直接解析model即可。如果msg_code为WARN开头(比如WARN_SYS、WARN_BIZ),说明有需要注意的信息,此时除了解析model还需要解析msg_info查看具体的告警信息。response_success为false时,说明接口调用失败,此时msg_code以FAIL开头,细分为FAIL_SYS(系统错误)和 FAIL_BIZ(业务错误)等。
二、通过消息方式接收单据处理状态
1、如果要通过消息方式接收单据处理状态,首先在上传单据的时候接口入参clientType需填写为: 8
请求示例
C/c++
Python
JAVA
NodeJS
CURL
NET
PHP
TaoDaocHentcLentDeutaoaocen
Btbbatthe
reg.setailicode(bcoo
Eeg.setB11TSu
reg.setBilltype(L
reg.setPhysictypeL)
reg.setReruserrd(320000000000127971
reg.setgenteuserid20000000000127971)
reg.setFromuserid00000000000020671792
Eeg.settouserdd505c6ao4a79b877
eg.setDestuserd505cbo4oa
reg.setoperIccode("212000345")
reg.setoperIcname("张兰")
teg.etiacon
reg.setuploadFilename单文件00001.m1
reg.setciienttype""
reg.setouReceivable
reg.setxtischeck(o"
reg.setxtcheckcode"未验证通过原因"
reg.setxtcheckcodeDesc("未通过原因描述")
image.png

2、订阅消息,登录控制台在应用管理页面【消息服务】->【订阅消息】勾选需要订阅的消息,勾选alibaba_alihealth_BillProcessStatusNotify后即可接收消息。
op.fam"..doctor
如向使用潮县型务?
From淘宝
根剪
清点名或中文名
搜率
SDK下
中文名称
消只多称
应用设置
单撼处理状态薄知
已订扣/取消
阿里修本追润势
albaba.aheaheillProcesssta
玛生,根务机关霜泉
xibabecheoth_Dodtorllossoge
安全中心
O
平台潘三方机构"订单状态变买"
订间
alibabaalheshhOroasanooa
报表中心
已订阅/消
取消授权浦总通知
平台消启
闵里饿续-会员...
阿里位陕测试消息
已订约取消
消点服务
O
订间
YUNOSYOC
YunosYocdatapool沙箱环境
订问消息
YunDsYoc
订购
yoc有尽服务
Messp-ScrmVice
我的消息
农入球认失送
服务市场
订餐
fuwu_canfrmFall
消息报表
订店
农入码认院功
轻努市场
消足物边查询
订购
订单关闭消息
adao.fuNJCrdardcsed
服务市场
消总队别及况
页群转
共12条亚页页上页下页尾页荒
TMC连接宜询
消总订阅查询
消启流控配置
API服务提供
?
满站园
咨涛小开
20210630110302.jpg


3、编写业务代码
TmcClient client = new TmcClient("app_key", "app_secret", "default");
client.setMessageHandler(new MessageHandler() {
public void onMessage(Message message, MessageStatus status){
try {
System.out.println(message.getContent());
System.out.println(message.getTopic());
} catch (Exception e) {
e.printStackTrace();
status.fail(); // 消息处理失败回滚,服务端需要重发// 重试注意:不是所有的异常都需要系统重试。 // 对于字段不全、主键冲突问题,导致写DB异常,不可重试,否则消息会一直重发// 对于,由于网络问题,权限问题导致的失败,可重试。// 重试时间 5分钟不等,不要滥用,否则会引起雪崩
}
}
});
client.connect("ws://mc.api.taobao.com");
注: 采用Java main方法在IDE里面运行上面的代码测试时,请在client.connect()后面加上Thread.sleep让main线程等待一段 时间结束,以便观察消息的实时接收情况,否则main线程结束后,TMC长连接也会跟着断开。如果是在web服务器上运行上面的代码,则不用在 client.connect()后面加任何Thread.sleep代码,也不需要在外面包一层while(true)循环,因为web服务器上的主线 程只要服务器不关闭都是不会结束的,TMC的长连接会一直保持。

消息返回结果示例:
{
"result_type":"4", // 处理状态 0,处理中 1, 上传成功 3, 处理成功 4, 处理失败
"ref_user_id":"320000000000127971", //单据所属企业ID
"process_info":"该单有1个追溯码未激活,如81012350000000157474。", // 处理信息
"ic_code":"123456", //单据上传人
"bill_code":"BC1_112001aaa", //单据编号
"process_date":"2021-06-11 17:38:39", //单据处理时间
"bill_type":"102", //单据类型
"store_inout_seq_no":"a92dfa23c53e4ffe99ee2c2bf6fcbf7c", // 出入库唯一编号
"bill_time":"2021-01-02 02:21:21" // 单据时间
}
三、通过客户端的方式查看单据处理状态
1、登录码上放心客户端
2、选择【入出库单】菜单下拉列表下的【单据处理状态查询】
上放心客户端
国际医药物流
关联关系
追溯码管理
临床试验用药
客户服务
受权管理
系统设吉
入出库单
帮助中心
品度管理
账户管理
信息管理
单据处理状态查询
首页
全部
2022-02-17
单层类型
结束时间:
开始时间:
2022-02-01
发货单位:
全部
处理状态:
全部药品
药品类型
请点击选择
配送单位:
委托单位:
收货单位:
请选择
消点击选择
货主与委托单位的区别?
请点击选择
重五
查询
删除
红色背景色的是处理失败的单据,请双击查者失败原因
单据号码
收驾单位
入出库日期
药品类型
配送单位
单指类型
文件名
发货单位
委托单位
中信测试21世纪制药厂北
中信测试21世纪制药厂北
生产入库
SYS_IN_2022021717230254626XML
SY5JNL2022021717230254626
2022-02-17
普通药品
京分公司7
京分公司
中信测试21世纪制药厂北
中信测试21世纪制药厂北
生产入库
普通药品
SY5_IN_2022021716193349629XML
SY5_IN_2022021716193349629
2022-02-17
京分公司7
京分公司7
中信测试21世纪制药厂北
中信测试21世纪制药厂北
普通药品
生产入串
SY5 IN 202202171520448700
SY5.IN_202202171520448700XML
2022-02-17
京分公司7
京分公司7
中信测试21世纪制药厂北
2022-02-08
普通药品
XIAOSHOU 20220208 003
销售出店
LUOJI测试企业11
XIAOSHOU_20220208 003XML
京分公司7
中信测试21世纪制药厂北
特殊药品制剂
采购入库
中信测试21世纪医院
DET_102 OUT_2022021142807695
2022-02-09
20220211142842390
京分公司7
中信测试21世纪制药厂北
普通药品
供应入库
DEF_107_OUT_2022021142618948
20220211142655069
LUOJ通试企业11
2022-02-10
京分公司7
中信测试21世纪制药厂北
2022-02-10
召回入库
DEF_108_OUT_20220210204114596
20220210203721872
999香港第一制药厂
京分公司7
image.png


(4)其它更多接口使用方法,请到
https://open.taobao.com/api.htm?docId=68503&docType=2&scopeId=30203进行查看。
 在进行接口调用时,出现的接口调用错误 ,请参考下面说明
https://qg6r2i.yuque.com/qg6r2i/csvggm/zv23fl?singleDoc# 《码上放心-接口错误说明指南》
(5)关于接口访问安全的设置(必须设置,不然后期接口将不允许访问)
为了防止接口被恶意调用,使用的开放平台调用的ISV及企业都应该进行接口安全调用的白名单设置(若为浮动IP请请勿设置,固定IP请必必须设置),设置页面如图:
个IP白名单是您用来调用API的服务器IP,设置后可以防止您的APPKEY被其他服务器盗用,
聚石塔云应用更多信息以及操作,请前往聚石塔中进行.立即前往
设置IP白名单会影响您的应用安全指数,查看更多
节大促API服务调整公告[12月5日
持.UT纯文本文件,请将每个IP换行分割
试企业码上放心接口
公告|2023年好价
203.119.241.126
IP白名单设置
IP白名单设置
47.100.21.242山
124220.81.219
5返回应用列表
+批量导入IP数据
8158张张
74.125.71.1
203.119.196.9血
聚石培
提交信息
6设管
手动添加
门文档
淘宝
缺陷列表
自动添加
+新增
仑首页
消息服务
仑云托管
手动添加
国财务
操作日志
开放平台
能力
2工具
59.82.**
用设置
2支持
表中心
对接
DK下载
开发
重置
203.119.*.*[
image.png

      点击新增,输入您要添加的IP地址(哪台机器需要访问接口,就设置哪台机器的IP),点提交信息,完成设置。
被设置的IP为访问接口的机器出口IP(并不是机器的内网IP),出口IP可以通过百度查询如图:
查询ip
百度一下
Baidu百度
更多>
资讯
文库贴吧
采购
地图
知道
图片
视频
网页
百度为您找到相关结果约73,700,000个
了搜索工具
IP查询数据接口免费API接口调用-聚合数据
聚合教据专业的AP数据平台为您提供P查询数据接口以及调用信息无期限免费试用再付
升级.
https://www.juhe.cndocai.-度快照
P地址查询
北京市北京市阿里云
本机LIP:106.11.34.4
查询
请输入ip地址
本机IP查看方法IP地址设置方法
2.png

如果您的服务器不是windows可以通过:curl http://members.3322.org/dyndns/getip
进行查询,如下图:
5:242020from10.47.144.132
Lastlogin:wedMay1311:56:2420
welcometoaliyunElasticcomputeservice!
[tomcatemaster~scurlhttp://members.3322.og/yds/ge
112.124.1.165
tomcatamaster~1s
22.png

得到IP后,请在IP白名单设置中进行添加 ,若为浮动IP的企业可不设置或者设置为浮动的IP区间(如上图)106.11.*.*;
如果报下面图的错误,则将报错信息中的IP配到白名单中。如果IP后两位经常发生变化,后两位可以配置成*.*的方式,例如:203.119.*.*
响应:
Cory
ferrorresponse/code:11,msg:"nsufficientis
permissions'subcode:"isypermissi
I-whitelist-limit"'sub_msg:"The
appkey32122119isonl
owedtocallfromitsipwhitelist,butthesoucep
203.119.193.10
isnotincluded"rquestid":zap9ad67gf7"7
ff.png

(6)平台提供如下测试企业
企业类型
名称
ref_ent_id
ent_id
生产企业
测试1生产企业
646d79e8e4b09d4f0095a831
646d79e8e4b09d4f0095a831
批发企业
香港测试107new
320000000000127970
c12db0d3fbc3401987d605b80f3b5e90
批发企业
中信测试批发企业001
320000000000141936
00000000000022959216
批发企业
测试入驻批发企业
64547b8de4b0cae8cc3f2f3f
64547b8de4b0cae8cc3f2f3f
零售药店
开心大药房(测试)
5f742dc2e4b009caa5b865f8
5f742dc2e4b009caa5b865f8
(7)平台提供如下测试用的追溯码
测试企业使用儿童.xml(7 KB)
测试企业使用五朵金花.xml(7 KB)

12-22 16:30
1258
IP 属地北京
举报