发票邮件
查询邮件模板
完整模板,含正文与该类型允许的变量清单。
GET
/openapi/v2/emails/templates/{templateId}需要
token、timestamp、sign 三个签名头,参见认证与签名。按 templateId 返回本集成商的一份模板,含 corpoHtml 与 variaveisDisponiveis。其他集成商的模板不可见,返回 10021001。
路径参数
templateId* | string | 模板标识 |
* 必填字段
200
模板存在。
templateId | string | 模板标识 |
tipoDocumento | string | 发票类型 |
idioma | string | 模板语言 |
nome | string | 模板名 |
assunto | string | 主题模板 |
corpoHtml | string | 正文模板 |
padrao | bool | 是否默认模板 |
ativo | bool | 是否启用 |
variaveisDisponiveis | array | 可用变量清单 |
criadoEm | string | 创建时间 |
atualizadoEm | string | 更新时间 |
variaveisDisponiveis 是模板可用变量的完整清单,顺序与平台声明一致:先是 11 个公共变量,再是该类型专属的。可以用它来做模板编辑器;不在清单内的名字在保存时被 10021003 拒绝。
NFe:只有公共变量
NF-e 没有专属变量;cliente.nome 是买方。
json
["numero","serie","chaveAcesso","dataEmissao","valorTotal","emitente.nome","emitente.cnpj","cliente.nome","cliente.documento","linkPdf","linkXml"]
variaveisDisponiveis* | array | 可用变量清单 |
* 必填字段
NFSe:公共加四个专属
codigoVerificacao、municipio、descricaoServico、valorIss;cliente.nome 是服务承担方。
json
["numero","serie","chaveAcesso","dataEmissao","valorTotal","emitente.nome","emitente.cnpj","cliente.nome","cliente.documento","linkPdf","linkXml","codigoVerificacao","municipio","descricaoServico","valorIss"]
variaveisDisponiveis* | array | 可用变量清单 |
* 必填字段
CTe:公共加三个专属
remetente.nome、destinatario.nome、valorFrete;cliente.nome 是运费承担方。
json
["numero","serie","chaveAcesso","dataEmissao","valorTotal","emitente.nome","emitente.cnpj","cliente.nome","cliente.documento","linkPdf","linkXml","remetente.nome","destinatario.nome","valorFrete"]
variaveisDisponiveis* | array | 可用变量清单 |
* 必填字段
DCe:公共加一个专属
marketplace.site 取自主体的 DC-e 档案;cliente.nome 是收货人。
json
["numero","serie","chaveAcesso","dataEmissao","valorTotal","emitente.nome","emitente.cnpj","cliente.nome","cliente.documento","linkPdf","linkXml","marketplace.site"]
variaveisDisponiveis* | array | 可用变量清单 |
* 必填字段
tipoDocumento发票类型
| 取值 | 含义 |
|---|---|
| NFe | NF-e 商品发票 |
| NFSe | NFS-e 服务发票 |
| CTe | CT-e 运输发票 |
| DCe | DC-e 内容申报 |
idioma模板语言
语言决定变量里金额与日期的格式;时刻一律按圣保罗时区。
| 取值 | 含义 |
|---|---|
| pt | 葡萄牙语;金额 1.234,56,日期 dd/MM/yyyy HH:mm |
| en | 英语;金额 1,234.56,日期 yyyy-MM-dd HH:mm |
| zh | 中文;金额 1,234.56,日期 yyyy-MM-dd HH:mm |
| es | 西班牙语;金额 1.234,56,日期 dd/MM/yyyy HH:mm |
variaveisDisponiveis[]模板变量:四类单据共有
写法 {{nome}},花括号内可有空格。无值时渲染为空文本。正文里取值经 HTML 转义,主题里不转义。
| 取值 | 含义 |
|---|---|
| numero | 票号 |
| serie | 系列号 |
| chaveAcesso | 访问密钥,44 位或 50 位 |
| dataEmissao | 开票时间,按圣保罗时区与模板语言格式化 |
| valorTotal | 票面总额,按模板语言格式化;NF-e 取票总额,NFS-e 取服务金额,CT-e 取运输服务总额,DC-e 取申报总额 |
| emitente.nome | 开票主体名称 |
| emitente.cnpj | 开票主体 CNPJ |
| cliente.nome | 收件方名称;NF-e 买方、NFS-e 与 CT-e 承担方、DC-e 收货人 |
| cliente.documento | 收件方证件号,CPF 或 CNPJ |
| linkPdf | PDF 凭证下载链接;有效期按集成商设置,缺省 7 天 |
| linkXml | 授权 XML 下载链接;XML 尚未归档时为空 |
variaveisDisponiveis[]模板变量:NFSe 专属
在其他发票类型的模板里使用会在保存时被拒,10021003。
| 取值 | 含义 |
|---|---|
| codigoVerificacao | NFS-e 校验码 |
| municipio | 开票主体所在市镇名称 |
| descricaoServico | 服务描述 |
| valorIss | ISS 税额,按模板语言格式化 |
variaveisDisponiveis[]模板变量:CTe 专属
在其他发票类型的模板里使用会在保存时被拒,10021003。
| 取值 | 含义 |
|---|---|
| remetente.nome | 发货人名称 |
| destinatario.nome | 收货人名称 |
| valorFrete | 运费总额,按模板语言格式化 |
variaveisDisponiveis[]模板变量:DCe 专属
在其他发票类型的模板里使用会在保存时被拒,10021003。
| 取值 | 含义 |
|---|---|
| marketplace.site | 平台站点,取自主体的 DC-e 档案 |
| 错误码 | HTTP | |
|---|---|---|
| 10021001 | 404 | 邮件模板不存在:templateId 不存在或不属于本集成商。 |
