---
title: "Produtos consultados - Detalhe."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-CatalogoProduto-Produto-produtoEmissorId--ObterDetalhe/get"
---

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

# Produtos consultados - Detalhe.

`GET` `/api/v1/CatalogoProduto/Produto/{produtoEmissorId}/ObterDetalhe`

Permite obter a visão detalhada de um produto específico presente no catálogo do <strong>Emissor</strong>, utilizando seu identificador único gerado pela plataforma. 📋 **INFORMAÇÕES RETORNADAS**: O retorno abrange desde os dados cadastrais básicos (EAN, Descrição, NCM) até o histórico de <strong>bilhetagem aplicada sobre o produto</strong>. 💡 **UTILIZAÇÃO**: Este endpoint é ideal para obter o histórico de bilhetagem do produto.

## Path parameters

- `produtoEmissorId` (string, uuid, required) - Identificador interno do produto do emissor.

## 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/CatalogoProduto/Produto/{produtoEmissorId}/ObterDetalhe:
    get:
      tags:
        - CatalogoProduto
      summary: Produtos consultados - Detalhe.
      description: >-
        Permite obter a visão detalhada de um produto específico presente no
        catálogo do <strong>Emissor</strong>, 

        utilizando seu identificador único gerado pela plataforma.


        📋 **INFORMAÇÕES RETORNADAS**: O retorno abrange desde os dados
        cadastrais básicos (EAN, Descrição, NCM) 

        até o histórico de <strong>bilhetagem aplicada sobre o produto</strong>.


        💡 **UTILIZAÇÃO**: Este endpoint é ideal para obter o histórico de
        bilhetagem do produto.
      parameters:
        - name: produtoEmissorId
          in: path
          description: Identificador interno do produto do emissor.
          required: true
          schema:
            type: string
            format: uuid
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ProdutoEmissorViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ProdutoEmissorViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ProdutoEmissorViewModel"
        "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:
    ProdutoEmissorViewModel:
      type: object
      properties:
        id:
          type: string
          description: Identificador interno do produto do emissor.
          format: uuid
        hash:
          type: string
          description: Hash de identificação da tributação.
          nullable: true
        filtro:
          type: string
          description: Filtro usado na consulta para identificar o produto.
          nullable: true
        ultimaConsulta:
          type: string
          description: Data da última consulta realizada.
          format: date-time
        ultimaAtualizacaoFiscal:
          type: string
          description: Data da última atualização fiscal.
          format: date-time
          nullable: true
        bilhetagem:
          type: array
          items:
            $ref: "#/components/schemas/ProdutoEmissorBilhetagemViewModel"
          description: Histórico de bilhetagem do produto.
          nullable: true
      additionalProperties: false
      description: Dados detalhados do produto relacionado ao 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
    ProdutoEmissorBilhetagemViewModel:
      type: object
      properties:
        dataBilhetagem:
          type: string
          description: Data de ocorrência da bilhetagem.
          format: date-time
        codigoMunicipioEmissor:
          type: string
          description: Código do município do emissor utilizado na consulta.
          nullable: true
        regimeTributarioEmissor:
          type: string
          description: Regime tributário do emissor utilizado na consulta.
          nullable: true
        cnaeEmissor:
          type: string
          description: CNAE do emissor utilizado na consulta.
          nullable: true
        cnaeSecundarioEmissor:
          type: string
          description: CNAE secundário do emissor utilizado na consulta.
          nullable: true
        codigoMunicipioDestinatario:
          type: string
          description: Código do município do destinatário utilizado na consulta.
          nullable: true
        finalidade:
          type: string
          description: Finalidade da operação utilizada na consulta.
          nullable: true
        situacaoEspecialDestinatario:
          type: string
          description: Situação especial do destinatário utilizada na consulta.
          nullable: true
        origem:
          type: string
          description: Origem do produto utilizado na consulta.
          nullable: true
        destinatarioSimplesNacional:
          type: boolean
          description: Indicador de destinatário optante pelo Simples Nacional utilizado
            na consulta.
        destinatarioSubstitutoTributario:
          type: boolean
          description: Indicador de destinatário substituto tributário utilizado na
            consulta.
        mercadoriaProduzidaZFM:
          type: boolean
          description: Indicador de mercadoria produzida na Zona Franca de Manaus (ZFM)
            utilizado na consulta.
        fabricacaoPropria:
          type: boolean
          description: Indicador de fabricacao própria utilizado na consulta.
      additionalProperties: false
      description: Dados da bilhetagem do produto.
  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
```