---
title: "Emitir NFS-e - Modo Tomador."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfse-Tomador-Emitir/post"
---

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

# Emitir NFS-e - Modo Tomador.

`POST` `/api/v1/Nfse/Tomador/Emitir`

Realiza a <strong>emissão completa</strong> de uma Nota Fiscal de Serviços Eletrônica (NFS-e) junto ao ADN (Ambiente de Desenvolvimento Nacional), atuando o emissor como o <strong>tomador do serviço</strong>. Neste modo, os dados do <strong>prestador externo</strong> devem ser informados no corpo da requisição, enquanto os dados do tomador são obtidos automaticamente do cadastro do emissor. O processo segue o fluxo: 1. Geração e assinatura digital do XML da DPS (Declaração de Prestação de Serviços). 2. Persistência com status <strong>Pendente</strong>. 3. Transmissão ao ADN e atualização do status para <strong>Autorizada</strong> ou <strong>Rejeitada</strong>. 🔁 **IDEMPOTÊNCIA**: O campo `codigoErp` identifica a nota unicamente por emissor. Em caso de reenvio (nota Pendente ou Rejeitada), os dados são atualizados e a DPS é retransmitida sem duplicar registros. ⚙️ **SEQUÊNCIA**: A série e o número da DPS são gerenciados automaticamente com base nos parâmetros de NFS-e configurados para o emissor. Para sequência manual, informe `serie` e `numeroDps`. ⚠️ **ATENÇÃO**: Certifique-se de que o documento do emissor configurado no cabeçalho corresponda ao tomador do serviço antes de efetuar a chamada.

## Header parameters

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

## Request body

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

