---
title: "NcmViewModel"
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/schemas/NcmViewModel"
---

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

# NcmViewModel

Dados detalhados do NCM.

## 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
components:
  schemas:
    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.
    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.
```