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

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

# TomadorNfseInputModel

Dados do tomador de serviços (toma).

## 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:
    TipoDocumentoTomadorNfseModelEnum:
      enum:
        - Cpf
        - Cnpj
        - Nif
        - CodigoNaoNif
      type: string
      description: Tipo de documento de identificação do tomador de serviços na NFS-e.
    EnderecoTomadorNfseInputModel:
      type: object
      properties:
        logradouro:
          type: string
          description: Tipo e nome do logradouro do endereço do tomador. Opcional.
          nullable: true
        numero:
          type: string
          description: Número no logradouro do endereço do tomador. Opcional.
          nullable: true
        complemento:
          type: string
          description: Complemento do endereço do tomador. Opcional.
          nullable: true
        bairro:
          type: string
          description: Bairro do endereço do tomador. Opcional.
          nullable: true
        codigoMunicipio:
          type: string
          description: Código do município do endereço do tomador (7 dígitos IBGE). Usar
            para endereço nacional.
          nullable: true
        nomeMunicipio:
          type: string
          description: Nome do município.
          nullable: true
        uf:
          $ref: "#/components/schemas/UfExtNotaFiscalServicoModelEnum"
        cep:
          type: string
          description: CEP do endereço do tomador (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 tomador (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 tomador de serviços.

        Preencher os campos nacionais (CodigoMunicipio + Cep) OU os campos do
        exterior (CodigoPais + demais), nunca ambos.
    UfExtNotaFiscalServicoModelEnum:
      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
        - EX
      type: string
      description: Lista de Unidades Federativas para Nota Fiscal de Serviço incluindo
        exterior.
    TomadorNfseInputModel:
      required:
        - documento
        - endereco
        - nome
      type: object
      properties:
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoTomadorNfseModelEnum"
        documento:
          minLength: 1
          type: string
          description: >-
            Documento de identificação do tomador.

            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 tomador. Opcional.
          nullable: true
        nome:
          maxLength: 150
          minLength: 2
          type: string
          description: Nome / razão social do tomador.
        telefone:
          type: string
          description: Telefone do tomador. Opcional.
          nullable: true
        email:
          type: string
          description: E-mail do tomador. Opcional.
          nullable: true
        endereco:
          $ref: "#/components/schemas/EnderecoTomadorNfseInputModel"
      additionalProperties: false
      description: Dados do tomador de serviços (toma).
```