--- title: "EmitirNfseModoPrestadorInputModel" url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/schemas/EmitirNfseModoPrestadorInputModel" --- > Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md # EmitirNfseModoPrestadorInputModel Dados para emissão de uma Nota Fiscal de Serviço Eletrônica (NFS-e) no modo prestador. ## 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: 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). 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). 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. ValoresNfseModoPrestadorInputModel: 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/TributosFederaisNfseModoPrestadorInputModel" additionalProperties: false description: Valores do serviço prestado e tributação ISSQN para NFS-e no modo prestador. 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. MotivoSubstituicaoNfseModelEnum: enum: - DesenquadramentoSimplesNacional - EnquadramentoSimplesNacional - InclusaoRetroativaImunidadeIsencao - ExclusaoRetroativaImunidadeIsencao - RejeicaoPeloTomadorOuIntermediario - Outros type: string description: Código do motivo da substituição de uma NFS-e (cMotivo). 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. 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). TributosFederaisNfseModoPrestadorInputModel: type: object properties: pisCofins: $ref: "#/components/schemas/PisCofinsNfseModoPrestadorInputModel" 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 prestador. 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. 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. PisCofinsNfseModoPrestadorInputModel: type: object properties: cst: $ref: "#/components/schemas/CstPisCofinsNfseModoPrestadorModelEnum" 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 prestador. 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. CstPisCofinsNfseModoPrestadorModelEnum: enum: - "00" - "01" - "02" - "03" - "04" - "05" - "06" - "07" - 8 - 9 - "49" - "99" type: string description: CST de PIS/COFINS para NFS-e no modo prestador — CSTs de saída. TipoRetencaoPisCofinsNfseModelEnum: enum: - NaoRetidos - PisCofinsRetido - PisCofinsNaoRetido - PisCofinsCSLLRetidos - PisCofinsRetidosCSLLNaoRetido - PisRetidoCofinsCSLLNaoRetido - CofinsRetidoPisCSLLNaoRetido - PisNaoRetidoCofinsCSLLRetidos - PisCofinsNaoRetidosCSLLRetido - CofinsNaoRetidoPisCSLLRetidos type: string description: Tipo de retenção PIS/COFINS e CSLL (tpRetPisCofins). EmitirNfseModoPrestadorInputModel: required: - codigoErp - servico - tomador - 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" tomador: $ref: "#/components/schemas/TomadorNfseInputModel" servico: $ref: "#/components/schemas/ServicoNfseInputModel" valores: $ref: "#/components/schemas/ValoresNfseModoPrestadorInputModel" 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 prestador. ```