--- title: "Receita Federal - Nfe" method: POST path: "/br/receita-federal/nfe" tags: ["Receita Federal - RF"] --- # Receita Federal - Nfe `POST /br/receita-federal/nfe` ## Request - Base URL: `https://api.exato.digital` - URL: `https://api.exato.digital/br/receita-federal/nfe` - Auth: API key in header `token` Receita Federal - Nfe ## Query parameters - `test_mode` boolean - `lightweight` boolean ## Request body `application/x-www-form-urlencoded` - object - `chave_acesso` string, required: A chave de acesso usada para acessar a consulta ## Response `200` Success - ReceitaFederalNfeResponse: ReceitaFederalNfeResponse - `ApiResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInput' | 'DataUnavailable' | 'NotFound' | 'InvalidParameters' | 'UnsupportedCombination' | 'RemoteUnavailable' | 'Timeout' | 'RetryLimitReached' | 'RemoteError' | 'InProgress' | 'InsufficientCredits' | 'ConcurrentLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'Created' | 'Updated' | 'Deleted' | 'InternalError' | 'ValidationFailed' | 'Conflict' | 'ResourceLocked' | 'PendingApproval' | 'Approved' | 'Rejected' | 'Cancelled' | 'Paused' | 'Resumed': Novo tipo de resultado unificado para queries e operações administrativas. Substitui TransactionResultType com melhor semântica. - `BalanceInBrl` number, double: Saldo atual em BRL. - `BalanceInCredits` integer: Saldo atual em créditos. - `DataSourceCategory` string: Categoria da fonte de dados - `Date` string, date-time: Data da transação. - `ElapsedTimeInMilliseconds` integer: Tempo de execução (em milisegundos). - `ExecutedDataSourceName` string: Nome de exibição do tipo de consulta que realmente executou. - `ExecutedDataSourceTypeId` integer: Id do tipo de consulta que realmente executou (o gravado na transação), que pode diferir do tipo pedido quando a rota é genérica por UF ou quando um master delega a uma sub-consulta. - `HasOriginalFiles` boolean: Indica que a transação carrega arquivos originais da fonte (a certidão emitida, por exemplo) para download em OriginalFilesUrl. Falso não significa que a URL não exista: ela é montada sempre. - `HasPdf` boolean: Indica que existe PDF de comprovante do resultado. - `Message` string: Mensagem. - `OriginalFilesUrl` string: Url para download dos arquivos originais da transação (quando disponíveis). - `OutdatedResult` boolean: Indica que o resultado é datado. - `PdfUrl` string: Url para download do arquivo de comprovante em PDF da transação (quando disponível). - `ResultSubtype` string: Subtipo específico do resultado para fornecer contexto adicional (ex: 'duplicate_name', 'invalid_cpf'). - `ResultTypeCode` integer: Código numérico do resultado (compatível com TransactionResultTypeCode mas extensível). - `TotalCost` number, double: Internal use only. - `TotalCostInCredits` integer: Custo total da transação em créditos. - `TransactionResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInputData' | 'UnavailableData' | 'EntityNotFound' | 'InvalidParameters' | 'ParametersNotSupported' | 'RemoteSystemUnavailable' | 'Timeout' | 'AttemptsLimitReached' | 'RemoteSystemError' | 'AsyncExecutionInProgress' | 'AwaitingExecution' | 'BirthDateRequired' | 'InsufficientBalance' | 'SimultaneousTransactionsLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'InternalError':
TransactionResultType CodeTransactionResultTypeDefinitivoFaturavelErro
1SucessoVerdadeiroVerdadeiroFalso
2Sucesso parcial ou com observaçõesVerdadeiroVerdadeiroFalso
3Entrada ou documento inválidoVerdadeiroFalsoVerdadeiro
4Dados não disponíveisVerdadeiro (no dia)FalsoFalso
5Entidade ou documento inexistente/não encontradoVerdadeiroVerdadeiroFalso
6Parâmetros de entrada inválidosVerdadeiroFalsoVerdadeiro
7Combinação de parâmetros não suportadosVerdadeiroFalsoVerdadeiro
8Fonte de dados ou sistema remoto indisponívelFalsoFalsoVerdadeiro
9Limite de tempo esgotadoFalsoFalsoVerdadeiro
10Limite de tentativas atingidoFalsoFalsoVerdadeiro
11Erro na fonte de dados ou sistema remotoFalsoFalsoVerdadeiro
12Transação em execuçãoFalsoFalsoFalso
101Saldo em créditos insuficiente, entre em contatoFalsoFalsoVerdadeiro
102Limite de transações simultâneas atingido, entre em contatoFalsoFalsoVerdadeiro
103Transação não disponível, entre em contatoFalsoFalsoVerdadeiro
104Credenciais inválidas ou acesso negado, entre em contatoFalsoFalsoVerdadeiro
105Transação cancelada, entre em contatoFalsoFalsoVerdadeiro
255*Erro interno não esperado, entre em contatoVerdadeiro (no dia)FalsoVerdadeiro
* Consulta em manutenção, tente refazer mais tarde ou entre em contato com a Exato para notificação do problema
- `TransactionResultTypeCode` integer: Código do tipo de resultado da transação. - `UniqueIdentifier` string: Identificador único da transação. Recomendado armazenar para controle e depuração. - `Result` ReceitaFederalNfeResult: ReceitaFederalNfeResult - `ChaveAcesso` string - `Numero` integer - `Versao` string - `NFe` NFe: NFe - `Modelo` string - `Serie` integer - `Numero` integer - `DataEmissao` string, date-time - `DataHoraSaidaEntrada` string, date-time - `ValorTotalNotaFiscal` number, double - `EmitenteCNPJ` string - `EmitenteNomeRazao` string - `EmitenteInscricaoEstadual` string - `EmitenteUF` string - `DestinatarioCPFCNPJ` string - `DestinatarioNomeRazao` string - `DestinatarioInscricaoEstadual` string - `DestinatarioUF` string - `DestinatarioDestinoOperacao` string - `DestinatarioConsumidorFinal` string - `DestinatarioPresencaComprador` string - `EmissaoProcesso` string - `EmissaoProcessoVersao` string - `EmissaoTipo` string - `EmissaoFinalidade` string - `EmissaoNaturezaOperacao` string - `EmissaoTipoOperacao` string - `EmissaoFormaPagamento` string - `EmissaoDigest` string - `SituacaoAtual` string - `SituacaoOcorrencias` Situacao[] - `EventosNFe` string - `Protocolo` string - `DataAutorizacao` string - `DataRecebimentoAn` string - `Emitente` Emitente: Emitente - `NomeRazao` string - `NomeFantasia` string - `CNPJ` string - `InscricaoEstadual` string - `Endereco` string - `BairroDistrito` string - `FoneFax` string - `CEP` string - `Municipio` string - `UF` string - `Pais` string - `Destinatario` Destinatario: Destinatario - `NomeRazao` string - `NomeFantasia` string - `CNPJ` string - `CPF` string - `InscricaoEstadual` string - `Endereco` string - `BairroDistrito` string - `FoneFax` string - `CEP` string - `Municipio` string - `UF` string - `Pais` string - `ProdutosServicos` ProdutoServico[] - `ResumoNum` integer - `ResumoDescricao` string - `ResumoQtd` number, double - `ResumoUnidadeComercial` string - `ResumoValor` number, double - `CodigoProduto` string - `CodigoNCM` integer - `CodigoCEST` integer - `IndicadorEscalaRelevante` string - `CNPJFabricanteMercadoria` integer - `CodigoBenefícioFiscalUF` string - `CodigoEXTIPI` integer - `CFOP` integer - `OutrasDespesasAcessórias` string - `ValorDesconto` number, double - `ValorTotalFrete` number, double - `ValorSeguro` number, double - `IndicadorComposicaoValorTotal` string - `CodigoEANComercial` string - `UnidadeComercial` string - `QuantidadeComercial` number, double - `CodigoEANTributavel` string - `UnidadeTributavel` string - `QuantidadeTributavel` number, double - `ValorUnitarioComercializacao` number, double - `ValorUnitarioTributacao` number, double - `NumeroPedidoCompra` string - `ItemPedidoCompra` string - `ValorAproximadoTributos` string - `NumeroFCI` string - `ICMSNormalST` ICMSNormalST: ICMSNormalST - `OrigemMercadoria` string - `TributacaoICMS` string - `ModalidadeDefinicaoBCICMSNormal` string - `BaseCalculoICMSNormal` number, double - `AliquotaICMSNormal` number, double - `ValorICMSNormal` number, double - `PercentualFundoCombatePobrezaFCP` number, double - `ValorFundoCombatePobrezaFCP` number, double - `ICMSUFDestino` ICMSUFDestino: ICMSUFDestino - `ValorBCICMSUFDestino` number, double - `ValorBCFCPUFdestino` number, double - `PercentualICMSFCPUFDestino` number, double - `AliquotaInternaUFDestino` number, double - `AliquotaInterestadualUFs` number, double - `PercentualProvisorioPartilha` number, double - `ValorICMSFCP` number, double - `ValorICMSInterestadualUFDestino` number, double - `ValorICMSInterestadualUFRemetente` number, double - `ImpostoProdutoIndustrializado` ImpostoProdutoIndustrializado: ImpostoProdutoIndustrializado - `ClasseEnquadramento` string - `CodigoEnquadramento` string - `CodigoSelo` string - `CNPJProdutor` string - `QtdSelo` string - `CST` string - `QtdTotalUnidadePadrao` string - `ValorUnidade` string - `ValorIPI` string - `BaseCalculo` string - `Aliquota` string - `PIS` PIS: PIS - `CST` string - `BaseCalculo` number, double - `Aliquota` number, double - `Valor` number, double - `QuantidadeVendida` number, double - `COFINS` COFINS: COFINS - `CST` string - `BaseCalculo` number, double - `Aliquota` number, double - `Valor` number, double - `QuantidadeVendida` number, double - `InformacoesAdicionaisProduto` string - `Totais` Totais: Totais - `ValorPrestacaoServico` string - `ValorReceber` string - `ComponentesValorPrestacaoServico` ComponenteValorPrestacaoServico[] - `Nome` string - `Valor` string - `CST` string - `PercentualReducaoBC` string - `ValorCredito` string - `BaseCalculoICMS` string - `AliquotaICMS` string - `ValorICMS` string - `Transporte` Transporte: Transporte - `ModalidadeFrete` string - `Transportador` Transportador: Transportador - `CNPJ` string - `RazaoSocialNome` string - `InscricaoEstadual` string - `EnderecoCompleto` string - `Municipio` string - `UF` string - `Veiculo` Veiculo: Veiculo - `Placa` string - `UF` string - `RNTC` string - `Volumes` Volume[] - `Numero` integer - `Quantidade` string - `Especie` string - `MarcaVolumes` string - `Numeracao` string - `PesoLiquido` string - `PesoBruto` string - `Cobranca` Cobranca: Cobranca - `Fatura` Fatura: Fatura - `Numero` string - `ValorOriginal` number, double - `ValorDesconto` number, double - `ValorLiquido` number, double - `Duplicatas` Duplicata[] - `Numero` string - `Vencimento` string, date-time - `Valor` number, double - `InformacoesAdicionais` InformacoesAdicionais: InformacoesAdicionais - `InteresseFiscoDescricao` string - `InteresseContribuinteDescricao` string - `NfeCompleta` boolean - `Resumida` NfeResumida: NfeResumida - `Nfe` Nfe: Nfe - `NaturezaOperacao` string - `TipoOperacao` string - `ChaveAcesso` string - `Modelo` string - `Serie` string - `Numero` string - `DataEmissao` string - `NormalizadoChaveAcesso` string - `Emitente` Emitente: Emitente - `NomeRazao` string - `NomeFantasia` string - `CNPJ` string - `InscricaoEstadual` string - `Endereco` string - `BairroDistrito` string - `FoneFax` string - `CEP` string - `Municipio` string - `UF` string - `Pais` string - `Destinatario` Destinatario: Destinatario - `NomeRazao` string - `NomeFantasia` string - `CNPJ` string - `CPF` string - `InscricaoEstadual` string - `Endereco` string - `BairroDistrito` string - `FoneFax` string - `CEP` string - `Municipio` string - `UF` string - `Pais` string - `Produtos` Produto[] - `Num` string - `Descricao` string - `Quantidade` string - `UnidadeComercial` string - `ValorUnidade` string - `ValorProduto` string - `EventosServicos` EventoServico[] - `Evento` string - `Protocolo` string - `DataAutorizacao` string - `DataInclusao` string - `Digest` string --- [API](https://skmtc.dev/exato/apis/backend-apis.md) - [All operations](https://skmtc.dev/exato/apis/backend-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/exato/apis/backend-apis/revisions/c25e99bad8a4?raw)