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

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

# NCM - Obter detalhe.

`GET` `/api/v1/RecursosAdicionais/Ncm/{codigoNcm}/ObterDetalhe`

Realiza uma consulta detalhada à tabela de <strong>Nomenclatura Comum do Mercosul (NCM)</strong>, fornecendo informações sobre a classificação fiscal e tributos aproximados por UF. 🔍 **CLASSIFICAÇÃO**: O código NCM deve ser informado com 8 dígitos numéricos. O tributo aproximado deve ser informado em operações de vendas a consumidor final. ℹ️ **EXTENSÃO TIPI**: Caso o produto possua uma exceção tarifária específica, utilize o parâmetro <strong>Extensão TIPI</strong> (Ex) para obter o detalhamento diferenciado aplicável ao código. ⚠️ **ATENÇÃO**: A utilização de NCMs inválidos ou extintos pode ocasionar a rejeição de documentos fiscais eletrônicos (NF-e/NFC-e) pelas Secretarias da Fazenda.

## Path parameters

- `codigoNcm` (string, required) - Código do NCM.

## Query parameters

- `extensaoTipi` (integer, int32, optional) - Extensão TIPI do NCM. (Opcional)

## Header parameters

- `DocumentoEmissor` (string, optional) - 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/RecursosAdicionais/Ncm/{codigoNcm}/ObterDetalhe:
    get:
      tags:
        - RecursosAdicionais
      summary: NCM - Obter detalhe.
      description: >-
        Realiza uma consulta detalhada à tabela de <strong>Nomenclatura Comum do
        Mercosul (NCM)</strong>, fornecendo informações sobre a classificação
        fiscal e tributos aproximados por UF.


        🔍 **CLASSIFICAÇÃO**: O código NCM deve ser informado com 8 dígitos
        numéricos. O tributo aproximado deve ser informado em operações de
        vendas a consumidor final.


        ℹ️ **EXTENSÃO TIPI**: Caso o produto possua uma exceção tarifária
        específica, utilize o parâmetro <strong>Extensão TIPI</strong> (Ex) para
        obter o detalhamento diferenciado aplicável ao código.


        ⚠️ **ATENÇÃO**: A utilização de NCMs inválidos ou extintos pode
        ocasionar a rejeição de documentos fiscais eletrônicos (NF-e/NFC-e)
        pelas Secretarias da Fazenda.
      parameters:
        - name: codigoNcm
          in: path
          description: Código do NCM.
          required: true
          schema:
            type: string
        - name: extensaoTipi
          in: query
          description: Extensão TIPI do NCM. (Opcional)
          schema:
            type: integer
            format: int32
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/NcmViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/NcmViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/NcmViewModel"
        "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:
    NcmViewModel:
      type: object
      properties:
        codigoNcm:
          type: string
          description: Código da Nomenclatura Comum do Mercosul.
          nullable: true
        extensaoTipi:
          type: integer
          description: Código de extensão da TIPI (Tabela de Incidência do IPI).
          format: int32
        descricao:
          type: string
          description: Descrição completa da mercadoria ou serviço vinculada ao NCM.
          nullable: true
        inicioVigencia:
          type: string
          description: Data de início da vigência do código NCM.
          format: date
          example: 2025-03-31
        fimVigencia:
          type: string
          description: Data de término da vigência (opcional).
          format: date
          nullable: true
        tributosAproximados:
          type: array
          items:
            $ref: "#/components/schemas/NcmTributoAproximadoViewModel"
          description: Lista de tributos aproximados por UF.
          nullable: true
        cests:
          type: array
          items:
            $ref: "#/components/schemas/NcmCestViewModel"
          description: Lista de CEST´s associados ao NCM.
          nullable: true
      additionalProperties: false
      description: Dados detalhados do NCM.
    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
    NcmTributoAproximadoViewModel:
      type: object
      properties:
        uf:
          $ref: "#/components/schemas/UfTributoAproximadoModelEnum"
        aproximadoMunicipal:
          type: number
          description: Alíquota aproximada dos tributos municipais.
          format: double
        aproximadoEstadual:
          type: number
          description: Alíquota aproximada dos tributos estaduais.
          format: double
        aproximadoNacional:
          type: number
          description: Alíquota aproximada dos tributos nacionais (federais).
          format: double
        aproximadoImportados:
          type: number
          description: Alíquota aproximada para produtos importados.
          format: double
        fonte:
          type: string
          description: "Fonte da informação técnica (ex: IBPT)."
          nullable: true
      additionalProperties: false
      description: Dados dos tributos aproximados vinculados a um NCM (Lei da
        Transparência).
    NcmCestViewModel:
      type: object
      properties:
        codigoCest:
          type: string
          description: CEST - Código especificador da substituição tributária.
          nullable: true
        descricao:
          type: string
          description: Descrição do CEST.
          nullable: true
      additionalProperties: false
      description: Dados do CEST do NCM.
    UfTributoAproximadoModelEnum:
      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: Unidade Federativa.
  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
```