# 微信“一物一码”
# 一、申请流程
整体流程如下：
# 1. 申请条件
- 已认证的服务号。
- 有明确的一物一码赋码场景，期望通过商品赋码实现防伪、溯源、营销、数字化经营等。
# 2. 申请渠道
- 从站内信等通知渠道进入申请页。
- 从公众号菜单添加功能，进入一物一码，点击申请进入申请页。
申请结果将通过预留的联系邮箱通知。
# 二、赋码管理
# 1. 调用“申请及获取二维码”接口
通过接口您可以获得格式为：
a1 b1 c1 d1
a2 b2 c2 d2
- a为361字节的01点阵，用于支持生成19乘以19的微型码，0为白，1为黑
- b为原始码数据，最长9位
- c为该码在此次申请的索引位置
- d为28位字符，用于支持转为普通二维码。可生成码制2，纠错等级Q的二维码
# 2. 选择需要的二维码类型
如果有在较小印刷面积下进行赋码的需求，或需要特殊码制带来的安全性，可以使用微型码。微型码为腾讯专利码制，不能为其他组织或个人仿制，支持最小印刷面积0.5cm乘以0.5cm。
需要注意的是：
- 微型码的打印需要将点阵转为二维码。如果你的设备提供方不支持，可以联系wxsaoyisao@tencent.com，在工作人员指导下打印。
- 微型码的读取需要升级微信引擎。如果你的产线上有采集二维码信息的环节，可以联系我们，由工作人员指导设备提供方进行升级。
- 如果没有较小面积下的印刷需求，可以使用普通二维码。普通二维码的印刷和读取和通行标准一致。
微型码和普通码对照表
# 3. 管理微型码，完成商品赋码
获取微型码之后，按照生产流程和赋码进行产线改造，将二维码印刷在商品上。 也可以先进行码的打印，管理分发后再与商品关联。
# 三、落地小程序开发
# 1. 一物一码方案设计
根据不同的需求场景，进行市场调研和一物一码整体方案设计。规划方案目的、预算和执行的具体步骤。这一步通常发生在赋码之前。
# 2. 落地小程序开发
微信扫一扫入口和小程序工具提供了一物一码的载体。小程序开发者可以根据不同用户和二维码设置不同的扫码承接策略。
一物一码生成的二维码是小程序码的一种，拥有以下特殊产品能力：
# 2.1 小程序关注公众号组件
小程序关注公众号功能可以帮助品牌商更好的触达用户，可发送公众号群发消息实现扫码用户的回流，培养用户粘性。
当前功能支持绑定相同主体的公众号。请在小程序管理中绑定小程序，可以前往小程序管理后台，在“设置”-“关注公众号”中绑定，设置的公众号需与小程序主体一致。当用户扫小程序码打开小程序时，开发者可在小程序内配置公众号关注组件，方便用户快捷关注公众号，可嵌套在原生组件内。
可参考 开发文档
组件示意：
# 2.2 小程序红包
小程序红包是吸引用户参与一物一码扫码活动的重要功能，能够显著提升扫码率。用户扫瓶身二维码进小程序领取红包能直接领取到用户零钱，起到激励作用，促使用户对商品进行回购。
申请条件需满足：商户号满足微信支付产品开通条件，小程序未开通社交红包类目。
功能示意：
# 3. 激活二维码并投入市场
通常情况下，在商品投入市场之前，会有二维码激活的环节，该环节的目的是降低码在生产中的泄露风险。微信一物一码的码激活目的是回传商品信息（以提供数据分析服务）、定义码和小程序的跳转关系，应在原有激活环节前完成，不影响原有激活环节设置。
# 4. 登录MP查看数据
商品投入市场后，登录公众号后台，选择一物一码功能，可以查看扫码数据和用户分析。数据口径中的活动名称、商品名、品牌均来自于激活二维码时定义的字段，激活时请注意按分析诉求规范填写。
# 四、服务商代实现业务
一物一码的整体流程包含方案制定、线下赋码印刷、线上公众号接口调用＆小程序开发，服务商可以通过以下流程帮助商家使用微型码并跳转小程序。
# 1. 在开放平台成为第三方服务商
服务商需要通过开发者资质认证，成为开放平台第三方服务商后可以代公众号实现业务、代小程序实现业务。
# 2. 代商家调用一物一码接口
品牌商需要登录公众号授权给第三方服务商，然后第三方服务商通过调用接口来实现公众号业务。商家参考上文开通一物一码的同时，第三方服务商需要向微信申请第三方下载密钥，方法为联系邮箱(wxsaoyisao@tencent.com)发送邮件说明服务对象并提供第三方APPID。
第三方服务商调用一物一码接口实现发码、激活参考上文。
# 3. 代商家开发扫码落地小程序
品牌小程序需授权后，第三方平台才能进行小程序开发，参考授权流程 。
第三方服务商帮助旗下已授权的小程序进行代码管理时，需先开发完成小程序模版，再将小程序模版部署到旗下小程序账号中，具体流程参考代小程序实现业务。
# 4. 成为微信一物一码合作伙伴
第三方服务商拥有帮助品牌实现“一物一码”的能力后，可以入驻微信服务商市场，充分展示自身能力，广泛触达有数字化营销诉求的商户。
第三方服务商可以在企业主页集中展示所提供的服务，支持使用图文、富媒体等多种格式展示过往案例、与一物一码相关的营销、防伪等模块能力。编辑完成的企业主页，经过服务质量评估后，可被商户通过行业推荐关键词搜索、服务行业和内容相关关键词搜索。
# 五、接口列表
申请及获取二维码
用户扫描二维码
| 接口名称 | 英文名 | 请求路径 |
|---|---|---|
| 查询二维码申请单接口 | intp_marketcode_applycodequery | /intp/marketcode/applycodequery |
| 下载二维码包接口 | intp_marketcode_applycodedownload | /intp/marketcode/applycodedownload |
| 激活二维码接口 | intp_marketcode_codeactive | /intp/marketcode/codeactive |
| 查询二维码激活状态接口 | intp_marketcode_codeactivequery | /intp/marketcode/codeactivequery |
| CODE_TICKET换CODE接口 | intp_marketcode_tickettocode | /intp/marketcode/tickettocode |
| 申请二维码接口 | intp_marketcode_applycode | /intp/marketcode/applycode |
# 六、二维码包解密说明
实名数据的加密方式使用AES的CBC模式，iv使用加解密钥，填充使用PKCS7Padding，最后使用base64进行编码。
解密时，先进行base64解码，然后使用密钥及AES/CBC/PKCS7Padding进行解密。 密钥在申请实名接口权限时，会提供到申请方。
# 七、常见问题
# 1. 权限开通
# Q：一物一码入口在哪里？
A：可以从站内信等通知渠道进入申请页，或从公众号菜单添加功能，添加一物一码功能插件，点击申请进入申请页。
# Q：一物一码收费吗？
A：微信提供一物一码和小程序相关产品能力，开放给品牌和服务商接入，不做收费。
# 2. 发码
# Q：微信发的码是什么码？和普通二维码有什么不同？
A：微信通过“一物一码”接口发放的是腾讯专利微型码。微型码从属于QR-code，使用微信专有的编码规则，区别于任何一种普通QR-code。带来的影响是：
微型码只能通过微信生成，不能被任何组织或个人仿冒，从根本上提升制码安全性。同时，也只能通过微信扫码才能读取并落地小程序，难以通过大批量模拟扫码的方式套取利益。
微型码由19*19的点阵组成，在较小印刷面积下（0.5mm*0.5mm），仍能保持良好的扫码读取速度。
# Q：如何通过微信发码？
A：微信开放api接口，商户开通一物一码功能后，可自行调用或通过第三方服务商调用公众号接口获取码包，灵活定义码和小程序的跳转关系。
# 3. 赋码
# Q：通过微信接口获取的码包格式是什么，如何印刷？
A：根据请求的码数量，码包为请求量/1w个文件的压缩包，单个码格式示例：
1111111111111111111100000110101100000110111010000010111011011101011101011101101110100100101110110000011011110000011111111110111111111110001100000110001100101110111100010010100000011110100010100101110010101010111000110100100010101111111100101001100100000111001111101010111010101110111111011101000110101110101110101011100100110000011011001111111111111100101000101 0436Z31$0 0 P.URL.CN/0V/IXO*FWWYLZLXUXGR
其中前361位为19乘以19的点阵，1代表黑色，0代表白色，组成微型码点阵。第二个参数是码代表的参数，第三个参数是该二维码的相对位置编号，最后一串字符为普通二维码字符。
印刷时，可直接打印点阵或转为位图印刷。如果遇到印刷问题，可联系wxsaoyisao@tencent.com，在工作人员指导下印刷。
# Q：微信码的纠错和冗余情况如何？码的校验机制是否完善？如果印刷中出现部分缺失、破损、沾污等是否可以正确读取？
A：在微型码的19*19=361位点阵中，60%用于冗余和纠错（普通码制最高档H档容错度为30%）。在现有印刷技术水平下，出现残次品的概率极低，也不会存在错码的情况。
# Q：赋码环节中，商品生产线、流通线的硬件设备如何采集到码信息？
A：微型码的信息只能被微信扫码引擎所读取。如果在生产和流通中，有使用硬件设备扫码的诉求，需要印刷供应商或硬件设备供应商，通过品牌商申请获得微信Qbar引擎开放，升级解码库，微信技术人员将配合方案评估和落地。
注：当前已有部分设备厂商支持微型码的硬件读取，具体可联系wxsaoyisao@tencent.com。
# Q：当前印刷和采集设备暂不支持升级为微型码，如何接入微信一物一码？
A：微型码无论从安全性还是从消费者扫码体验上，都是对普通二维码的重要升级。如果当前印刷和采集设备难以支持微型码，接口返回的第四个字符串可直接转码印刷，兼容目前大多数印刷和采集设备。
普通二维码单个码格式示例：
P.URL.CN/0C12345678901234ABC
总长度为28个字符，支持转为版本2，纠错等级Q的二维码。
普通二维码在小程序能力和数据分析上，和微型码一致。
# 4. 落地小程序
# Q：微信是否提供落地小程序开发？
A：微信不提供落地小程序开发，由品牌自行开发或委托第三方服务商开发。可通过一物一码服务商市场案例介绍，评估和选择合适的服务商。
# Q：码和小程序的跳转关系是如何定义的？同一批次的码可以跳转不同的小程序吗？
A：码和小程序的跳转关系，是在调用码激活接口时定义的，可以根据某批次下不同的码段，灵活定义跳转的小程序，以及小程序下的页面。同批次同号段的码，可以重复激活跳转关系。因此，发码阶段不需要确定码和小程序的对应关系，可灵活定义。
# Q：一物一码场景下，有哪些小程序能力？
A：一物一码场景的特殊赋能是小程序红包和扫码关注公众号。其中小程序红包即将开放，扫码关注公众号的组件已开放。此外，根据不同的扫码诉求，小程序拥有多种能力组合，相比H5，有更好的用户体验和回流渠道，也是品牌连接微信生态的第一步。
# 5. 用户扫码
# Q：消费者扫码体验是怎么样的？
A：无论是微型码还是普通二维码，消费者仅可通过微信扫码。通过其他应用扫码时，微型码将难以读取；普通二维码将通过浏览器跳转码代表的url并返回错误提示。
# 6. 持续运营
# Q：如何查看扫码数据和用户分析？
A：在赋码商品投放市场，产生扫码数据后，可以登录微信公众平台，在一物一码功能菜单下，查看详细的扫码数据和用户分析。
# Q：可查看的数据维度包含哪些？和小程序数据看板有什么不同？
A：扫码数据包含商品、活动的扫码时间、地点、次数分布，以及商品交叉扫码情况。用户分析包含用户年龄、性别、地域、终端、机型分布，品牌触达，以及对不同商品的复购情况。
小程序数据为单个小程序的访问数据和用户分析，包含多种流量来源。一物一码数据是扫码本身反映的综合数据，体现的是同一主体下的扫码分布，可有多个小程序承接不同服务，同时支持对活动、品牌、商品的筛选。
# Q：扫码数据如何运用？能否和品牌自有CRM打通？
A：可以结合品牌自有CRM综合分析。需要指出的是，微信提供的数据分析为群像数据，不包含单个消费者的信息，不能实现个体维度对应。
扫码数据是消费者消费行为的客观反馈，在获取到准确扫码数据的基础上，可以分析并利用微信生态内消息通道，如公众号图文消息等进行再触达。
此外，扫码用户可以作为核心用户，实现微信商业流量的准确触达，提升广告效能。