{"id":2161,"date":"2025-07-10T19:32:38","date_gmt":"2025-07-10T19:32:38","guid":{"rendered":"https:\/\/www.ophos.com.br\/suporte\/?post_type=ht_kb&p=2161"},"modified":"2025-12-30T12:51:18","modified_gmt":"2025-12-30T12:51:18","slug":"historico-de-alteracoes-da-api-ophos-nf-e","status":"publish","type":"ht_kb","link":"https:\/\/www.ophos.com.br\/suporte\/knowledge-base\/historico-de-alteracoes-da-api-ophos-nf-e\/","title":{"rendered":"Hist\u00f3rico de altera\u00e7\u00f5es da API OPHOS NF-e"},"content":{"rendered":"\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t\t
API REST Nota Fiscal Eletr\u00f4nica<\/h5>

Documenta\u00e7\u00e3o: http:\/\/developer.ophos.com.br\/?url=\/api\/nfe.json<\/a><\/p>

0.2.5 \u2013 Dezembro 2025<\/strong><\/h6>

Adequa\u00e7\u00f5es \u00e0 Reforma Tribut\u00e1ria<\/strong><\/em><\/p>

Estrutura Raiz:<\/strong><\/p>

  • finalidadeEmissao:<\/strong><\/em> Inclu\u00eddas as op\u00e7\u00f5es DEVOLUCAO<\/strong>, NOTA_CREDITO<\/strong>, NOTA_DEBITO<\/strong><\/li><\/ul>
    0.2.4 \u2013 Novembro 2025<\/strong><\/h6>

    Adequa\u00e7\u00f5es \u00e0 Reforma Tribut\u00e1ria<\/em><\/strong><\/p>

    Foram implementadas adequa\u00e7\u00f5es no schema de emiss\u00e3o da NF-e para alinhamento \u00e0 Reforma Tribut\u00e1ria (IBS\/CBS).<\/p>

    \u26a0\ufe0f Observa\u00e7\u00e3o: A Reforma Tribut\u00e1ria ainda est\u00e1 em fase de regulamenta\u00e7\u00e3o. Portanto, os leiautes e campos descritos abaixo poder\u00e3o sofrer ajustes nas pr\u00f3ximas vers\u00f5es.<\/em><\/strong><\/p>

    Altera\u00e7\u00f5es no Schema JSON \u2013 Endpoint \/emissao<\/p>

    Estrutura Raiz:<\/strong><\/p>

    • dataPrevistaEntrega:<\/strong> a formata\u00e7\u00e3o do campo foi alterada para AAAA-MM-DD<\/li><\/ul>

      Estrutura CreditoPresumido<\/strong>:<\/p>

      • Altera\u00e7\u00e3o do nome dos atributos: creditoPresumidoIBS -> creditoIbs <\/em><\/strong>e creditoPresumidoCBS -> creditoCbs<\/em><\/strong><\/li><\/ul>

        Estrutura CreditoPresumidoZFM:<\/strong><\/p>

        • Adicionados os campos ano e m\u00eas de apura\u00e7\u00e3o<\/li><\/ul>

          Estrutura Tributos:<\/strong><\/p>

          • Incluida as situa\u00e7\u00f5es tribut\u00e1rias: 515 – DIFERIMENTO_COM_REDUCAO<\/strong>, 810 – AJUSTE_ZFM<\/strong> e 811 – AJUSTES, 830 – EXCLUSAO_BC<\/strong><\/li><\/ul>
            0.2.3 \u2013 Outubro 2025<\/h6>

            Adequa\u00e7\u00f5es \u00e0 Reforma Tribut\u00e1ria \u2013 NT 2025.002 v1.30<\/strong><\/p>

            Em conformidade com a Nota T\u00e9cnica 2025.002 \u2013 vers\u00e3o 1.30<\/em>, publicada pela SEFAZ em 07\/10\/2025<\/strong>, foram implementadas adequa\u00e7\u00f5es no schema de emiss\u00e3o da NF-e<\/strong> para alinhamento \u00e0s novas regras tribut\u00e1rias previstas na Reforma Tribut\u00e1ria (IBS\/CBS)<\/strong>.<\/p>

            \u26a0\ufe0f Observa\u00e7\u00e3o: A Reforma Tribut\u00e1ria ainda est\u00e1 em fase de regulamenta\u00e7\u00e3o. Portanto, os leiautes e campos descritos abaixo poder\u00e3o sofrer ajustes nas pr\u00f3ximas vers\u00f5es.<\/em><\/strong><\/p>

            Altera\u00e7\u00f5es no Schema JSON \u2013 Endpoint \/emissao<\/strong><\/p>

            Estrutura Raiz<\/strong><\/p>

            • dataPrevistaEntrega<\/strong>: campo inclu\u00eddo \u2013 indica a data prevista para entrega ou disponibiliza\u00e7\u00e3o do bem.<\/li>
            • tipoNotaDebito<\/strong> e tipoNotaCredito<\/strong>: novas op\u00e7\u00f5es inclu\u00eddas para identifica\u00e7\u00e3o de tipos espec\u00edficos de nota de d\u00e9bito e cr\u00e9dito.<\/li><\/ul>

              Estrutura Item<\/strong><\/p>

              • tipoCreditoPresumidoZFM<\/strong>: campo inclu\u00eddo \u2013 informa o tipo de cr\u00e9dito presumido aplic\u00e1vel \u00e0 Zona Franca de Manaus (ZFM).<\/li><\/ul>

                Estrutura CreditoPresumido<\/strong><\/p>

                • valorSuspensivo<\/strong>: campo removido.<\/li>
                • valor<\/strong>: campo tornado obrigat\u00f3rio.<\/li><\/ul>

                  Estrutura Tributos<\/strong><\/p>

                  • doacao<\/strong>: campo inclu\u00eddo \u2013 identifica opera\u00e7\u00f5es classificadas como doa\u00e7\u00e3o.<\/li>
                  • ajusteCompetencia<\/strong>: estrutura inclu\u00edda, de preenchimento condicionado conforme indicador na tabela de classifica\u00e7\u00e3o do IBS\/CBS.<\/li>
                  • estornoCredito<\/strong>: estrutura inclu\u00edda, de preenchimento condicionado conforme indicador na tabela de classifica\u00e7\u00e3o do IBS\/CBS.<\/li>
                  • creditoPresumido<\/strong>: nova estrutura inclu\u00edda, consolidando o cr\u00e9dito presumido de IBS e CBS (substitui a estrutura anterior removida da classe IBSCBS).<\/li><\/ul>

                    Estrutura IBSCBS<\/strong><\/p>

                    • valorTotalIbs<\/strong>: campo inclu\u00eddo \u2013 totaliza o valor do IBS (somat\u00f3rio Municipal + Estadual).<\/li>
                    • compraGovernamental<\/strong>: estrutura inclu\u00edda \u2013 detalha a composi\u00e7\u00e3o do IBS e CBS em opera\u00e7\u00f5es de compras governamentais.<\/li>
                    • creditoPresumidoIBS<\/strong> e creditoPresumidoCBS<\/strong>: campos removidos (substitu\u00eddos pelo novo campo creditoPresumido<\/strong> da estrutura Tributos).<\/li><\/ul>

                      Estrutura Totais<\/strong><\/p>

                      • estorno<\/strong>: estrutura inclu\u00edda \u2013 consolida os totais de estorno de IBS e CBS.<\/li><\/ul>
                        0.2.2 – Setembro 2025<\/span><\/h6>

                        Disponibilizamos na API o m\u00e9todo para inutiliza\u00e7\u00e3o de numera\u00e7\u00e3o de NF-e.<\/strong>Esse recurso permite inutilizar um n\u00famero espec\u00edfico<\/strong> ou uma faixa de numera\u00e7\u00e3o<\/strong> junto \u00e0 Sefaz.<\/p>

                        • Regras de uso:<\/strong> somente n\u00fameros n\u00e3o autorizados<\/strong> ou j\u00e1 cancelados<\/strong> podem ser inutilizados.<\/p><\/li>

                        • Comportamento da Sefaz:<\/strong> caso seja enviado posteriormente um documento para autoriza\u00e7\u00e3o utilizando um n\u00famero previamente inutilizado, a Sefaz ir\u00e1 sobrescrever a inutiliza\u00e7\u00e3o<\/strong> e autorizar o documento normalmente<\/strong>.<\/p><\/li><\/ul>

                          0.2.1 – Agosto 2025<\/strong><\/h6>

                          Disponibilizamos na API, os recursos necess\u00e1rios para a averba\u00e7\u00e3o da Nota Fiscal Eletr\u00f4nica (NF-e) junto \u00e0s seguradoras. Foram integrados os principais provedores utilizados no mercado, incluindo ATM, Porto Seguro, ELT e SmartLoad. Para utilizar, verifique junto \u00e0 seguradora qual provedor est\u00e1 homologado e configure os par\u00e2metros, como usu\u00e1rio e senha, no cadastro da empresa no sistema Ophos.<\/p>

                          0.2.0 \u2013 Julho de 2025<\/h6>

                          Atualiza\u00e7\u00e3o do Schema de Emiss\u00e3o da NF-e \u2013 Adequa\u00e7\u00f5es \u00e0 Reforma Tribut\u00e1ria (NT2025.002 v1.10)<\/strong><\/p>

                          Em conformidade com a especifica\u00e7\u00e3o t\u00e9cnica NT2025.002 \u2013 v1.10 \u2013 publicada pela Sefaz, foram realizados ajustes no schema de emiss\u00e3o da NF-e visando atender \u00e0s exig\u00eancias da nova reforma tribut\u00e1ria. Ressaltamos que a reforma ainda est\u00e1 em fase de discuss\u00e3o, portanto, os leiautes podem sofrer altera\u00e7\u00f5es ao longo da implementa\u00e7\u00e3o.<\/p>\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t

                          \n\t\t\t\t\t\t
                          \n\t\t\t\t\t\t\t
                          \n\t\t\t\t\t
                          \n\t\t\t
                          \n\t\t\t\t\t\t\t
                          \n\t\t\t\t\t\t
                          \n\t\t\t\t
                          \n\t\t\t