---
title: "Status da NFCe."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfce-filtro--StatusFiscal/get"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# Status da NFCe.

`GET` `/api/v1/Nfce/{filtro}/StatusFiscal`

Retorna o <strong>status</strong> de uma nota fiscal de consumidor eletrônica (NFCe) identificada pelo código ERP ou chave de acesso. 🔍 **IDENTIFICAÇÃO**: O filtro aceita a <strong>chave de acesso</strong> da nota fiscal (44 dígitos numéricos) ou o <strong>código ERP</strong> informado pelo integrador no momento da emissão. 📋 **RETORNO**: Inclui modelo, série, número, chave de acesso, status, protocolos de autorização/cancelamento e mensagem da SEFAZ.

## Path parameters

- `filtro` (string, required) - Chave de acesso da nota fiscal (44 dígitos) ou Código ERP.

## Header parameters

- `DocumentoEmissor` (string, required) - Documento do emissor.

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Not Found
- `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/Nfce/{filtro}/StatusFiscal:
    get:
      tags:
        - Nfce
      summary: Status da NFCe.
      description: >-
        Retorna o <strong>status</strong> de uma nota fiscal de consumidor
        eletrônica (NFCe) identificada pelo código ERP ou chave de acesso.
                    
        🔍 **IDENTIFICAÇÃO**: O filtro aceita a <strong>chave de acesso</strong>
        da nota fiscal (44 dígitos numéricos) ou o <strong>código ERP</strong>
        informado pelo integrador no momento da emissão.
                    
        📋 **RETORNO**: Inclui modelo, série, número, chave de acesso, status,
        protocolos de autorização/cancelamento e mensagem da SEFAZ.
      parameters:
        - name: filtro
          in: path
          description: Chave de acesso da nota fiscal (44 dígitos) ou Código ERP.
          required: true
          schema:
            type: string
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ObterStatusFiscalViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ObterStatusFiscalViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ObterStatusFiscalViewModel"
        "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"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    ObterStatusFiscalViewModel:
      type: object
      properties:
        codigoErp:
          type: string
          description: Identificador da operação fiscal no ERP.
          nullable: true
        modelo:
          $ref: "#/components/schemas/ModeloNotaFiscalModelEnum"
        serie:
          type: string
          description: Série do documento fiscal.
          nullable: true
        numeroDocumento:
          type: integer
          description: Número do documento fiscal.
          format: int64
        chaveAcesso:
          type: string
          description: Chave de acesso do documento fiscal.
          nullable: true
        dataEmissao:
          type: string
          description: Data de emissão do documento fiscal.
          format: date-time
        naturezaOperacao:
          type: string
          description: Natureza da operação.
          nullable: true
        tipoAmbiente:
          $ref: "#/components/schemas/TipoAmbienteSefazModelEnum"
        status:
          $ref: "#/components/schemas/StatusNotaFiscalModelEnum"
        ultimoCstat:
          type: integer
          description: Último código de status retornado pela sefaz.
          format: int32
          nullable: true
        mensagemSefaz:
          type: string
          description: Última mensagem retornada pela SEFAZ.
          nullable: true
        qrcodeLink:
          type: string
          description: Link do QR Code da NFC-e.
          nullable: true
        protocoloAutorizacao:
          type: string
          description: Protocolo de autorização emitido pela SEFAZ.
          nullable: true
        protocoloCancelamento:
          type: string
          description: Protocolo de cancelamento emitido pela SEFAZ.
          nullable: true
      additionalProperties: false
      description: Dados fiscais de uma nota fiscal identificada pelo código ERP.
    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.
    TipoAmbienteSefazModelEnum:
      enum:
        - Producao
        - Homologacao
      type: string
      description: Tipo de ambiente da SEFAZ.
    StatusNotaFiscalModelEnum:
      enum:
        - Pendente
        - Autorizada
        - Cancelada
        - Inutilizada
        - Rejeitada
        - Denegada
        - EmCancelamento
        - EmContingencia
        - Substituida
      type: string
      description: Status do documento eletrônico.
  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
```