DC-e
发行 DC-e
受理一张电子内容申报单（模型 99），并异步向 SEFAZ 授权。
POST
/openapi/v2/empresas/{empresaId}/dc-e需要
token、timestamp、sign 三个签名头，参见认证与签名。路径参数
empresaId* | string | 发行主体标识 |
* 必填字段
请求体
id* | string | 请求标识 |
ambiente* | string | 发行环境 |
dataEmissao | string | 开具时刻 |
*Marketplace 主体必填。 | object | 发件方 |
* | object | 收件方 |
* | array | 申报物品 |
* | object | 运输信息 |
| array | 下载授权名单 |
informacoesAdicionais | string | 平台备注 |
informacoesAdicionaisFisco | string | 税务机关备注 |
informacoesAdicionaisEmitente | string | 发行方备注 |
| array | 平台自定义项 |
* 必填字段
200
已受理；无响应体。单据进入
Pendente，异步取号并送 SEFAZ。通过查询接口或 Webhook 跟进。无响应体
主体注册时配置的 DC-e 发行类型决定 remetente 怎么填。Marketplace 代卖家发行；OwnIssuer 以自己名义发行；Carrier 当前不能发行，返回 10019013。
Marketplace 代卖家发行
卖家填在 remetente 里，证件号与地址都要传；访问密钥里的 CNPJ 仍是 Marketplace 主体。
json
"remetente": {"tipoPessoa": "F", "nome": "JOAO DA SILVA", "cpfCnpj": "12345678909", "telefone": "41999990000","endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "RUA XV DE NOVEMBRO", "numero": "100", "bairro": "CENTRO", "cep": "80020310" }}
* | object | 发件方 |
* 必填字段
企业自发
不传 remetente，发件方与发货地址取主体档案。若传了 remetente.cpfCnpj，必须等于主体自身 CNPJ，否则 10019019。
json
{"id": "DCe-000012334","ambiente": "Homologacao","destinatario": {"tipoPessoa": "F", "nome": "MARIA OLIVEIRA", "cpfCnpj": "11144477735","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA", "cep": "01310100" }},"itens": [ { "descricao": "CARTEIRA", "ncm": "42023100", "quantidade": 1, "valorUnitario": 40.00 } ],"transporte": { "modalidade": "PorContaPropria" }}
modalidade 必填。cnpjTransportadora 只在 PorEmpresaTransportadora 时有意义。
邮政或自行运送
json
"transporte": { "modalidade": "PelosCorreios" }
* | object | 运输信息 |
* 必填字段
交运输公司承运
json
"transporte": { "modalidade": "PorEmpresaTransportadora", "cnpjTransportadora": "14422279000106" }
* | object | 运输信息 |
* 必填字段
行总额 = 数量 × 单价，四舍五入保留 2 位；单据总额 = 各行总额之和。两者由平台计算，请求里不传。文本字段先净化（去变音符号、控制字符换空格、折叠空白）再校验长度。
受理侧校验（不取号、不出站，直接 400）：主体可开票且证书可用、DC-e 已配置；ambiente 与主体一致；证件位数与校验位；市政 IBGE 码与 UF 一致；cep 8 位；itens 非空且数量、单价、NCM 合法；条数上限；文本长度。
发行阶段的 SEFAZ 驳回不走 HTTP 错误，而是查询结果 Negada 加 Webhook dce.rejected。完整状态机见 DC-e。
ambiente发行环境
| 取值 | 含义 |
|---|---|
| Homologacao | 税务局测试环境，单据无法律效力 |
| Producao | 正式环境 |
remetente.tipoPessoa参与方类型
同样适用于 destinatario.tipoPessoa。
| 取值 | 含义 |
|---|---|
| F | 个人，cpfCnpj 为 11 位 |
| J | 企业，cpfCnpj 为 14 位 |
transporte.modalidade运输方式
| 取值 | 含义 |
|---|---|
| PelosCorreios | 走邮政 |
| PorContaPropria | 发件方自行运送 |
| PorEmpresaTransportadora | 交运输公司承运，配 cnpjTransportadora |
| 错误码 | HTTP | |
|---|---|---|
| 10003000 | 404 | empresaId 不存在。 |
| 10019012 | 400 | 主体未配置 DC-e 发行（缺 tipoEmitente / 模型 99 号段 / Marketplace 站点）。注册时传 emissaoDCe 或带 id 更新补配。 |
| 10019010 | 400 | ambiente 与主体当前环境不一致（如注册后尚未切生产就传 Producao）。按主体当前环境提交。 |
| 10019014 | 400 | Marketplace 主体未传 remetente。补发件方。 |
| 10019015 | 400 | remetente.endereco 缺失。补发件方地址。 |
| 10019016 | 400 | 巴西发件方缺 cpfCnpj。补发件方证件。 |
| 10019004 | 400 | 主体不可发行（未审批 / 证书未就绪）。等待审批 / 关联证书。 |
| 10019017 | 400 | 巴西收件方缺 cpfCnpj。补收件方证件。 |
| 10019011 | 400 | 市政 IBGE 码不存在或与 uf 不一致。核对 cidade / uf。 |
| 10019005 | 400 | 同请求并发重复。稍后重试。 |
| 10019006 | 400 | 该 CNPJ 待处理任务超限。稍后重试。 |
| 10019007 | 400 | 号段无法确定（多个启用号段）。联系运营收敛号段。 |
| 10019013 | 400 | 主体类型 Carrier 当前不支持发行。改用 Marketplace / OwnIssuer 主体。 |
| 10019018 | 400 | 明细不合法（NCM 位数、数量 ≤ 0、单价为负）。按 mensagem 修正。 |
| 10019019 | 400 | 枚举或格式非法（mensagem 点名字段：tipoPessoa、modalidade、dataEmissao、证件、电话、邮箱、自发主体 remetente 与主体不符等）。按 mensagem 修正。 |
| 10019020 | 400 | 承运商 CNPJ 不合法。修正 cnpjTransportadora。 |
| 10019021 | 400 | 附加信息超长。缩短文本。 |
| 10019022 | 400 | autorizacaoDownloadXml 条数或证件不合法；含发行方自身 CNPJ；同一证件重复。修正列表。 |
| 10019030 | 400 | 同 id 报文不同。换 id 或沿用原报文。 |
| 10019031 | 400 | 生产环境同 id 已有在途 / 已授权单据。查询原单。 |
| 10019048 | 400 | dataEmissao 超出允许窗口（超前 > 5 分钟或回溯 > 30 天，mensagem 带当前允许范围）。改用当前时刻或省略 dataEmissao。 |
| 10001001 | 400 | 请求字段校验失败（每字段一条）。按 mensagem 修正。 |