Automação

Rejeição 531 no CT-e 4.00 e a Tag vTotDFe (Reforma Tributária): Por que a SEFAZ Rejeita vRec Igual a vTPrest e Como Resolver

Entenda por que a SEFAZ e a SVRS retornam a Rejeição 531 (Valor a receber deve ser menor ou igual ao Valor da Prestação) mesmo quando vRec e vTPrest são iguais, o papel da nova tag vTotDFe na Reforma Tributária e como emitir CT-e 4.00 via API JSON.

Fábio Magalhães CostaAtualizado em 18/11/2026
Diagnóstico da Rejeição 531 no CT-e 4.00: relação entre vTPrest, vRec e a nova tag vTotDFe da Reforma Tributária na SEFAZ

Diagnóstico da Rejeição 531 no CT-e 4.00: relação entre vTPrest, vRec e a nova tag vTotDFe da Reforma Tributária na SEFAZ

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 vRec e vTPrest idê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 a vTPrest.
  • A partir da vigência plena da cobrança: O vTotDFe passa 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 avalia vRec (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:

  1. Pedágio somado só no Valor a Receber: O sistema calcula Frete Valor = R$ 1.350,00, grava vTPrest = 1350.00 e depois soma R$ 150,00 de 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 em componentes e compor tanto vTPrest quanto vTotDFe.
  2. 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.004 em vRec contra 1500.00 em vTPrest gera 1500.01 > 1500.00 na 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ário 208/210 ou razão social de homologação 646–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 de valorTotal;
  • Antes mesmo de assinar o XML, a API confere se a soma dos componentes bate com valorTotal e garante que valorReceber <= 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:

👉 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.

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em Automação

Automação • 19/11/2026

Tomador do Serviço no CT-e (Frete CIF, FOB, Expedidor, Recebedor e Outros): Diferença entre toma3 e toma4 via API JSON

Entenda quem é o tomador do serviço no CT-e 4.00 (Frete CIF remetente, FOB destinatário, expedidor, recebedor e terceiros), a diferença entre os grupos toma3 e toma4 no XML da SEFAZ e como emitir via API JSON vinculando múltiplas NF-es.

Automação • 18/11/2026

Tributação de ICMS no CT-e 4.00 via API: Guia Prático de CST (00, 20, 40, 60 ST, 90, Outra UF e Simples Nacional)

Guia técnico para desenvolvedores de TMS e ERPs sobre como preencher o grupo de ICMS no CT-e 4.00: CST 00, redução de base (CST 20), isenção/diferimento (40/41/51), substituição tributária (CST 60), transporte iniciado em outra UF (CFOP 5932/6932) e Simples Nacional.

Automação • 09/11/2026

Como Automatizar NFS-e de MEI no Stripe, Asaas, Kiwify, Hotmart e WooCommerce via Webhook (Sem Comprar Certificado A1)

Tutorial prático com código em Node.js/TypeScript para automatizar a emissão de NFS-e de MEI e Simples Nacional após vendas no Stripe, Asaas, Kiwify, Hotmart e WooCommerce usando webhooks e Procuração Eletrônica RFB (00233) sem arquivo .pfx.

Automacao • 29/10/2026

Anexo VIII (Correlação Item NBS, cIndOp e cClassTrib) e Código 170601 / 010601: Tabela Pronta e IBS/CBS via Org API

Tabela pronta da planilha AnexoVIII-CorrelacaoItemNBSIndOpcClassTrib_IBSCBS: qual NBS, cIndOp (100301) e cClassTrib (000001) usar nos códigos 170601 (NBS 114061100), 010601 (NBS 115011000) e CNAE 73.19-0-99.

Guias Pilares de Integração Fiscal