Quem mantém a integração fiscal de um TMS ou ERP logístico já conhece de cor a descrição clássica da Rejeição 531 do Conhecimento de Transporte Eletrônico (CT-e, modelo 57): "Valor a receber deve ser menor ou igual ao Valor da Prestação".
Historicamente, sempre que esse erro aparecia no log, a causa era óbvia: algum cálculo de pedágio, seguro ou acréscimo havia sido somado no campo <vRec> (Valor a Receber) sem ter sido incluído em <vTPrest> (Valor Total da Prestação).
Só que, com a entrada em produção dos novos schemas da Reforma Tributária do Consumo (NT 2025.001 e NT 2026.002 — IBS e CBS) nos autorizadores estaduais e na SVRS (SEFAZ Virtual do Rio Grande do Sul), desenvolvedores começaram a se deparar com um cenário que parece um bug impossível: o XML enviado tem <vTPrest>1500.00</vTPrest> e <vRec>1500.00</vRec> exatamente iguais, e mesmo assim a SEFAZ devolve cStat 531.
A Rejeição 531 no CT-e 4.00 ocorre hoje por dois motivos distintos: (1) a ausência da nova tag <vTotDFe> ao final do grupo <imp>, que faz a validação atualizada da Reforma Tributária na SEFAZ/SVRS comparar <vRec> contra zero (vTotDFe = 0.00); ou (2) uma divergência real na composição do frete onde <vRec> ultrapassa <vTPrest>.
Quando você olha para um XML com
vRecevTPrestidênticos e a SEFAZ insiste que o valor a receber é maior que a prestação, o problema não está no grupo de valores — está no final do grupo de impostos.
Se você está integrando o transporte de cargas pela primeira vez, recomendo salvar também o nosso guia pilar de integração de API CT-e e MDF-e e o tutorial prático de como emitir CT-e Modelo 57 com seguro RCTR-C e DACTE. A seguir, mostro exatamente o que mudou no XML da SEFAZ, como corrigir a tag <vTotDFe> e como emitir CT-e via JSON sem se preocupar com essas armadilhas.
A nova causa da Rejeição 531 na Reforma Tributária: a tag <vTotDFe> dentro de <imp>
Antes das Notas Técnicas de adequação ao IBS e à CBS (NT 2025.001 e NT 2026.002 do CT-e 4.00), a regra de validação da SEFAZ para o código 531 fazia uma comparação direta dentro do mesmo bloco <vPrest>:
<vRec>precisava ser menor ou igual a<vTPrest>.
Com a chegada da Reforma Tributária sobre o Consumo, o schema oficial do CT-e (cteTiposBasico_v4.00.xsd) ganhou dois novos elementos dentro do nó de impostos (<imp>): o grupo <IBSCBS> e, logo na última posição de <imp>, a tag <vTotDFe> (Valor Total do Documento Fiscal Eletrônico).
A função do <vTotDFe> é consolidar o valor total da operação considerando a transição entre os tributos atuais e os novos tributos "por fora" (IBS e CBS):
- Durante o ano de 2026 (período informativo de teste de 0,9% de CBS e 0,1% de IBS): Os valores de IBS e CBS não somam ao total cobrado no documento, portanto
vTotDFeé exatamente igual avTPrest. - A partir da vigência plena da cobrança: O
vTotDFepassa a refletir a soma da prestação com os novos tributos aplicáveis conforme as regras da Nota Técnica.
Por que a ausência de <vTotDFe> dispara falso erro 531 na SVRS?
Nos autorizadores que já ativaram a revisão da regra de validação de totalizadores (como a SVRS, que atende a grande maioria dos estados brasileiros no CT-e), o motor da SEFAZ passou a validar se o valor a receber (<vRec>) é compatível com o valor total do documento (<vTotDFe>).
Como no arquivo XSD a tag <vTotDFe> está declarada com ocorrência opcional (minOccurs="0"), o seu validador de schema local aprova o XML mesmo sem ela. Porém, quando o XML chega na SEFAZ sem <vTotDFe>, o autorizador assume o valor padrão 0.00 na comparação:
⚡ O que acontece dentro do validador da SEFAZ:
- 1. O que seu ERP enviou:
<vTPrest>1500.00</vTPrest>e<vRec>1500.00</vRec>, mas omitiu<vTotDFe>no bloco<imp>.- 2. Como a SEFAZ avalia a regra: Como
<vTotDFe>não veio no XML, o comparador avaliavRec (1500.00) <= vTotDFe (0.00).- 3. O retorno enganoso: A comparação falha e a SEFAZ devolve a mensagem antiga da tabela de erros:
cStat 531 — Rejeição: Valor a receber deve ser menor ou igual Valor da Prestação.
Veja a diferença no XML do grupo <imp> antes e depois da correção:
<!-- ❌ XML que passa no XSD local, mas sofre Rejeição 531 na SVRS -->
<vPrest>
<vTPrest>1500.00</vTPrest>
<vRec>1500.00</vRec>
<Comp>
<xNome>FRETE VALOR</xNome>
<vComp>1500.00</vComp>
</Comp>
</vPrest>
<imp>
<ICMS>
<ICMS00>
<CST>00</CST>
<vBC>1500.00</vBC>
<pICMS>12.00</pICMS>
<vICMS>180.00</vICMS>
</ICMS00>
</ICMS>
<vTotTrib>180.00</vTotTrib>
</imp>
<!-- ✅ XML correto com <vTotDFe> posicionado no final de <imp> -->
<vPrest>
<vTPrest>1500.00</vTPrest>
<vRec>1500.00</vRec>
<Comp>
<xNome>FRETE VALOR</xNome>
<vComp>1500.00</vComp>
</Comp>
</vPrest>
<imp>
<ICMS>
<ICMS00>
<CST>00</CST>
<vBC>1500.00</vBC>
<pICMS>12.00</pICMS>
<vICMS>180.00</vICMS>
</ICMS00>
</ICMS>
<vTotTrib>180.00</vTotTrib>
<vTotDFe>1500.00</vTotDFe>
</imp>
Atenção à ordem estrita do XSD dentro de <imp>: a sequência obrigatória é <ICMS>, <vTotTrib> (opcional), <infAdFisco> (opcional), <ICMSUFFim> (opcional), <infTribFed> (opcional), <IBSCBS> (opcional) e, por último, <vTotDFe>. Colocar <vTotDFe> antes de <infAdFisco> ou de <vTotTrib> causará Rejeição 215 (Falha no schema XML).
As causas clássicas de composição de valores (vTPrest, vRec e <Comp>)
Se o seu XML já inclui <vTotDFe> e ainda assim ocorre a Rejeição 531, vale revisar a matemática do grupo <vPrest>. No CT-e 4.00, existem três valores que conversam entre si:
| Campo no XML | Campo na API JSON da Notaas | O que representa | Regra de Ouro |
|---|---|---|---|
<Comp><vComp> |
valores.componentes[].valor |
Parcelas que formam o frete (Frete Peso, Frete Valor, GRIS, Pedágio, Taxa de Entrega) | A soma de todos os vComp deve bater centavo a centavo com vTPrest. |
<vTPrest> |
valores.valorTotal |
Valor Total da Prestação do Serviço | É o valor bruto fiscal do transporte (base para cálculo dos tributos). |
<vRec> |
valores.valorReceber |
Valor Líquido a Receber do Tomador | Sempre <= vTPrest. Pode ser menor que vTPrest (ex.: quando há desconto ou adiantamento), mas nunca maior. |
Dois tropeços comuns em ERPs que geram vRec > vTPrest na prática:
- Pedágio somado só no Valor a Receber: O sistema calcula
Frete Valor = R$ 1.350,00, gravavTPrest = 1350.00e depois somaR$ 150,00de pedágio apenas no boleto/cobrança (vRec = 1500.00). Se o pedágio faz parte do valor cobrado no CT-e, ele precisa entrar como um componente emcomponentese compor tantovTPrestquantovTotDFe. - Arredondamento de ponto flutuante em JavaScript/Python: Ao ratear o valor do frete por peso de várias NF-es vinculadas, uma dízima como
1500.004emvReccontra1500.00emvTPrestgera1500.01 > 1500.00na serialização de duas casas decimais.
O número do CT-e é perdido quando dá Rejeição 531?
Uma dúvida importante para qualquer desenvolvedor que migrou para o CT-e 4.00: como a SEFAZ extinguiu o webservice de inutilização de numeração na versão 4.00, o que acontece com o número (nCT) quando uma emissão falha com cStat 531?
A resposta está no ciclo de vida da validação dentro da SEFAZ:
- A Rejeição 531 (assim como erros de schema
215, erro de CNPJ/IE do destinatário208/210ou razão social de homologação646–649) é uma rejeição pré-persistência. A SEFAZ recusa o pacote na camada de validação de regras de negócio e não grava a chave de acesso no banco estadual. - Isso significa que o número daquele CT-e não foi consumido e deve ser reaproveitado na tentativa seguinte, após corrigir o valor.
- É bem diferente do que ocorre em um timeout de rede ou em uma Rejeição 539 (Duplicidade de CT-e com diferença na Chave de Acesso), onde aquele número já está registrado na SEFAZ e precisa ser avançado ou reconciliado via consulta de protocolo.
Na API da Notaas, essa inteligência de numeração já é gerenciada automaticamente: nós mantemos uma lista estrita de códigos de rejeição recicláveis do CT-e 4.00. Quando uma tentativa falha por validação prévia, o número volta para a fila do seu projeto sem deixar buracos na sequência contábil; quando ocorre uma falha de rede ambígua, o motor consulta a chave na SEFAZ antes de decidir se autoriza a nota existente ou libera a numeração.
Como emitir CT-e 4.00 via API JSON sem dor de cabeça com <vTotDFe>
Em vez de montar XML na mão, controlar a ordem das tags dentro de <imp> e manter tabelas de autorizadores (SVRS, SP, MG, PR, MT, MS) no seu backend, você pode emitir o CT-e enviando um único JSON para o endpoint POST https://platform.notaas.com.br/api/v1/cte/emitir.
Na nossa API pública:
- Você informa os nomes em português claro (
valores.valorTotal,valores.valorReceber,valores.componentes,impostos.icms); - Se você omitir
valorReceber, a API assume automaticamente o mesmo valor devalorTotal; - Antes mesmo de assinar o XML, a API confere se a soma dos
componentesbate comvalorTotale garante quevalorReceber <= valorTotal; - E na geração do XML 4.00, a plataforma injeta a tag
<vTotDFe>na posição exata exigida pelo schema da Reforma Tributária, assina com o Certificado A1 da transportadora e gera o DACTE em PDF pronto para impressão.
Veja um exemplo real e completo compatível com a nossa API pública:
curl -X POST "https://platform.notaas.com.br/api/v1/cte/emitir" \
-H "x-api-key: ntaas_live_SEU_TOKEN_AQUI" \
-H "Content-Type: application/json" \
-d '{
"serie": 1,
"dados": {
"cfop": "6353",
"naturezaOperacao": "Prestacao de servico de transporte",
"origem": {
"codigoMunicipio": "3550308",
"municipio": "Sao Paulo",
"uf": "SP"
},
"destino": {
"codigoMunicipio": "4106902",
"municipio": "Curitiba",
"uf": "PR"
},
"tomador": "remetente",
"remetente": {
"cnpj": "12345678000199",
"inscricaoEstadual": "110042490114",
"razaoSocial": "Industria Metalurgica Paulista LTDA",
"endereco": {
"logradouro": "Av. das Nacoes Unidas",
"numero": "12000",
"bairro": "Brooklin",
"codigoMunicipio": "3550308",
"municipio": "Sao Paulo",
"cep": "04578000",
"uf": "SP"
}
},
"destinatario": {
"cnpj": "98765432000188",
"inscricaoEstadual": "9012345678",
"razaoSocial": "Distribuidora Sul Paranaense S/A",
"endereco": {
"logradouro": "Rua XV de Novembro",
"numero": "500",
"bairro": "Centro",
"codigoMunicipio": "4106902",
"municipio": "Curitiba",
"cep": "80020310",
"uf": "PR"
}
},
"valores": {
"valorTotal": 1500.00,
"valorReceber": 1500.00,
"componentes": [
{ "nome": "FRETE VALOR", "valor": 1350.00 },
{ "nome": "PEDAGIO", "valor": 150.00 }
]
},
"impostos": {
"icms": {
"cst": "00",
"baseCalculo": 1500.00,
"aliquota": 12.00,
"valor": 180.00
},
"valorTotalTributos": 180.00
},
"carga": {
"valorTotal": 48000.00,
"produtoPredominante": "EQUIPAMENTOS INDUSTRIAIS",
"quantidades": [
{
"unidade": "KG",
"tipoMedida": "PESO BRUTO",
"quantidade": 1250.50
}
]
},
"documentosOriginarios": {
"tipo": "nfe",
"chaves": [
"35261112345678000199550010000001231000001234"
]
}
}
}'
Assim que o CT-e é autorizado na SEFAZ, você pode vincular a chave gerada diretamente na emissão do Manifesto de Carga (POST /api/v1/mdfe/emitir) e usar nossos endpoints de encerramento automático de MDF-e para evitar a Rejeição 611 nas barreiras fiscais.
Teste agora com 20 emissões grátis por mês em produção
Se você desenvolve um TMS, um ERP para transportadoras ou precisa automatizar a logística da sua operação, não precisa pagar mensalidades caras nem módulos adicionais para emitir CT-e e MDF-e.
Na Notaas, você conta com uma única plataforma REST JSON para CT-e (Mod 57), MDF-e (Mod 58), NF-e (Mod 55), NFC-e (Mod 65) e NFS-e, com:
- 20 documentos fiscais gratuitos por mês em produção real (1 CNPJ) + até 5 projetos simultâneos grátis em homologação via Org API Multi-CNPJ;
- Parametrização simples de RNTRC, séries e numeração via painel ou API;
- Geração imediata de DACTE e DAMDFE em PDF e suporte nativo no
@notaas/mcppara quem programa com Cursor e Claude Code.
👉 Crie sua conta gratuita na Notaas e emita seu primeiro CT-e 4.00 em minutos ou acesse a especificação completa do contrato JSON em docs.notaas.com.br.

