NFS-eNF-e
Exigibilidade suspensa do ISSQN na NFS-e Nacional
Informe o número do processo judicial ou administrativo emnational.suspensionProcessNumber quando taxationType for suspendedByCourt ou suspendedByAdministrativeProcedure. A NFS-e emitida no Ambiente Nacional passa a declarar a suspensão da exigibilidade do ISSQN.IPI devolvido na NF-e de devolução
Na NF-e de devolução, o IPI devolvido passa a ser informado por item (ipiReturnedAmount e returnedPercent) e é somado ao valor total da nota, evitando as rejeições 610 e 863. O total de IPI devolvido é calculado pela soma dos itens.NFS-e
Intermediário na NFS-e de São Paulo/SP
O intermediário informado na emissão passa a ser enviado também na NFS-e de São Paulo/SP. Em «Cidades integradas», o novo campoprovider.options.supportsIntermediary indica se o provedor do município aceita o intermediário.NF-eNFC-eNFS-e
Eventos da nota fiscal
Consulte os eventos de uma nota fiscal emGET /v1/{product-invoices|consumer-invoices|service-invoices}/{id}/events, com tipo, data, protocolo, código e mensagem de cada evento. Baixe o XML de um evento em GET .../{id}/events/{eventId}/xml; para carta de correção e cancelamento de NF-e e NFC-e, o retorno é o procEventoNFe.Ajuste de competência do IBS/CBS (gAjusteCompet)
Adicionado o grupo de ajuste de competência do IBS/CBS no schema da NF-e (obrigatório para operações específicas, como o CST 811), permitindo o correto preenchimento do período de referência e valores de ajuste.Declaração de importação (DI) nos itens da NF-e
Informe a declaração de importação e suas adições em cada item da NF-e de entrada de importação. O IPI com CST 00 (entrada com recuperação de crédito) passa a ser enviado quando há valor de IPI.Dados de comércio exterior na NFS-e
Informe os dados de comércio exterior (moeda, valor, modo de prestação, vínculo entre as partes e demais campos) na criação da NFS-e. Os campos informados substituem os da regra fiscal da empresa, e a consulta da nota devolve esses dados.Código interno do contribuinte no provedor EL
Nas prefeituras atendidas pelo provedor EL, o código interno do contribuinte passa a ser preenchido com o código de serviço municipal (cityServiceCode) em vez do CNAE.NFS-e
Regimes especiais Profissional Autônomo e Notário ou Registrador
O regime especial de tributação da empresa passa a aceitar selfEmployedProfessional (Profissional Autônomo) e notaryOrRegistrar (Notário ou Registrador), enviados na emissão de NFS-e pelo padrão nacional.NFS-e
Regimes e método de emissão nas configurações de NFS-e por município
A consulta de configurações de emissão por município informa, em cada provedor, os regimes tributários atendidos (taxRegimes) e o método de emissão a configurar na empresa (issueType), e lista o canal alternativo do provedor quando o município tiver um. O campo appliesTo está obsoleto e será removido: use taxRegimes.NF-eNFC-eNFS-e
Reemissão de nota em processamento
Pedir a reemissão de uma nota cuja emissão ainda está em andamento agora retorna erro de validação, em vez de reenviá-la — evitando duplicidade na autoridade e que uma nota já autorizada volte para processamento.Consultas de municípios integrados sem chave de API
As consultas de municípios integrados e de exemplo de emissão por município passam a responder sem chave de API. Nova consulta de configurações de emissão por município, com os provedores de cada município, o regime a que cada um se aplica, as configurações e um exemplo de requisição.CPF da transportadora na NF-e
O campotransport.carrier.federalTaxNumber passa a aceitar CPF (11 dígitos) além de CNPJ (14 dígitos), permitindo informar transportador pessoa física. O documento é enviado no XML como CPF ou CNPJ conforme o tamanho.NF-eVendasNFS-eNFC-e
Modalidade de frete (SEFAZ) permite escolher transporte próprio
Ao informar a modalidade de frete, dois novos itens estão disponíveis: “Transporte Próprio por conta do Remetente” e “Transporte Próprio por conta do Destinatário”.NF-eNFC-eNFS-e
Consulta de inutilização e dados do cancelamento
Consulte uma inutilização de numeração pelo id emGET /v1/product-invoices/disablements/{id} e baixe o XML homologado (procInutNFe) em GET /v1/product-invoices/disablements/{id}/xml. Também disponível para NFC-e. O retorno das notas fiscais passa a incluir cancellation, com data, protocolo e justificativa do cancelamento.Exemplo de emissão de NFS-e por município
Consulte emGET /v1/service-invoices/cities/{cityCode}/payload-example um exemplo de criação de NFS-e com os códigos fiscais no formato aceito pelo município. Municípios que adotaram o Emissor Nacional para parte dos regimes devolvem um exemplo para cada ambiente.A consulta de cidades integradas passa a informar provider.code, o mesmo valor devolvido em provider no exemplo. O provider.name passa a separar corretamente siglas e versões (por exemplo, NFe Cidades e IPM v2).Códigos CNAE e de serviço municipal na consulta de cidades
A consulta de cidades integradas (GET /v1/service-invoices/cities) passa a informar em provider.options os indicadores cnaeCode e cityServiceCode, que indicam se o município envia à prefeitura o código CNAE e o código do serviço no município.Os municípios que passaram a emitir pelo Ambiente Nacional, entre eles Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Recife, Florianópolis e Vitória, passam a informar esse ambiente como provedor. Belo Horizonte e Rio de Janeiro passam a indicar todos os regimes tributários em nationalServiceInvoiceRegimes. O caminho de emissão das notas não muda.NFS-eWebhooksNF-eNFC-e
NFS-e tomadas
Consulte as NFS-e emitidas contra o CNPJ da sua empresa nos municípios conveniados ao ambiente nacional, baixe XML/DANFSe e registre a manifestação do tomador (confirmação ou rejeição com motivo). Habilitação opt-in por empresa, com busca automática, sincronização sob demanda e webhooks (inbound_invoice.detected/event). A nota chega completa: XML e DANFSe ficam disponíveis já na importação, sem depender de manifestação.NFS-e com emitente pessoa fisica no Ambiente Nacional
A emissão de NFS-e no Ambiente Nacional passa a suportar prestadores de serviço pessoa física.NFS-eNF-eNFC-e
Redutores de alíquota do IBS/CBS na NFS-e
Novos campos opcionais emtotals na emissão de NFS-e: ibsStateRedRate (redução da alíquota do IBS de competência da UF), ibsCityRedRate (redução da alíquota do IBS do município) e cbsRedRate (redução da alíquota da CBS). Nas prefeituras atendidas pelo provedor SilTecnologia, os dados de IBS/CBS passam a ser enviados no XML para a prefeitura.ICMS monofásico retido anteriormente (CST 61)
O CST 61 passa a ser aceito na emissão. Nos itens com esse CST, informe a quantidade tributada, a alíquota ad rem e o valor do ICMS retidos anteriormente em singleStageRetQuantityTax, singleStageRetAdRemRate e singleStageRetAmount.Webhooks
Assinatura nas notificações de webhook
Cada notificação enviada pelo Spedy passa a incluir os headerswebhook-id, webhook-timestamp e webhook-signature, no padrão Standard Webhooks, permitindo confirmar a origem do evento antes de processá-lo. Consulte o segredo da conta em GET /v1/webhooks/secret e rotacione-o em POST /v1/webhooks/secret/rotate; durante a janela de rotação, configurável em até 72 horas, as entregas são assinadas com o segredo novo e o anterior.O corpo das notificações permanece inalterado e a verificação é opcional — integrações existentes seguem funcionando sem alteração.NF-e
Resultado da última sincronização de notas recebidas
A consulta de status de sincronização passa a informar o resultado da última tentativa, a mensagem devolvida pela autoridade fiscal e quando ela aconteceu — inclusive quando a tentativa não teve sucesso.NF-eNFC-eNFS-eWebhooks
Notas recebidas (NF-e)
Consulte as NF-e emitidas contra o CNPJ da sua empresa, baixe XML/DANFE e registre a manifestação do destinatário (ciência, confirmação, desconhecimento, operação não realizada). Habilitação opt-in por empresa, com busca automática, sincronização sob demanda e webhooks (inbound_invoice.detected/completed/event).Pré-visualização de PDF antes da emissão
Crie a nota como rascunho (sem emitir) e gere um PDF de pré-visualização — mesmo layout do definitivo, marcado claramente como sem valor fiscal, com número e chave fictícios. Não consome numeração nem transmite à SEFAZ/prefeitura. Disponível para NF-e, NFC-e e NFS-e.Devolução: origem referenciada por item (DFeReferenciado)
Na emissão de NF-e de devolução pela API, cada item passa a exigir a chave de acesso e o número do item do documento de origem (grupo DFeReferenciado); o referenciamento no nível da nota (referencedDocuments) deixa de ser aceito para devolução. Exigência da NT 2025.002-RTC (Reforma Tributária) — homologação a partir de 01/07/2026, produção a partir de 01/09/2026.docs
Nova documentação da API
Disponibilizamos um novo portal de documentação com Guias, Referência interativa e changelog da API.NF-eNFC-eNFS-e
Pessoas autorizadas (autXML)
Na emissão de NF-e e NFC-e agora é possível informar os CPFs/CNPJs autorizados a acessar o XML da nota na SEFAZ (grupoautXML) — útil para liberar contadores e
parceiros.Intermediário da transação
A emissão de NF-e, NFC-e e NFS-e (Ambiente Nacional) passou a aceitar os dados do intermediário (marketplace/plataforma) da operação.Vendas
Modo de emissão nas recorrências
Vendas recorrentes passaram a ter umautoIssueMode próprio, controlando quando a
nota é emitida a cada ciclo — independente da configuração da venda avulsa.Empresas
Responsável técnico configurável
Agora dá para configurar o responsável técnico (infRespTec da NF-e/NFC-e) nas
configurações da empresa via API, sem depender do padrão da Spedy.EmpresasNFC-e
NF-e
PDF e XML da carta de correção
Novos endpoints para baixar o PDF e o XML de uma carta de correção (CC-e) de NF-e, identificados peloeventId retornado no registro da correção.Vendas
Transporte na criação de vendas
A criação de venda via API passou a aceitar a transportadora e os dados de transporte, que fluem para a nota emitida.Notas FiscaisVendas
Novos filtros de listagem
- Listar notas fiscais passou a aceitar filtro por
integrationId. - Corrigido o filtro por intervalo de datas na listagem de vendas.