Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Informações complementares da operação

idCadIntTran: cadastro do vendedor no intermediador da NF-e

<idCadIntTran>infIntermed › idCadIntTran

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

idCadIntTran é a identificação do vendedor cadastrado no intermediador da transação. Está em /nfeProc/NFe/infNFe/infIntermed/idCadIntTran, item YB03. A NT 2020.006 descreve nome de usuário ou identificação do perfil do vendedor no site/plataforma intermediadora; não é número da venda ou identificação da pessoa jurídica intermediadora.

Qual conta deve ser identificada?

Confronte o CNPJ do intermediador e o perfil que a empresa emitente utiliza naquele canal. O primeiro filho do grupo identifica o intermediador; idCadIntTran identifica o vendedor ali. Uma conta de outra loja, empresa ou ambiente não deve ser reutilizada por semelhança de nome.

Quando houver cadeia de marketplaces, a NT orienta identificar como intermediador quem enviou ao vendedor a informação da venda. A conta precisa corresponder àquela plataforma e à operação real. Não combine CNPJ de M1 com perfil de M2 sem comprovação de que representam o cadastro pertinente.

Use a identificação cadastral apropriada obtida da plataforma. Número do pedido, código de transação ou identificador do pagamento são dados de outra natureza, mesmo quando uma API os apresenta próximos. Não substitua o perfil pelo CNPJ do vendedor ou do intermediador.

Pode informar senha, token ou chave de API?

Não. Identificador de usuário/perfil não é credencial de autenticação. O XML fiscal circula entre participantes e sistemas; o campo não foi definido como canal de armazenamento de segredo. Não envie senha, token, chave privada ou certificado para preencher uma identificação que está faltando. Solicite a referência cadastral correta do vendedor, preservando as credenciais nos mecanismos apropriados da integração.

Como preencher e conferir o tamanho?

O campo é obrigatório dentro de infIntermed, após CNPJ, e aceita 2 a 60 caracteres do tipo TString. A NT v1.31 registra esse intervalo; a antiga apresentação de tamanho 60 no MOC não deve ser lida como exigência de exatamente 60 caracteres. Não complete um identificador curto com espaços e não envie tag vazia.

Fragmento sintético parcial em relação à nota, com perfil e CNPJ demonstrativos sem vínculo real:

<infIntermed xmlns="http://www.portalfiscal.inf.br/nfe">
  <CNPJ>12345678000195</CNPJ>
  <idCadIntTran>LOJA-EXEMPLO-A</idCadIntTran>
</infIntermed>

O exemplo não inclui o indicador, outras partes da NF-e ou condição de transmissão. A aprovação do fragmento no XSD não valida a conta na plataforma.

Como investigar informação ausente ou não reconhecida?

Para 438, compare indIntermed=1 e a presença completa de infIntermed; para 439, examine o grupo quando o indicador difere de 1. Essas regras alcançam 55/65 na NT 2020.006 v1.31. Não atribua 440 ao perfil: essa regra examina CNPJ inválido.

Se houver falha de tamanho, confira o valor efetivamente serializado e a versão do validador. Se o perfil tiver formato aceito, mas não corresponder à venda, confronte conta da empresa, plataforma e origem do pedido. Corrija o mapeamento demonstradamente errado e confirme o XML gerado, sem trocar para perfil de outra empresa nem expor credenciais no diagnóstico. O campo não comprova pagamento ou determina tratamento tributário.

Fontes técnicas

NT 2020.006 — Intermediador e marketplace — 1.31, setembro/2022: p. 6, correção do tamanho YB03; p. 9, YB03; p. 11–13, regras YB e orientações.

XSD NF-e/NFC-e — PL_010f_v1.04: linhas 6110–6134, infIntermed/idCadIntTran.

Tipos básicos NF-e/NFC-e — PL_010f_v1.04: linhas 519–527, TString.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/infIntermed/idCadIntTran
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
inline:TString · TString
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

maxLength
60
minLength
2
pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}
whiteSpace
preserve