API REST Nota Fiscal Eletrônica
Documentação: http://developer.ophos.com.br/?url=/api/nfe.json0.2.0 – Julho de 2025
Atualização do Schema de Emissão da NF-e – Adequações à Reforma Tributária (NT2025.002 v1.10) Em conformidade com a especificação técnica NT2025.002 – v1.10 – publicada pela Sefaz, foram realizados ajustes no schema de emissão da NF-e visando atender às exigências da nova reforma tributária. Ressaltamos que a reforma ainda está em fase de discussão, portanto, os leiautes podem sofrer alterações ao longo da implementação.- Alterações no schema JSON - URI /emissao
- tipoNotaDebito, tipoNotaDebito: campo adicionado para identificar o tipo de débito ou crédito,conforme a finalidade de emissão.
- finalidadeEmissao: novo tipo incluído – NOTA_CREDITO e NOTA_DEBITO;
- nrIbgeMunicipioFatoGeradorIbsCbs: código IBGE do município do fato gerador do IBS/CBS.
- agropecuario: grupo de informações agropecuárias (ex.: GTA, receituário de agrotóxicos)
- compraGoverno: grupo específico para operações com administração pública.
- chavesAntecipacaoPgto: grupo para referência a documentos de antecipação de pagamento.
- itens/bemMovelUsado: indicador de fornecimento de bem móvel usado, aplicável apenas a aquisições de pessoa física não contribuinte ou MEI
- itens/valorTotal: novo campo que representa o valor total do item, incluindo valor do produto, frete,seguro, descontos e tributos.
- itens/creditoPresumido/valorSuspensivo: campo adicionado para representar o valor suspensivo no crédito presumido.
- itens/refDfe: grupo para referência a notas fiscais de antecipação de pagamento.
- itens/tributos: nova estrutura que contempla os tributos IBS, CBS, Tributação Regular e Crédito Presumido
- itens/impostoSeletivo: nova estrutura para detalhamento do Imposto Seletivo (IS).
- totais/valorImpostoSeletivo: valor total do Imposto Seletivo.
- totais/ibsCbs: totais relacionados aos tributos IBS/CBS/Monofásico.
- totais/valorTotal: valor total da nota fiscal, incluindo IBS, CBS e IS.
Estrutura raiz
Estrutura itens
Totais da NF-e
- Prazos de implantação
- Homologação: A partir de 07/07/2025, a Sefaz passará a aceitar documentos com o novo leiaute em ambiente de homologação. A validação obrigatória dos novos campos será aplicada somente a partir de 06/10/2025. Após essa data, documentos fora do novo padrão serão rejeitados.
- Produção: a partir de 01/01/2026, o novo leiaute passa a ser exigido em ambiente de produção. A ausência dos novos campos implicará na rejeição de todos os documentos.
- Modelo JSON
A seguir, apresentamos um exemplo de estrutura JSON que representa o grupo impostos no nível de itens/produtos, incorporando os novos campos introduzidos conforme a NT2025.002:
{ "tributos": { "situacaoTributaria": "INTEGRAL", "classificacaoTributaria": "000000", "ibsCbs": { "baseCalculo": 0, "uf": {}, "municipal": {}, "federal": {}, "tributacaoRegular": {}, "creditoPresumidoIBS": [] }, "monofasica": {}, "transferencia": {}, "creditoPresumidoZFM": {} }, "impostoSeletivo": { "situacaoTributaria": "INTEGRAL", "classificacaoTributaria": "000000", "baseCalculo": 0, "aliquota": 0, "aliquotaPorValor": 0, "unidadeTributavel": "XX", "quantidadeTributavel": 0, "valor": 0 } }
Estrutura Totais:
{ "totais": { "ibsCbs": { "baseCalculo": 0.0, "ibs": { "diferimentoUf": 0, "devolucaoUf": 0, "valorIbsUf": 0, "diferimentoMunicipal": 0, "devolucaoMunicipal": 0, "valorIbsMunicipal": 0, "valorIbs": 0, "valorCredPresumido": 0 }, "cbs": { "diferimento": 0, "devolucao": 0, "valorCbs": 0, "valorCredPresumido": 0 }, "monofasica": {} } } } - Links úteis
- Tabela de CST e Classificações Tributárias: https://dfe-portal.svrs.rs.gov.br/DFE/TabelaClassificacaoTributaria
0.1.0 – Agosto de 2024
Publicação da documentação no formato OpenAPI