---
title: "Emitir NFe - Estorno (extemporâneo)."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfe-Estorno-Emitir/post"
---
> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md
# Emitir NFe - Estorno (extemporâneo).
`POST` `/api/v1/Nfe/Estorno/Emitir`
Permite a emissão de uma NFe de estorno para documentos fiscais cujo prazo legal de cancelamento já tenha sido expirado perante a SEFAZ. Este recurso automatiza a geração do documento de anulação, garantindo que as cláusulas fiscais de estorno (finalidade de emissão 3) sejam aplicadas corretamente em relação à nota de origem referenciada. Realiza a emissão de um novo documento fiscal com o objetivo de reverter os efeitos financeiros e de estoque de uma nota anteriormente autorizada. ⚠️ **ATENÇÃO**: O estorno deve ser utilizado apenas quando o cancelamento não for mais possível. A nota de estorno referenciará a chave de acesso da nota original e deve conter os mesmos dados de itens e valores, porém com CFOPs inversos, conforme a legislação vigente. ⚙️ **CONFIGURAÇÃO**: Certifique-se de que o certificado digital do Emissor esteja válido e configurado no contexto da Stone Tax API para a assinatura do XML.
## Header parameters
- `danfe` (string, optional) - Escolha o formato do DANFE gerado na emissão da nota (Default: Nenhum).
- `tipoDanfeNfe` (string, optional) - Tipo de DANFE gerado (Opcional).
- `DocumentoEmissor` (string, required) - Documento do emissor.
## Request body
Content types: `application/json-patch+json`, `application/json`, `text/json`, `application/*+json`
## Responses
- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Not Found
- `422` - Unprocessable Content
- `500` - Internal Server Error
## OpenAPI definition
```yaml
openapi: 3.0.4
info:
title: Stone Tax API
version: 1.0.0
servers:
- url: https://stone-tax-sdx.stone.com.br
description: Ambiente de Desenvolvimento
- url: https://stone-tax.stone.com.br
description: Ambiente de Produção
paths:
/api/v1/Nfe/Estorno/Emitir:
post:
tags:
- Nfe
summary: Emitir NFe - Estorno (extemporâneo).
description: >-
Permite a emissão de uma NFe de estorno para documentos
fiscais cujo prazo legal de cancelamento já tenha sido expirado perante
a SEFAZ.
Este recurso automatiza a geração do documento de anulação, garantindo
que as cláusulas fiscais de estorno (finalidade de
emissão 3) sejam aplicadas
corretamente em relação à nota de origem referenciada.
Realiza a emissão de um novo documento fiscal com o objetivo de reverter
os efeitos financeiros e de estoque de uma nota anteriormente
autorizada.
⚠️ **ATENÇÃO**: O estorno deve ser utilizado apenas quando o
cancelamento não for mais possível. A nota de estorno referenciará a
chave de acesso da nota original e deve conter os mesmos dados de itens
e valores, porém com CFOPs inversos, conforme a legislação vigente.
⚙️ **CONFIGURAÇÃO**: Certifique-se de que o certificado digital do
Emissor esteja válido e configurado no contexto da
Stone Tax API para a assinatura do XML.
parameters:
- name: danfe
in: header
description: "Escolha o formato do DANFE gerado na emissão da nota (Default:
Nenhum)."
schema:
$ref: "#/components/schemas/DanfeEmissaoNotasModelEnum"
- name: tipoDanfeNfe
in: header
description: Tipo de DANFE gerado (Opcional).
schema:
$ref: "#/components/schemas/TipoDanfeNfeModelEnum"
- name: DocumentoEmissor
in: header
description: Documento do emissor.
required: true
schema:
type: string
requestBody:
description: Objeto contendo os dados complementares para a emissão do estorno.
content:
application/json-patch+json:
schema:
$ref: "#/components/schemas/EmitirNfeEstornoInputModel"
application/json:
schema:
$ref: "#/components/schemas/EmitirNfeEstornoInputModel"
text/json:
schema:
$ref: "#/components/schemas/EmitirNfeEstornoInputModel"
application/*+json:
schema:
$ref: "#/components/schemas/EmitirNfeEstornoInputModel"
responses:
"200":
description: OK
content:
text/plain:
schema:
$ref: "#/components/schemas/EmissaoNotaFiscalViewModel"
application/json:
schema:
$ref: "#/components/schemas/EmissaoNotaFiscalViewModel"
text/json:
schema:
$ref: "#/components/schemas/EmissaoNotaFiscalViewModel"
"400":
description: Bad Request
content:
application/json:
schema:
$ref: "#/components/schemas/ResponseErrorResult"
"401":
description: Unauthorized
content:
application/json:
schema:
$ref: "#/components/schemas/ResponseErrorResult"
"403":
description: Forbidden
content:
application/json:
schema:
$ref: "#/components/schemas/ResponseErrorResult"
"404":
description: Not Found
content:
application/json:
schema:
$ref: "#/components/schemas/ResponseErrorResult"
"422":
description: Unprocessable Content
content:
text/plain:
schema:
$ref: "#/components/schemas/EmissaoNotaFiscalViewModel"
application/json:
schema:
$ref: "#/components/schemas/EmissaoNotaFiscalViewModel"
text/json:
schema:
$ref: "#/components/schemas/EmissaoNotaFiscalViewModel"
"500":
description: Internal Server Error
content:
application/json:
schema:
$ref: "#/components/schemas/ResponseErrorResult"
security:
- BearerAuth: []
security:
- BearerAuth: []
components:
schemas:
DanfeEmissaoNotasModelEnum:
enum:
- Html
- Pdf
- Nenhum
type: string
description: Tipo de arquivo DANFE gerado na emissão.
TipoDanfeNfeModelEnum:
enum:
- Retrato
- Simplificado
type: string
description: Tipo de danfe para NFe.
EmitirNfeEstornoInputModel:
required:
- codigoErp
- identificadorDocumentoFiscalEstornado
type: object
properties:
codigoErp:
minLength: 1
type: string
description: Identificador da operação fiscal no ERP.
serie:
type: string
description: Série do documento fiscal (Informar somente se estiver configurado
para geração numérica manual).
nullable: true
numeroDocumento:
type: integer
description: Numero do documento fiscal (Informar somente se estiver configurado
para geração numérica manual).
format: int64
nullable: true
modeloDocumentoFiscalEstornado:
$ref: "#/components/schemas/ModeloNotaFiscalModelEnum"
identificadorDocumentoFiscalEstornado:
minLength: 1
type: string
description: Identificador da nota fiscal a ser estornada - Chave de acesso ou
Código ERP.
tipoEmissao:
$ref: "#/components/schemas/TipoEmissaoNfeModelEnum"
autXml:
type: array
items:
$ref: "#/components/schemas/NfeAuxXmlInputModel"
description: Documentos autorizados a visualizar a NFe.
nullable: true
additionalProperties: false
description: Dados necessários para criar uma nota de estorno.
EmissaoNotaFiscalViewModel:
type: object
properties:
sucesso:
type: boolean
description: Indica se a nota foi autorizada pela sefaz ou não.
codigoStatus:
type: integer
description: Código de status de envio para a sefaz.
format: int32
mensagemSefaz:
type: string
description: Mensagem de retorno da sefaz.
nullable: true
serie:
type: string
description: Série da nota fiscal.
nullable: true
numeroDocumento:
type: integer
description: Número do documento.
format: int64
chaveAcesso:
type: string
description: Chave de acesso da nota fiscal.
nullable: true
numeroProtocolo:
type: string
description: Número do protocolo de autorização da nota fiscal.
nullable: true
linkQrcode:
type: string
description: Link de acesso a nota fiscal (Apenas para NFC-e).
nullable: true
danfe:
type: string
description: Arquivo DANFE solicitado (HTML ou PDF Base64).
nullable: true
emitidaEmContingencia:
type: boolean
description: Indica se a nota foi emitida em modo contingência.
additionalProperties: false
description: Dados de retorno da emissão de nota fiscal.
ResponseErrorResult:
type: object
properties:
status:
type: integer
format: int32
titulo:
type: string
nullable: true
erros:
type: object
additionalProperties:
type: array
items:
type: string
nullable: true
additionalProperties: false
ModeloNotaFiscalModelEnum:
enum:
- Nfe
- Nfce
type: string
description: Modelo de nota fiscal.
TipoEmissaoNfeModelEnum:
enum:
- Automatica
- Normal
- ContingenciaFsda
- ContingenciaSvcan
- ContingenciaSvcrs
type: string
description: Tipo de emissão de NFe.
NfeAuxXmlInputModel:
required:
- documento
type: object
properties:
tipoDocumento:
$ref: "#/components/schemas/TipoDocumentoNotaFiscalModelEnum"
documento:
minLength: 1
type: string
description: Documento autorizado.
additionalProperties: false
description: Documentos autorizados a capturar e visualizar a NFe.
TipoDocumentoNotaFiscalModelEnum:
enum:
- Cpf
- Cnpj
- IdEstrangeiro
type: string
description: Tipo de documento.
securitySchemes:
BearerAuth:
type: http
description: Autenticação via token JWT. Obtenha o token através do endpoint
/Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
scheme: bearer
bearerFormat: JWT
```