---
title: "Parâmetros da NFS-e."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Emissor-documentoEmissor--Parametros-Nfse-Definir/post"
---

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

# Parâmetros da NFS-e.

`POST` `/api/v1/Emissor/{documentoEmissor}/Parametros/Nfse/Definir`

Permite definir os parâmetros de emissão da NFS-e. ⚠️ **ATENÇÃO**: É necessário observar se o emissor já realizou emissão de NFS-e antes em outro sistema e definir a série e numeração única adequada para evitar rejeição por duplicidade.

## Path parameters

- `documentoEmissor` (string, required) - Documento do emissor.

## Request body

Content types: `application/json-patch+json`, `application/json`, `text/json`, `application/*+json`

## Responses

- `204` - No Content
- `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/Emissor/{documentoEmissor}/Parametros/Nfse/Definir:
    post:
      tags:
        - Emissor
      summary: Parâmetros da NFS-e.
      description: >-
        Permite definir os parâmetros de emissão da NFS-e.
                    
        ⚠️ **ATENÇÃO**: É necessário observar se o emissor já realizou emissão
        de NFS-e antes em outro sistema e definir a série e numeração única
        adequada para evitar rejeição por duplicidade.
      parameters:
        - name: documentoEmissor
          in: path
          description: Documento do emissor.
          required: true
          schema:
            type: string
      requestBody:
        description: Dados dos parâmetros da NFS-e.
        content:
          application/json-patch+json:
            schema:
              $ref: "#/components/schemas/DefinirParametrosNfseInputModel"
          application/json:
            schema:
              $ref: "#/components/schemas/DefinirParametrosNfseInputModel"
          text/json:
            schema:
              $ref: "#/components/schemas/DefinirParametrosNfseInputModel"
          application/*+json:
            schema:
              $ref: "#/components/schemas/DefinirParametrosNfseInputModel"
      responses:
        "204":
          description: No Content
        "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:
    DefinirParametrosNfseInputModel:
      required:
        - enviarEmailNfse
      type: object
      properties:
        sequenciaAutomatica:
          type: boolean
          description: Indica se a sequência da numeração do DPS será automática ou manual.
        serie:
          type: string
          description: Série do DPS. (Apenas se a sequência for automática)
          nullable: true
        numeroUltimoDps:
          type: integer
          description: Número do último DPS emitido. (Apenas se a sequência for automática)
          format: int64
          nullable: true
        enviarEmailNfse:
          type: boolean
          description: Enviar e-mail com a NFS-e para o cliente de forma automática.
        opcaoSimpleNacional:
          $ref: "#/components/schemas/OpcaoSimpleNacionalNfseModelEnum"
        regimeEspecialTributacao:
          $ref: "#/components/schemas/RegimeEspecialTributacaoNfseModelEnum"
        regimeApuracaoSimplesNacional:
          $ref: "#/components/schemas/RegimeApuracaoSimplesNacionalNfseModelEnum"
        diasInutilizacaoAutomatica:
          maximum: 30
          minimum: 1
          type: integer
          description: Quantidade de dias para inutilização automática de numerações não
            utilizadas.
          format: int32
        aliquotaEfetivaSn:
          type: number
          description: >-
            Alíquota efetiva do Simples Nacional (pTotTribSN) em %.

            Obrigatório (aceitando 0) para emissores do Simples Nacional e MEI.

            Não deve ser informado para emissores de Lucro Real e Lucro
            Presumido.
          format: double
          nullable: true
      additionalProperties: false
      description: Dados para definição dos parâmetros 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
    OpcaoSimpleNacionalNfseModelEnum:
      enum:
        - NaoOptante
        - OptanteMeEppAcimaLimite
        - OptanteMicroempresaAteSubLimite
      type: string
      description: Opção pelo Simples Nacional para fins do ISSQN (opSimpNac).
    RegimeEspecialTributacaoNfseModelEnum:
      enum:
        - Nenhum
        - MicroempresaMunicipal
        - Estimativa
        - SociedadeProfissionais
        - Cooperativa
        - Mei
        - MeEppSimplesNacional
      type: string
      description: Regime especial de tributação do prestador (regEspTrib).
    RegimeApuracaoSimplesNacionalNfseModelEnum:
      enum:
        - TributosFederaisEMunicipalPeloSn
        - TributosFederaisPeloSnEIssqnPelaNfse
        - TributosFederaisEMunicipalPelaNfse
      type: string
      description: Regime de apuração do Simples Nacional (regApuracao).
  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
```