通用 > 巴西发票
共 14 条需求，按创建时间倒序。产品经理：陈家宜
当前最新逻辑
（待人工总结：以最新一条已完成需求的描述为准）
需求历史
2025-11-19 ｜ 已完成 ｜ ECERPH-39799
标题：订单系统》shopee巴西发票状态更新说明
负责人：梁康太 ｜ 需求类型：客户需求 ｜ 模块：销售-订单管理 ｜ 迭代：20251209-常规-12月第二迭代 ｜ 最后更新：2025-12-09
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
客户代码：ntinwp9 订单：2511183QDQHVPN 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》shopee订单
- 如果我们系统的上传发票成功后，如果平台返回订单内的标识显示未上传发票也不要更新订单发票上传状态，以系统的发票上传成功状态为准
（系统上传，以系统上传为准，平台上传，以平台上传状态为准，不能回滚状态）
2025-11-14 ｜ 已完成 ｜ ECERPH-39375
标题：订单系统》巴西发票管理下载和上传发票功能调整
负责人：梁康太 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-订单管理 ｜ 迭代：20251202-常规-12月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
测试客户：
- 需求（做什么？怎么做？有什么要注意的？）
1.上传失败的订单点击【上传发票】的情况下出现的情况如下，需要进行优化 【图片】
2、点击单个订单下载xml的时候，勾选单个订单的xml但是却下载到整个列表的xml，下载danfe也是一样下载了整个列表的pdf 【图片】 【图片】
2025-10-24 ｜ 已完成 ｜ ECERPH-37731
标题：订单系统》巴西发票管理上传发票文件的时候调整为使用xml文件进行上传
负责人：梁康太 ｜ 需求类型：客户需求 ｜ 模块：销售-订单管理 ｜ 迭代：20251111-常规-11月第二迭代 ｜ 最后更新：2025-11-11
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
【图片】
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》巴西发票管理
- 上传至shopee的发票的文件类型调整为XML，并且需要使用发票xml文件进行上传。
【图片】
2.下载xml文件的时候提示没有下载发票数据。需要调整此问题。 【图片】
【图片】
2025-10-15 ｜ 已完成 ｜ ECERPH-36965
标题：订单系统》巴西发票管理不需要手机号码进行开票
负责人：文明亮 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-订单管理 ｜ 迭代：20251028-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
shopee的手机号码是加密的推送到bling导致无法正常开票，所以调整发票 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》巴西发票管理
1.创建发票的时候mobile和Phone都不用传参 【图片】
2.已开票状态上的上传状态下，如果上传失败需要显示接口返回的失败原因在如下截图位置 【图片】 并且上传失败的情况下，此发票新增显示【上传发票】按钮，点击后立刻向平台上传发票如下 【图片】
2025-09-17 ｜ 已完成 ｜ ECERPH-35558
标题：订单系统》巴西发票管理增加发件人的取值-需前端
负责人：梁康太 ｜ 需求类型：扬帆起航(启航版) ｜ 模块：销售-订单管理-拉单 ｜ 迭代：20251014-常规-10月第一迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
测试客户：ntinwp9 测试创建发票失败： 【图片】 和wms那边成功开票的订单对比了信息后发现是少了Importer和Shipper ，补充后再测试
- 需求（做什么？怎么做？有什么要注意的？）
1.接口补充以下传值
| 接口字段 | 系统是否校验必填 | object | 系统字段 | 系统取值 |
| --- | --- | --- | --- | --- |
| shipper.name | 是 | string | 姓名 | 运输方式关联的物流地址簿（发货地址）-联系人
【图片】
【图片】 |
| shipper.companyName | 是 | string | 公司名称 | 运输方式关联的物流地址簿（发货地址）-公司名称 |
| shipper.countryCode | 是 | string | 国家（二字简码） | 运输方式关联的物流地址簿（发货地址）-国家 |
| shipper.stateOrProvince | 是 | string | 州/省 | 运输方式关联的物流地址簿（发货地址）-州/省 |
| shipper.city | 是 | string | 城市 | 运输方式关联的物流地址簿（发货地址）-城市 |
| shipper.district | 否 | string | 区 | 运输方式关联的物流地址簿（发货地址）-区 |
| shipper.address1 | 是 | string | 地址1 | 运输方式关联的物流地址簿（发货地址）-地址1 |
| shipper.address2 | 否 | string | 地址2 | 运输方式关联的物流地址簿（发货地址）-地址2 |
| shipper.houseNo | 否 | string | 门牌号 | 运输方式关联的物流地址簿（发货地址）-门牌号 |
| shipper.postalCode | 否 | string | 邮编 | 运输方式关联的物流地址簿（发货地址）-邮编 |
| shipper.phone | 否 | string | 电话号码 | 运输方式关联的物流地址簿（发货地址）-联系电话 |
| shipper.mobile | 否 | string | 电话号码 | 运输方式关联的物流地址簿（发货地址）-联系电话 |
| shipper.phoneExtension | 否 | string | 电话分机号 | |
| shipper.email | 否 | string | E-mail | 运输方式关联的物流地址簿（发货地址）-邮箱 |
| shipper.vatNum | 是 | string | 发件人税号 | 运输方式关联的物流地址簿（发货地址）-发件人税号 |
| products.grossWeight | 是 | float | 商品毛重
最多保留2位小数 | 仓库SKU-毛重
【图片】 |
| products.netWeight | 是 | float | 商品净重
最多保留2位小数 | 仓库SKU-净重。
如果净重为0或者为空则取值毛重进行传值
【图片】 |
| order.weightUnit | 否 | string | 重量单位，可选值（KG、G、LB、OZ），默认KG
KG 千克
G 克
LB 磅
OZ 盎司 | 默认KG |
| products.nameEn [调整取值] | 是 | string | 英文品名 | 原取值仓库SKU的英文名现在调整为取值平台SKU的商品标题 |
2.新增配置：bling巴西发票发送发票失败是否自动删除发票 Y：是 N：否（默认值）
【图片】
3.增加校验： 1、如果创建发票的时候缺失以上的必填字段时候转到开票失败并且增加以下提示： 缺失shipper相关字段的时候提示： 缺少寄件人的[系统字段名称]，请设置订单关联运输方式的发货地址或者补充发货地址在物流地址簿中的[系统字段名称] 例如：缺少寄件人的[发件人税号]，请设置订单关联运输方式的发货地址或者补充发货地址在物流地址簿中的[发件人税号]
4.在开票失败状态下新增“重新开票”的按钮，点击出现确认弹窗。 点击后需要重新更新获取所有的开票信息，按照最新的开票信息进行开票 【图片】 【图片】
2025-08-28 ｜ 已完成 ｜ ECERPH-34275
标题：【巴西发票】账号系统》bling授权的时候调整为查询发票接口来判断授权是否成功
负责人：梁康太 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-平台账号授权 ｜ 迭代：20250909-常规-9月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
bling这边客户授权的时候，没有勾选Ordens de Produção 这个权限，因为这个权限现在要购买更贵的套餐才能使用，所以出现以下错误提示，能不能优化下？ 我这边和平台确认了实际上只用勾选截图那个权限就能开票（也确认了最低的套餐就能使用api开票）
- 需求（做什么？怎么做？有什么要注意的？）
账号系统》bling
bling授权的时候需要调整为使用GET https://www.bling.com.br/Api/v3/nfe 接口判断授权是否成功。 接口：https://developer.bling.com.br/referencia#/Notas%20Fiscais%20Eletr%C3%B4nicas/get_nfe
调用接口的时候只要接口通了，没有返回内容也认为此授权成功了
2025-07-17 ｜ 已完成 ｜ ECERPH-31544
标题：订单系统》巴西发票管理问题优化
负责人：梁康太 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-订单管理 ｜ 迭代：20250812-常规-8月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
订单系统》巴西发票管理
1.【开票并上传】页面优化 （1）页面的操作按钮固定在弹窗的右下角和系统弹窗保持一致 【图片】
（2）订单状态更新后不是待发货审核状态点击【开票上传】的时候弹窗提示：订单状态非待发货审核，无法进行开票上传。这种情况下不需要打开【开票上传】弹窗。
（3）收件人类型默认值为个人 【图片】 （4）【开票上传】成功提示：已经成功加入创建发票队列 后 关闭【开票上传】页面 【图片】
2.巴西发票管理列表页面调整 （1）将此下载xml的按钮调整成获取界面中的xml（invoiceXmlUrl） 【图片】
【图片】
（2）同步时间调整名称为上传时间。 【图片】
（3）新增Bling发票状态字段，取值oapi报文中的invoiceStatus（显示为中文） 【图片】 【图片】 | 状态编号 | 状态（葡萄牙语） | 状态（中文） | 说明 | | --- | --- | --- | --- | | 1 | Pendente | 待处理 | 文档已生成，但尚未传输或未被税务局（SEFAZ）验证。 | | 2 | Cancelada | 已取消 | 文档已被取消，不再具备税务效力。 | | 3 | Aguardando recibo | 等待回执 | 税务局已接收文档，但尚未签发授权协议。 | | 4 | Rejeitada | 已拒绝 | 税务局因数据错误或不一致等原因拒绝了该文档。 | | 5 | Autorizada | 已授权 | 文档已通过税务局验证并批准，具备税务效力。 | | 6 | Emitida DANFE | 已生成DANFE | DANFE（电子发票辅助文件）已生成，但电子发票尚未授权。 | | 7 | Registrada | 已登记 | 文档已在系统登记，但尚未推送税务局 | | 8 | Aguardando protocolo | 等待协议 | 文档已提交至税务局，正在等待授权协议的签发。 | | 9 | Denegada | 已否决 | 税务局因税务问题（如开票方或接收方不合规）拒绝授权。 | | 10 | Consulta situação | 查询状态 | 临时状态，表示正在手动查询该电子发票的状态。 | | 11 | Bloqueada | 已冻结 | 文档因司法或税务监管原因被冻结，无法使用。 |
（5）目前已开票的订单不会自动上传发票，需要优化当订单的发票成功进入已开票需要加入待开票的队列向平台推送发票
2025-06-30 ｜ 已完成 ｜ ECERPH-30541
标题：订单系统》巴西发货管理中商品的CEST改为非必填项
负责人：梁康太 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-订单管理 ｜ 迭代：20250708-常规-7月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
订单系统》巴西发货管理
1.创建巴西发货的时候商品中的CEST不是必填参数，不需要强制校验。
2025-06-17 ｜ 已完成 ｜ ECERPH-29587
标题：仓配系统》shopee巴西待上传发票的订单需要上传发票成功后再进行预报
负责人：王海刚 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：仓配-物流管理 ｜ 迭代：20251209-常规-12月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
关联需求：https://devops.aliyun.com/projex/project/b3b56b1f88e98c5e0b75512fe1/req/daa3699ab75c49da41e8c87378 【图片】 https://devops.aliyun.com/projex/req/ECERPH-39799# 《订单系统》shopee巴西发票状态更新说明》
【图片】
-
需求（做什么？怎么做？有什么要注意的？）
-
针对shopee平台线上物流生效：SHOPEE 需要去查询订单是否待上传发票或者是否已上传发票
【orders 表 invoice_status 1 已上传 4 待上传】
2、如果发票标识为已上传则需要正常预报。 如果发票标识为待上传需要通知OAPI需要先通过拉单接口查询订单是否已经上传发票。如果还未上传发票则通知仓配系统等待下一轮再预报。 订单初次预报时间至今预报时间已超过24小时还处于无发票无法预报的情况下则需要将订单转问题件并且提供异常信息“此订单还未上传发票，无法进行预报，请先上传发票然后再审核订单进行预报”
2025-05-26 ｜ 已完成 ｜ ECERPH-28313 🚀【0-1】
标题：【巴西发票】新增发票发票管理页面
负责人：梁康太 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-客服管理 ｜ 迭代：20250630-紧急-6月紧急迭代 ｜ 最后更新：2026-05-18
原始需求：01_原始需求\ECERPH-28313_【巴西发票】新增发票发票管理页面\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
oapi提供的接口：https://eccang.yuque.com/gv76wn/dfz5b2/zchwmz8noprskaad
Bling接口文档： https://developer.bling.com.br/bling-api#introdu%C3%A7%C3%A3o
- 需求（做什么？怎么做？有什么要注意的？）
前置需求： 1.https://devops.aliyun.com/projex/req/ECERPH-28011# 《【巴西发票】仓配系统》产品资料新增支持填入税务信息NCM和CEST》 2.https://devops.aliyun.com/projex/req/ECERPH-27925# 《【巴西发票】订单系统》shopee订单新增待上传发票和已上传发票的标识》 3.https://devops.aliyun.com/projex/req/ECERPH-27601# 《【巴西发票】订单系统》shopee订单保存订单的CPF》 4.https://devops.aliyun.com/projex/req/ECERPH-28014# 《【巴西发票】新增Bling平台授权功能》
中台需求： 1.https://devops.aliyun.com/projex/req/ECERPJ-7664# 《中台》shopee需要提供一个拉取订单list的透传接口接口》【已上线】 关联文档： https://eccang.yuque.com/gv76wn/kz11w8/sfog071znefqc8gn 2.https://devops.aliyun.com/projex/req/ECERPJ-7601# 《中台》shopee新增对接上传发票的接口》【已上线】
【以上基础需求需要和巴西发票需求一起上线】
订单系统》巴西发票管理
- 新增巴西发票管理-店铺绑定页面
【图片】 (1)展示当前授权的Bling账号以及绑定的店铺账号别名。 (2)点击查看全部和绑定店铺弹出如下绑定店铺弹窗 【图片】 ①添加绑定店铺弹窗如下，支持一次性多选多个店铺，选择多个店铺后按照每个店铺一行进行保存数据。 【图片】 ②添加店铺内仅展示Shopee巴西店铺以及未绑定Bling账号的店铺。 ③发票商品金额支持以下2个设置方式 【图片】 ④发票运费金额支持选择不含买家运费和含买家运费 （2）编辑绑定设置弹窗如下 【图片】
（3）删除绑定设置弹窗如下： 【图片】 （4） 日志 | 操作场景 | 日志内容 | | --- | --- | | 绑定店铺关系 | 将XX店铺和此Bling账号绑定，发票商品金额按照商品金额百分比：10%，不含买家运费进行开票 | | 编辑店铺关系 | XX店铺的发票商品金额设置由按照商品金额百分比：10%调整为按照订单全额开票 | | 删除店铺关系 | 删除和XX店铺的绑定关系 |
（5）筛选项 Bling账号：支持多选筛选 店铺账号：仅显示shopee店铺，支持多选筛选 授权状态：已授权/授权异常/已过期，单选筛选 账号状态：开启/关闭，单选筛选
2.在shopee订单上待发货审核状态下新增按钮 【图片】 (1)勾选的订单不是待上传发票的订单提示 【图片】 （2）)勾选的订单的订单号在系统内已经申请开票过了 【图片】
(2)勾选的订单都是待上传发票订单的时候弹窗如下： 【图片】 ①点击开票的时候检验订单所在店铺有没有绑定Bling店铺 【图片】 ②检验商品信息中是否缺失NCM码 【图片】 ③检查订单中是否所有商品都设置了不发 【图片】
④订单的商品缺失产品商品英文名 【图片】 ⑤已经成功加入创建发票队列 【图片】
（3）①以上勾选的订单仅加入待开发票的队列等待等待订单审核成功后按照订单审核后的订单内容生成发票 ②这些订单在审核的时候要推送给仓配系统，通知仓配系统这些订单为待上传发票的订单，暂缓进行订单预报。 ③创建发票成功（即订单发票状态为开票中）后需要在订单日志中记录：”订单已提交开票，请在巴西发货管理页面查看开票结果。此订单将在发票上传成功后再进行预报。”
（4）创建发票接口调用详情说明
| 参数名 | 必选 | 类型 | 说明 | 服务商字段名 | 系统取值说明 | |
| --- | --- | --- | --- | --- | --- | --- |
| account | 是 | object | 帐号信息（params.account） | | | |
| url | 否 | string | API请求地址
不填会使用默认地址：https://www.bling.com.br | | | |
| authCompanyCode | 是 | string | 帐号中心公司代码 | 传这2个字段时，将会使用帐号中心的授权信息 | 客户代码 | |
| platformSellerId | 是 | string | 帐号中心店铺帐号 | Bling店铺账号英文名 | username | 是 |
| | string | bling账号 | 传这3个字段时，将会使用OAPI的授权功能 | | clientId | 是 |
| | string | bling开发者clientId | | clientSecret | 是 | string |
| | bling开发者clientSecret | | order | 是 | object | 订单信息 |
| （params.order） | | | orderNo | 是 | string | 订单号 |
| | | 系统订单号 | weightUnit | 否 | string | 重量单位，可选值（KG、G、LB、OZ），默认KG |
| KG 千克
G 克
LB 磅
OZ 盎司 | | | createTime | 否 | string | 签发时间(巴西时间) |
| example: 2025-05-12 12:34:19
不传值时默认传当前时间 | dataOperacao | 创建发票的时间（使用巴西首都的时间UTC-3） | shippingAmount | 否 | string | 发票相关的额外费用。这些费用可以是运输费、手续费、包装费等，通常会影响发票的总金额。 |
| 默认为0 | despesas | 根据订单上用户的设置决定是否填写运费 | discountAmount | 否 | string | 对发票总金额的折扣。折扣可以是固定金额或百分比，通常用于促销、客户优惠或批量购买 |
| 默认为0 | desconto | | remark | 否 | string | 备注 |
| 不传值时默认取第1个商品英文名 | observacoes | | ext | 是 | object | 订单信息扩展字段 |
| （params.order.ext） | | | naturezaOperacaoId | 否 | string | 操作性质ID |
| 这个 ID 是 Bling 系统内部生成的，用于区分不同的操作性质
您可登录 Bling 系统，导航到 Cadastros > Naturezas de Operação，在列表中查找您需要的操作性质，并记录其 ID。 | naturezaOperacao.id | | invoiceNum | 否 | string | 发票序号 |
| 如果不传，则会从bling获取最大发票序号再加1生成 | numero | | products | 是 | []object | 产品信息 |
| params.order.products | | | nameEn | 是 | string | 英文品名 |
| | descricao | 仓库SKU产品英文名。如果缺失英文名则报错提示 | sku | 否 | string | 产品sku |
| 为空时取nameEn值 | codigo | 仓库SKU编码 | quantity | 是 | int | 数量 |
| | quantidade | 仓库SKU数量 | quantityUnit | 否 | string | 数量单位 |
| 默认：PCS | unidade | | price | 是 | float | 产品单价 |
| 最多保留2位小数 | valor | 根据订单设置计算：
（1）全额：按照订单商品单价原价进行取值
（2）自定义比例：按照订单单价原价自定义比例计算取值 | grossWeight | 否 | float | 毛重 |
| 最多保留2位小数 | pesoBruto | | netWeight | 否 | float | 净重 |
| 最多保留2位小数 | pesoLiquido | | ext | 是 | object | 扩展字段 |
| （params.products..ext） | 商品扩展 | | ncm | 否 | string | NCM（Nomenclatura Comum do Mercosul，南方共同市场通用命名法）是一个用于商品分类的编码系统。它是巴西和其他南方共同市场国家（如阿根廷、巴拉圭、乌拉圭等）用于标识商品类型和适用税率的标准编码。 |
| | classificacaoFiscal | 根据仓配系统用户在仓库SKU上填写的NCM推送 | cest | 否 | string | CEST（Código Especificador da Substituição Tributária，替代税特定代码）是一个用于标识商品是否适用 替代税制度（Substituição Tributária, ST） 的编码。CEST 编码与 NCM 编码结合使用，帮助确定商品的税务处理方式。 |
| | cest | 根据仓配系统用户填写在仓库SKU上填写的的Cest推送 | source | 否 | string | Origem（来源）用于标识商品的来源地。这个字段与巴西的税务规则（如 ICMS 税率）密切相关，直接影响税费的计算。默认为0. |
0 国产商品（Nacional）
1 进口商品（Estrangeira - Importação Direta）
2 进口商品（Estrangeira - Adquirida no Mercado Interno）
3 国产商品，且符合特定法律条件（Nacional, Conteúdo de Importação >= 40%）
4 国产商品，且符合特定法律条件（Nacional, Cuja Produção Seguiu Processos Produtivos Básicos）
5 国产商品，且符合特定法律条件（Nacional, Conteúdo de Importação < 40%）
6 进口商品（Estrangeira - Importação Direta, sem Similar Nacional）
7 进口商品（Estrangeira - Adquirida no Mercado Interno, sem Similar Nacional）
| 8 国产商品，且符合特定法律条件（Nacional, Conteúdo de Importação >= 70%） | origem | | |
| --- | --- | --- | --- |
| serviceCode | 否 | string | 服务代码，是用于标识发票（Nota Fiscal de Serviço, NFS-e）中提供的服务类型的代码。这个代码是巴西市政服务税（ISS）计算和申报的关键信息。 |
| | codigoServico | | |
| shipper | 是 | object | 发件人信息（params.shipper） |
| name | 否 | string | 姓名 |
| companyName | 否 | string | 公司名称 |
| | nomeUsuario | | |
| countryCode | 否 | string | 国家二字简码 |
| stateOrProvince | 否 | string | 州/省 |
| city | 否 | string | 城市 |
| address1 | 否 | string | 地址1 |
| address2 | 否 | string | 地址2 |
| houseNo | 否 | string | 门牌号 |
| postalCode | 否 | string | 邮编 |
| phone | 否 | string | 电话号码 |
| mobile | 否 | string | 电话号码 |
| phoneExtension | 否 | string | 电话分机号 |
| email | 否 | string | E-mail |
| vatNum | 否 | string | cnpj税号 |
| | cnpj | | |
| consignee | 是 | object | 收件人信息（params.consignee） |
| name | 是 | string | 姓名 |
| | nome | 收件人名称 | |
| countryCode | 是 | string | 国家二字简码 |
| 默认为BR | pais | 收件人国家二字码 | |
| stateOrProvince | 是 | string | 州/省 |
| | uf | 州/省 | |
| city | 是 | string | 城市 |
| | municipio | 城市 | |
| address1 | 是 | string | 地址1 |
| | endereco | 地址1 | |
| address2 | 否 | string | 地址2 |
| | 地址2 | houseNo | 否 |
| | string | 门牌号 | numero |
| | 门牌号 | postalCode | 否 |
| | string | 邮编 | cep |
| | 邮编 | phone | 是 |
| | string | 电话号码 | telefone（有手机优先取手机，否则取电话） |
| | | mobile | 否 |
| | string | 手机号码 | 手机号码 |
| | email | 否 | string |
| | 邮箱号 | email | 邮箱号 |
| | vatNum | 是 | string |
| | CNPJ（公司） 或 CPF（个人） 税号 | numeroDocumento | CPF |
| | ext | 是 | object |
| | 扩展字段
（params.consignee.ext） | | |
| | personType | 否 | |
| | 联系人的类型 | | |
F-Física 个人
J-Jurídica 公司
E-Estrangeira 外国联系人
| 不填默认 F | tipoPessoa | 根据用户选择 | |
| --- | --- | --- | --- |
| taxPayer | 否 | string | 纳税人类型(可不传) |
| 1 Contribuinte do ICMS 需要缴纳 ICMS 的正规企业
2 Contribuinte isento de ICMS 享受 ICMS 免税政策的行业或交易
9 Não contribuinte 个人消费者
如果未传值时，会自动根据 personType值传值：如果 personType 为 J 时传 1; 为 F 时,传 9；默认传2 | contribuinte | | |
| stateTaxNum | 是 | string | 州税号 |
| 当personType为 J 时必填 | ie | 用户填写则提供 | |
| specialAttr | 是 | object | 运输属性 |
| insuranceValue | 否 | float | 与发票相关的保险费用。保险费用通常用于保障货物在运输过程中的安全，可能会影响发票的总金额。 |
| 默认为0 | | | |
| 3.发票管理页面
【图片】
（1）发票状态说明
状态 | 场景说明 | 可操作按钮 | |
| 开票中 | 加入系统创建发票队列未推送到Bling的发票 | 查看详情
日志 | |
| 开票失败 | 调用了Bling接口开票失败的发票。（需要区分创建发票接口报错还是发送发票接口报错） | 查看详情
日志 | |
| 已开票 | 调用Bling接口开票成功的发票 | 查看详情
下载XML
下载DANFE（下载PDF） | |
（2）查看详情
【图片】
（3）下载XML/下载DANFE/下载
以上按钮仅在已开票状态下显示。
下载按钮的情况下，如果勾选了发票则导出勾选发票，如果没有勾选发票则导出筛选条件下的发票。
导出的多个发票的时候合并在一个压缩包内，压缩包的名称为：”日期+时间+发票XML/发票Danfe“。例如：202505261130:01发票XML
（4）列表字段说明
| 字段名称 | 取值说明 |
| --- | --- |
| 系统订单号 | 系统订单号+系统订单状态 |
| 发票号 | 已开票状态显示发票号，点击发票号弹出发票详情弹窗 |
| Bling账号 | 发票关联的Bling 账号，显示别名和英文名 |
| 店铺账号 | 订单所属的店铺，显示别名和英文名 |
| 开票金额 | 订单中商品开票金额+运费开票金额之和 |
| 收件人名称 | 发票的收票人的名称以及CPF |
| 时间 | 创建时间：发票在系统的创建时间
开票时间：发票推送给Bling的时间
上传时间：发票推送给平台的时间 |
| 开票失败原因 | 仅在开票失败下显示。 |
需要根据返回判断是创建发票失败还是发送发票失败，并且显示对应的提示词。如下：
创建发票失败，请查看以下失败原因，然后按照失败原因编辑发票后提交重新开票
平台返回失败原因
创建发票失败，请查看以下失败原因，然后按照失败原因编辑发票后提交重新开票
系统返回失败原因（仓库SKU缺失NCM码；仓库SKU缺失英文名称）
发送发票失败，请查看以下失败原因，然后按照失败原因登陆Bling平台编辑发票后再提交开票
| 平台返回失败原因 | |
| --- | --- |
| 上传状态 | 待上传：发票未生成的时候，等待上传发票的状态 |
| 上传中：已生成发票并且进入上传队列的状态
已上传：发票已经成功上传到shopee的状态
上传失败：发票上传到shopee失败的状态 | |
（6）筛选功能 全部店铺：显示shopee的巴西店铺支持多选筛选 全部Bling账号：显示Bling账号，支持多选筛选 开票失败原因：创建发票失败/发送发票失败，支持单选 系统订单号/参考号/发票号：单个搜索时候模糊搜索，多个搜索的时候精确搜索 上传状态：待上传、上传中、已上传、上传失败 时间筛选项：创建时间/开票时间/上传时间。默认选中最近3个月的创建时间
（7）订单的发票状态已开票状态并且通过系统上传发票到shopee成功则需要在对应订单的日志中记录“通过系统成功上传发票，发票号：XXXXXXXXX”
（8）在审核的时候要推送给仓配系统，通知仓配系统这订单为待上传发票的订单暂缓进行订单预报。 这些订单如果通过系统上传发票成功或者此订单更新为已上传发票的订单则再次通知仓配系统此订单可以进行预报了。 关联需求：https://devops.aliyun.com/projex/req/ECERPH-29587# 《仓配系统》shopee巴西待上传发票的订单需要上传发票成功后再进行预报》
2025-05-20 ｜ 已完成 ｜ ECERPH-28014 🚀【0-1】
标题：【巴西发票】新增Bling平台授权功能
负责人：梁康太 ｜ 需求类型：客户需求 ｜ 模块：销售-平台账号授权 ｜ 迭代：20250617-常规-6月第三迭代 ｜ 最后更新：2025-06-17
原始需求：01_原始需求\ECERPH-28014_【巴西发票】新增Bling平台授权功能\原始需求.md
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
巴西发票对接需求
- 需求（做什么？怎么做？有什么要注意的？）
oapi已实现授权操作，可以参考他们的实现：https://eccang.yuque.com/gv76wn/dfz5b2/boon4yg9kdpzo80z
- 账号系统新增Bling平台。
【图片】
平台icon：https://www.bling.com.br/wp-content/themes/bling_br/images/bling.svg
2025-05-20 ｜ 已完成 ｜ ECERPH-28011
标题：【巴西发票】仓配系统》产品资料新增支持填入税务信息NCM和CEST（6.17前一定要上线）
负责人：王海刚 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：仓配-产品管理 ｜ 迭代：20250624-常规-6月第四迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
巴西发票项目协助
- 需求（做什么？怎么做？有什么要注意的？）
1.产品资料内新增填写NCM和CEST。（非必填项） 【图片】 NCM的？提示：在巴西中用于标识商品的类别，适用于进出口报关、关税计算和贸易统计。示例：0203.29.00（8位数字，前6位是国际HS编码，后2位是Mercosur的细分） CEST的？提示：巴西国内税务专用的商品代码，用于标识适用 替代税制（Substituição Tributária, ST）的商品。示例：01.001.00（一般是7位数字，前2位为分类，后5位为细分）
2.产品资料导入属性，海关资料中新增NCM和CEST字段 【图片】 【图片】
2025-05-19 ｜ 已完成 ｜ ECERPH-27925
标题：【巴西发票】订单系统》shopee订单新增待上传发票和已上传发票的标识
负责人：梁康太 ｜ 需求类型：客户需求 ｜ 模块：销售-订单管理 ｜ 迭代：20250617-常规-6月第三迭代 ｜ 最后更新：2025-06-17
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
shopee巴西发票相关说明：https://open.shopee.com/developer-guide/382 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
中台需求：https://devops.aliyun.com/projex/req/ECERPJ-7904# 《中台》针对巴西站点的shopee订单需要额外查询是否待上传发票订单（6.20日需要上线）》
1.将中台中获取到待上传发票标识的订单在系统内标识为待上传发票订单。
2.待上传发票的订单详情更新的时候如果出现以下情况，需要根据情况更新订单上的发票标识 （1）如果订单详情存在invoice_data.number 则标记此订单为已上传发票订单。如果没有invoice_data.number 则仍旧认为此单为待上传发票订单
【图片】
（2）如果订单通过系统上传了发票，也标识此订单为已上传发票订单。【关联此需求：https://devops.aliyun.com/projex/req/ECERPH-28313# 《【巴西发票】新增发票发票管理页面》】
（3）需要区分系统上传的发票还是非系统上传发票。 通过系统上传的发票需要记录日志“通过系统成功上传发票，发票号：XXXXXXXXX”【关联此需求：https://devops.aliyun.com/projex/req/ECERPH-28313# 《【巴西发票】新增发票发票管理页面》】 通过平台获取到的发票上传信息（即通过订单报文中获取到invoice_data.number）则记录日志：”已在平台上或者其他方式上传了发票，发票号：XXXXXXX“
（4）待上传发票订单标识（同amazon订单中的发票标识）：鼠标悬停提示”待上传巴西发票“ 【图片】 已上传发票标识（同amazon订单中的发票标识）：鼠标悬停提示”已上传巴西发票“
3.shopee订单上新增筛选项： 巴西发票：全部/待上传/已上传 【图片】 全部：所有订单 待上传：待上传发票标识的订单 已上传：已上传发票标识的订单
2025-05-13 ｜ 已完成 ｜ ECERPH-27601
标题：【巴西发票】订单系统》shopee订单保存订单的CPF
负责人：陈嘉骏 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：销售-订单管理 ｜ 迭代：20250527-常规-5月第四迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
巴西发票开票需要cpf https://open.shopee.com/developer-guide/382
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》shopee订单
1.获取订单中的buyer_cpf _id作为买家的CPF填充系统的CPF字段内 【图片】
【图片】 【图片】