---
title: "Obter detalhe."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Emissor-documento--ObterDetalhe/get"
---

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

# Obter detalhe.

`GET` `/api/v1/Emissor/{documento}/ObterDetalhe`

Permite obter os dados cadastrais completos do emissor selecionado.

## Path parameters

- `documento` (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/Emissor/{documento}/ObterDetalhe:
    get:
      tags:
        - Emissor
      summary: Obter detalhe.
      description: Permite obter os dados cadastrais completos do emissor selecionado.
      parameters:
        - name: documento
          in: path
          description: Documento do emissor.
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/EmissorDetalheViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/EmissorDetalheViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/EmissorDetalheViewModel"
        "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:
    EmissorDetalheViewModel:
      type: object
      properties:
        documento:
          type: string
          description: Documento (CPF/CNPJ) do emissor.
          nullable: true
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoEmissorModelEnum"
        nome:
          type: string
          description: Nome ou Razão Social do emissor.
          nullable: true
        nomeFantasia:
          type: string
          description: Nome fantasia do emissor.
          nullable: true
        regimeTributario:
          $ref: "#/components/schemas/RegimeTributarioModelEnum"
        aliquotaCreditoSimples:
          type: number
          description: Alíquota do crédito de icms do simples nacional consedido em
            operações de revenda do regime Simples Nacional.
          format: double
          nullable: true
        tipoIcmsSt:
          $ref: "#/components/schemas/TipoIcmsStEmissorModelEnum"
        tipoEstabelecimento:
          $ref: "#/components/schemas/TipoEstabelecimentoEmissorModelEnum"
        telefone:
          type: string
          description: Telefone de contato.
          nullable: true
        inscricaoMunicipal:
          type: string
          description: Inscrição municipal do emissor.
          nullable: true
        cnae:
          type: string
          description: Código CNAE principal.
          nullable: true
        cnaeSecundario:
          type: string
          description: Código CNAE secundário.
          nullable: true
        endereco:
          $ref: "#/components/schemas/EnderecoEmissorViewModel"
        inscricoesEstaduais:
          type: array
          items:
            $ref: "#/components/schemas/InscricaoEstadualEmissorViewModel"
          description: Lista de inscrições estaduais do emissor.
          nullable: true
        certificadoDigital:
          $ref: "#/components/schemas/CertificadoDigitalViewModel"
        parametrosNfe:
          $ref: "#/components/schemas/ParametrosNfeViewModel"
        parametrosNfce:
          $ref: "#/components/schemas/ParametrosNfceViewModel"
        parametrosNfse:
          $ref: "#/components/schemas/ParametrosNfseViewModel"
        dataCriacao:
          type: string
          description: Data de criação do emissor no sistema.
          format: date-time
        ultimaAlteracao:
          type: string
          description: Data de última alteração dos dados do emissor no sistema.
          format: date-time
        status:
          $ref: "#/components/schemas/StatusEmissorModelEnum"
        bilhetagem:
          $ref: "#/components/schemas/EmissorBilhetagemViewModel"
      additionalProperties: false
      description: Dados detalhados do emissor.
    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
    TipoDocumentoEmissorModelEnum:
      enum:
        - Cpf
        - Cnpj
      type: string
      description: Tipo de documento do emissor.
    RegimeTributarioModelEnum:
      enum:
        - Mei
        - SimplesNacional
        - SimplesNacionalExcessoReceita
        - LucroPresumido
        - LucroReal
      type: string
      description: Regime tributário do emissor.
    TipoIcmsStEmissorModelEnum:
      enum:
        - Substituta
        - Substituida
      type: string
      description: Tipo de ICMS ST do emissor.
    TipoEstabelecimentoEmissorModelEnum:
      enum:
        - Outros
        - IndustriaOuEquiparado
      type: string
      description: Tipo de estabelecimento do emissor quanto ao IPI.
    EnderecoEmissorViewModel:
      type: object
      properties:
        logradouro:
          type: string
          description: Logradouro.
          nullable: true
        numero:
          type: string
          description: Número.
          nullable: true
        complemento:
          type: string
          description: Complemento.
          nullable: true
        bairro:
          type: string
          description: Bairro.
          nullable: true
        codigoMunicipio:
          type: string
          description: Código IBGE do município.
          nullable: true
        municipio:
          type: string
          description: Nome do município.
          nullable: true
        uf:
          $ref: "#/components/schemas/UfModelEnum"
        cep:
          type: string
          description: CEP.
          nullable: true
      additionalProperties: false
      description: Dados do emissor.
    InscricaoEstadualEmissorViewModel:
      type: object
      properties:
        inscricaoEstadual:
          type: string
          description: Número da Inscrição Estadual do emissor.
          nullable: true
        nome:
          type: string
          description: Nome na inscrição estadual.
          nullable: true
        endereco:
          $ref: "#/components/schemas/EnderecoEmissorViewModel"
      additionalProperties: false
      description: Dados da inscrição estadual do emissor.
    CertificadoDigitalViewModel:
      type: object
      properties:
        numeroSerie:
          type: string
          description: Número de série do certificado.
          nullable: true
        dataValidade:
          type: string
          description: Data de validade do certificado.
          format: date
          example: 2025-03-31
      additionalProperties: false
      description: Informações do certificado digital.
    ParametrosNfeViewModel:
      type: object
      properties:
        sequenciaAutomatica:
          type: boolean
          description: Indica se a sequência da numeração será automática ou manual.
        serie:
          type: string
          description: Série da NF-e. (Apenas se a sequência for automática)
          nullable: true
        numeroUltimaNfe:
          type: integer
          description: Número da última NF-e emitida. (Apenas se a sequência for automática)
          format: int64
          nullable: true
        enviarEmailNfe:
          type: boolean
          description: Enviar email com a NF-e para o cliente de forma automatica.
        tipoDanfe:
          $ref: "#/components/schemas/ParametroNfeTipoDanfeModelEnum"
        diasInutilizacaoAutomatica:
          type: integer
          description: Dias "A partir de" para inutilização automática de notas rejeitadas
            ou pendentes de emissão.
          format: int32
        crtId:
          type: string
          description: ID do responsável técnico exigido no estado do Paraná para emissão
            de NFe´s.
          nullable: true
        crtHash:
          type: string
          description: Hash do responsável técnico exigido no estado do Paraná para
            emissão de NFe´s.
          nullable: true
        contingenciaAutomaticaAtiva:
          type: boolean
          description: Indica se a contingência automática está ativa no momento.
        dataHoraInicioContingenciaAutomatica:
          type: string
          description: Data e hora de início da contingência automática atual.
          format: date-time
          nullable: true
        contingenciaTimeOut:
          type: boolean
          description: Indica se o timeout de comunicação com a SEFAZ deve acionar o modo
            de contingência automaticamente.
      additionalProperties: false
      description: Parâmetros da NF-e.
    ParametrosNfceViewModel:
      type: object
      properties:
        sequenciaAutomatica:
          type: boolean
          description: Indica se a sequência da numeração será automática ou manual.
        serie:
          type: string
          description: Série da NFC-e. (Apenas se a sequência for automática)
          nullable: true
        numeroUltimaNfce:
          type: integer
          description: Número da última NFC-e emitida. (Apenas se a sequência for
            automática)
          format: int64
          nullable: true
        enviarEmailNfe:
          type: boolean
          description: Enviar email com a NFC-e para o cliente de forma automatica.
        tipoDanfe:
          $ref: "#/components/schemas/ParametroNfceTipoDanfeModelEnum"
        diasInutilizacaoAutomatica:
          type: integer
          description: Dias "A partir de" para inutilização automática de notas rejeitadas
            ou pendentes de emissão.
          format: int32
        contingenciaAutomaticaAtiva:
          type: boolean
          description: Indica se a contingência automática está ativa no momento.
        dataHoraInicioContingenciaAutomatica:
          type: string
          description: Data e hora de início da contingência automática atual.
          format: date-time
          nullable: true
        contingenciaTimeOut:
          type: boolean
          description: Indica se o timeout de comunicação com a SEFAZ deve acionar o modo
            de contingência automaticamente.
      additionalProperties: false
      description: Parâmetros da NFC-e.
    ParametrosNfseViewModel:
      type: object
      properties:
        sequenciaAutomatica:
          type: boolean
          description: Indica se a sequência da numeração do DPS será automática ou manual.
        serie:
          type: string
          description: Série do DPS. (Apenas se a sequência for automática)
          nullable: true
        numeroUltimoDps:
          type: integer
          description: Número do último DPS emitido. (Apenas se a sequência for automática)
          format: int64
          nullable: true
        enviarEmailNfse:
          type: boolean
          description: Enviar e-mail com a NFS-e para o cliente de forma automática.
        opcaoSimpleNacional:
          $ref: "#/components/schemas/OpcaoSimpleNacionalNfseModelEnum"
        regimeEspecialTributacao:
          $ref: "#/components/schemas/RegimeEspecialTributacaoNfseModelEnum"
        regimeApuracaoSimplesNacional:
          $ref: "#/components/schemas/RegimeApuracaoSimplesNacionalNfseModelEnum"
        diasInutilizacaoAutomatica:
          type: integer
          description: Quantidade de dias para inutilização automática de numerações não
            utilizadas.
          format: int32
        aliquotaEfetivaSn:
          type: number
          description: |-
            Alíquota efetiva do Simples Nacional (pTotTribSN) em %.
            Preenchido apenas para emissores do Simples Nacional e MEI.
          format: double
          nullable: true
      additionalProperties: false
      description: Parâmetros da NFS-e.
    StatusEmissorModelEnum:
      enum:
        - Inativo
        - Ativo
      type: string
      description: Status do emissor.
    EmissorBilhetagemViewModel:
      type: object
      properties:
        contrato:
          $ref: "#/components/schemas/EmissorBilhetagemContratoViewModel"
        dataInicioContagem:
          type: string
          description: Data de início da contagem.
          format: date
          example: 2025-03-31
        consultasProdutoBilhetadas:
          type: integer
          description: Quantidade de consultas de produtos bilhetadas após início da
            contagem.
          format: int64
        consultasCnpjBilhetadas:
          type: integer
          description: Quantidade de consultas de CNPJ´s bilhetadas após início da contagem.
          format: int64
        notasFiscaisBilhetadas:
          type: integer
          description: Quantidade de notas fiscais bilhetadas após início da contagem.
          format: int64
      additionalProperties: false
      description: Dados da bilhetagem do emissor.
    UfModelEnum:
      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.
    ParametroNfeTipoDanfeModelEnum:
      enum:
        - Retrato
        - Paisagem
        - Simplificado
      type: string
      description: Tipos de Danfe para NFe.
    ParametroNfceTipoDanfeModelEnum:
      enum:
        - Danfe56mm
        - Danfe80mm
      type: string
      description: Tipo de danfe para NFC-e.
    OpcaoSimpleNacionalNfseModelEnum:
      enum:
        - NaoOptante
        - OptanteMeEppAcimaLimite
        - OptanteMicroempresaAteSubLimite
      type: string
      description: Opção pelo Simples Nacional para fins do ISSQN (opSimpNac).
    RegimeEspecialTributacaoNfseModelEnum:
      enum:
        - Nenhum
        - MicroempresaMunicipal
        - Estimativa
        - SociedadeProfissionais
        - Cooperativa
        - Mei
        - MeEppSimplesNacional
      type: string
      description: Regime especial de tributação do prestador (regEspTrib).
    RegimeApuracaoSimplesNacionalNfseModelEnum:
      enum:
        - TributosFederaisEMunicipalPeloSn
        - TributosFederaisPeloSnEIssqnPelaNfse
        - TributosFederaisEMunicipalPelaNfse
      type: string
      description: Regime de apuração do Simples Nacional (regApuracao).
    EmissorBilhetagemContratoViewModel:
      type: object
      properties:
        quantidadeConsultasCatalogoProduto:
          type: integer
          description: Quantidade de consultas contratadas para catálogo de produtos.
          format: int64
          nullable: true
        quantidadeConsultasCnpjEmissor:
          type: integer
          description: Quantidade de consultas contratadas para de CNPJ.
          format: int64
          nullable: true
        quantidadeNotasFiscais:
          type: integer
          description: Quantidade de emissões de notas fiscais contratada.
          format: int64
          nullable: true
      additionalProperties: false
      description: Dados da bilhetagem contratados.
  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
```