---
title: "Status SEFAZ."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfce-Sefaz-Status/post"
---

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

# Status SEFAZ.

`POST` `/api/v1/Nfce/Sefaz/Status`

Realiza a verificação em tempo real da <strong>disponibilidade dos serviços da SEFAZ</strong> (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 <strong>contingência</strong> 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.

## Header parameters

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

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `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/Sefaz/Status:
    post:
      tags:
        - Nfce
      summary: Status SEFAZ.
      description: >-
        Realiza a verificação em tempo real da <strong>disponibilidade dos
        serviços da SEFAZ</strong> (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 <strong>contingência</strong> 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.
      parameters:
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ConsultarStatusSefazViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ConsultarStatusSefazViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ConsultarStatusSefazViewModel"
        "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"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    ConsultarStatusSefazViewModel:
      type: object
      properties:
        sucesso:
          type: boolean
          description: Indica se a consulta foi bem sucedida.
        tipoAmbiente:
          $ref: "#/components/schemas/TipoAmbienteSefazModelEnum"
        uf:
          $ref: "#/components/schemas/UfNotaFiscalModelEnum"
        cStat:
          type: integer
          description: Código de status da SEFAZ.
          format: int32
        xMotivo:
          type: string
          description: Motivo do status da SEFAZ.
          nullable: true
      additionalProperties: false
      description: Retorno da consulta de status da SEFAZ.
    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
    TipoAmbienteSefazModelEnum:
      enum:
        - Producao
        - Homologacao
      type: string
      description: Tipo de ambiente da SEFAZ.
    UfNotaFiscalModelEnum:
      enum:
        - RO
        - AC
        - AM
        - RR
        - PA
        - AP
        - TO
        - MA
        - PI
        - CE
        - RN
        - PB
        - PE
        - AL
        - SE
        - BA
        - MG
        - ES
        - RJ
        - SP
        - PR
        - SC
        - RS
        - MS
        - MT
        - GO
        - DF
      type: string
      description: Lista de Unidades Federativas para Nota Fiscal.
  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
```