---
title: "NFS-e - Obter detalhe do serviço CTN."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-RecursosAdicionais-ServicoCtn-codigoCtn--ObterDetalhe/get"
---

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

# NFS-e - Obter detalhe do serviço CTN.

`GET` `/api/v1/RecursosAdicionais/ServicoCtn/{codigoCtn}/ObterDetalhe`

Retorna os dados completos de um serviço da <strong>Lista de Serviços do CTN (Código Tributário Nacional)</strong>, incluindo os códigos NBS associados, os indicadores de operação de NFS-e e as classificações tributárias vinculadas.

## Path parameters

- `codigoCtn` (string, required) - Código do serviço conforme a Lista de Serviços do CTN.

## Header parameters

- `DocumentoEmissor` (string, optional) - 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/RecursosAdicionais/ServicoCtn/{codigoCtn}/ObterDetalhe:
    get:
      tags:
        - RecursosAdicionais
      summary: NFS-e - Obter detalhe do serviço CTN.
      description: >-
        Retorna os dados completos de um serviço da <strong>Lista de Serviços do
        CTN (Código Tributário Nacional)</strong>,

        incluindo os códigos NBS associados, os indicadores de operação de NFS-e
        e as classificações tributárias vinculadas.
      parameters:
        - name: codigoCtn
          in: path
          description: Código do serviço conforme a Lista de Serviços do CTN.
          required: true
          schema:
            type: string
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ObterDetalheServicoCtnViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ObterDetalheServicoCtnViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ObterDetalheServicoCtnViewModel"
        "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:
    ObterDetalheServicoCtnViewModel:
      type: object
      properties:
        codigoCtn:
          type: string
          description: Código do serviço conforme a Lista de Serviços do CTN.
          nullable: true
        descricao:
          type: string
          description: Descrição do serviço.
          nullable: true
        incidenciaIss:
          $ref: "#/components/schemas/IncidenciaIssCtnModelEnum"
        nbs:
          type: array
          items:
            $ref: "#/components/schemas/ObterDetalheServicoCtnNbsViewModel"
          description: Lista de códigos NBS associados ao serviço.
          nullable: true
        indicadoresOperacaoNfse:
          type: array
          items:
            $ref: "#/components/schemas/ObterDetalheServicoCtnIndicadorOperacaoNfseViewMode\
              l"
          description: Lista de indicadores de operação de NFS-e associados ao serviço.
          nullable: true
        cClassTribs:
          type: array
          items:
            $ref: "#/components/schemas/ObterDetalheServicoCtnCClassTribViewModel"
          description: Lista de classificações tributárias associadas ao serviço.
          nullable: true
      additionalProperties: false
      description: Dados detalhados de um serviço da Lista de Serviços do CTN.
    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
    IncidenciaIssCtnModelEnum:
      enum:
        - LocalPrestador
        - LocalPrestacao
        - LocalTomador
      type: string
      description: Incidência do ISS conforme a Lista de Serviços do CTN.
    ObterDetalheServicoCtnNbsViewModel:
      type: object
      properties:
        codigoNbs:
          type: string
          description: Código da Nomenclatura Brasileira de Serviços.
          nullable: true
        descricao:
          type: string
          description: Descrição do serviço conforme a NBS.
          nullable: true
      additionalProperties: false
      description: Dados do NBS no detalhe do Serviço CTN.
    ObterDetalheServicoCtnIndicadorOperacaoNfseViewModel:
      type: object
      properties:
        codigo:
          type: string
          description: Código do indicador de operação (cIndOp).
          nullable: true
        artigo:
          type: string
          description: Artigo legal relacionado ao indicador de operação.
          nullable: true
        tipoOperacao:
          type: string
          description: Tipo de operação do serviço.
          nullable: true
        caracteristicaFornecimento:
          type: string
          description: Característica do fornecimento do serviço.
          nullable: true
        localFornecimento:
          type: string
          description: Local de fornecimento do serviço.
          nullable: true
      additionalProperties: false
      description: Dados do indicador de operação de NFS-e no detalhe do Serviço CTN.
    ObterDetalheServicoCtnCClassTribViewModel:
      type: object
      properties:
        cClassTrib:
          type: string
          description: Código da classificação tributária.
          nullable: true
      additionalProperties: false
      description: Dados da classificação tributária no detalhe do Serviço CTN.
  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
```