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.