乐企沙箱控制

操作手册更新版本记录

1. 乐企沙箱控制操作路径以及所属模块编码

【发票云】→【基础资料】→【乐企相关】→【乐企沙箱控制】

所属模块编码：F11019

所属模块名称：合规管控

2. 乐企沙箱接入要求

企业使用乐企沙箱，需要满足以下条件：

1、直连单位需完成乐企直连单位接入，将系统的互联网出口 IP 报税务机关备案，开通 IP 白名单。

2、直连单位需完成乐企数字能力的订阅。

3、直连单位需要获取自身及虚拟使用单位平台编号（乐企 ID）。

4、直连单位需要获取沙箱密钥用于报文请求加密。

5、在沙箱环境，一个直连单位默认分配一个虚拟使用单位。除保险行业企业外销售方纳税人识别号和购买方纳税人识别号不能相同，直连单位只能给虚拟使用单位开票，或接收虚拟使用单位开票。保险行业企业允许购销方纳税人识别号一致，需调用企业基础信息更新接口设置行业代码。

更多信息请查看： 乐企数字开放平台 - 沙箱操作指引 1 （开票及基础） -V4.000.pdf

3. 配置乐企沙箱环境（开具测试发票）

3.1.  指定乐企沙箱服务地址（必配）

路径：开发服务云->开发平台->发票云->系统管理->云应用参数配置->参数配置单据->列表（TAB）->预览 -> 新增 两项配置:

第1项（如果已经存在该项配置，则点击进行编辑操作即可）： 配置项类型: 填写（bdm_lqpt）,

配置项key: 填写（baseurl），

配置项值：填写（https://lqpt.chinatax.gov.cn:8443/access/newsandbox/v2/invoke/，如果使用代理服务，需修改为代理地址，最终需访问到该地址） 第2项（如果已经存在该项配置，则点击进行编辑操作即可）:

配置项类型: 填写（bdm_lqpt）,

配置项key: 填写（sxcsbz），

配置项值：填写（1）

如下图所示：

4. 乐企沙箱控制配置流程

页面中沙箱基础配置模块必须配置，沙箱场景测试模块在沙箱使用对应场景时配置，其中沙箱场景测试-通用对测试开票、用票均生效，沙箱场景测试-开票对测试开票场景生效，沙箱场景测试-用票对用票场景生效。

4.1. 沙箱基础配置

步骤一：

1、控制服务地址：自动填写，如果使用代理服务，需修改为代理地址，最终需访问到乐企沙箱控制服务地址： https://lqpt.chinatax.gov.cn:8443/access/sandbox_kzfw/v1。

2、接入单位乐企id：必填，填写企业接入单位乐企沙箱id（与乐企正式id是同一个），用于连接沙箱环境。

3、接入单位乐企沙箱密钥：必填，填写企业接入单位乐企沙箱密钥（请注意，不是乐企正式密钥），用于连接沙箱环境。

4、接入纳入识别号：必填，选择接入单位税号，需先在发票云→基础资料→企业信息中，将接入单位的税号绑定发票云组织中，并完成许可授权。

5、省市级税务机关代码：必填，选择接入单位的机关代码。

步骤二：

填写步骤一内容后，先选择虚拟企业组织，再点击初始化。

1、虚拟企业组织：需要先在发票云→基础资料→企业信息中，引入为发票云组织。注意，不要配置税号！！点击放大镜可以选择已创建、无税号的组织。

在沙箱控制中点击初始化，乐企接口会自动返回虚拟税号。

虚拟单位为乐企分配的虚拟单位组织（购方），需要把该虚拟单位绑定发票云组织，用于测试购方确认红字确认单等场景。

2、点击后方【初始化】按钮，可获取乐企分配的虚拟单位税号、名称、乐企id，系统自动将虚拟单位和已选中的虚拟企业组织绑定，如未自动绑定可能是发票云版本较低，可以在发票云→基础资料→企业信息中将组织设置虚拟企业税号、名称等信息。

3、在发票云→基础资料→企业信息→许可授权，选择虚拟单位税号，进行许可授权。

4.2. 沙箱场景测试-通用

自动获取基础信息，可手动编辑企业信息。

1、点击【企业基础信息变更】按钮，可以将填写的企业信息上传至乐企，将乐企中的企业信息更新为本次填写的信息。

2、点击【企业基础信息重置】按钮，将乐企中的企业信息更新为初始的企业信息。

如对企业信息没有特殊要求，不需要操作，如需变更或重置，点击后方【企业基础信息变更】或【企业基础信息重置】按钮。

4.3. 沙箱场景测试-开票

企业信息初始化（必配）

1、企业税号：配置接入单位税号

2、省市级税务机关代码：选择接入单位所在税局的税务机关代码。

授信额度设置

适用于需要增加授信额度的场景。

1、销方税号：填写开票企业税号

2、授信额度：填写需要增加的授信额度金额

点击后方的【增加授信额度】按钮，将输入的授信额度上传至乐企，乐企增加授信额度。

发票认证抵扣状态设置

适用于测试原蓝票已入账/已抵扣后，申请红字确认单需对方确认的场景。

1、购方税号：填写虚拟单位的税号

2、蓝字发票发票号码：需要入账的发票号码

3、发票入账状态：设置发票的入账状态

4、发票抵扣状态：设置发票的抵扣状态

设置完成，点击后方的【状态变更】按钮，即可将该发票在乐企变更为指定状态，可进行场景测试。

4.4. 沙箱场景测试-用票

用票初始化

测试用票必须配置，可以选择用票的初始化场景。

1、初始化场景编码：选择需要使用的用票场景，不需要测试时，可不配置。

选择完成后，点击后方【初始化】按钮，将乐企中企业的用票设置为指定场景。

不同场景说明如下：

税款所属期期设置

适用于测试在不同税款所属期的发票用票场景。

1、税控所属期：选择需要测试的税款所属期

2、申请标志：填写需测试的申请标志

配置完成后，点击后方【税款所属期】按钮，可以将已配置的信息上传乐企，将乐企中企业的税控所属期，设置为指定信息。