其他电子凭证
SPED 税务申报
1 个接口
POST
/api/sped/efd生成 SPED EFD
生成指定期间的 SPED EFD ICMS/IPI(数字财务记账)文件,数据来自生产环境中的自开发票(NF-e 型号 55)— 出库和入库(例如:退货,tpNF=0),含已取消的发票(C100 记录 COD_SIT=02,依据《Guia Prático》)。可通过 status 和 tipo 参数选择写入文件的内容:已授权/已取消/全部,以及入库/出库/全部。构建 0/B/C/D/E/G/H/K/1/9 区块、ICMS 计税(E110/E116 — 销项借方 × 进项贷方)、参与方以及会计师(0100 记录,若存在公司会计师资料则自动填充)。文件以 ISO-8859-1 编码生成并上传至存储,响应在 arquivo_url 中返回下载链接。
必需请求头
| 请求头 | 类型 | 说明 |
|---|---|---|
| token | string | 公司令牌 |
| sign | string | MD5 签名 |
| timestamp | string | 秒级 Unix 时间戳 |
Body — 参数
| 字段 | 类型 | 说明 |
|---|---|---|
| start_date * | string | 期间起始,格式为 dd/MM/aaaa 或 dd/MM/aaaa HH:mm:ss。不含时间时默认为 00:00:00。圣保罗时区。 |
| end_date * | string | 期间结束(相同格式)。结束为不包含(开区间)— 若要整月,请使用次月第一天(例如:01/07/2026)。 |
| status | string | 可选。包含发票的状态:"todas"(默认)、"emitidas"(仅已授权)或 "canceladas"(已取消)。 |
| tipo | string | 可选。操作类型:"todas"(默认)、"saida"(出库;也接受带重音的写法 "saída")或 "entrada"(入库)。入库指 tpNF=0 的自开发票,例如退货。使用 status 或 tipo 筛选时,生成的文件只是用于核对的节选 — 当月正式的 EFD 文件必须包含全部发票。 |
| limit | number | 可选。限制处理的发票数量 — 仅用于快速测试。 |
| cod_ver | string | 可选。覆盖布局版本(COD_VER)。默认根据期间确定。 |
| perfil | string | 可选。覆盖呈现档案(A/B/C)。 |
| ativ | string | 可选。覆盖活动指标(0/1)。 |
* 必填字段。