> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spedy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Histórico de mudanças da API da Spedy.

Acompanhe as mudanças da API. Versões maiores (v1, v2…) mudam apenas em
*breaking changes*; mudanças aditivas e correções de comportamento aparecem aqui,
alinhadas às nossas releases.

<Update label="06 de set, 2026" tags={["NFS-e","Webhooks","NF-e","NFC-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.
</Update>

<Update label="26 de ago, 2026" tags={["NFS-e","NF-e","NFC-e"]}>
  ## Redutores de alíquota do IBS/CBS na NFS-e

  Novos campos opcionais em `totals` 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.
</Update>

<Update label="21 de ago, 2026" tags={["Webhooks"]}>
  ## Assinatura nas notificações de webhook

  Cada notificação enviada pelo Spedy passa a incluir os headers `webhook-id`, `webhook-timestamp` e `webhook-signature`, no padrão [Standard Webhooks](https://standardwebhooks.com), 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.
</Update>

<Update label="19 de ago, 2026" tags={["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.
</Update>

<Update label="11 de ago, 2026" tags={["NF-e", "NFC-e", "NFS-e", "Webhooks"]}>
  ## 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.
</Update>

<Update label="05 de ago, 2026" tags={["docs"]}>
  ## Nova documentação da API

  Disponibilizamos um novo portal de documentação com Guias, Referência interativa e changelog da API.
</Update>

<Update label="28 de jul, 2026" tags={["NF-e", "NFC-e", "NFS-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 (grupo `autXML`) — ú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.
</Update>

<Update label="17 de jul, 2026" tags={["Vendas"]}>
  ## Modo de emissão nas recorrências

  Vendas recorrentes passaram a ter um `autoIssueMode` próprio, controlando quando a
  nota é emitida a cada ciclo — independente da configuração da venda avulsa.
</Update>

<Update label="15 de jul, 2026" tags={["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.
</Update>

<Update label="13 de jul, 2026" tags={["Empresas", "NFC-e"]}>
  ## Consulta de configurações da empresa

  Novo `GET /v1/companies/{id}/settings` para ler as configurações de emissão da
  empresa (blocos `general`, `productInvoice`, `consumerInvoice` e `serviceInvoice`).

  ## NFC-e disponível (fim do Beta)

  A emissão de NFC-e saiu do Beta e passa a ser oficialmente suportada na API.
</Update>

<Update label="09 de jul, 2026" tags={["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 pelo `eventId` retornado no registro da correção.
</Update>

<Update label="11 de jun, 2026" tags={["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.
</Update>

<Update label="20 de mai, 2026" tags={["Notas Fiscais", "Vendas"]}>
  ## Novos filtros de listagem

  * **Listar notas fiscais** passou a aceitar filtro por `integrationId`.
  * Corrigido o filtro por intervalo de datas na **listagem de vendas**.
</Update>

<Update label="15 de mai, 2026" tags={["NF-e", "NFC-e"]}>
  ## Tributos aproximados (IBPT)

  Os tributos aproximados só são calculados automaticamente quando você **não** envia
  o valor na emissão — o valor informado por você é sempre respeitado.
</Update>