# Glossário de A a Z — letra U > 20 termos. Glossário compacto: https://conota.dev/glossario/llms-full.txt --- # UF de destino > UF de destino é a unidade federativa, ou seja, o estado brasileiro ou o Distrito Federal, para onde uma mercadoria é enviada ou onde termina uma operação registrada em documento fiscal. Na NF-e, ela consta no endereço do destinatário e indica se a venda é interna ou interestadual, o que influencia o CFOP, as alíquotas e o cálculo do ICMS. **Também conhecido como:** Estado de destino, Unidade federativa de destino, UF do destinatário, UF, Destination state **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que significa UF de destino? UF é a sigla de Unidade Federativa, que no Brasil corresponde aos 26 estados e ao Distrito Federal. A UF de destino é aquela onde a operação termina, normalmente o estado em que está o comprador ou o local que recebe a mercadoria. Ela é sempre comparada com a UF do emitente. Quando as duas são iguais, a operação é interna. Quando são diferentes, a operação é interestadual. Quando o destino fica fora do país, trata-se de uma operação com o exterior, como uma exportação. ## Onde a UF de destino aparece nos documentos fiscais? Na NF-e, a UF é informada no endereço do destinatário, junto com o município e seu código. A nota também traz um campo que indica o tipo de destino da operação: interna, interestadual ou com o exterior. Nas operações com o exterior, usa-se a sigla EX no lugar de uma UF brasileira. No transporte, a ideia é semelhante. O CT-e registra a UF onde a prestação do frete termina, e o MDF-e informa a UF onde a carga será descarregada, o que permite acompanhar o percurso entre estados. Na NFC-e, voltada à venda presencial ao consumidor, a operação costuma ser interna, no mesmo estado do estabelecimento. ## Por que a UF de destino afeta os impostos? O ICMS é um imposto estadual, e cada estado tem regras próprias. Por isso, a UF de destino ajuda a definir qual alíquota se aplica. Em operações internas vale a alíquota do próprio estado. Em operações interestaduais vale uma alíquota interestadual, geralmente menor. Em vendas interestaduais para consumidor final que não é contribuinte do ICMS, parte do imposto, chamada diferencial de alíquotas (DIFAL), cabe ao estado de destino. A UF de destino também pode determinar a cobrança do FCP e a aplicação de substituição tributária, conforme os acordos entre os estados envolvidos. ## Qual a diferença entre UF de destino e local de entrega? A UF de destino costuma ser a do endereço do destinatário da NF-e. Mas a mercadoria pode ser entregue em outro endereço, por exemplo, numa filial ou num depósito de terceiros. Nesse caso, a NF-e possui um grupo específico para informar o local de entrega. Na prática, quem emite precisa verificar qual informação a legislação considera para classificar a operação. Confundir o endereço de cobrança, o do destinatário e o de entrega é uma fonte frequente de erros de tributação. ## Quais erros comuns envolvem a UF de destino na emissão por API? O erro mais comum é a incoerência entre dados. Um CFOP iniciado por 5 indica operação interna, e um iniciado por 6 indica operação interestadual. Se o CFOP não combina com a UF do destinatário ou com o tipo de destino informado, a SEFAZ rejeita a nota. Outros problemas frequentes são a sigla da UF incompatível com o código do município, endereços desatualizados no cadastro de clientes e o uso de alíquota interna em uma venda interestadual. Por isso, sistemas que emitem notas por API costumam validar esses campos antes do envio para reduzir rejeições. ## Exemplos de UF de destino - Uma loja virtual sediada em São Paulo vende um produto para um cliente em Minas Gerais. A UF de destino é MG, a operação é interestadual e a NF-e usa um CFOP iniciado por 6. - Um ERP de uma distribuidora do Paraná emite uma NF-e para um supermercado de Curitiba. Como a UF de destino é igual à UF do emitente, a operação é interna e o CFOP começa com 5. - Uma transportadora emite um CT-e para um frete que sai da Bahia e termina em Pernambuco. A UF de término da prestação, PE, é informada no documento. - Uma indústria exporta peças para outro país. Na NF-e, o endereço do destinatário recebe a sigla EX, e a operação é classificada como destinada ao exterior. ## Perguntas frequentes ### UF de destino é sempre o estado do comprador? Na maioria dos casos, sim, pois corresponde ao endereço do destinatário na NF-e. Porém, quando a entrega ocorre em outro endereço, é preciso verificar qual local a legislação considera para definir a tributação. ### O que acontece se a UF de destino estiver errada? A nota pode ser rejeitada pela SEFAZ por incoerência com o CFOP ou com o tipo de destino. Se for autorizada com erro, o imposto pode ser calculado incorretamente, exigindo correção ou cancelamento. ### Qual UF informar em uma exportação? Na NF-e, operações com destinatário no exterior usam a sigla EX no campo de UF, e o tipo de destino da operação é marcado como exterior. ## Termos relacionados - [Operação interestadual](https://conota.dev/glossario/operacao-interestadual.md) - [Operação interna](https://conota.dev/glossario/operacao-interna.md) - [Destinatário da NF-e](https://conota.dev/glossario/destinatario-da-nf-e.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [ICMS](https://conota.dev/glossario/icms.md) - [Local de entrega na NF-e](https://conota.dev/glossario/local-de-entrega-na-nf-e.md) --- Fonte: [UF de destino](https://conota.dev/glossario/uf-de-destino/) · Atualizado em 2026-10-22 --- # UF de embarque de exportação > UF de embarque de exportação é a sigla do estado brasileiro onde a mercadoria exportada será embarcada ou cruzará a fronteira para deixar o país. Na NF-e de exportação, essa informação aparece no grupo de exportação, junto com o local de embarque, e ajuda o fisco a acompanhar por onde o produto sai fisicamente. **Também conhecido como:** UF de saída do país, UFSaidaPais, UFEmbarq, Estado de embarque da exportação, UF de transposição de fronteira, State of export shipment **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é a UF de embarque de exportação? UF significa Unidade Federativa, ou seja, um dos estados brasileiros ou o Distrito Federal. A UF de embarque de exportação indica em qual estado a mercadoria vai efetivamente sair do Brasil, seja por um porto, um aeroporto ou um ponto de fronteira terrestre. Ela não precisa ser o estado da empresa que vende. Uma indústria de Minas Gerais, por exemplo, pode exportar pelo porto de Santos, em São Paulo. Nesse caso, a UF de embarque é SP, mesmo que a nota seja emitida em MG. ## Onde essa informação aparece na NF-e? Na nota fiscal eletrônica, a UF de embarque fica no grupo de informações de exportação. Na versão atual do leiaute, o campo é chamado UFSaidaPais e vem acompanhado de outros dois: o local de embarque ou de transposição de fronteira (xLocExporta) e, opcionalmente, o local de despacho (xLocDespacho). Em versões mais antigas do leiaute, o mesmo conceito aparecia com o nome UFEmbarq. Por isso, ainda é comum encontrar a expressão UF de embarque em documentação, sistemas legados e conversas entre contadores e desenvolvedores. ## Para que serve informar a UF de embarque? A exportação de mercadorias costuma ter tratamento tributário favorecido, como a não incidência do ICMS. Para conceder esse benefício, o fisco precisa conseguir comprovar que o produto realmente saiu do país. A UF e o local de embarque ajudam a ligar a nota fiscal ao trajeto físico da carga e ao despacho aduaneiro. Além disso, a informação é usada no cruzamento de dados entre a NF-e e os registros de exportação feitos no ambiente do comércio exterior, reduzindo divergências que poderiam gerar questionamentos em uma fiscalização. ## Quando o campo deve ser preenchido? O grupo de exportação é usado em notas de operações com destinatário no exterior, em que o identificador de destino da operação indica operação com o exterior e o CFOP costuma começar com 7. Nesses casos, informar a UF de saída e o local de embarque é parte do preenchimento esperado. Em vendas internas para uma empresa comercial exportadora, chamadas de exportação indireta, a lógica é diferente: a nota é emitida para um destinatário no Brasil, e a saída para o exterior será documentada depois pela empresa exportadora. ## Quais erros são mais comuns nesse campo? O erro mais frequente é preencher a UF do emitente automaticamente, sem considerar o porto ou a fronteira por onde a carga realmente vai sair. Outro problema é usar uma sigla inválida ou deixar o local de embarque vazio quando o grupo de exportação é informado. Em integrações por API, vale tratar a UF de embarque como um dado da operação logística, e não do cadastro da empresa. Assim, o sistema de origem, como um ERP, envia a informação correta para cada pedido, e o emissor apenas a repassa ao XML, evitando rejeições e inconsistências. ## Exemplos de UF de embarque de exportação - Uma fabricante de calçados do Rio Grande do Sul vende para um cliente na Argentina e envia a carga por caminhão, cruzando a fronteira em Uruguaiana. Na NF-e, a UF de embarque é RS e o local de transposição de fronteira é Uruguaiana. - Uma cooperativa de Goiás exporta grãos pelo porto de Paranaguá. A nota é emitida em GO, mas o campo de UF de saída do país é preenchido com PR. - Uma empresa de autopeças de São Paulo envia uma remessa urgente por via aérea a partir do aeroporto de Guarulhos. A UF de embarque informada é SP e o local de embarque é o aeroporto. - Um ERP integrado a uma API fiscal envia, para cada pedido de exportação, a UF e o local de embarque definidos pela área de logística, e o emissor monta o grupo de exportação no XML da NF-e. ## Perguntas frequentes ### A UF de embarque precisa ser igual à UF do emitente? Não. Ela corresponde ao estado onde a mercadoria efetivamente sai do Brasil, que pode ser diferente do estado da empresa que emite a nota, como quando uma indústria do interior exporta por um porto de outro estado. ### Qual é a diferença entre UF de embarque e local de embarque? A UF de embarque é apenas a sigla do estado, como SP ou PR. O local de embarque descreve o ponto específico de saída, como o nome do porto, do aeroporto ou da cidade de fronteira. ### UFEmbarq e UFSaidaPais são a mesma coisa? Representam o mesmo conceito. UFEmbarq era o nome usado em versões antigas do leiaute da NF-e; nas versões mais recentes, o campo passou a se chamar UFSaidaPais. ### Notas de exportação indireta precisam informar a UF de embarque? Em geral, não da mesma forma. Na exportação indireta, a nota é emitida para uma comercial exportadora no Brasil, e quem documenta a saída do país, incluindo o local de embarque, é a empresa exportadora. ## Termos relacionados - [Grupo de informações de exportação da NF-e](https://conota.dev/glossario/grupo-de-informacoes-de-exportacao-da-nf-e.md) - [Exportação indireta](https://conota.dev/glossario/exportacao-indireta.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [Habilitação no Siscomex](https://conota.dev/glossario/habilitacao-no-siscomex.md) - [Destinatário da NF-e](https://conota.dev/glossario/destinatario-da-nf-e.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) --- Fonte: [UF de embarque de exportação](https://conota.dev/glossario/uf-de-embarque-de-exportacao/) · Atualizado em 2026-10-22 --- # UF de início da prestação de transporte > UF de início da prestação de transporte é a unidade federativa, estado ou Distrito Federal, onde o serviço de transporte começa, ou seja, onde a carga ou o passageiro é recebido pelo transportador. Ela é informada em documentos fiscais como CT-e e MDF-e e influencia o cálculo do ICMS, a escolha do CFOP e a validação do documento. **Também conhecido como:** UF de início, UFIni, Estado de início da prestação, UF de origem do transporte, UF de início da viagem **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é a UF de início da prestação de transporte? É o estado onde o transporte tem início. Em um frete que sai de Campinas (SP) e vai até Curitiba (PR), a UF de início é SP, mesmo que a transportadora tenha sede em outro estado. Junto com a UF, o documento fiscal também registra o município de início. Os dois dados descrevem o ponto de partida real do serviço, e não o endereço do emitente, do remetente ou do tomador. ## Onde esse campo aparece nos documentos fiscais? No CT-e, a UF de início fica no grupo de identificação do documento, no campo UFIni, acompanhado do código e do nome do município de início. Ao lado dele ficam os campos equivalentes de término da prestação. No MDF-e, o campo UFIni indica o estado onde começa a viagem, e o documento também lista os municípios de carregamento e as UFs de percurso até a UF de destino. Essas informações aparecem ainda nos documentos auxiliares impressos, como o DACTE e o DAMDFE. ## Por que a UF de início é tão importante? A regra geral do ICMS sobre transporte é que o imposto é devido ao estado onde a prestação começa. Por isso, a UF de início ajuda a definir qual alíquota e qual legislação estadual se aplicam ao frete. Ela também orienta a escolha do CFOP. Quando o início e o término estão no mesmo estado, a prestação é interna e usa códigos iniciados em 5. Quando estão em estados diferentes, é interestadual e usa códigos iniciados em 6. Um erro nesse campo pode gerar cálculo incorreto de imposto, rejeição do documento ou problemas em fiscalizações. ## Qual a diferença entre UF de início e UF do emitente? A UF do emitente é o estado onde a transportadora está inscrita e de onde emite o documento. É a SEFAZ dessa UF que, em regra, autoriza o CT-e ou o MDF-e. A UF de início é onde o transporte começa de fato. Uma transportadora de Minas Gerais pode buscar uma carga em São Paulo: nesse caso, a UF do emitente é MG e a UF de início é SP. Confundir as duas é um erro comum em integrações. ## Como informar corretamente a UF de início em uma integração por API? O sistema que gera o documento, como um ERP ou TMS, deve enviar a sigla da UF e o código IBGE do município onde a carga é coletada. O ideal é derivar esses dados do endereço de coleta, e não do cadastro da empresa emissora. Antes de enviar, vale validar se o município pertence à UF informada e se o CFOP está coerente com a combinação entre início e término. Uma API fiscal costuma devolver mensagens de rejeição claras quando há inconsistência, o que facilita a correção automática ou manual. ## Exemplos de UF de início da prestação de transporte - Uma transportadora sediada no Paraná coleta mercadorias em Joinville (SC) e entrega em Porto Alegre (RS). No CT-e, a UF de início é SC e a UF de término é RS, caracterizando uma prestação interestadual. - Um MDF-e de uma viagem que começa em Goiânia (GO), passa por Minas Gerais e termina no Rio de Janeiro informa GO como UF de início, MG como UF de percurso e RJ como UF de destino. - Um ERP integrado a uma API fiscal recebe rejeição ao emitir um CT-e porque o código do município de início pertence a outro estado; o sistema corrige o cadastro do endereço de coleta e reenvia o documento. - Um frete de Ribeirão Preto a Santos, ambos em SP, tem UF de início e de término iguais, por isso o CT-e usa um CFOP de prestação interna. ## Perguntas frequentes ### A UF de início é sempre o estado da transportadora? Não. A UF de início é onde o transporte começa de fato, normalmente o local de coleta. A transportadora pode estar registrada em outro estado e ainda assim prestar um serviço que começa fora dela. ### A UF de início pode ser corrigida por Carta de Correção? Em geral, não. Dados que alteram o cálculo do imposto ou a natureza da prestação, como o local de início, não costumam ser corrigíveis por carta de correção. Normalmente é preciso cancelar, dentro do prazo, e emitir um novo documento. ### Qual o código usado para identificar a UF no XML? O campo UFIni recebe a sigla do estado, como SP ou MG. Já o município de início é identificado pelo código IBGE, que deve pertencer à UF informada. ### A UF de início influencia o ICMS do frete? Sim. Pela regra geral, o ICMS sobre transporte é devido ao estado onde a prestação se inicia, e a comparação entre UF de início e de término define se a operação é interna ou interestadual. ## Termos relacionados - [CT-e](https://conota.dev/glossario/ct-e.md) - [ICMS](https://conota.dev/glossario/icms.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [Encerramento do MDF-e](https://conota.dev/glossario/encerramento-do-mdf-e.md) - [Emitente de documento fiscal](https://conota.dev/glossario/emitente-de-documento-fiscal.md) - [DACTE](https://conota.dev/glossario/dacte.md) --- Fonte: [UF de início da prestação de transporte](https://conota.dev/glossario/uf-de-inicio-da-prestacao-de-transporte/) · Atualizado em 2026-10-22 --- # UF de percurso no MDF-e > UF de percurso no MDF-e é a informação que lista, em ordem, os estados que o veículo atravessa entre a UF de carregamento e a UF de descarregamento da carga. Ela fica no Manifesto Eletrônico de Documentos Fiscais e permite que o fisco de cada estado no caminho saiba que aquela mercadoria vai passar pelo seu território. **Também conhecido como:** UF de passagem, Estados de percurso do MDF-e, Percurso do veículo no MDF-e, UFPer **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é a UF de percurso no MDF-e? O MDF-e (Manifesto Eletrônico de Documentos Fiscais) é o documento que acompanha uma carga durante o transporte e reúne as notas fiscais (NF-e) ou conhecimentos de transporte (CT-e) que estão no veículo. Entre os dados do manifesto estão o estado onde a carga começa a viagem, o estado onde termina e os estados intermediários. Esses estados intermediários são as UFs de percurso. UF é a sigla de Unidade Federativa, ou seja, cada estado brasileiro e o Distrito Federal. No XML do MDF-e, essa informação aparece em um grupo próprio de percurso, com uma ocorrência para cada estado atravessado. ## Para que serve informar a UF de percurso? A principal função é dar visibilidade às secretarias da fazenda dos estados por onde a carga passa. Com o percurso declarado, os postos fiscais e equipes de fiscalização no caminho conseguem identificar que aquele veículo está apenas em trânsito e conferir se o trajeto informado bate com a rota real. Para quem transporta, informar o percurso corretamente evita problemas em abordagens na estrada, já que o motorista apresenta o DAMDFE e o fiscal consulta o manifesto com os estados previstos. ## Como preencher a UF de percurso corretamente? Devem ser informados apenas os estados atravessados entre a origem e o destino, sem repetir a UF de carregamento nem a UF de descarregamento. Os estados precisam seguir a ordem real da viagem, do primeiro ao último estado cruzado. Se a carga sai e chega no mesmo estado, ou se os estados de origem e destino fazem divisa e o veículo não cruza nenhum outro, o grupo de percurso simplesmente não é preenchido. O leiaute do MDF-e define um limite máximo de ocorrências, suficiente para rotas longas. ## O que acontece se a UF de percurso estiver errada? Alguns erros são barrados na própria emissão: a SEFAZ pode rejeitar o manifesto quando, por exemplo, a UF de percurso repete a UF de início ou de fim, ou quando o mesmo estado aparece de forma inconsistente. Nesses casos, é preciso corrigir os dados e enviar de novo. Outros erros não são detectados automaticamente, como declarar uma rota diferente da que o caminhão realmente faz. Isso pode gerar questionamentos na fiscalização. Como o percurso não pode ser simplesmente editado depois da autorização, mudanças de rota normalmente exigem cancelar o manifesto, quando ainda permitido, ou encerrá-lo e emitir um novo, conforme as regras vigentes. ## Como a UF de percurso entra numa emissão por API? Em uma integração fiscal, o sistema do transportador ou da empresa envia os dados do manifesto para a API, incluindo a lista ordenada de estados do percurso. A API monta o XML no formato exigido, assina, transmite à SEFAZ e devolve o status, o XML autorizado e o DAMDFE. Uma boa prática é calcular o percurso a partir da rota planejada no próprio sistema, em vez de deixar o preenchimento manual, e validar antes do envio se origem e destino não aparecem repetidos na lista. Testar esses cenários no ambiente de homologação ajuda a evitar rejeições em produção. ## Exemplos de UF de percurso no MDF-e - Uma carga sai de São Paulo com destino à Bahia passando por Minas Gerais: a UF de carregamento é SP, a UF de descarregamento é BA e a única UF de percurso informada é MG. - Uma transportadora leva mercadorias do Rio Grande do Sul para Goiás, cruzando Santa Catarina, Paraná, São Paulo e Minas Gerais: o percurso é informado como SC, PR, SP e MG, nessa ordem. - Um caminhão carrega em Minas Gerais e descarrega em São Paulo, estados vizinhos, sem cruzar outro estado: o grupo de percurso fica vazio. - Um ERP de logística integrado por API gera o MDF-e com o percurso calculado pela rota cadastrada e recebe de volta a rejeição da SEFAZ quando um usuário inclui por engano a UF de destino na lista de percurso. ## Perguntas frequentes ### A UF de carregamento e a de descarregamento entram na lista de percurso? Não. A lista de percurso contém apenas os estados intermediários atravessados pelo veículo. Origem e destino são informados em campos próprios do MDF-e. ### A ordem das UFs de percurso importa? Sim. Os estados devem ser informados na sequência em que o veículo os atravessa, do primeiro ao último, refletindo a rota real da viagem. ### Posso alterar a UF de percurso depois que o MDF-e foi autorizado? Não há edição direta do percurso após a autorização. Em caso de mudança de rota, normalmente é necessário cancelar o manifesto, se ainda estiver dentro das condições permitidas, ou encerrá-lo e emitir um novo. ### É obrigatório preencher a UF de percurso em toda viagem? Só quando o veículo atravessa algum estado entre a origem e o destino. Em viagens dentro do mesmo estado ou entre estados vizinhos sem passagem por outro, o grupo não é preenchido. ## Termos relacionados - [Encerramento do MDF-e](https://conota.dev/glossario/encerramento-do-mdf-e.md) - [DAMDFE](https://conota.dev/glossario/damdfe.md) - [CT-e](https://conota.dev/glossario/ct-e.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) - [Emissão fiscal por API](https://conota.dev/glossario/emissao-fiscal-por-api.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) --- Fonte: [UF de percurso no MDF-e](https://conota.dev/glossario/uf-de-percurso-no-mdf-e/) · Atualizado em 2026-10-22 --- # UF de término da prestação de transporte > UF de término da prestação de transporte é o campo do CT-e que informa o estado onde o serviço de transporte termina, ou seja, onde a carga chega ao destino final. Junto com a UF de início, ele indica se a prestação é interna ou interestadual e influencia o CFOP, a alíquota de ICMS e as validações da SEFAZ. **Também conhecido como:** UF final da prestação, UF de fim da prestação, UFFim, Estado de término do transporte **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é a UF de término da prestação de transporte? UF é a sigla de Unidade Federativa, ou seja, um dos estados brasileiros ou o Distrito Federal. A UF de término da prestação é o estado onde o transporte efetivamente se encerra, isto é, onde a mercadoria é entregue ao final do trajeto contratado. No leiaute do CT-e, essa informação fica no grupo de identificação do documento, na tag UFFim, acompanhada do código IBGE do município de término (cMunFim) e do nome desse município (xMunFim). Quando o transporte termina fora do Brasil, usa-se a sigla EX. ## Para que serve a UF de término no CT-e? A principal função é mostrar o alcance geográfico da prestação. Comparando a UF de início com a UF de término, o fisco e o próprio sistema emissor sabem se o transporte é interno (mesmo estado), interestadual (estados diferentes) ou internacional. Essa classificação afeta vários pontos do documento: o primeiro dígito do CFOP (5 para operações internas, 6 para interestaduais e 7 para o exterior), a alíquota de ICMS aplicável e, em alguns casos, o cálculo do DIFAL quando o tomador é não contribuinte do imposto em outro estado. A informação também aparece impressa no DACTE, o que facilita a conferência por fiscais, motoristas e pelo destinatário da carga. ## Qual a diferença entre UF de término da prestação e UF do destinatário? São informações diferentes, embora muitas vezes coincidam. A UF do destinatário é o estado onde está cadastrado quem recebe a carga. A UF de término da prestação é o estado onde o serviço de transporte termina fisicamente. Elas podem divergir, por exemplo, quando a transportadora leva a mercadoria até um armazém ou um ponto de redespacho em outro estado, encerrando ali a sua parte do trajeto. Nesse caso, o CT-e deve refletir onde aquela prestação termina, e não necessariamente o endereço final do destinatário. ## Como a UF de término se relaciona com o MDF-e? No MDF-e, que acompanha a carga durante a viagem, existe um conceito parecido: a UF de descarregamento, onde os documentos transportados serão entregues. Ela deve ser coerente com os municípios de término informados nos CT-e ou NF-e vinculados ao manifesto. Ao final da viagem, o manifesto passa pelo encerramento, que também informa a UF e o município onde o percurso terminou. Inconsistências entre esses dados podem gerar rejeições ou problemas em fiscalizações de trânsito. ## Quais erros são comuns ao preencher a UF de término? Os erros mais frequentes são informar uma UF que não corresponde ao código do município de término, usar um CFOP interno quando a prestação é interestadual (ou o contrário) e preencher o endereço do destinatário no lugar do ponto real de término do serviço. Em uma emissão por API, é recomendável que o sistema de origem, como um TMS ou ERP, valide esses dados antes do envio. O retorno da SEFAZ indica a rejeição quando há incoerência, e o sistema precisa tratar a correção e reenviar o documento. ## Exemplos de UF de término da prestação de transporte - Uma transportadora de Campinas (SP) leva uma carga até Curitiba (PR). No CT-e, a UF de início é SP, a UF de término é PR, e o CFOP usado começa com 6, indicando prestação interestadual. - Um frete entre Belo Horizonte e Uberlândia tem UF de início e UF de término iguais a MG. O CT-e usa CFOP iniciado por 5 e a alíquota interna de ICMS do estado. - Um TMS integrado a uma API fiscal envia no JSON os campos de município e UF de término; antes da transmissão, o sistema verifica se o código IBGE do município pertence à UF informada para evitar rejeição. - Uma carga exportada que sai do Rio Grande do Sul com destino ao Uruguai tem a UF de término preenchida como EX e o município de término com o código reservado para o exterior. ## Perguntas frequentes ### A UF de término é obrigatória no CT-e? Sim. Ela faz parte do grupo de identificação do CT-e, junto com o município de término. Sem ela, o documento não passa pelas validações do esquema XML e não é autorizado. ### A UF de término define para qual estado vai o ICMS do transporte? Em regra, o ICMS do transporte é devido ao estado onde a prestação se inicia. A UF de término ajuda a classificar a operação como interestadual e pode influenciar a alíquota e o DIFAL, conforme o tipo de tomador. ### O que preencher quando o transporte termina no exterior? Usa-se a sigla EX na UF de término e o código de município reservado para o exterior, com o nome do local de destino. O CFOP, nesse caso, costuma começar com 7. ### Posso corrigir a UF de término com Carta de Correção? Não é recomendável. Dados que alteram valores, tributação ou a natureza da operação, como a classificação interna ou interestadual, geralmente não podem ser corrigidos por carta de correção. O caminho costuma ser cancelar e emitir novo CT-e, dentro do prazo. ## Termos relacionados - [CT-e](https://conota.dev/glossario/ct-e.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [ICMS](https://conota.dev/glossario/icms.md) - [DIFAL](https://conota.dev/glossario/difal.md) - [DACTE](https://conota.dev/glossario/dacte.md) - [Encerramento do MDF-e](https://conota.dev/glossario/encerramento-do-mdf-e.md) --- Fonte: [UF de término da prestação de transporte](https://conota.dev/glossario/uf-de-termino-da-prestacao-de-transporte/) · Atualizado em 2026-10-22 --- # UF do emitente > UF do emitente é a Unidade Federativa, ou seja, o estado brasileiro ou o Distrito Federal, onde está estabelecida a empresa que emite um documento fiscal. Ela aparece no XML como sigla e como código numérico do IBGE e define qual SEFAZ autoriza a nota, quais regras estaduais se aplicam e se a operação é interna ou interestadual. **Também conhecido como:** Estado do emitente, UF de origem, Código da UF do emitente, cUF, UF, Issuer state **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que significa UF do emitente? UF é a sigla de Unidade Federativa, o nome técnico para os 26 estados e o Distrito Federal. A UF do emitente é o estado onde fica o estabelecimento que está emitindo a nota fiscal, e não necessariamente onde fica a matriz da empresa. Isso é importante porque cada filial com CNPJ próprio tem sua própria inscrição estadual, vinculada ao estado em que funciona. Uma empresa com matriz em São Paulo e filial em Minas Gerais terá UF do emitente SP nas notas da matriz e MG nas notas da filial. ## Onde a UF do emitente aparece no documento fiscal? Na NF-e e na NFC-e, a UF do emitente aparece em mais de um lugar. No grupo de identificação da nota, ela é informada como um código numérico de dois dígitos definido pelo IBGE, como 35 para São Paulo, 33 para o Rio de Janeiro e 41 para o Paraná. No endereço do emitente, ela aparece como sigla, por exemplo SP, RJ ou PR. Esse mesmo código numérico forma os dois primeiros dígitos da chave de acesso. Por isso, só de olhar o início da chave já é possível saber de qual estado a nota foi emitida. As informações precisam ser coerentes entre si: um código de UF que não corresponde ao endereço ou à inscrição estadual do emitente gera rejeição. ## Por que a UF do emitente define qual SEFAZ autoriza a nota? Documentos como NF-e, NFC-e, CT-e e MDF-e são autorizados pela Secretaria da Fazenda do estado do emitente. Alguns estados mantêm seu próprio ambiente de autorização, enquanto outros utilizam um ambiente compartilhado, chamado de SEFAZ virtual. A UF do emitente é o que indica ao sistema para qual endereço de serviço a nota deve ser enviada. A UF também define detalhes que variam entre estados, como as regras do CSC da NFC-e, particularidades de validação e qual ambiente de contingência (SVC) deve ser usado caso o autorizador principal fique indisponível. ## Qual a diferença entre UF do emitente e UF do destinatário? A UF do emitente indica de onde a mercadoria ou o documento sai; a UF do destinatário indica para onde vai. A comparação entre as duas define o tipo de operação: se forem iguais, a operação é interna; se forem diferentes, é interestadual. Essa diferença tem efeito direto nos impostos e nos códigos da nota. O CFOP muda (operações internas costumam usar códigos iniciados por 5 e interestaduais por 6), a alíquota de ICMS aplicada é outra e podem surgir obrigações adicionais, como a partilha do imposto com o estado de destino em certas vendas a consumidor final. ## A UF do emitente importa na NFS-e, no CT-e e no MDF-e? Na NFS-e, o que pesa mais é o município do prestador, porque o ISSQN é um imposto municipal e a autorização é feita pela prefeitura ou pelo Padrão Nacional. A UF aparece no endereço, mas não decide sozinha o autorizador. No CT-e e no MDF-e, a UF do emitente define a SEFAZ autorizadora, assim como na NF-e. No MDF-e, porém, ela convive com outras UFs importantes, como a de carregamento, a de descarregamento e as UFs de percurso, que descrevem o trajeto da carga. ## Como a UF do emitente é tratada em uma emissão por API? Em uma API fiscal, a UF do emitente normalmente vem do cadastro da empresa emissora: ao registrar o CNPJ, o endereço e a inscrição estadual, o sistema já sabe para qual SEFAZ encaminhar os documentos e qual código usar no XML e na chave de acesso. Para quem gerencia várias empresas ou filiais, o cuidado principal é emitir cada nota pelo estabelecimento correto. Usar o CNPJ da matriz para uma venda que saiu da filial, por exemplo, muda a UF do emitente, altera a tributação e pode gerar rejeição ou problema fiscal posterior. ## Exemplos de UF do emitente - Um e-commerce com centro de distribuição em Santa Catarina emite NF-e com UF do emitente SC; a chave de acesso dessas notas começa com o código 42. - Um ERP envia pela API uma venda de uma filial do Paraná para um cliente em São Paulo; como a UF do emitente (PR) é diferente da do destinatário (SP), a nota é tratada como operação interestadual, com CFOP e alíquota de ICMS correspondentes. - Uma transportadora sediada em Goiás emite CT-e e MDF-e autorizados pela SEFAZ goiana, mesmo que a carga seja carregada e entregue em outros estados. - Uma nota é rejeitada porque o código de UF informado no grupo de identificação não corresponde à sigla do estado no endereço do emitente. ## Perguntas frequentes ### A UF do emitente é a mesma da matriz da empresa? Não necessariamente. Ela corresponde ao estado do estabelecimento que emite a nota. Cada filial com inscrição estadual própria usa a UF onde está instalada. ### Como descobrir a UF do emitente pela chave de acesso? Os dois primeiros dígitos da chave de acesso são o código IBGE da UF do emitente. Por exemplo, uma chave iniciada em 35 indica nota emitida em São Paulo. ### Posso escolher a UF do emitente ao emitir uma nota? Não livremente. Ela decorre do endereço e da inscrição estadual do estabelecimento emissor. Para emitir por outro estado, é preciso usar um estabelecimento regularmente inscrito naquela UF. ### O que acontece se a UF do emitente estiver errada? Em geral, a SEFAZ rejeita a nota por inconsistência entre código da UF, endereço, inscrição estadual ou autorizador. Se passar, pode gerar tributação incorreta e exigir correção ou cancelamento. ## Termos relacionados - [Emitente de documento fiscal](https://conota.dev/glossario/emitente-de-documento-fiscal.md) - [SEFAZ](https://conota.dev/glossario/sefaz.md) - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Inscrição estadual](https://conota.dev/glossario/inscricao-estadual.md) - [Operação interestadual](https://conota.dev/glossario/operacao-interestadual.md) - [Operação interna](https://conota.dev/glossario/operacao-interna.md) --- Fonte: [UF do emitente](https://conota.dev/glossario/uf-do-emitente/) · Atualizado em 2026-10-22 --- # Unidade comercial > Unidade comercial é a unidade de medida em que um produto é efetivamente vendido e informado na nota fiscal, como unidade, caixa, quilo, litro ou fardo. Na NF-e e na NFC-e, ela aparece no campo uCom e serve de referência para a quantidade comercial e o valor unitário de cada item da operação. **Também conhecido como:** uCom, Unidade de comercialização, Unidade de venda, Commercial unit **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é unidade comercial na nota fiscal? Unidade comercial é a forma como o produto é negociado entre quem vende e quem compra. Se uma loja vende refrigerante em fardos de 12 latas, a unidade comercial é o fardo. Se vende a lata avulsa, a unidade comercial é a lata. Ela responde à pergunta: em que medida este item foi vendido nesta operação? Por isso, costuma refletir a embalagem ou a medida que aparece no pedido, no catálogo ou na etiqueta de preço. ## Como a unidade comercial aparece na NF-e e na NFC-e? No XML da NF-e e da NFC-e, cada item tem um grupo de dados de comercialização. A unidade comercial fica no campo uCom, que é um texto curto (no leiaute da NF-e, até 6 caracteres), como UN, CX, KG, LT ou FD. Ela trabalha junto com outros dois campos: a quantidade comercial (qCom), que indica quantas unidades daquela medida foram vendidas, e o valor unitário de comercialização (vUnCom), que indica o preço de cada uma. Multiplicando a quantidade pelo valor unitário chega-se ao valor bruto do produto no item. O código de barras informado no campo de GTIN comercial também deve corresponder a essa mesma unidade. Se a venda é por caixa, o GTIN deve ser o da caixa, e não o da unidade avulsa. ## Qual a diferença entre unidade comercial e unidade tributável? A unidade comercial segue a lógica da venda. A unidade tributável (campo uTrib) segue a lógica dos impostos e das estatísticas oficiais, e é a medida usada como referência para cálculo de alguns tributos e para controles do fisco. Muitas vezes as duas são iguais, mas nem sempre. Uma distribuidora pode vender cerveja por caixa (unidade comercial) e ter de informar a quantidade em litros ou em unidades (unidade tributável). Nesse caso, a nota traz as duas medidas com quantidades e valores unitários coerentes entre si. A relação entre elas é chamada de quociente entre unidades comercial e tributável: se uma caixa tem 24 unidades, vender 2 caixas corresponde a 48 unidades tributáveis. ## Por que a unidade comercial correta é importante? Uma unidade comercial mal informada gera notas confusas para o cliente, dificulta a conferência no recebimento e pode causar divergências de estoque. Também pode levar a inconsistências entre quantidade, valor unitário e valor total, que resultam em rejeição fiscal. Para quem recebe a nota, como o setor de compras de outra empresa, a unidade comercial é o que permite comparar a nota com o pedido. Se o pedido foi de 10 caixas e a nota diz 10 unidades, surge um problema operacional imediato. ## Como informar a unidade comercial ao emitir por API? Em uma emissão fiscal por API, o sistema de origem, como um ERP ou uma plataforma de venda, envia no payload de cada item a unidade comercial, a quantidade comercial e o valor unitário. O emissor monta o XML com esses dados, valida o leiaute e transmite à SEFAZ. O ideal é que a unidade venha do cadastro do produto no sistema de origem, padronizada (por exemplo, sempre CX para caixa), e que a unidade tributável e o quociente entre elas também estejam cadastrados. Isso evita digitação manual e reduz erros de validação na hora da emissão. ## Exemplos de Unidade comercial - Um atacadista vende 5 fardos de água mineral: na NF-e, a unidade comercial é FD, a quantidade comercial é 5 e o valor unitário é o preço de cada fardo. - Um supermercado emite uma NFC-e com 1,250 kg de queijo: a unidade comercial é KG, a quantidade comercial é 1,250 e o valor unitário é o preço do quilo. - Um ERP integrado a uma API fiscal envia um item com unidade comercial CX e quantidade 2, enquanto a unidade tributável é UN com quantidade 24, pois cada caixa tem 12 unidades. - Uma loja de materiais de construção vende cabo elétrico por rolo: a unidade comercial é RL, mesmo que o cabo também possa ser medido em metros. ## Perguntas frequentes ### Unidade comercial e unidade tributável podem ser iguais? Sim. Quando o produto é vendido na mesma medida usada para fins fiscais, como uma unidade avulsa, as duas coincidem, assim como suas quantidades e valores unitários. ### Existe uma lista obrigatória de siglas para a unidade comercial? O campo aceita texto curto, e cada empresa costuma padronizar suas siglas, como UN, CX e KG. O importante é manter consistência no cadastro e coerência com a quantidade e o valor informados. ### Errar a unidade comercial pode causar rejeição da nota? Pode, principalmente quando a quantidade, o valor unitário e o valor total do item ficam incoerentes, ou quando o GTIN não corresponde à unidade informada. Mesmo autorizada, uma unidade errada pode gerar problemas de estoque e conferência. ## Termos relacionados - [Quantidade comercial na NF-e](https://conota.dev/glossario/quantidade-comercial-na-nf-e.md) - [Quantidade tributável na NF-e](https://conota.dev/glossario/quantidade-tributavel-na-nf-e.md) - [Quociente entre unidades comercial e tributável](https://conota.dev/glossario/quociente-entre-unidades-comercial-e-tributavel.md) - [GTIN](https://conota.dev/glossario/gtin.md) - [NF-e](https://conota.dev/glossario/nf-e.md) - [Payload de emissão fiscal](https://conota.dev/glossario/payload-de-emissao-fiscal.md) --- Fonte: [Unidade comercial](https://conota.dev/glossario/unidade-comercial/) · Atualizado em 2026-10-22 --- # Unidade de carga no CT-e > Unidade de carga no CT-e é a informação que identifica o recipiente ou suporte físico que agrupa as mercadorias transportadas, como contêiner, pallet ou ULD de transporte aéreo. Ela é registrada no XML do Conhecimento de Transporte Eletrônico junto aos documentos da carga e ajuda a rastrear como os volumes foram acondicionados e lacrados. **Também conhecido como:** Informações da unidade de carga, infUnidCarga, Unidade de carga do CT-e, Load unit **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é a unidade de carga no CT-e? No transporte, a mercadoria raramente viaja solta. Ela costuma ser agrupada em algo que facilita o manuseio: um contêiner, um pallet ou uma unidade de carga aérea (ULD, sigla em inglês para Unit Load Device). No CT-e, a unidade de carga é o campo que descreve esse agrupamento. No leiaute do CT-e, essas informações ficam em um grupo chamado infUnidCarga, vinculado aos documentos que acompanham a carga, como a NF-e transportada. Assim, o documento fiscal informa não só o que está sendo levado, mas também em que estrutura física a carga está acondicionada. ## Quais informações compõem a unidade de carga? O grupo de unidade de carga reúne basicamente quatro dados: o tipo da unidade, sua identificação, os lacres e, quando necessário, a quantidade rateada. O tipo indica a natureza da unidade, com opções como contêiner, ULD, pallet ou outros. A identificação é o código que diferencia aquela unidade específica, como o número de um contêiner. Os lacres registram os números dos selos de segurança aplicados. A quantidade rateada é usada quando uma mesma unidade transporta cargas de documentos diferentes e é preciso indicar a parcela correspondente a cada um. ## Para que serve informar a unidade de carga? A principal utilidade é a rastreabilidade. Ao vincular a nota fiscal da mercadoria a um contêiner ou pallet identificado e lacrado, fica mais fácil para transportadoras, embarcadores, seguradoras e fiscalização conferir se a carga chegou como saiu. Essa informação também ajuda em processos como conferência no recebimento, investigação de avarias ou extravios e conciliação entre o que foi faturado e o que foi efetivamente transportado, especialmente em operações com contêineres e transporte multimodal. ## Qual a diferença entre unidade de carga e unidade de transporte? São conceitos complementares e costumam ser confundidos. A unidade de carga é o que agrupa a mercadoria: contêiner, pallet, ULD. A unidade de transporte é o veículo ou equipamento que leva essa carga: cavalo mecânico, reboque, navio, balsa, aeronave ou vagão. No XML do CT-e, existe um grupo próprio para a unidade de transporte (infUnidTransp), e a unidade de carga pode ser informada dentro dele ou diretamente vinculada ao documento da carga. Por exemplo: um contêiner (unidade de carga) pode estar sobre um reboque rodoviário (unidade de transporte). ## Unidade de carga é o mesmo que unidade de medida da carga? Não. O CT-e também tem campos de quantidade da carga, em que se informa a unidade de medida, como quilograma, tonelada, metro cúbico, litro ou unidade. Esses campos dizem quanto está sendo transportado. Já a unidade de carga diz em que estrutura física a mercadoria está acondicionada. Uma carga pode ter 20 toneladas (medida) distribuídas em um contêiner (unidade de carga). ## Como isso funciona na emissão do CT-e por API? Quando o CT-e é emitido por um sistema próprio, como um TMS ou ERP integrado a uma API fiscal, os dados da unidade de carga são enviados no corpo da requisição, geralmente em JSON, e convertidos para o XML exigido pelo leiaute oficial. Se os dados forem informados com tipo inválido, identificação ausente ou estrutura fora do esquema, o documento pode ser rejeitado na validação. Por isso, vale validar tipo, identificação e lacres antes do envio e tratar as rejeições retornadas com o status do documento. ## Exemplos de Unidade de carga no CT-e - Uma transportadora rodoviária emite o CT-e de uma carga de eletrônicos que viaja em contêiner sobre uma carreta, informando o tipo contêiner, o número do contêiner e os números dos lacres aplicados no embarque. - Um operador logístico agrupa mercadorias de três NF-e diferentes em um mesmo pallet e usa a quantidade rateada para indicar a parcela da unidade de carga correspondente a cada nota. - Em um transporte aéreo, o CT-e informa a ULD em que as caixas foram acondicionadas, permitindo conferir no destino se a unidade chegou com a mesma identificação. - Um TMS integrado a uma API fiscal envia no JSON de emissão o grupo de unidade de carga com tipo, identificação e lacres, e recebe de volta o XML autorizado e o DACTE. ## Perguntas frequentes ### A unidade de carga é obrigatória em todo CT-e? Não necessariamente. Ela é informada quando a carga está acondicionada em uma unidade identificável, como contêiner, pallet ou ULD. A obrigatoriedade depende do leiaute vigente e do tipo de operação, por isso convém consultar o manual oficial do CT-e. ### Posso informar mais de uma unidade de carga no mesmo CT-e? Sim. Uma mesma carga pode estar distribuída em vários contêineres ou pallets, e o leiaute permite informar múltiplas unidades, cada uma com sua identificação e seus lacres. ### Onde aparece a unidade de carga além do XML? Ela pode constar na representação impressa do CT-e, o DACTE, e informações semelhantes existem no MDF-e, que também possui grupos para unidades de carga e de transporte vinculadas aos documentos transportados. ### O que acontece se eu informar a unidade de carga errada? Erros de formato podem gerar rejeição na validação. Se o documento já foi autorizado com informação incorreta, a correção pode ser feita por Carta de Correção Eletrônica quando a regra permitir, ou por outros procedimentos previstos na legislação. ## Termos relacionados - [CT-e](https://conota.dev/glossario/ct-e.md) - [DACTE](https://conota.dev/glossario/dacte.md) - [Averbação de carga](https://conota.dev/glossario/averbacao-de-carga.md) - [Encerramento do MDF-e](https://conota.dev/glossario/encerramento-do-mdf-e.md) - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) --- Fonte: [Unidade de carga no CT-e](https://conota.dev/glossario/unidade-de-carga-no-ct-e/) · Atualizado em 2026-10-22 --- # Unidade de despacho aduaneiro > Unidade de despacho aduaneiro é a repartição da Receita Federal responsável por conduzir o despacho aduaneiro de uma mercadoria, ou seja, conferir os dados declarados na importação ou exportação e liberar a carga. Ela costuma aparecer em declarações aduaneiras e pode ser exigida em campos da NF-e de operações com o exterior. **Também conhecido como:** Unidade da Receita Federal de despacho, Repartição de despacho aduaneiro, Local de despacho aduaneiro, Customs clearance office **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é uma unidade de despacho aduaneiro? É o órgão local da Receita Federal, como uma alfândega ou inspetoria, que tem competência para processar o despacho aduaneiro de uma operação de comércio exterior. O despacho é o procedimento em que a fiscalização verifica se as informações declaradas pelo importador ou exportador batem com a mercadoria, a documentação e a legislação. Essa unidade é responsável pelos recintos alfandegados da sua região, como portos, aeroportos, portos secos e pontos de fronteira. É ali que a declaração aduaneira é analisada e, quando tudo está correto, a mercadoria é desembaraçada, ou seja, liberada para entrar ou sair do país. ## Para que serve a unidade de despacho aduaneiro? Ela define quem fiscaliza a operação e onde a carga será conferida. Ao registrar uma declaração de importação ou exportação no Siscomex, a empresa informa a unidade de despacho, e é essa repartição que vai analisar documentos, eventualmente vistoriar a carga e autorizar a liberação. Para a empresa, saber qual é a unidade de despacho ajuda a planejar logística, prazos e custos, já que o local de despacho influencia o trajeto da mercadoria e onde ela precisará estar disponível para conferência. ## Qual a diferença entre unidade de despacho e unidade de embarque? Na exportação, nem sempre a carga é despachada no mesmo lugar em que sai do país. A unidade de despacho é onde ocorre a conferência e a liberação aduaneira. A unidade de embarque é onde a mercadoria efetivamente deixa o território nacional, como um porto marítimo ou um aeroporto. Um exemplo comum é a carga despachada em um porto seco no interior, já conferida e lacrada, que segue depois para um porto no litoral apenas para embarque. Na importação, a lógica equivalente aparece como local de desembaraço aduaneiro, que pode ser diferente do ponto de chegada da mercadoria. ## Onde a unidade de despacho aparece na nota fiscal eletrônica? Na NF-e de exportação, o grupo de informações de exportação reúne dados como a UF de saída do país, o local de embarque e o local de despacho. Essas informações ligam a nota fiscal à operação registrada no ambiente aduaneiro e ajudam o fisco a comprovar que a mercadoria realmente saiu do país. Na NF-e de importação, os dados da declaração de importação incluem o local e a UF do desembaraço aduaneiro, além da data em que ele ocorreu. A obrigatoriedade e o formato exato de cada campo seguem o leiaute vigente da NF-e e as notas técnicas publicadas para o documento. ## Como isso afeta quem emite notas fiscais por API? Sistemas como ERPs e plataformas de venda que atendem exportadores ou importadores precisam ter esses dados no cadastro da operação antes de emitir a nota. Se o local de despacho ou de desembaraço estiver ausente ou inconsistente com a operação, a NF-e pode ser rejeitada na validação ou gerar problemas na comprovação da exportação. Por isso, é comum o sistema buscar essas informações junto ao despachante aduaneiro ou ao módulo de comércio exterior e enviá-las no JSON de emissão, nos campos correspondentes ao grupo de exportação ou de importação. ## Exemplos de Unidade de despacho aduaneiro - Uma indústria do interior de São Paulo despacha sua carga em um porto seco da região, onde a Receita Federal faz a conferência, e depois a envia lacrada ao porto de Santos apenas para embarque. Na NF-e, o local de despacho e o local de embarque são informados separadamente. - Um importador de eletrônicos tem a mercadoria desembaraçada na alfândega de um aeroporto internacional e, ao emitir a NF-e de entrada, informa o local, a UF e a data do desembaraço aduaneiro com base na declaração de importação. - Um ERP integrado a uma API fiscal recebe uma rejeição em uma nota de exportação porque o grupo de exportação foi enviado sem o local de embarque, e o time ajusta o cadastro do pedido para preencher esses dados automaticamente. - Um despachante aduaneiro informa ao exportador qual repartição da Receita Federal ficará responsável pela conferência, e essa informação é repassada ao setor fiscal para compor a declaração e a nota fiscal. ## Perguntas frequentes ### Unidade de despacho aduaneiro é o mesmo que alfândega? Nem sempre. Alfândega é um tipo de unidade da Receita Federal que pode atuar como unidade de despacho. Inspetorias e outras repartições aduaneiras também podem exercer essa função, conforme sua jurisdição. ### Toda NF-e precisa informar o local de despacho? Não. Esses dados só fazem sentido em operações com o exterior, como exportações e importações. Notas de vendas internas ou interestaduais comuns não usam o grupo de exportação nem os dados de desembaraço. ### Quem define a unidade de despacho de uma operação? Normalmente o exportador ou importador, com apoio do despachante aduaneiro, escolhe o local conforme a logística da carga e registra essa informação na declaração aduaneira, respeitando as regras da Receita Federal. ### O local de despacho pode ser diferente do local de embarque? Sim. É comum a carga ser conferida e liberada em um recinto no interior, como um porto seco, e depois seguir para outro ponto, como um porto ou aeroporto, apenas para embarque ao exterior. ## Termos relacionados - [Grupo de informações de exportação da NF-e](https://conota.dev/glossario/grupo-de-informacoes-de-exportacao-da-nf-e.md) - [Habilitação no Siscomex](https://conota.dev/glossario/habilitacao-no-siscomex.md) - [Exportação indireta](https://conota.dev/glossario/exportacao-indireta.md) - [Ficha de Conteúdo de Importação](https://conota.dev/glossario/ficha-de-conteudo-de-importacao.md) - [CFOP](https://conota.dev/glossario/cfop.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) --- Fonte: [Unidade de despacho aduaneiro](https://conota.dev/glossario/unidade-de-despacho-aduaneiro/) · Atualizado em 2026-10-22 --- # Unidade de transporte no MDF-e > Unidade de transporte no MDF-e é a informação, dentro do Manifesto Eletrônico de Documentos Fiscais, que identifica o equipamento físico que leva a carga de cada documento vinculado, como cavalo mecânico, reboque, vagão, navio, balsa ou aeronave. Ela mostra ao fisco em qual veículo ou compartimento está cada nota fiscal ou conhecimento de transporte da viagem. **Também conhecido como:** Informações das unidades de transporte, infUnidTransp, Unidade de transporte do MDF-e **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é a unidade de transporte no MDF-e? O MDF-e é o documento que reúne todas as notas fiscais (NF-e) ou conhecimentos de transporte (CT-e) que viajam juntos em uma mesma carga. A unidade de transporte é o campo que diz em qual equipamento cada um desses documentos está sendo levado. No arquivo XML do MDF-e, essa informação fica no grupo chamado infUnidTransp, que aparece dentro de cada documento vinculado ao manifesto. Assim, é possível dizer, por exemplo, que uma NF-e está no primeiro reboque e outra no segundo reboque da mesma carreta. ## Para que serve informar a unidade de transporte? Serve para dar rastreabilidade à carga. Em uma fiscalização, o agente consegue relacionar cada documento ao veículo, vagão ou compartimento onde a mercadoria deveria estar, o que facilita a conferência física. Também ajuda a transportadora a organizar operações com vários equipamentos, como composições com mais de um reboque, trens com diversos vagões ou cargas que passam por balsa. Os lacres de cada unidade também podem ser registrados, reforçando o controle sobre a integridade da carga. ## Quais tipos de unidade de transporte existem? O leiaute do MDF-e prevê uma lista fechada de tipos, informada por código: rodoviário tração (o cavalo mecânico ou caminhão), rodoviário reboque, navio, balsa, aeronave, vagão e outros. Além do tipo, informa-se a identificação da unidade, como a placa do veículo ou o número do vagão, e, quando houver, os números dos lacres aplicados nela. ## Qual a diferença entre unidade de transporte e unidade de carga? A unidade de transporte é o veículo ou equipamento que se desloca, como o reboque ou o vagão. A unidade de carga é o recipiente que fica dentro dele e agrupa a mercadoria, como um contêiner, um pallet ou um ULD (unidade de carga usada no transporte aéreo). No XML, a unidade de carga aparece dentro da unidade de transporte, no grupo infUnidCarga. Assim, é possível descrever, por exemplo, um contêiner específico que está sobre um reboque específico. Também existe o campo de quantidade rateada, usado quando a carga de um documento é dividida entre mais de uma unidade. ## A unidade de transporte é obrigatória no MDF-e? No leiaute nacional, o grupo de unidades de transporte vinculado a cada documento é opcional. Ele não substitui os dados do veículo exigidos no grupo do modal, como as informações do veículo de tração e dos reboques no modal rodoviário. Mesmo sendo opcional, quando o grupo é preenchido ele precisa seguir as regras do esquema XML, com tipos e formatos válidos. Dados inconsistentes podem gerar rejeição na autorização. Por isso, vale conferir as regras vigentes no Manual de Orientação do Contribuinte do MDF-e e as particularidades de cada operação. ## Como isso funciona na emissão por API? Em uma emissão por API, o sistema da transportadora ou do embarcador envia os dados do manifesto em formato estruturado, incluindo, para cada documento, a lista de unidades de transporte, seus lacres e as unidades de carga. A API monta o XML, assina, envia para autorização e devolve o status. Como a mesma carga pode estar distribuída entre vários equipamentos, é comum o sistema de gestão de frota ou o TMS ser a fonte dessa informação, repassando placas, números de vagões e contêineres diretamente para a integração fiscal, sem digitação manual. ## Exemplos de Unidade de transporte no MDF-e - Uma transportadora emite um MDF-e para uma carreta bitrem com duas NF-e: a primeira é vinculada à unidade de transporte do tipo rodoviário reboque com a placa do primeiro reboque, e a segunda à placa do segundo reboque. - Um operador ferroviário informa, para cada CT-e do manifesto, o número do vagão em que a carga foi embarcada, usando o tipo vagão como unidade de transporte. - Uma empresa de cabotagem descreve no MDF-e o navio como unidade de transporte e, dentro dele, os contêineres de cada documento como unidades de carga, com os respectivos lacres. - O ERP de um embarcador recebe do TMS a placa do reboque e o número do lacre e envia esses dados pela API fiscal junto com as NF-e vinculadas ao manifesto. ## Perguntas frequentes ### A placa do veículo de tração já basta, ou preciso preencher a unidade de transporte? Os dados do veículo do modal rodoviário são exigidos em grupo próprio. A unidade de transporte por documento é opcional e complementa essa informação, indicando em qual equipamento cada nota ou conhecimento está. ### Posso informar mais de uma unidade de transporte para o mesmo documento? Sim. O leiaute permite listar várias unidades para um mesmo documento, e o campo de quantidade rateada ajuda a indicar quanto da carga está em cada uma. ### Os lacres são informados na unidade de transporte ou na unidade de carga? Podem ser informados nas duas. Lacres do veículo ou reboque ficam na unidade de transporte; lacres de contêineres ou outros recipientes ficam na unidade de carga. ### A unidade de transporte aparece no DAMDFE? O DAMDFE é uma representação simplificada do manifesto. A informação completa sobre unidades de transporte fica no XML autorizado, que é o documento com validade jurídica. ## Termos relacionados - [DAMDFE](https://conota.dev/glossario/damdfe.md) - [Encerramento do MDF-e](https://conota.dev/glossario/encerramento-do-mdf-e.md) - [CT-e](https://conota.dev/glossario/ct-e.md) - [Averbação de carga](https://conota.dev/glossario/averbacao-de-carga.md) - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) --- Fonte: [Unidade de transporte no MDF-e](https://conota.dev/glossario/unidade-de-transporte-no-mdf-e/) · Atualizado em 2026-10-22 --- # Unidade fiscal de referência > Unidade fiscal de referência é um indexador criado pelo poder público para expressar valores tributários, como multas, taxas e limites legais, em unidades em vez de reais. O valor de cada unidade é atualizado periodicamente, o que mantém esses montantes corrigidos sem precisar alterar a lei sempre que a inflação muda o poder de compra. **Também conhecido como:** UFIR, Unidade fiscal, Unidade de referência fiscal, Unidade fiscal estadual, Unidade fiscal municipal, Tax reference unit **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é uma unidade fiscal de referência? É uma espécie de régua que o governo usa para medir valores ligados a tributos. Em vez de a lei dizer que uma multa custa um valor fixo em reais, ela diz que a multa equivale a uma quantidade de unidades fiscais. Para saber quanto pagar, basta multiplicar essa quantidade pelo valor da unidade vigente. A sigla mais conhecida é UFIR, nome da unidade criada pela União. Com o tempo, a UFIR federal foi extinta, mas muitos estados e municípios mantêm unidades próprias, como a UFESP em São Paulo e a UFEMG em Minas Gerais, além de diversas unidades fiscais municipais. ## Para que serve a unidade fiscal de referência? Ela serve para manter valores atualizados ao longo do tempo. Se uma lei fixasse multas em reais, a inflação faria esses valores perderem força, e seria preciso aprovar novas leis para corrigi-los. Com a unidade fiscal, basta o órgão responsável divulgar o novo valor da unidade. Na prática, ela aparece em multas por descumprimento de obrigações acessórias, em taxas de serviços públicos, em limites de faturamento para regimes especiais, em valores mínimos para parcelamentos e em faixas que definem se uma dívida pode ou não ser inscrita em cobrança. ## Como funciona o cálculo com a unidade fiscal? O cálculo é simples: quantidade de unidades prevista na norma multiplicada pelo valor da unidade no período. Se uma penalidade equivale a 100 unidades e cada unidade vale um determinado valor em reais naquele ano, o resultado é a multa em reais. O ponto de atenção é a data de referência. Cada ente define quando a unidade é atualizada, geralmente uma vez por ano, e a norma pode indicar se vale o valor da data da infração, do lançamento ou do pagamento. Usar a unidade do período errado gera diferenças no valor final. ## Qual a diferença entre unidade fiscal de referência e índices de correção como a SELIC? A unidade fiscal é um valor de base usado para expressar montantes previstos em lei, como multas e taxas. Já índices e taxas como a SELIC costumam ser usados para calcular juros e atualização de débitos em atraso. Os dois podem aparecer juntos: uma multa pode ser fixada em unidades fiscais e, se não for paga no prazo, sofrer acréscimo de juros calculados por outro índice, conforme a legislação de cada ente. ## Por que isso importa para quem emite documentos fiscais por API? Muitas penalidades ligadas a notas fiscais, como deixar de emitir NF-e, NFS-e ou NFC-e, emitir com dados incorretos ou não guardar os arquivos XML, são previstas em unidades fiscais pela legislação estadual ou municipal. Errar na emissão pode, portanto, gerar multas que variam de um local para outro. Para empresas com ERPs, marketplaces ou plataformas que operam em vários estados e municípios, isso reforça a importância de emitir corretamente e acompanhar rejeições. Se o sistema calcula valores ligados a unidades fiscais, como taxas ou limites, o ideal é tratar o valor da unidade como um parâmetro configurável por ente e por período, e não como número fixo no código. ## Exemplos de Unidade fiscal de referência - Uma lei municipal prevê multa equivalente a determinada quantidade de unidades fiscais do município para o prestador que deixar de emitir NFS-e; o valor em reais muda a cada atualização anual da unidade. - Em São Paulo, diversas penalidades e taxas estaduais são expressas em UFESP, e o contribuinte converte para reais usando o valor da UFESP vigente no período. - Um ERP que atende clientes em vários estados mantém uma tabela com o valor de cada unidade fiscal estadual por ano para estimar multas e taxas corretamente. - Um município define um valor mínimo, em unidades fiscais, abaixo do qual débitos de ISSQN não são encaminhados para cobrança judicial. ## Perguntas frequentes ### A UFIR ainda existe? A UFIR federal foi extinta, mas o conceito continua vivo. Vários estados e municípios mantêm unidades fiscais próprias, algumas inclusive com nomes parecidos, como UFIR estadual ou municipal, usadas em suas leis tributárias. ### Onde encontro o valor atual da unidade fiscal? O valor é divulgado pelo próprio ente que criou a unidade, normalmente a secretaria da fazenda do estado ou a secretaria de finanças do município, por meio de ato oficial publicado no diário oficial ou no site do órgão. ### Todos os estados usam a mesma unidade fiscal? Não. Cada estado e cada município pode criar sua própria unidade, com nome, valor e regra de atualização diferentes. Por isso, é preciso verificar a legislação do local onde a obrigação ou a penalidade se aplica. ## Termos relacionados - [Fisco](https://conota.dev/glossario/fisco.md) - [Fiscalização tributária](https://conota.dev/glossario/fiscalizacao-tributaria.md) - [Juros de mora tributária](https://conota.dev/glossario/juros-de-mora-tributaria.md) - [Juros SELIC em débitos fiscais](https://conota.dev/glossario/juros-selic-em-debitos-fiscais.md) - [Jurisdição tributária](https://conota.dev/glossario/jurisdicao-tributaria.md) - [ISSQN](https://conota.dev/glossario/issqn.md) --- Fonte: [Unidade fiscal de referência](https://conota.dev/glossario/unidade-fiscal-de-referencia/) · Atualizado em 2026-10-22 --- # Unidade tributável > Unidade tributável é a unidade de medida usada para calcular os tributos de um produto na nota fiscal eletrônica, como unidade, quilo, litro ou metro. Ela pode ser diferente da unidade comercial, que é a forma como o item foi vendido, e aparece no XML da NF-e e da NFC-e no campo uTrib. **Também conhecido como:** Unidade de tributação, uTrib, Unidade fiscal do produto, Taxable unit **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é unidade tributável na nota fiscal? Cada produto informado em uma NF-e ou NFC-e tem duas formas de medida. A primeira é a unidade comercial, que mostra como o item foi negociado, por exemplo caixa, fardo ou pacote. A segunda é a unidade tributável, que mostra a medida usada como referência para os impostos e para o controle fiscal. No arquivo XML da nota, a unidade tributável fica no campo uTrib. Ela vem sempre acompanhada da quantidade tributável (qTrib) e do valor unitário de tributação (vUnTrib). Os três campos precisam estar coerentes entre si. ## Para que serve a unidade tributável? Ela padroniza a forma de medir os produtos para o Fisco. Uma empresa pode vender refrigerante em fardos de 6 ou de 12 unidades, mas a tributação e as estatísticas oficiais costumam olhar para a garrafa, o litro ou outra medida padrão. Essa padronização é importante quando um tributo é calculado por quantidade, e não só pelo preço, e também em operações controladas, como as exportações, em que a medida informada precisa seguir a unidade estatística associada ao NCM do produto. ## Qual a diferença entre unidade comercial e unidade tributável? A unidade comercial (uCom) reflete a venda: é o que aparece no pedido, na etiqueta e no acordo com o cliente. A unidade tributável (uTrib) reflete a medida fiscal de referência. Em muitos produtos as duas são iguais, como quando se vende e se tributa por unidade. Quando são diferentes, é preciso converter a quantidade. Se a venda foi de 2 caixas com 12 unidades cada, a quantidade comercial é 2 e a quantidade tributável é 24. Essa relação é chamada de quociente ou fator de conversão entre as unidades. ## Como preencher a unidade tributável corretamente? Primeiro, identifique a medida de referência do produto, considerando o NCM e as regras aplicáveis à operação. Depois, calcule a quantidade tributável multiplicando a quantidade comercial pelo fator de conversão. Por fim, ajuste o valor unitário tributável para que o valor total do item continue o mesmo. Na prática, a conta deve fechar assim: quantidade comercial vezes valor unitário comercial deve resultar no mesmo valor que quantidade tributável vezes valor unitário tributável. Se o produto tiver código de barras, o GTIN da unidade tributável também deve corresponder à embalagem informada nessa medida. ## Como a unidade tributável aparece em uma API fiscal? Em uma emissão por API, o sistema de origem, como um ERP ou marketplace, envia no payload de cada item a unidade, a quantidade e o valor unitário tributáveis, ao lado dos dados comerciais. A API monta o XML no leiaute oficial e envia o documento para autorização. Por isso, vale manter no cadastro de produtos do sistema a unidade tributável e o fator de conversão de cada item. Assim, a integração calcula os campos automaticamente e reduz erros de validação e rejeições causadas por valores que não fecham. ## Exemplos de Unidade tributável - Uma distribuidora vende 10 caixas de água mineral com 12 garrafas cada. Na NF-e, a unidade comercial é CX com quantidade 10, e a unidade tributável é UN com quantidade 120. - Um ERP de material de construção vende cabos elétricos em rolos de 100 metros. O item sai com unidade comercial RL e unidade tributável M, e a integração converte a quantidade automaticamente antes de chamar a API fiscal. - Uma indústria que exporta grãos informa a unidade tributável em quilos, conforme a unidade estatística do NCM, mesmo negociando o produto em sacas com o comprador. - Um supermercado emite NFC-e de um pacote de café vendido por unidade, em que unidade comercial e unidade tributável são iguais: UN e quantidade 1 nos dois casos. ## Perguntas frequentes ### A unidade tributável pode ser igual à unidade comercial? Sim. Em muitos produtos as duas são iguais, e então quantidade e valor unitário também se repetem nos dois grupos de campos. Só é preciso diferenciá-las quando a forma de venda não coincide com a medida fiscal de referência. ### O que acontece se a unidade tributável for preenchida errada? A nota pode ser rejeitada por inconsistência de valores ou, se autorizada, gerar divergências fiscais, cálculo incorreto de tributos e problemas em operações controladas, como exportações. Nesses casos, pode ser necessário corrigir por nota complementar ou cancelamento, conforme a situação. ### Onde fica a unidade tributável no XML da NF-e? Fica no grupo de dados do produto de cada item, no campo uTrib, junto com qTrib (quantidade tributável), vUnTrib (valor unitário de tributação) e cEANTrib (GTIN da unidade tributável). ## Termos relacionados - [Quantidade tributável na NF-e](https://conota.dev/glossario/quantidade-tributavel-na-nf-e.md) - [Quantidade comercial na NF-e](https://conota.dev/glossario/quantidade-comercial-na-nf-e.md) - [Quociente entre unidades comercial e tributável](https://conota.dev/glossario/quociente-entre-unidades-comercial-e-tributavel.md) - [NCM](https://conota.dev/glossario/ncm.md) - [GTIN](https://conota.dev/glossario/gtin.md) - [Operação de exportação](https://conota.dev/glossario/operacao-de-exportacao.md) --- Fonte: [Unidade tributável](https://conota.dev/glossario/unidade-tributavel/) · Atualizado em 2026-10-22 --- # Upload de certificado digital > Upload de certificado digital é o envio do arquivo do certificado A1 (geralmente .pfx ou .p12) e de sua senha para um sistema emissor ou API fiscal, que passa a usá-lo para assinar digitalmente os documentos fiscais em nome da empresa. Sem esse passo, não é possível emitir NF-e, NFC-e, CT-e, MDF-e e, em muitos casos, NFS-e. **Também conhecido como:** Envio de certificado digital, Importação de certificado digital, Cadastro de certificado digital, Upload do certificado A1, Digital certificate upload **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## Para que serve o upload de certificado digital? Todo documento fiscal eletrônico precisa ser assinado digitalmente antes de ser enviado à SEFAZ ou à prefeitura. Essa assinatura comprova que o documento foi emitido pela empresa dona do CNPJ e que não foi alterado depois. Quem faz essa assinatura é o certificado digital da empresa. Quando a emissão é feita por uma API fiscal, o certificado precisa estar disponível no servidor que monta e assina o XML. O upload é justamente o momento em que a empresa entrega esse certificado à plataforma, autorizando-a a assinar documentos em seu nome. ## Como funciona o upload de certificado digital? Na prática, a empresa envia o arquivo do certificado e informa a senha que o protege. Isso pode ser feito por uma tela de administração, como um painel ou console, ou diretamente pela API. No envio por API, o arquivo costuma ser convertido para texto em Base64 e enviado dentro de uma requisição junto com a senha. Ao receber o arquivo, o sistema normalmente faz algumas verificações: se a senha abre o certificado, se ele está dentro do prazo de validade e se o CNPJ do certificado corresponde à empresa cadastrada. Se algo estiver errado, o upload é recusado com uma mensagem explicando o problema. Depois de aceito, o certificado fica vinculado à empresa emissora e passa a ser usado automaticamente em cada emissão, cancelamento, carta de correção e outros eventos fiscais. ## Qual certificado pode ser enviado: A1 ou A3? Apenas o certificado do tipo A1 pode ser enviado por upload, porque ele é um arquivo comum instalado no computador ou servidor. Isso permite que a plataforma o use de forma automática, sem intervenção humana. O certificado A3 fica gravado em um dispositivo físico, como token USB ou cartão, e sua chave privada não pode ser copiada para fora dele. Por isso, ele não serve para emissão automatizada em nuvem. Empresas que usam A3 e querem emitir por API geralmente precisam adquirir também um certificado A1. ## O upload de certificado digital é seguro? O certificado A1 é, na prática, a identidade digital da empresa. Quem tem o arquivo e a senha pode assinar documentos como se fosse ela. Por isso, o upload deve ocorrer sempre por conexão criptografada (HTTPS) e o arquivo deve ser guardado de forma protegida pela plataforma. Boas práticas incluem armazenar o certificado e a senha criptografados, em cofres de segredos ou serviços de gerenciamento de chaves, restringir quem pode enviar ou substituir certificados e registrar cada troca em trilha de auditoria. Do lado da empresa, o ideal é não circular o arquivo por e-mail ou mensagens e enviá-lo apenas pelos canais oficiais da plataforma. ## O que fazer quando o certificado vence ou é trocado? O certificado A1 tem validade limitada, normalmente de um ano. Quando ele vence, a emissão para de funcionar e os documentos passam a ser rejeitados. Para evitar isso, é preciso renovar o certificado e fazer um novo upload antes da data de expiração. Muitas plataformas mostram a data de validade e avisam com antecedência sobre o vencimento. Em ambientes com várias empresas, como ERPs e marketplaces que emitem para muitos CNPJs, acompanhar essas datas em um único painel evita interrupções inesperadas. ## Exemplos de Upload de certificado digital - Um ERP que atende centenas de clientes oferece uma tela onde cada cliente anexa seu arquivo .pfx e digita a senha; o ERP converte o arquivo para Base64 e o envia pela API do emissor fiscal, vinculando o certificado ao CNPJ correto. - Uma transportadora renova seu certificado A1 uma semana antes do vencimento e faz o upload do novo arquivo no console do emissor, garantindo que a emissão de CT-e e MDF-e continue sem interrupção. - Um marketplace tenta cadastrar um vendedor, mas o upload é recusado porque o CNPJ do certificado é da matriz e não da filial cadastrada; o vendedor envia o certificado correto e a emissão é liberada. - Uma equipe de desenvolvimento faz o upload de um certificado no ambiente de homologação para testar a emissão de NF-e antes de ativar a integração em produção. ## Perguntas frequentes ### Preciso fazer upload do certificado para cada documento emitido? Não. O upload é feito uma vez por certificado. Depois disso, a plataforma usa o mesmo arquivo em todas as emissões e eventos da empresa até que ele vença ou seja substituído. ### Por que meu upload de certificado foi recusado? Os motivos mais comuns são senha incorreta, certificado vencido, arquivo corrompido, formato diferente de .pfx ou .p12, ou CNPJ do certificado diferente do CNPJ da empresa cadastrada. ### Toda NFS-e exige upload de certificado digital? Depende do município e do padrão usado. Muitas prefeituras e o Padrão Nacional da NFS-e exigem assinatura com certificado, mas alguns municípios aceitam outras formas de autenticação, como usuário e senha. ### Posso usar o mesmo certificado em mais de um sistema? Sim, o certificado A1 pode ser enviado a mais de uma plataforma. Porém, quanto mais lugares guardam o arquivo, maior o risco de vazamento, então convém limitar essa distribuição. ## Termos relacionados - [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Base64 no envio de certificados](https://conota.dev/glossario/base64-no-envio-de-certificados.md) - [Keystore de certificados digitais](https://conota.dev/glossario/keystore-de-certificados-digitais.md) - [Gerenciamento de segredos](https://conota.dev/glossario/gerenciamento-de-segredos.md) - [Gestão de empresas emissoras](https://conota.dev/glossario/gestao-de-empresas-emissoras.md) --- Fonte: [Upload de certificado digital](https://conota.dev/glossario/upload-de-certificado-digital/) · Atualizado em 2026-10-22 --- # Uptime da API fiscal > Uptime da API fiscal é o percentual de tempo em que uma API de emissão de documentos fiscais permanece disponível e respondendo corretamente às requisições dos sistemas integrados. Ele indica a confiabilidade do serviço e ajuda a avaliar se ERPs, lojas virtuais e marketplaces conseguirão emitir NF-e, NFS-e, NFC-e, CT-e e MDF-e sem interrupções. **Também conhecido como:** Disponibilidade da API fiscal, Tempo de atividade da API fiscal, Uptime do emissor fiscal, Fiscal API uptime **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que significa uptime da API fiscal? Uptime, em tradução livre, é o tempo em que um serviço está no ar. No caso de uma API fiscal, é a medida de quanto tempo ela ficou disponível para receber pedidos de emissão, consulta, cancelamento e download de documentos fiscais. Normalmente, o uptime é expresso em porcentagem dentro de um período, como um mês. Um valor de 99,9% mensal, por exemplo, significa que a API ficou fora do ar por pouco mais de 40 minutos naquele mês. Quanto mais próximo de 100%, menor o tempo de indisponibilidade. ## Por que o uptime é importante na emissão de notas fiscais? Muitas vendas só podem ser concluídas com a nota fiscal emitida. Se a API fica indisponível, um e-commerce pode atrasar o despacho de pedidos, um caixa de loja pode travar na emissão da NFC-e e uma transportadora pode não conseguir emitir o CT-e e o MDF-e antes de liberar a carga. Por isso, o uptime é um dos critérios mais relevantes na escolha de um provedor de API fiscal. Ele afeta diretamente a operação, o atendimento ao cliente e o cumprimento de obrigações fiscais dentro do prazo. ## Como o uptime da API fiscal é medido? A medição costuma ser feita por ferramentas de monitoramento que enviam requisições periódicas à API, muitas vezes a um endpoint de healthcheck, e registram se a resposta chegou corretamente e dentro de um tempo aceitável. O cálculo básico divide o tempo em que o serviço esteve disponível pelo tempo total do período. Alguns provedores excluem desse cálculo as janelas de manutenção programadas e comunicadas com antecedência, por isso vale verificar como cada um define a métrica. ## O uptime da API depende da SEFAZ e das prefeituras? Em parte, sim. A API fiscal é um intermediário: ela recebe o pedido do sistema do cliente e o encaminha para a SEFAZ ou para a prefeitura autorizadora. Mesmo com a API funcionando perfeitamente, uma instabilidade no órgão autorizador pode impedir a autorização do documento. Por isso, é útil separar dois conceitos: a disponibilidade da própria API, que é responsabilidade do provedor, e a disponibilidade dos autorizadores, que está fora do controle dele. Boas APIs lidam com isso usando filas, processamento assíncrono e mecanismos de contingência, como SVC e EPEC, quando previstos na legislação. ## Qual a diferença entre uptime e latência? Uptime indica se a API está disponível. Latência indica quanto tempo ela demora para responder. Uma API pode ter uptime alto e, ainda assim, responder devagar em certos momentos. As duas métricas se complementam e fazem parte da observabilidade da API fiscal. Juntas, mostram se o serviço está no ar e se está respondendo em tempo adequado para a operação do cliente. ## Como o sistema integrado pode se proteger de indisponibilidades? Mesmo com uptime elevado, nenhuma API está livre de falhas. O sistema que consome a API deve tratar erros de forma robusta, com retry e backoff exponencial, timeouts bem configurados e idempotência para evitar notas duplicadas ao reenviar uma requisição. Também é recomendável manter uma fila interna de emissão, registrar logs de integração e acompanhar o status dos documentos por webhook ou polling. Assim, uma interrupção curta não se transforma em perda de vendas ou retrabalho. ## Exemplos de Uptime da API fiscal - Um marketplace avalia provedores de API fiscal e compara o uptime mensal informado por cada um, além de verificar se as janelas de manutenção entram ou não no cálculo. - Um ERP configura um monitoramento que consulta o healthcheck da API fiscal a cada minuto e alerta a equipe técnica se houver falhas seguidas. - Durante uma instabilidade na SEFAZ de um estado, a API fiscal continua no ar, recebe as NF-e e as mantém em fila até que o autorizador volte a responder, preservando o uptime do serviço. - Uma equipe de engenharia analisa o relatório mensal e percebe que o uptime ficou alto, mas a latência aumentou nos horários de pico, e ajusta os timeouts da integração. ## Perguntas frequentes ### Uptime de 99,9% é bom para uma API fiscal? É um patamar comum em serviços críticos e representa pouco mais de 40 minutos de indisponibilidade por mês. O ideal é avaliar também como a métrica é calculada, se há manutenção excluída e como o provedor lida com falhas dos autorizadores. ### Se a SEFAZ cair, o uptime da API também cai? Não necessariamente. A API pode continuar disponível, recebendo e enfileirando documentos, enquanto o autorizador está instável. A autorização, porém, só acontece quando a SEFAZ ou a prefeitura voltam a responder ou quando há contingência aplicável. ### Manutenção programada conta como tempo fora do ar? Depende da política do provedor. Muitos excluem janelas de manutenção comunicadas com antecedência do cálculo de uptime. Por isso, é importante ler a definição da métrica antes de comparar serviços. ### Como acompanhar o uptime na prática? Use ferramentas de monitoramento externas, consulte a página de status do provedor, se houver, e registre nos logs da sua integração os erros de conexão e os tempos de resposta. ## Termos relacionados - [Healthcheck de API](https://conota.dev/glossario/healthcheck-de-api.md) - [Latência da API fiscal](https://conota.dev/glossario/latencia-da-api-fiscal.md) - [Janela de manutenção da API](https://conota.dev/glossario/janela-de-manutencao-da-api.md) - [Observabilidade da API fiscal](https://conota.dev/glossario/observabilidade-da-api-fiscal.md) - [Fallback na integração fiscal](https://conota.dev/glossario/fallback-na-integracao-fiscal.md) - [Retry na integração fiscal](https://conota.dev/glossario/retry-na-integracao-fiscal.md) --- Fonte: [Uptime da API fiscal](https://conota.dev/glossario/uptime-da-api-fiscal/) · Atualizado em 2026-10-22 --- # URL da API fiscal > URL da API fiscal é o endereço na internet usado por um sistema para se comunicar com um serviço de emissão de documentos fiscais. Ela indica onde enviar requisições para emitir, consultar ou cancelar NF-e, NFS-e, NFC-e, CT-e e MDF-e, e normalmente muda conforme o ambiente, como homologação ou produção. **Também conhecido como:** URL base da API fiscal, Endereço da API fiscal, Base URL da API fiscal, Fiscal API base URL **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que compõe a URL de uma API fiscal? Uma URL de API fiscal costuma ter algumas partes fixas. Primeiro vem o protocolo, quase sempre HTTPS, que garante que os dados trafeguem criptografados. Depois vem o domínio, que identifica o servidor do provedor da API, como em api.exemplo.com.br. Em seguida, muitas APIs incluem a versão, por exemplo /v1, para que mudanças futuras não quebrem integrações antigas. Por fim, aparece o caminho do recurso, como /nfe ou /nfse, e, quando necessário, parâmetros de consulta depois do sinal de interrogação, como ?status=autorizado. ## Qual a diferença entre URL base e endpoint? A URL base é a parte comum a todas as chamadas, como https://api.exemplo.com.br/v1. Ela funciona como o endereço do prédio. O endpoint é o caminho específico de cada operação, como o número da sala: /nfe para emitir uma nota de produto ou /nfse/{id} para consultar uma nota de serviço. Na prática, o desenvolvedor configura a URL base uma única vez e o sistema monta as chamadas juntando essa base aos endpoints. Assim, se o endereço do servidor mudar, basta alterar a configuração em um só lugar. ## Por que existem URLs diferentes para homologação e produção? A maioria das APIs fiscais oferece dois ambientes. O de homologação serve para testes: as notas emitidas ali não têm validade jurídica. O de produção é o ambiente real, onde cada documento autorizado gera efeitos fiscais e tributários. Separar os ambientes por URL, ou por credenciais distintas, evita que um teste vire uma nota verdadeira por engano. Por isso, é comum o sistema ter uma configuração que define qual URL usar, e a troca para produção só acontece depois que a integração foi validada. ## Como configurar a URL da API fiscal com segurança? O ideal é guardar a URL em uma variável de ambiente ou arquivo de configuração, e não escrevê-la diretamente no código. Isso facilita alternar entre homologação e produção sem precisar alterar e publicar o sistema novamente. Também é importante usar sempre HTTPS e nunca colocar a API Key ou outros segredos na própria URL, pois endereços costumam ficar registrados em logs e históricos. As credenciais devem ir no header de autenticação da requisição. ## Qual a diferença entre a URL da API fiscal e os endereços da SEFAZ ou da prefeitura? As SEFAZ e as prefeituras disponibilizam seus próprios endereços de web services, geralmente diferentes por estado ou município e muitas vezes baseados em SOAP e XML. Integrar diretamente com cada um exige conhecer e manter vários endereços e padrões. Uma API fiscal intermediária oferece uma URL única e padronizada, normalmente REST com JSON. O sistema do cliente fala apenas com ela, e o provedor se encarrega de encaminhar cada documento ao órgão autorizador correto e devolver o resultado. ## Exemplos de URL da API fiscal - Um ERP armazena a variável FISCAL_API_URL com o endereço de homologação durante os testes e, após validar as emissões, troca o valor para o endereço de produção. - Uma plataforma de vendas envia um POST para a URL base seguida do endpoint /nfce para emitir o cupom fiscal de uma compra no varejo. - Um software de gestão de transportadora consulta o status de um MDF-e chamando a URL base acrescida de /mdfe/{id}, onde {id} é o identificador do documento. - Uma equipe de suporte identifica que notas de teste não estavam sendo geradas porque o sistema apontava para uma URL de versão antiga da API. ## Perguntas frequentes ### Posso usar a mesma URL para testes e para emissão real? Depende do provedor. Alguns usam URLs diferentes para cada ambiente; outros usam a mesma URL e diferenciam pelo tipo de credencial. Consulte a documentação da API para saber qual regra se aplica. ### O que acontece se eu errar a URL da API fiscal? A requisição falha, geralmente com erro de conexão ou código HTTP 404, indicando recurso não encontrado. Nenhum documento é emitido. Verifique domínio, versão e caminho do endpoint. ### Onde encontro a URL da API fiscal? Ela fica na documentação técnica do provedor, frequentemente publicada em formato OpenAPI ou em uma página de referência da API, junto com a lista de endpoints disponíveis. ## Termos relacionados - [Endpoint de API](https://conota.dev/glossario/endpoint-de-api.md) - [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md) - [Ambiente de produção](https://conota.dev/glossario/ambiente-de-producao.md) - [HTTPS](https://conota.dev/glossario/https.md) - [Query parameter](https://conota.dev/glossario/query-parameter.md) - [API fiscal](https://conota.dev/glossario/api-fiscal.md) --- Fonte: [URL da API fiscal](https://conota.dev/glossario/url-da-api-fiscal/) · Atualizado em 2026-10-22 --- # Uso denegado de documento fiscal > Uso denegado de documento fiscal é a resposta da Secretaria da Fazenda (SEFAZ) que recusa a autorização de um documento eletrônico, como NF-e ou CT-e, por irregularidade cadastral do emitente ou do destinatário. Ao contrário da rejeição, a denegação fica registrada na base do fisco, consome o número do documento e impede seu uso na operação. **Também conhecido como:** Denegação de uso, Uso denegado, Nota fiscal denegada, Documento denegado, Denegação da NF-e **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que significa ter o uso de um documento fiscal denegado? Quando uma empresa envia uma nota fiscal eletrônica para a SEFAZ, o fisco pode responder de três formas principais: autorizar, rejeitar ou denegar. A denegação significa que o documento foi recebido, estava tecnicamente correto, mas o fisco se recusou a autorizar seu uso porque encontrou um problema na situação cadastral de uma das partes envolvidas. Na prática, o documento denegado não tem validade para acompanhar a mercadoria ou comprovar a prestação do serviço. Mesmo assim, ele passa a existir na base de dados da SEFAZ com o status de denegado, e essa informação fica disponível para consulta pela chave de acesso. ## Por que a SEFAZ denega um documento fiscal? O motivo mais comum é uma irregularidade na inscrição estadual do emitente, como inscrição suspensa, cancelada, baixada ou considerada inapta. Também pode haver denegação por irregularidade do destinatário ou quando o destinatário não está habilitado a operar naquela unidade da federação, conforme as regras de cada estado. Esses casos aparecem com códigos de retorno específicos na resposta da SEFAZ, como 301 (irregularidade fiscal do emitente) e 302 (irregularidade fiscal do destinatário). A mensagem de retorno indica qual das partes está com problema, o que ajuda a direcionar a correção. ## Qual a diferença entre uso denegado e rejeição? A rejeição acontece quando o documento tem algum erro de preenchimento, de estrutura do XML ou de regra de validação. Nesse caso, a nota não é registrada na SEFAZ, o número continua livre e a empresa pode corrigir o erro e reenviar usando a mesma numeração. Na denegação, o documento é registrado no fisco e a numeração é consumida definitivamente. Não é possível corrigir e reenviar com o mesmo número. Por isso, a denegação é mais séria: além de impedir a operação, ela deixa um registro permanente vinculado ao emitente. ## O que fazer quando um documento é denegado? O documento denegado não pode ser cancelado nem ter seu número inutilizado, já que ele já está registrado na SEFAZ. O XML com o retorno de denegação deve ser guardado junto com os demais documentos fiscais, pois comprova o que aconteceu com aquela numeração e costuma ser exigido na escrituração. O passo seguinte é regularizar a situação cadastral que causou o problema, geralmente junto à secretaria da fazenda do estado ou com apoio do contador. Depois de resolvida a pendência, a operação pode ser emitida novamente em um novo documento, com outro número da sequência. ## Como o uso denegado aparece em uma integração por API? Em sistemas que emitem notas por API, a denegação chega como um status final do documento, distinto de autorizado e de rejeitado. É importante que o ERP ou a plataforma de vendas trate esse status de forma própria: não tentar reenviar automaticamente, marcar a numeração como consumida e alertar o responsável pelo cadastro. Em uma infraestrutura como o Conota, o sistema do cliente recebe o status e o XML de retorno automaticamente, o que permite registrar a ocorrência, guardar o arquivo e acompanhar o caso pelo Console sem precisar consultar a SEFAZ manualmente. ## Exemplos de Uso denegado de documento fiscal - Uma distribuidora tenta emitir uma NF-e de venda, mas sua inscrição estadual foi suspensa por falta de entrega de declarações. A SEFAZ devolve o código 301 e a nota fica registrada como denegada. - Um ERP envia por API uma NF-e para um cliente cuja inscrição estadual está inapta. O retorno indica irregularidade do destinatário, e o sistema bloqueia novas emissões para esse cadastro até a verificação. - Uma transportadora recebe denegação ao emitir um CT-e e precisa regularizar sua situação no estado antes de emitir um novo conhecimento com outro número. - Na conferência mensal, o contador encontra uma lacuna na sequência de notas e verifica que o número corresponde a um documento denegado, cujo XML foi guardado como comprovação. ## Perguntas frequentes ### Posso cancelar uma nota com uso denegado? Não. O documento denegado já está registrado na SEFAZ e não admite cancelamento nem inutilização. Basta guardar o XML da denegação e emitir um novo documento, com outro número, depois de regularizar o cadastro. ### Posso reutilizar o número de uma nota denegada? Não. A denegação consome a numeração de forma definitiva. Diferente da rejeição, em que o número continua disponível, o documento denegado ocupa aquele número para sempre na base do fisco. ### Preciso guardar o XML de um documento denegado? Sim. O XML com o retorno de denegação comprova a situação daquela numeração e deve ser armazenado junto aos demais documentos fiscais, inclusive para fins de escrituração e fiscalização. ### A denegação acontece em todos os tipos de documento fiscal? Ela é típica dos documentos autorizados pelas SEFAZ estaduais, principalmente NF-e, NFC-e e CT-e. Na NFS-e, as regras dependem do município ou do padrão nacional e o tratamento pode ser diferente. ## Termos relacionados - [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) - [Cancelamento de documento fiscal](https://conota.dev/glossario/cancelamento-de-documento-fiscal.md) - [Inutilização de numeração](https://conota.dev/glossario/inutilizacao-de-numeracao.md) - [Inscrição estadual](https://conota.dev/glossario/inscricao-estadual.md) - [Bloqueio de emissão pela SEFAZ](https://conota.dev/glossario/bloqueio-de-emissao-pela-sefaz.md) --- Fonte: [Uso denegado de documento fiscal](https://conota.dev/glossario/uso-denegado-de-documento-fiscal/) · Atualizado em 2026-10-23 --- # Uso e consumo na classificação fiscal > Uso e consumo na classificação fiscal é a categoria que identifica bens comprados por uma empresa para seu próprio funcionamento, sem revenda, sem industrialização e sem integrar o ativo imobilizado. Materiais de limpeza, de escritório e de copa são exemplos. Essa classificação define CFOP, direito a crédito de impostos e eventual cobrança de diferencial de alíquota. **Também conhecido como:** Material de uso e consumo, Bens de uso e consumo, Material de uso ou consumo, Material de consumo, Goods for own use and consumption **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é material de uso e consumo? Material de uso e consumo é tudo aquilo que a empresa compra para manter a rotina, sem vender adiante e sem usar como matéria-prima de um produto. Papel, canetas, produtos de limpeza, café para a copa, lâmpadas e uniformes costumam entrar nesse grupo. O ponto central é o destino do bem dentro da empresa, e não o tipo de produto. Uma resma de papel é mercadoria para uma papelaria que a revende, mas é uso e consumo para um escritório de contabilidade que a utiliza na impressora. ## Por que essa classificação importa na nota fiscal? A forma como o bem é classificado muda o tratamento tributário da operação. Ela define o CFOP usado na escrituração, se a empresa pode aproveitar créditos de impostos e se há diferencial de alíquota de ICMS a recolher em compras de outros estados. Classificar errado pode gerar crédito indevido, que depois é glosado pela fiscalização com multa e juros, ou o contrário: a empresa deixa de aproveitar um crédito a que teria direito por ter enquadrado como consumo algo que era insumo. ## Quais CFOPs são usados para uso e consumo? Na entrada, a compra de material para uso ou consumo costuma ser registrada com o CFOP 1.556, quando o fornecedor está no mesmo estado, ou 2.556, quando está em outro estado. Quando o material está sujeito a substituição tributária, são usados os CFOPs 1.407 ou 2.407. Há também códigos para transferências entre estabelecimentos da mesma empresa, como 5.557 e 6.557 na saída, e para devolução da compra ao fornecedor, como 5.556 e 6.556. A escolha exata depende da operação e deve ser conferida com a contabilidade. ## Qual a diferença entre uso e consumo, insumo, revenda e ativo imobilizado? Mercadoria para revenda é comprada para ser vendida sem transformação. Insumo ou matéria-prima entra no processo produtivo e compõe ou é consumido na fabricação do produto. Ativo imobilizado é um bem durável usado por longo prazo, como máquinas, veículos e computadores. Uso e consumo é o que sobra: itens de baixo valor ou curta duração, ligados à manutenção geral da empresa e não diretamente à produção ou à venda. Cada categoria tem regras próprias de crédito e de escrituração. ## A empresa pode aproveitar crédito de ICMS sobre uso e consumo? Em regra, não. A legislação do ICMS prevê o crédito sobre material de uso e consumo, mas esse direito vem sendo adiado sucessivamente, de modo que, na prática, a empresa não credita o imposto pago nessas compras. Além disso, quando um contribuinte do ICMS compra material de uso e consumo de outro estado, normalmente precisa recolher o DIFAL, que é a diferença entre a alíquota interna do seu estado e a alíquota interestadual destacada na nota. As regras de quem recolhe e como variam conforme o estado. ## Como a reforma tributária afeta o uso e consumo? Com o IBS e a CBS, a proposta é de não cumulatividade ampla, permitindo crédito sobre a maior parte das aquisições ligadas à atividade da empresa. A principal exceção prevista é para bens de uso e consumo pessoal, como itens destinados a sócios ou empregados sem relação com a atividade. Isso tende a reduzir a importância da distinção entre uso e consumo e insumo para os novos tributos, mas ela continua relevante para o ICMS durante o período de transição. Sistemas emissores e ERPs precisam conviver com as duas lógicas ao mesmo tempo. ## Exemplos de Uso e consumo na classificação fiscal - Uma clínica médica compra produtos de limpeza de um distribuidor do mesmo estado e escritura a nota de entrada com CFOP 1.556, sem aproveitar crédito de ICMS. - Uma indústria de São Paulo compra uniformes de um fornecedor de outro estado para seus funcionários administrativos; a entrada é registrada com CFOP 2.556 e o setor fiscal calcula o DIFAL devido. - Um ERP integrado a uma API fiscal permite que o comprador marque cada item do pedido como revenda, insumo, imobilizado ou uso e consumo, sugerindo automaticamente o CFOP de entrada correspondente. - Uma rede de lojas transfere caixas de papel para impressora da matriz para uma filial e emite a NF-e de transferência com CFOP 5.557. ## Perguntas frequentes ### Quem decide se um item é uso e consumo? A própria empresa, com base no destino real do bem dentro do negócio. A decisão deve ser coerente e documentada, pois a fiscalização pode questionar a classificação. É recomendável validar critérios com o contador. ### O fornecedor precisa saber que a compra é para uso e consumo? Em operações interestaduais, sim, porque isso afeta o indicador de consumidor final na NF-e e a apuração do DIFAL. Em compras internas, a classificação pesa mais na escrituração de entrada do comprador. ### Empresa do Simples Nacional também classifica uso e consumo? Sim. Ela registra as entradas com o CFOP adequado e pode estar sujeita ao DIFAL em compras interestaduais, conforme a legislação do seu estado, mesmo sem aproveitar créditos de ICMS. ## Termos relacionados - [CFOP](https://conota.dev/glossario/cfop.md) - [DIFAL](https://conota.dev/glossario/difal.md) - [Aproveitamento de crédito tributário](https://conota.dev/glossario/aproveitamento-de-credito-tributario.md) - [Entrada de mercadoria](https://conota.dev/glossario/entrada-de-mercadoria.md) - [ICMS](https://conota.dev/glossario/icms.md) - [Glosa de crédito tributário](https://conota.dev/glossario/glosa-de-credito-tributario.md) --- Fonte: [Uso e consumo na classificação fiscal](https://conota.dev/glossario/uso-e-consumo-na-classificacao-fiscal/) · Atualizado em 2026-10-22 --- # Usuário autorizado na API > Usuário autorizado na API é a pessoa, sistema ou agente de inteligência artificial que recebeu credenciais e permissões para acessar uma API, como uma API fiscal, e executar ações específicas, por exemplo emitir, consultar ou cancelar notas fiscais. A autorização define o que ele pode fazer, em quais empresas e com qual nível de acesso. **Também conhecido como:** Usuário com acesso à API, Cliente autorizado da API, Credencial autorizada, Consumidor autorizado da API, Authorized API user **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que significa ser um usuário autorizado na API? Uma API é a porta pela qual um sistema conversa com outro. Para que essa porta não fique aberta a qualquer um, cada chamada precisa vir de alguém identificado e liberado. Esse alguém é o usuário autorizado. Apesar do nome, o usuário nem sempre é uma pessoa. Pode ser um ERP, uma plataforma de vendas, um script interno ou um agente de inteligência artificial. O que importa é que ele tenha uma credencial válida, como uma API Key ou um token, e permissões compatíveis com a ação que tenta executar. ## Qual a diferença entre autenticação e autorização? Autenticação responde à pergunta "quem é você?". É o momento em que a API confere a credencial enviada, normalmente em um header de autenticação, e confirma a identidade de quem está chamando. Autorização responde à pergunta "o que você pode fazer?". Mesmo um usuário autenticado pode ser impedido de cancelar uma nota ou de acessar dados de uma empresa que não é sua. Ser um usuário autorizado significa passar pelas duas etapas: estar identificado e ter permissão para aquela ação específica. ## Como funciona a autorização em uma API fiscal? Em uma API fiscal, as permissões costumam ser definidas por tipo de ação (emitir, consultar, cancelar, baixar XML), por tipo de documento (NF-e, NFS-e, NFC-e, CT-e, MDF-e) e por empresa emissora. Assim, um sistema de vendas pode emitir NFC-e de uma loja sem enxergar as notas de outra filial. Quando um usuário tenta fazer algo fora do que lhe foi liberado, a API recusa a requisição, geralmente com uma resposta de acesso negado. Isso protege dados sensíveis, como valores de vendas e informações de clientes, e evita emissões ou cancelamentos indevidos. Em plataformas que atendem vários CNPJs, a autorização também garante a segregação de dados por conta: cada usuário só acessa as empresas às quais está vinculado. ## Agentes de IA podem ser usuários autorizados? Sim. Com o MCP, um agente de inteligência artificial pode se conectar a uma infraestrutura fiscal para consultar documentos, verificar status ou executar ações. Nesse caso, o agente funciona como um usuário autorizado com permissões controladas. A boa prática é dar ao agente apenas o necessário. Um assistente que responde dúvidas sobre notas emitidas, por exemplo, pode ter acesso somente de leitura, sem poder emitir ou cancelar. Todas as ações ficam registradas para auditoria, permitindo saber o que foi feito e por quem. ## Qual a diferença para as pessoas autorizadas no XML da NF-e? São conceitos diferentes que às vezes se confundem. A NF-e possui um campo próprio no leiaute para indicar CPFs ou CNPJs autorizados a obter o XML da nota junto à SEFAZ, como o escritório de contabilidade do emitente ou uma transportadora. Já o usuário autorizado na API diz respeito ao acesso à plataforma de emissão: quem pode chamar os endpoints e o que pode fazer neles. Um contador pode constar como autorizado no XML de uma nota sem ter qualquer acesso à API da empresa, e vice-versa. ## Quais cuidados ao gerenciar usuários autorizados? O princípio mais importante é o do menor privilégio: cada usuário recebe só as permissões de que realmente precisa. Credenciais diferentes para cada sistema ou integração facilitam identificar a origem de um problema e revogar um acesso sem afetar os demais. Também é recomendável guardar as credenciais em um cofre de segredos, nunca no código-fonte, fazer rotação periódica de chaves, separar credenciais de homologação e de produção e remover imediatamente acessos de sistemas desativados ou de pessoas que deixaram a empresa. ## Exemplos de Usuário autorizado na API - Um ERP recebe uma credencial com permissão para emitir e consultar NF-e de três CNPJs do mesmo grupo, mas sem permissão para cancelar notas, tarefa reservada ao time fiscal. - Uma plataforma de agendamento de serviços é cadastrada como usuário autorizado apenas para emitir NFS-e e baixar o PDF e o XML dos documentos gerados. - Um agente de IA conectado via MCP tem acesso somente de leitura para responder ao financeiro quais notas foram rejeitadas na última semana e qual o motivo. - Após a troca de fornecedor de sistema de vendas, a empresa revoga a credencial antiga, impedindo que o sistema desativado continue chamando a API. ## Perguntas frequentes ### Um usuário autorizado precisa ser uma pessoa? Não. Na maioria das integrações, o usuário autorizado é um sistema, como um ERP ou marketplace, ou um agente de IA. O que o caracteriza é ter uma credencial válida e permissões definidas para acessar a API. ### O que acontece se um usuário tentar uma ação sem permissão? A API recusa a requisição e devolve um erro de acesso negado. Nenhuma ação é executada, e a tentativa pode ficar registrada nos logs para análise posterior. ### Posso ter vários usuários autorizados para a mesma empresa? Sim, e é recomendável. Usar credenciais separadas para cada sistema ou finalidade permite controlar permissões de forma independente, rastrear quem fez cada ação e revogar um acesso sem interromper os outros. ### Usuário autorizado na API é o mesmo que autorizado a baixar o XML da NF-e? Não. O autorizado no XML é um CPF ou CNPJ informado na própria nota para obtê-la na SEFAZ. O usuário autorizado na API é quem tem acesso à plataforma de emissão e suas funções. ## Termos relacionados - [Permissão de acesso à API](https://conota.dev/glossario/permissao-de-acesso-a-api.md) - [API Key](https://conota.dev/glossario/api-key.md) - [Token de autenticação](https://conota.dev/glossario/token-de-autenticacao.md) - [Segregação de dados por conta](https://conota.dev/glossario/segregacao-de-dados-por-conta.md) - [Trilha de auditoria fiscal](https://conota.dev/glossario/trilha-de-auditoria-fiscal.md) - [Conota MCP](https://conota.dev/glossario/conota-mcp.md) --- Fonte: [Usuário autorizado na API](https://conota.dev/glossario/usuario-autorizado-na-api/) · Atualizado em 2026-10-22 --- # UTF-8 no XML fiscal > UTF-8 no XML fiscal é o padrão de codificação de caracteres adotado nos arquivos XML de documentos fiscais eletrônicos, como NF-e, NFC-e, CT-e, MDF-e e NFS-e. Ele define como letras, acentos e símbolos são gravados em bytes, garantindo que o texto seja lido corretamente pela SEFAZ, pela prefeitura e pelos sistemas que recebem o documento. **Também conhecido como:** Codificação UTF-8 do XML, Encoding UTF-8 na NF-e, Charset UTF-8 no documento fiscal, UTF-8, UTF-8 encoding in fiscal XML **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que é UTF-8, em palavras simples? Todo arquivo de computador guarda texto como números. A codificação é a tabela que diz qual número corresponde a cada caractere. O UTF-8 é uma dessas tabelas e consegue representar praticamente qualquer caractere existente, incluindo letras acentuadas do português, como á, ç e õ. Quando um sistema grava um texto em UTF-8 e outro sistema o lê também como UTF-8, tudo aparece certo. Se um grava em uma codificação e o outro lê em outra, surgem os famosos caracteres estranhos, como "São Paulo" no lugar de "São Paulo". ## Por que o XML fiscal usa UTF-8? Os leiautes oficiais de documentos como NF-e, NFC-e, CT-e e MDF-e determinam o UTF-8 como codificação do XML. Isso cria uma linguagem comum entre o emissor, a SEFAZ, o destinatário e qualquer sistema que vá armazenar ou importar o arquivo. Na prática, o arquivo costuma começar com a declaração , que avisa a quem for ler qual tabela de caracteres foi usada. Mas não basta escrever a declaração: o conteúdo precisa realmente estar gravado em UTF-8. ## Quais problemas a codificação errada pode causar? O mais comum é a rejeição do documento. Se o XML chega com bytes que não são UTF-8 válido, o autorizador pode recusar o envio antes mesmo de analisar os dados fiscais. Outro problema envolve a assinatura digital. A assinatura é calculada sobre os bytes exatos do conteúdo. Se algum sistema converte o arquivo para outra codificação depois de assinado, os bytes mudam e a assinatura deixa de ser válida, mesmo que o texto pareça igual na tela. Também há efeitos visíveis: nomes de clientes, endereços e descrições de produtos podem aparecer corrompidos no DANFE, no DANFCE ou no sistema do destinatário que importa o XML. ## Como evitar erros de UTF-8 na integração fiscal? O ideal é que todo o caminho dos dados use UTF-8: banco de dados, aplicação, chamadas de API e gravação de arquivos. Os pontos de atenção mais frequentes são dados vindos de planilhas, sistemas legados ou cadastros antigos gravados em outras codificações. Outros cuidados úteis: não alterar o XML depois de assinado, evitar a marca BOM no início do arquivo quando o destino não a aceita, remover caracteres de controle invisíveis e escapar símbolos reservados do XML, como & e <, que devem virar & e <. Ao usar uma API fiscal que recebe os dados em JSON, como o Conota, o sistema do cliente envia texto em UTF-8 e a geração, assinatura e transmissão do XML ficam a cargo da infraestrutura de emissão, o que reduz esse tipo de falha. ## Acentos são proibidos no XML fiscal? Não necessariamente. O UTF-8 suporta acentos, e muitos documentos são autorizados normalmente com eles. Porém, alguns emissores preferem remover acentos e caracteres especiais por precaução, principalmente na NFS-e, em que regras e sistemas variam entre municípios. O ponto central é consistência: se houver acentos, eles precisam estar codificados corretamente em UTF-8 do início ao fim do processo. ## Exemplos de UTF-8 no XML fiscal - Um ERP grava o nome do cliente "Associação São José" em uma codificação antiga; ao gerar o XML da NF-e, o texto vira caracteres corrompidos e o documento é rejeitado por conteúdo inválido. - Uma plataforma de vendas assina o XML corretamente, mas um script posterior converte o arquivo para outra codificação ao salvá-lo, e a assinatura digital passa a ser considerada inválida. - Um marketplace importa XMLs de fornecedores e passa a exibir as descrições de produtos corretamente após configurar a leitura dos arquivos em UTF-8. - Um time de desenvolvimento remove caracteres de controle invisíveis copiados de uma planilha antes de enviar o payload de emissão, evitando erro de validação do XML. ## Perguntas frequentes ### Basta colocar encoding="UTF-8" na declaração do XML? Não. A declaração apenas informa a codificação. Os bytes do arquivo precisam realmente estar em UTF-8; caso contrário, o XML continua inválido e pode ser rejeitado. ### O que é BOM e por que ele causa problemas? BOM é uma marca invisível de poucos bytes que alguns editores colocam no início de arquivos UTF-8. Certos validadores e autorizadores não a esperam e podem recusar o XML por isso. ### Posso converter um XML fiscal autorizado para outra codificação? Não é recomendado. A conversão altera os bytes do arquivo e invalida a assinatura digital, comprometendo a validade jurídica do documento armazenado. ### Preciso me preocupar com UTF-8 ao usar uma API fiscal? Menos, mas ainda sim. Basta enviar os dados em UTF-8 válido, sem caracteres corrompidos. A geração e assinatura do XML ficam com a API. ## Termos relacionados - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md) - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) - [Leiaute fiscal](https://conota.dev/glossario/leiaute-fiscal.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) - [Rejeição fiscal](https://conota.dev/glossario/rejeicao-fiscal.md) --- Fonte: [UTF-8 no XML fiscal](https://conota.dev/glossario/utf-8-no-xml-fiscal/) · Atualizado em 2026-10-22 --- # UUID de documento > UUID de documento é um código identificador único, gerado por um sistema ou API fiscal, que marca cada documento fiscal desde o momento em que ele é criado. Diferente do número da nota ou da chave de acesso, ele existe antes da autorização e serve para consultar status, baixar arquivos e rastrear o documento na integração. **Também conhecido como:** ID do documento, Identificador único do documento, GUID do documento, UUID, Document UUID (Universally Unique Identifier) **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** U ## O que significa UUID? UUID é a sigla em inglês para Universally Unique Identifier, ou identificador universalmente único. Trata-se de um padrão para criar códigos de 128 bits, normalmente escritos como 32 caracteres hexadecimais (números de 0 a 9 e letras de a até f) divididos em cinco grupos separados por hífens, como 3f2a9c1e-7b4d-4e8a-9c21-5d6f0a1b2c3d. A grande vantagem do UUID é que ele pode ser gerado por qualquer sistema, sem consultar um cadastro central, com uma chance de repetição tão pequena que, na prática, é desconsiderada. Por isso ele é muito usado para identificar registros em bancos de dados e recursos em APIs. ## Para que serve o UUID de documento na emissão fiscal? Quando um sistema envia os dados de uma nota para uma API fiscal, a autorização pela SEFAZ ou pela prefeitura nem sempre acontece na hora. Em um fluxo assíncrono, a API recebe o pedido, devolve imediatamente um UUID e continua o processamento em segundo plano. A partir daí, esse código vira a referência do documento dentro da integração: é com ele que o sistema consulta o status, recebe notificações por webhook, baixa o XML e o PDF, solicita cancelamento ou investiga uma rejeição. Ele funciona como o número de protocolo de um atendimento, que acompanha o caso do início ao fim. ## Qual a diferença entre UUID, chave de acesso e número da nota? O número e a série da nota são sequenciais e controlados por cada emitente, conforme as regras fiscais. A chave de acesso da NF-e, NFC-e, CT-e e MDF-e é um código oficial de 44 dígitos que identifica o documento perante o fisco e aparece no DANFE e em consultas públicas. Na NFS-e, a identificação oficial depende do padrão adotado pelo município ou pelo Padrão Nacional. Já o UUID é um identificador técnico da plataforma de emissão. Ele não é impresso no documento auxiliar, não tem validade jurídica e não serve para consulta na SEFAZ ou na prefeitura. Sua função é organizar a comunicação entre o sistema do cliente e a API. ## Por que não usar apenas o número da nota como identificador? O número fiscal pode não ser suficiente para identificar um documento na integração. Em uma API que atende várias empresas, dois CNPJs diferentes podem ter notas com o mesmo número e série. Além disso, em alguns modelos, como certas NFS-e, o número oficial só é conhecido depois da autorização. O UUID resolve esses casos porque existe desde a criação do pedido de emissão e é único em toda a plataforma, independentemente da empresa, do tipo de documento ou da situação da nota, seja ela autorizada, rejeitada ou ainda em processamento. ## Como o sistema deve guardar e usar o UUID? A prática recomendada é salvar o UUID no banco de dados do sistema logo após o envio, vinculado ao pedido, venda ou ordem de serviço que originou a nota. Assim, qualquer consulta futura pode ser feita direto pelo identificador, sem buscas por filtros amplos. Também é útil registrar o UUID nos logs de integração, o que facilita o suporte e a auditoria. Em integrações com agentes de inteligência artificial via MCP, o UUID permite que o agente consulte ou execute ações sobre um documento específico, sem ambiguidade. ## Exemplos de UUID de documento - Um ERP envia os dados de uma NF-e para a API fiscal, recebe como resposta o UUID do documento com status em processamento e grava esse código junto ao pedido de venda. - Uma plataforma de e-commerce recebe um webhook informando que a NFC-e foi autorizada; pelo UUID contido na notificação, ela identifica a venda correspondente e libera o envio do PDF ao cliente. - O time de suporte de um software de gestão recebe a reclamação de uma nota rejeitada e localiza o problema no Console buscando pelo UUID registrado no log da integração. - Um agente de IA conectado via MCP recebe o pedido de verificar uma NFS-e e usa o UUID do documento para consultar o status e o motivo da rejeição. ## Perguntas frequentes ### O UUID de documento substitui a chave de acesso? Não. A chave de acesso é o identificador oficial reconhecido pelo fisco. O UUID é apenas um identificador técnico da plataforma de emissão, usado para comunicação entre sistemas, e não tem validade fiscal. ### O UUID muda se a nota for rejeitada e reenviada? Depende da plataforma. Em geral, cada pedido de emissão recebe seu próprio UUID. Por isso é importante consultar a documentação da API para saber se a correção e o reenvio mantêm o mesmo identificador ou geram um novo. ### UUID e chave de idempotência são a mesma coisa? Não. A chave de idempotência costuma ser criada pelo sistema do cliente para evitar emissões duplicadas em reenvios. O UUID normalmente é gerado pela API para identificar o documento já registrado. ## Termos relacionados - [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md) - [Numeração de documentos fiscais](https://conota.dev/glossario/numeracao-de-documentos-fiscais.md) - [Status de documento fiscal](https://conota.dev/glossario/status-de-documento-fiscal.md) - [Fluxo assíncrono de emissão](https://conota.dev/glossario/fluxo-assincrono-de-emissao.md) - [Idempotência na emissão fiscal](https://conota.dev/glossario/idempotencia-na-emissao-fiscal.md) - [Polling de status fiscal](https://conota.dev/glossario/polling-de-status-fiscal.md) --- Fonte: [UUID de documento](https://conota.dev/glossario/uuid-de-documento/) · Atualizado em 2026-10-22