## 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/Nfse/Tomador/Emitir:
    post:
      tags:
        - Nfse
      summary: Emitir NFS-e - Modo Tomador.
      description: >-
        Realiza a <strong>emissão completa</strong> de uma Nota Fiscal de
        Serviços Eletrônica (NFS-e) junto ao ADN (Ambiente de Desenvolvimento
        Nacional), atuando o emissor como o <strong>tomador do serviço</strong>.
                    
        Neste modo, os dados do <strong>prestador externo</strong> devem ser
        informados no corpo da requisição, enquanto os dados do tomador são
        obtidos automaticamente do cadastro do emissor.
                    
        O processo segue o fluxo:
                    
        1. Geração e assinatura digital do XML da DPS (Declaração de Prestação
        de Serviços).


        2. Persistência com status <strong>Pendente</strong>.


        3. Transmissão ao ADN e atualização do status para
        <strong>Autorizada</strong> ou <strong>Rejeitada</strong>.
                    

                    
        🔁 **IDEMPOTÊNCIA**: O campo `codigoErp` identifica a nota unicamente
        por emissor. Em caso de reenvio (nota Pendente ou Rejeitada), os dados
        são atualizados e a DPS é retransmitida sem duplicar registros.
                    
        ⚙️ **SEQUÊNCIA**: A série e o número da DPS são gerenciados
        automaticamente com base nos parâmetros de NFS-e configurados para o
        emissor. Para sequência manual, informe `serie` e `numeroDps`.
                    
        ⚠️ **ATENÇÃO**: Certifique-se de que o documento do emissor configurado
        no cabeçalho corresponda ao tomador do serviço antes de efetuar a
        chamada.
      parameters:
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      requestBody:
        description: Dados para emissão da NFS-e.
        content:
          application/json-patch+json:
            schema:
              $ref: "#/components/schemas/EmitirNfseModoTomadorInputModel"
          application/json:
            schema:
              $ref: "#/components/schemas/EmitirNfseModoTomadorInputModel"
          text/json:
            schema:
              $ref: "#/components/schemas/EmitirNfseModoTomadorInputModel"
          application/*+json:
            schema:
              $ref: "#/components/schemas/EmitirNfseModoTomadorInputModel"
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/EmissaoNotaFiscalServicoViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/EmissaoNotaFiscalServicoViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/EmissaoNotaFiscalServicoViewModel"
        "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:
    EmitirNfseModoTomadorInputModel:
      required:
        - codigoErp
        - prestador
        - servico
        - valores
      type: object
      properties:
        codigoErp:
          maxLength: 60
          minLength: 1
          type: string
          description: Código de identificação interno do ERP do cliente. Utilizado para
            idempotência e reemissão.
        serie:
          type: string
          description: Série da DPS (até 5 dígitos numéricos). Informar somente quando a
            sequência for manual.
          nullable: true
        numeroDps:
          type: integer
          description: Número sequencial da DPS (nDPS). Informar somente quando a
            sequência for manual.
          format: int64
          nullable: true
        dataCompetencia:
          type: string
          description: |-
            Mês de competência da prestação do serviço no formato "AAAA-MM".
            Deve ser igual ou anterior ao mês de emissão.
            Quando não informado, assume o mês/ano atual.
          nullable: true
        substituicao:
          $ref: "#/components/schemas/SubstituicaoNfseInputModel"
        prestador:
          $ref: "#/components/schemas/PrestadorNfseInputModel"
        servico:
          $ref: "#/components/schemas/ServicoNfseInputModel"
        valores:
          $ref: "#/components/schemas/ValoresNfseModoTomadorInputModel"
        ibsCbs:
          $ref: "#/components/schemas/IbsCbsNfseInputModel"
      additionalProperties: false
      description: Dados para emissão de uma Nota Fiscal de Serviço Eletrônica (NFS-e)
        no modo tomador.
    EmissaoNotaFiscalServicoViewModel:
      type: object
      properties:
        sucesso:
          type: boolean
          description: Indica se a NFS-e foi autorizada pelo ADN.
        codigoStatus:
          type: integer
          description: Código de status retornado pelo ADN.
          format: int32
        mensagemSefaz:
          type: string
          description: Mensagem de retorno do ADN.
          nullable: true
        serie:
          type: string
          description: Série da DPS emitida.
          nullable: true
        numeroDps:
          type: integer
          description: Número sequencial da DPS.
          format: int64
        numeroNfse:
          type: integer
          description: Número sequencial da NFS-e gerado pelo ADN. Disponível após
            autorização.
          format: int64
          nullable: true
        chaveNfse:
          type: string
          description: Chave da NFS-e. Disponível após autorização.
          nullable: true
        alertas:
          type: array
          items:
            $ref: "#/components/schemas/MensagemNfseViewModel"
          description: Alertas retornados pelo ADN.
          nullable: true
        erros:
          type: array
          items:
            $ref: "#/components/schemas/MensagemNfseViewModel"
          description: Erros retornados pelo ADN.
          nullable: true
      additionalProperties: false
      description: Dados de retorno da emissão de Nota Fiscal de Serviço Eletrônica (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
    SubstituicaoNfseInputModel:
      required:
        - chaveNfse
      type: object
      properties:
        chaveNfse:
          maxLength: 53
          minLength: 53
          type: string
          description: Chave de acesso da NFS-e substituída (chSubstda — 53 chars).
        codigoMotivo:
          $ref: "#/components/schemas/MotivoSubstituicaoNfseModelEnum"
        descricaoMotivo:
          type: string
          description: Descrição do motivo da substituição (xMotivo). Opcional.
          nullable: true
      additionalProperties: false
      description: Dados da NFS-e substituída (subst).
    PrestadorNfseInputModel:
      required:
        - documento
        - endereco
      type: object
      properties:
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoPrestadorNfseModelEnum"
        documento:
          minLength: 1
          type: string
          description: >-
            Documento de identificação do prestador.

            CNPJ (14 dígitos), CPF (11 dígitos), NIF (até 40 chars) ou código
            cNaoNIF ("0", "1" ou "2").
        caepf:
          type: string
          description: CAEPF — Cadastro de Atividade Econômica da Pessoa Física (14
            dígitos). Opcional.
          nullable: true
        inscricaoMunicipal:
          type: string
          description: Inscrição municipal do prestador. Opcional.
          nullable: true
        nome:
          type: string
          description: Nome / razão social do prestador. Opcional.
          nullable: true
        telefone:
          type: string
          description: Telefone do prestador. Opcional.
          nullable: true
        email:
          type: string
          description: E-mail do prestador. Opcional.
          nullable: true
        opcaoSimpleNacional:
          $ref: "#/components/schemas/OpcaoSimpleNacionalNfseEnum"
        regimeEspecialTributacao:
          $ref: "#/components/schemas/RegimeEspecialTributacaoNfseEnum"
        endereco:
          $ref: "#/components/schemas/EnderecoPrestadorNfseInputModel"
      additionalProperties: false
      description: Dados do prestador de serviços (prest) informado pelo tomador na
        emissão de NFS-e no modo tomador.
    ServicoNfseInputModel:
      required:
        - codigoNbs
        - codigoServicoCtn
        - descricaoServico
      type: object
      properties:
        codigoMunicipioLocalizacao:
          type: string
          description: Código IBGE (7 dígitos) do município onde o serviço foi prestado.
            Usar para prestações nacionais.
          nullable: true
        codigoPaisLocalizacao:
          type: string
          description: Código do país (Tabela ISO) onde o serviço foi prestado. Usar para
            exportações de serviço.
          nullable: true
        codigoServicoCtn:
          maxLength: 6
          minLength: 6
          type: string
          description: Código de tributação nacional do serviço conforme tabela NFS-e
            Nacional (cTribNac — 6 dígitos).
        codigoTribMunicipal:
          type: string
          description: Código de tributação municipal do serviço (Complemento do código
            CTN no município - cTribMun). Opcional.
          nullable: true
        descricaoServico:
          maxLength: 2000
          minLength: 1
          type: string
          description: Descrição do serviço prestado (xDescServ).
        codigoNbs:
          maxLength: 9
          minLength: 9
          type: string
          description: Código NBS — Nomenclatura Brasileira de Serviços (cNBS — 9 dígitos).
        informacaoComplementar:
          type: string
          description: Informação complementar do serviço prestado (xInfComp). Opcional.
          nullable: true
      additionalProperties: false
      description: >-
        Dados do serviço prestado (serv).

        Informar CodigoMunicipioLocalizacao (nacional) OU CodigoPaisLocalizacao
        (exterior), nunca ambos.
    ValoresNfseModoTomadorInputModel:
      required:
        - valorServico
      type: object
      properties:
        valorServico:
          minimum: 0
          exclusiveMinimum: true
          type: number
          description: Valor monetário do serviço (vServ) em R$.
          format: double
        valorRecebidoIntermediario:
          type: number
          description: Valor recebido pelo intermediário (vReceb) em R$. Preencher somente
            quando TipoEmissor = Intermediário.
          format: double
          nullable: true
        valorDescontoIncondicionado:
          type: number
          description: Valor do desconto incondicionado (vDescIncond) em R$. Opcional.
          format: double
          nullable: true
        valorDescontoCondicionado:
          type: number
          description: Valor do desconto condicionado (vDescCond) em R$. Opcional.
          format: double
          nullable: true
        percentualDeducaoReducao:
          type: number
          description: Percentual padrão de dedução/redução da base de cálculo do ISSQN
            (pDR) em %. Mutuamente exclusivo com ValorDeducaoReducao.
          format: double
          nullable: true
        valorDeducaoReducao:
          type: number
          description: Valor monetário padrão de dedução/redução da base de cálculo do
            ISSQN (vDR) em R$. Mutuamente exclusivo com
            PercentualDeducaoReducao.
          format: double
          nullable: true
        tributacaoIssqn:
          $ref: "#/components/schemas/TributacaoIssqnEnum"
        tipoRetencaoIssqn:
          $ref: "#/components/schemas/TipoRetencaoIssqnEnum"
        aliquotaIssqn:
          type: number
          description: Alíquota do ISSQN (pAliq) em %. Opcional.
          format: double
          nullable: true
        codigoPaisResultado:
          type: string
          description: Código do país onde ocorreu o resultado do serviço (cPaisResult —
            Tabela ISO). Informar quando TributacaoIssqn = ExportacaoServico.
          nullable: true
        tipoImunidade:
          $ref: "#/components/schemas/TipoImunidadeNfseModelEnum"
        beneficioMunicipal:
          $ref: "#/components/schemas/BeneficioMunicipalNfseInputModel"
        tributosFederais:
          $ref: "#/components/schemas/TributosFederaisNfseModoTomadorInputModel"
      additionalProperties: false
      description: Valores do serviço prestado e tributação ISSQN para NFS-e no modo
        tomador.
    IbsCbsNfseInputModel:
      type: object
      properties:
        indDest:
          $ref: "#/components/schemas/IndDestIbsCbsNfseModelEnum"
        cIndOp:
          type: integer
          description: Código indicador da operação (cIndOp).
          format: int32
        cst:
          $ref: "#/components/schemas/CstIbsCbsNfseModelEnum"
        cClassTrib:
          type: string
          description: Código de classificação tributária (cClassTrib).
          nullable: true
        cCredPres:
          type: integer
          description: Código de crédito presumido (cCredPres). Opcional.
          format: int32
          nullable: true
        gTribRegularCstReg:
          type: integer
          description: CST da tributação regular (CSTReg). Opcional. Informar em conjunto
            com GTribRegularCClassTribReg.
          format: int32
          nullable: true
        gTribRegularCClassTribReg:
          type: string
          description: Código de classificação tributária regular (cClassTribReg).
            Opcional. Informar em conjunto com GTribRegularCstReg.
          nullable: true
        destinatario:
          $ref: "#/components/schemas/DestinatarioIbsCbsNfseInputModel"
      additionalProperties: false
      description: >-
        Dados de tributação do IBS (Imposto sobre Bens e Serviços) e CBS
        (Contribuição sobre Bens e Serviços)

        da reforma tributária para a NFS-e. Obrigatório para Lucro Real e Lucro
        Presumido; opcional para Simples Nacional e MEI.
    MensagemNfseViewModel:
      type: object
      properties:
        codigo:
          type: string
          description: Código da mensagem.
          nullable: true
        descricao:
          type: string
          description: Descrição da mensagem.
          nullable: true
        complemento:
          type: string
          description: Complemento da mensagem.
          nullable: true
      additionalProperties: false
      description: Mensagem de processamento retornada pelo ADN.
    MotivoSubstituicaoNfseModelEnum:
      enum:
        - DesenquadramentoSimplesNacional
        - EnquadramentoSimplesNacional
        - InclusaoRetroativaImunidadeIsencao
        - ExclusaoRetroativaImunidadeIsencao
        - RejeicaoPeloTomadorOuIntermediario
        - Outros
      type: string
      description: Código do motivo da substituição de uma NFS-e (cMotivo).
    TipoDocumentoPrestadorNfseModelEnum:
      enum:
        - Cnpj
        - Cpf
        - Nif
        - CodigoNaoNif
      type: string
      description: Tipo de documento de identificação do prestador de serviços na NFS-e.
    OpcaoSimpleNacionalNfseEnum:
      enum:
        - NaoOptante
        - OptanteMeEppAcimaLimite
        - OptanteMicroempresaAteSubLimite
      type: string
    RegimeEspecialTributacaoNfseEnum:
      enum:
        - Nenhum
        - MicroempresaMunicipal
        - Estimativa
        - SociedadeProfissionais
        - Cooperativa
        - Mei
        - MeEppSimplesNacional
      type: string
    EnderecoPrestadorNfseInputModel:
      type: object
      properties:
        logradouro:
          type: string
          description: Tipo e nome do logradouro do endereço do prestador. Opcional.
          nullable: true
        numero:
          type: string
          description: Número no logradouro do endereço do prestador. Opcional.
          nullable: true
        complemento:
          type: string
          description: Complemento do endereço do prestador. Opcional.
          nullable: true
        bairro:
          type: string
          description: Bairro do endereço do prestador. Opcional.
          nullable: true
        codigoMunicipio:
          type: string
          description: Código do município do endereço do prestador (7 dígitos IBGE). Usar
            para endereço nacional.
          nullable: true
        cep:
          type: string
          description: CEP do endereço do prestador (8 dígitos, sem hífen). Usar para
            endereço nacional.
          nullable: true
        codigoPais:
          type: string
          description: Código do país do endereço do prestador (Tabela ISO — até 4 chars).
            Usar para endereço no exterior.
          nullable: true
        codigoPostalExterior:
          type: string
          description: Código postal alfanumérico no exterior. Opcional.
          nullable: true
        cidadeExterior:
          type: string
          description: Nome da cidade no exterior. Opcional.
          nullable: true
        estadoExterior:
          type: string
          description: Estado, província ou região no exterior. Opcional.
          nullable: true
      additionalProperties: false
      description: >-
        Endereço do prestador de serviços.

        Preencher os campos nacionais (CodigoMunicipio + Cep) OU os campos do
        exterior (CodigoPais + demais), nunca ambos.
    TributacaoIssqnEnum:
      enum:
        - OperacaoTributavel
        - Imunidade
        - ExportacaoServico
        - NaoIncidencia
      type: string
    TipoRetencaoIssqnEnum:
      enum:
        - NaoRetido
        - RetidoPeloTomador
        - RetidoPeloIntermediario
      type: string
    TipoImunidadeNfseModelEnum:
      enum:
        - NaoInformado
        - PatrimonioRendaOuServicos
        - EntidadesReligiosas
        - PartidosSindicatosEducacaoAssistencia
        - LivrosJornaisPeriodicos
        - FontogramasVideofonogramas
      type: string
      description: |-
        Tipo de imunidade do ISSQN (tpImunidade).
        Informar somente quando TributacaoIssqn = Imunidade.
    BeneficioMunicipalNfseInputModel:
      type: object
      properties:
        numeroBeneficio:
          type: string
          description: >-
            Identificador único do benefício municipal (nBM — 14 dígitos).

            Formação: 7 dígitos (código IBGE do município) + 2 dígitos (tipo de
            parametrização:

            01=legislação, 02=regimes especiais, 03=retenções, 04=outros
            benefícios) +

            5 dígitos (número sequencial do parâmetro no sistema).
          nullable: true
        valorReducaoBaseCalculo:
          type: number
          description: Valor monetário de redução da base de cálculo do ISSQN (vRedBCBM)
            em R$. Opcional. Mutuamente exclusivo com
            PercentualReducaoBaseCalculo.
          format: double
          nullable: true
        percentualReducaoBaseCalculo:
          type: number
          description: Percentual de redução da base de cálculo do ISSQN (pRedBCBM) em %.
            Opcional. Mutuamente exclusivo com ValorReducaoBaseCalculo.
          format: double
          nullable: true
      additionalProperties: false
      description: Benefício Municipal parametrizado pelo município de incidência do
        ISSQN (BM).
    TributosFederaisNfseModoTomadorInputModel:
      type: object
      properties:
        pisCofins:
          $ref: "#/components/schemas/PisCofinsNfseModoTomadorInputModel"
        valorRetencaoCP:
          type: number
          description: Valor de retenção de Contribuição Previdenciária (vRetCP) em R$.
            Opcional.
          format: double
          nullable: true
        valorRetencaoIRRF:
          type: number
          description: Valor de retenção do IRRF (vRetIRRF) em R$. Opcional.
          format: double
          nullable: true
        valorRetencaoCSLL:
          type: number
          description: Valor de retenção da CSLL (vRetCSLL) em R$. Opcional.
          format: double
          nullable: true
      additionalProperties: false
      description: |-
        Tributação federal (tribFed) para NFS-e no modo tomador.
        Obrigatório para emissores de Lucro Real e Lucro Presumido.
        Não deve ser preenchido para emissores do Simples Nacional e MEI.
    IndDestIbsCbsNfseModelEnum:
      enum:
        - Tomador
        - Outro
      type: string
      description: Indicador a respeito do destinatário dos serviços (indDest) no
        IBS/CBS da NFS-e.
    CstIbsCbsNfseModelEnum:
      enum:
        - Cst000
        - Cst200
        - Cst400
        - Cst410
        - Cst510
        - Cst515
        - Cst550
        - Cst620
        - Cst800
        - Cst810
        - Cst811
        - Cst820
      type: string
      description: Código de Situação Tributária (CST) do IBS/CBS na NFS-e.
    DestinatarioIbsCbsNfseInputModel:
      type: object
      properties:
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoDestinatarioIbsCbsNfseModelEnum"
        documento:
          type: string
          description: Documento de identificação do destinatário (CNPJ, CPF, NIF ou
            código cNaoNIF como string).
          nullable: true
        nome:
          type: string
          description: Nome / razão social do destinatário. Opcional.
          nullable: true
        telefone:
          type: string
          description: Telefone do destinatário. Opcional.
          nullable: true
        email:
          type: string
          description: E-mail do destinatário. Opcional.
          nullable: true
        endereco:
          $ref: "#/components/schemas/EnderecoDestinatarioIbsCbsNfseInputModel"
      additionalProperties: false
      description: Destinatário para fins do IBS/CBS na NFS-e (dest). Obrigatório
        quando IndDest for Outro.
    PisCofinsNfseModoTomadorInputModel:
      type: object
      properties:
        cst:
          $ref: "#/components/schemas/CstPisCofinsNfseModoTomadorModelEnum"
        baseCalculoPisCofins:
          type: number
          description: Valor da Base de Cálculo do PIS/COFINS (vBCPisCofins) em R$.
            Opcional.
          format: double
          nullable: true
        aliquotaPis:
          type: number
          description: Alíquota do PIS (pAliqPis) em %. Opcional.
          format: double
          nullable: true
        aliquotaCofins:
          type: number
          description: Alíquota da COFINS (pAliqCofins) em %. Opcional.
          format: double
          nullable: true
        valorPis:
          type: number
          description: Valor do débito de PIS (vPis) em R$. Opcional.
          format: double
          nullable: true
        valorCofins:
          type: number
          description: Valor do débito de COFINS (vCofins) em R$. Opcional.
          format: double
          nullable: true
        tipoRetencaoPisCofins:
          $ref: "#/components/schemas/TipoRetencaoPisCofinsNfseModelEnum"
      additionalProperties: false
      description: Informações PIS/COFINS (piscofins) para NFS-e no modo tomador.
    TipoDocumentoDestinatarioIbsCbsNfseModelEnum:
      enum:
        - Cpf
        - Cnpj
        - Nif
        - CodigoNaoNif
      type: string
      description: Tipo de documento de identificação do destinatário do IBS/CBS na NFS-e.
    EnderecoDestinatarioIbsCbsNfseInputModel:
      type: object
      properties:
        codigoMunicipio:
          type: string
          description: Código do município (7 dígitos IBGE). Informar para destinatário
            brasileiro.
          nullable: true
        cep:
          type: string
          description: CEP (8 dígitos). Informar para destinatário brasileiro.
          nullable: true
        logradouro:
          type: string
          description: Logradouro (rua, avenida etc.).
          nullable: true
        numero:
          type: string
          description: Número do endereço.
          nullable: true
        complemento:
          type: string
          description: Complemento do endereço.
          nullable: true
        bairro:
          type: string
          description: Bairro.
          nullable: true
        codigoPais:
          type: string
          description: 'Código do país (tabela BACEN). Ex.: "1058" para o Brasil.'
          nullable: true
        codigoPostalExterior:
          type: string
          description: Código postal de destinatário no exterior.
          nullable: true
        cidadeExterior:
          type: string
          description: Nome da cidade no exterior.
          nullable: true
        estadoExterior:
          type: string
          description: Nome do estado/província no exterior.
          nullable: true
      additionalProperties: false
      description: Endereço do destinatário para fins do IBS/CBS na NFS-e. Todos os
        campos são opcionais.
    CstPisCofinsNfseModoTomadorModelEnum:
      enum:
        - "00"
        - "50"
        - "51"
        - "52"
        - "53"
        - "54"
        - "55"
        - "56"
        - "60"
        - "61"
        - "62"
        - "63"
        - "64"
        - "65"
        - "66"
        - "67"
        - "70"
        - "71"
        - "72"
        - "73"
        - "74"
        - "75"
        - "98"
        - "99"
      type: string
      description: CST de PIS/COFINS para NFS-e no modo tomador — CSTs de entrada/crédito.
    TipoRetencaoPisCofinsNfseModelEnum:
      enum:
        - NaoRetidos
        - PisCofinsRetido
        - PisCofinsNaoRetido
        - PisCofinsCSLLRetidos
        - PisCofinsRetidosCSLLNaoRetido
        - PisRetidoCofinsCSLLNaoRetido
        - CofinsRetidoPisCSLLNaoRetido
        - PisNaoRetidoCofinsCSLLRetidos
        - PisCofinsNaoRetidosCSLLRetido
        - CofinsNaoRetidoPisCSLLRetidos
      type: string
      description: Tipo de retenção PIS/COFINS e CSLL (tpRetPisCofins).
  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
```