NFe - Carta de Correção Eletrônica (CCe).
Registra um Evento de Carta de Correção Eletrônica (CCe) para uma NFe autorizada. Permite corrigir informações acessórias do documento fiscal perante a SEFAZ.
⚠️ RESTRIÇÃO: A CCe é suportada exclusivamente para NFe (modelo 55). Não é aplicável para NFC-e.
❌ VEDAÇÕES LEGAIS: Não é permitido utilizar a CCe para corrigir: dados que impliquem mudança no remetente ou destinatário, data de emissão, data de saída, valor total da NFe, base de cálculo, alíquotas e quantidades de mercadorias.
🔢 SEQUÊNCIA: Cada CCe possui um número de sequência gerado automaticamente. Podem ser emitidas múltiplas CCes para a mesma NFe, sendo que a mais recente prevalece sobre as anteriores para os campos corrigidos.
🧪 TESTE: Em ambiente de homologação, a CCe é transmitida para os servidores de teste da SEFAZ, permitindo validar a estrutura e o conteúdo da correção.
post
Path Parameters
filtrostringrequired
Chave de acesso da NFe (44 dígitos) ou Código ERP.
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Body
Body
Dados para emissão da carta de correção.
EmitirCartaDeCorrecaoInputModel
Dados para emissão de carta de correção de nota fiscal (NF-e).
* Additional properties are NOT allowed.
descricaoCorrecaostringrequired
Descrição da correção. (Mínimo de 15 e máximo de 1000 caracteres)
>= 15 characters<= 1000 characters
Response
Response
No Content
post/api/v1/Nfe/{filtro}/CartaCorrecao/Enviar
Authentication
Path Parameters
Headers
Body
{
"descricaoCorrecao": "descricaoCorrecao"
}
CCe - Listagem de cartas de correção eletrônicas.
Retorna uma lista paginada de cartas de correção eletrônicas (CCe) associadas às NFes do emissor autenticado.
É possível filtrar por busca genérica (CNPJ, nome do destinatário, chave de acesso ou código ERP), por status da CCe e por intervalo de data do evento.
Os registros são ordenados por data de emissão em ordem decrescente (mais recente primeiro).
get
Query Parameters
buscastring
Campo de busca genérico: CNPJ e Nome do destinatário, Chave de acesso da NFe (44 dígitos) ou Código ERP.
statusstring
Status da carta de correção eletrônica (CC-e).
Allowed values:PendenteAutorizadaRejeitadaSubstituida
dataEventoCartaCorrecaoInicialstring(date-time)
Data inicial do intervalo do evento da CCe.
dataEventoCartaCorrecaoFinalstring(date-time)
Data final do intervalo do evento da CCe.
offsetinteger(int32)
Paginação da listagem - offset (padrão 1).
Default:1
limitinteger(int32)
Paginação da listagem - limit (padrão 10, máximo 100).
Default:10
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Response
Response
OK
ListarCartasCorrecaoViewModelListPaginationResponse
* Additional properties are NOT allowed.
offsetinteger(int32)
limitinteger(int32)
totalinteger(int32)
dataarray | null[object]
Dados de listagem de cartas de correção eletrônicas (CC-e).
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1/Nfe/CartaCorrecao/Listar
Authentication
Query Parameters
Headers
CCe - Obter XML.
Obter o XML de uma Carta de Correção Eletrônica (CCe) previamente emitida.
get
Path Parameters
filtrostringrequired
Chave de acesso da NFe (44 dígitos) ou Código ERP.
sequenciainteger(int32)required
Número de sequência da carta de correção.
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Response
Response
OK
string
get/api/v1/Nfe/{filtro}/CartaCorrecao/{sequencia}/ObterXml
Authentication
Path Parameters
Headers
Nfce
Controlador de Notas Fiscais de Consumidor Eletrônicas (NFCe) da Stone Tax API.
Centraliza os recursos destinados à emissão, cancelamento e gestão de notas fiscais de consumidor (NFCe).
Fornece abstrações para simplificar a complexidade de comunicação com as Secretarias da Fazenda (SEFAZ).
Através desta controller, é possível gerenciar todo o ciclo de vida de um documento fiscal: desde a emissão até a obtenção de artefatos finais como o XML e o DANFE.
Operações de escrita (emissão/cancelamento) exigem assinatura digital e observância ao contexto do
Emissor configurado, garantindo a validade jurídica perante o Fisco.
Status SEFAZ.
Realiza a verificação em tempo real da disponibilidade dos serviços da SEFAZ (Secretaria da Fazenda) para a autorização de documentos fiscais.
Este recurso é essencial para diagnosticar instabilidades no webservice de destino, permitindo que o sistema emissor decida pela ativação de regimes de contingência ou aguarde a normalização do serviço.
⚠️ ATENÇÃO: O tempo de resposta deste endpoint depende diretamente da latência do servidor governamental consultado. Recomenda-se implementar um timeout adequado no lado do cliente para evitar retenção de threads.
🧪 TESTE: Em ambiente de sandbox, o retorno pode simular um status de “Operação Normal” de forma estática ou refletir o ambiente de homologação da SEFAZ, dependendo da configuração da aplicação.
post
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Response
Response
OK
ConsultarStatusSefazViewModel
Retorno da consulta de status da SEFAZ.
* Additional properties are NOT allowed.
sucessoboolean
Indica se a consulta foi bem sucedida.
tipoAmbientestring
Tipo de ambiente da SEFAZ.
Allowed values:ProducaoHomologacao
ufstring
Lista de Unidades Federativas para Nota Fiscal.
Allowed values:ROACAMRRPAAPTOMAPICERNPBPEALSEBAMGESRJSPPRSCRSMSMTGODF
cStatinteger(int32)
Código de status da SEFAZ.
xMotivostring | null
Motivo do status da SEFAZ.
post/api/v1/Nfce/Sefaz/Status