---
title: "NFS-e - Obter parâmetros do município."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-RecursosAdicionais-Nfse-Municipio-codigoMunicipio--Parametros/get"
---

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

# NFS-e - Obter parâmetros do município.

`GET` `/api/v1/RecursosAdicionais/Nfse/Municipio/{codigoMunicipio}/Parametros`

Retorna os parâmetros do município para emissão de NFS-e no Ambiente Nacional, incluindo dados do convênio (aderência ao Ambiente Nacional, Emissor Nacional e MAN) e as retenções configuradas no município. ⚠️ **ATENÇÃO**: O código do município deve ser o código IBGE de 7 dígitos.

## Path parameters

- `codigoMunicipio` (string, required) - Código IBGE do município.

## 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/Nfse/Municipio/{codigoMunicipio}/Parametros:
    get:
      tags:
        - RecursosAdicionais
      summary: NFS-e - Obter parâmetros do município.
      description: >-
        Retorna os parâmetros do município para emissão de NFS-e no Ambiente
        Nacional, incluindo dados do convênio

        (aderência ao Ambiente Nacional, Emissor Nacional e MAN) e as retenções
        configuradas no município.
                    
        ⚠️ **ATENÇÃO**: O código do município deve ser o código IBGE de 7
        dígitos.
      parameters:
        - name: codigoMunicipio
          in: path
          description: Código IBGE do município.
          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/ObterParametrosMunicipioNfseViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ObterParametrosMunicipioNfseViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ObterParametrosMunicipioNfseViewModel"
        "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:
    ObterParametrosMunicipioNfseViewModel:
      type: object
      properties:
        parametrosConvenio:
          $ref: "#/components/schemas/ParametrosConvenioMunicipioNfseViewModel"
        retencoes:
          $ref: "#/components/schemas/RetencoesDetalhesMunicipioNfseViewModel"
      additionalProperties: false
      description: Parâmetros do município para emissão de NFS-e.
    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
    ParametrosConvenioMunicipioNfseViewModel:
      type: object
      properties:
        aderenteAmbienteNacional:
          type: boolean
          description: Indica se o município é aderente ao Ambiente Nacional NFS-e.
        aderenteEmissorNacional:
          type: boolean
          description: Indica se o município é aderente ao Emissor Nacional NFS-e.
        emissorNacionalLiberadoParaUso:
          type: boolean
          description: Indica se o município já está com o processo de emissão de NFS-e
            liberado para uso.
        situacaoEmissaoPadraoContribuintesRFB:
          type: boolean
          description: Situação de emissão padrão para contribuintes da RFB.
        aderenteMAN:
          type: boolean
          description: Indica se o município é aderente ao MAN (Módulo de Autorização
            Nacional).
        permiteAproveitamentoDeCreditos:
          type: boolean
          description: Indica se o município permite o aproveitamento de créditos.
      additionalProperties: false
      description: Parâmetros do convênio do município com o Ambiente Nacional NFS-e.
    RetencoesDetalhesMunicipioNfseViewModel:
      type: object
      properties:
        artigoSexto:
          $ref: "#/components/schemas/ArtigoSextoMunicipioNfseViewModel"
        retencoesMunicipais:
          type: array
          items:
            $ref: "#/components/schemas/RetencaoMunicipalNfseViewModel"
          description: Lista de retenções municipais configuradas.
          nullable: true
      additionalProperties: false
      description: Detalhes das retenções configuradas no município.
    ArtigoSextoMunicipioNfseViewModel:
      type: object
      properties:
        habilitado:
          type: boolean
          description: Indica se o Artigo Sexto está habilitado no município.
        historico:
          type: array
          items:
            $ref: "#/components/schemas/HistoricoVigenciaMunicipioNfseViewModel"
          description: Histórico de vigências do Artigo Sexto.
          nullable: true
      additionalProperties: false
      description: Configuração de retenção via Artigo Sexto no município.
    RetencaoMunicipalNfseViewModel:
      type: object
      properties:
        descricao:
          type: string
          description: Descrição da retenção municipal.
          nullable: true
        dataInicioVigencia:
          type: string
          description: Data de início da vigência da retenção.
          format: date-time
        dataFimVigencia:
          type: string
          description: Data de fim da vigência da retenção, se houver.
          format: date-time
          nullable: true
        tiposRetencao:
          type: array
          items:
            type: integer
            format: int32
          description: Tipos de retenção aplicados.
          nullable: true
        servicos:
          type: array
          items:
            type: string
          description: Códigos de serviço aos quais a retenção se aplica.
          nullable: true
      additionalProperties: false
      description: Retenção municipal configurada para o município.
    HistoricoVigenciaMunicipioNfseViewModel:
      type: object
      properties:
        dataInicioVigencia:
          type: string
          description: Data de início da vigência.
          format: date-time
        dataFimVigencia:
          type: string
          description: Data de fim da vigência, se houver.
          format: date-time
          nullable: true
      additionalProperties: false
      description: Registro de vigência de uma configuração de retenção.
  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
```