rnfse 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b7d0978da0b4e417d2b68c42d43a7020357c75fd
-  data.tar.gz: eb5d2a24ee286fac30c8e295bd2f445f1a790a34
+  metadata.gz: e4a798eb55d0f7e2c930c5140085200a1653e3d2
+  data.tar.gz: 3f7057a92a3a5675c1df0b9c6b10f25ac97cf29e
 SHA512:
-  metadata.gz: 48a7f94a739fbb5f44fc700e6ccea7a4f41a3f23417921ae55b460ab8215e2c7827b5d9229e551f84fdee9429635ea8a936266fbd642a078af02f970c658e00d
-  data.tar.gz: d3b908f3a22e937ebcd65e3bc631ca22c81ec52ad07b7bfb95b5e77f49c6e140b8a201788ad0a70fb71af7551c5302f5036a3f1fef5bc1d82633cb832bfc6481
+  metadata.gz: e101457c59da02568f66d3a8b697f2ce2fc4b4550dbde9fd4ab004c6a90ea6b0965c39fa22ef2ddf37bf6a1c96a40c98a5bdefb37f5139bf4043a61150088a98
+  data.tar.gz: dce4fd87fc0458f7a937e24af4959d07d37f8d6550a8286a5c2366e0941f661ba021f5c7f26d44533074e26ef203567eca2893ab28f7670166d4f0a73086e64d

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.3.0 @ 2014-07-18
+* Adequando melhor ao versionamento semântico
+* Implementando consultar_situacao_lote_rps e consultar_lote_rps
+
 ## 0.0.2 @ 2014-07-11
 * BUGFIX ao usar o provedor ISS.net utilizar a api iss_net_1_0
 

data/README.md

@@ -1,8 +1,8 @@
 # rnfse
-[![Gem Version](http://img.shields.io/gem/v/rnfse.svg?style=flat)](http://rubygems.org/gems/rnfse)
-[![Dependency Status](https://img.shields.io/gemnasium/aitherios/rnfse.svg?style=flat)](https://gemnasium.com/aitherios/rnfse)
-[![Build Status](https://img.shields.io/travis/aitherios/rnfse.svg?style=flat)](https://travis-ci.org/aitherios/rnfse)
-[![Coverage](https://img.shields.io/codeclimate/coverage/github/aitherios/rnfse.svg?style=flat)](https://codeclimate.com/github/aitherios/rnfse)
+[![Gem Version](http://img.shields.io/gem/v/rnfse.svg?style=flat-square)](http://rubygems.org/gems/rnfse)
+[![Dependency Status](http://img.shields.io/gemnasium/aitherios/rnfse.svg?style=flat-square)](https://gemnasium.com/aitherios/rnfse)
+[![Build Status](http://img.shields.io/travis/aitherios/rnfse.svg?style=flat-square)](https://travis-ci.org/aitherios/rnfse)
+[![Coverage](http://img.shields.io/codeclimate/coverage/github/aitherios/rnfse.svg?style=flat-square)](https://codeclimate.com/github/aitherios/rnfse)
 
 Biblioteca para integração com as várias implementações
 municipais de Nota Fiscal de Serviços eletrônica (NFS-e) que utilizam uma 
@@ -15,11 +15,11 @@ das versões ou variações dos padrões
 ## Instalação
 
 Usando o rubygems.org rode:
-```
+```shell
 $ gem install rnfse
 ```
 **Ou** usando o repositório git rode:
-```
+```shell
 $ gem build rnfse.gemspec
 $ gem install rnfse-X.X.X.gem
 ```
@@ -39,6 +39,7 @@ Esta é uma lista de limitações e problemas conhecidos. São questões que nã
 plano imediato de resolução. Talvez porque a funcionalidade nunca foi 
 necessária ou nenhum pull request tenha sido enviado. (dica!)
 
+- Sem documentação =/
 - Suporte para o JRuby e Rubinius (problema com a dependência nokogiri-xmlsec1).
 - Só foi testada com municípios inscritos no [ISS.net](http://www.issnetonline.com.br/portaliss/) que utilizam o padrão [ABRASF v1](http://www.abrasf.org.br/paginas_multiplas_detalhes.php?cod_pagina=1).
 

data/lib/provedores.yml

@@ -3,9 +3,17 @@ producao:
     namespace: http://www.issnetonline.com.br/webservice/nfd
     endpoint: http://www.issnetonline.com.br/webserviceabrasf/%{municipio}/servicos.asmx
     api: iss_net_1_0
+  speed_gov:
+    namespace: http://ws.speedgov.com.br/
+    endpoint: http://www.speedgov.com.br/ws%{municipio}/Nfes
+    api: speed_gov_1_0
 
 homologacao:
   iss_net:
     namespace: http://www.issnetonline.com.br/webservice/nfd
     endpoint: http://www.issnetonline.com.br/webserviceabrasf/homologacao/servicos.asmx
     api: iss_net_1_0
+  speed_gov:
+    namespace: http://ws.speedgov.com.br/
+    endpoint: http://speedgov.com.br/wsmod/Nfes
+    api: speed_gov_1_0

data/lib/rnfse.rb

@@ -6,9 +6,11 @@ require 'json-schema'
 require 'gyoku'
 require 'nokogiri-xmlsec1'
 require 'savon'
+require 'cgi'
 
-require 'rnfse/core'
 require 'rnfse/version'
+require 'rnfse/error'
+require 'rnfse/core'
 require 'rnfse/configuration'
 require 'rnfse/hash'
 require 'rnfse/string'
@@ -17,7 +19,9 @@ require 'rnfse/call_chain'
 require 'rnfse/api'
 require 'rnfse/api/abrasf_1_0'
 require 'rnfse/api/iss_net_1_0'
+require 'rnfse/api/speed_gov_1_0'
 
 require 'rnfse/xml_builder'
 require 'rnfse/xml_builder/abrasf_1_0'
 require 'rnfse/xml_builder/iss_net_1_0'
+require 'rnfse/xml_builder/speed_gov_1_0'

data/lib/rnfse/api.rb

@@ -14,52 +14,70 @@ module Rnfse
 
     def initialize(options = {})
       options = load_options(options)
-      
-      file = Pathname.new(File.expand_path('../..', __FILE__))
-      provedores = YAML.load_file(file.join('provedores.yml'))
-      
+            
       case
       when has_options(options, 'provedor', 'homologacao')
         provedor = provedores['homologacao'][options['provedor'].to_s]
         raise ArgumentError, 'provedor de homologação inexistente', caller if provedor.nil?
-        self.namespace = provedor['namespace']
-        self.endpoint = provedor['endpoint']
         self.api = provedor['api']
+        load_options_method = :load_options_for_staging
 
       when has_options(options, 'provedor', 'municipio')
         provedor = provedores['producao'][options['provedor'].to_s]
         raise ArgumentError, 'provedor inexistente', caller if provedor.nil?
-        self.namespace = provedor['namespace']
-        self.endpoint = provedor['endpoint'] % { municipio: options['municipio'] }
         self.api = provedor['api']
+        load_options_method = :load_options_for_production
 
       when has_options(options, 'padrao', 'namespace', 'endpoint')
-        self.namespace = options['namespace'].to_s
-        self.endpoint = options['endpoint'].to_s
         self.api = options['padrao'].to_s
+        load_options_method = :load_options_for_custom
 
       else
         raise ArgumentError, 'opções inválidas', caller
       end
 
-      if has_options(options, 'certificate', 'key')
-        self.certificate = options['certificate']
-        self.key = options['key']
-      else
-        raise ArgumentError, 'opções de assinatura digital faltando', caller
-      end
+      extend self.class.const_get(String.camelize(self.api))
+
+      self.send(load_options_method, options)
+    end
+
+    private
+
+    def load_options_for_custom(options)
+      self.namespace = options['namespace'].to_s
+      self.endpoint = options['endpoint'].to_s
+      load_default_options(options)
+    end
+
+    def load_options_for_production(options)
+      provedor = provedores['producao'][options['provedor'].to_s]
+      self.namespace = provedor['namespace']
+      self.endpoint = provedor['endpoint'] % { municipio: options['municipio'] }
+      load_default_options(options)
+    end
 
+    def load_options_for_staging(options)
+      provedor = provedores['homologacao'][options['provedor'].to_s]
+      self.namespace = provedor['namespace']
+      self.endpoint = provedor['endpoint']
+      load_default_options(options)
+    end
+
+    def load_default_options(options)
+      self.certificate = options['certificate']
+      self.key = options['key']
       self.verbose = options['verbose'] || false
       self.xml_builder = options['xml_builder'] || XMLBuilder.new(padrao: self.api)
       self.soap_client = options['soap_client'] || savon_client
-
-      extend self.class.const_get(String.camelize(self.api))
     end
 
-    private
+    def provedores
+      file = Pathname.new(File.expand_path('../..', __FILE__))
+      YAML.load_file(file.join('provedores.yml'))
+    end
 
-    def savon_client
-      savon_hash = {
+    def savon_client_options
+      {
         soap_version: 2,
         env_namespace: :soap,
         namespace_identifier: nil,
@@ -69,11 +87,15 @@ module Rnfse
         endpoint: self.endpoint,
         namespace: self.namespace
       }
+    end
+
+    def savon_client
+      savon_hash = savon_client_options
 
       savon_hash = savon_hash.merge(
         log: true,
         log_level: :debug,
-        pretty_print_xml: true
+        pretty_print_xml: false
       ) if self.verbose
 
       Savon.client(savon_hash)

data/lib/rnfse/api/abrasf_1_0.rb

@@ -5,10 +5,29 @@ module Rnfse::API::Abrasf10
 
   module ClassMethods
 
+    def operations()
+      [ :recepcionar_lote_rps, :consultar_situacao_lote_rps, 
+        :consultar_nfse_por_rps, :consultar_nfse, :consultar_lote_rps,
+        :cancelar_nfse ]
+    end
+    
     def recepcionar_lote_rps(hash = {})
-      validate(hash)
-      xml = xml_builder.build_recepcionar_lote_rps_xml(hash)
-      xml.sign!(certificate: File.read(self.certificate), key: File.read(self.key))
+      validate_sign_options
+      validate_options(hash)
+      xml = xml_builder.build_recepcionar_lote_rps_xml(hash) do |inner_xml|
+        regex = /<tc:Rps>.*<\/tc:Rps>/
+        plain_xml = inner_xml.to_xml(
+          save_with: Nokogiri::XML::Node::SaveOptions::NO_DECLARATION).strip
+        signed_rps = Nokogiri::XML(
+                       plain_xml.match(regex)[0]).
+                     sign!(
+                       certificate: File.read(self.certificate), 
+                       key: File.read(self.key)).
+                     to_xml(
+                       save_with: Nokogiri::XML::Node::SaveOptions::NO_DECLARATION).
+                     strip
+        plain_xml.gsub(regex, signed_rps)
+      end
       response = self.soap_client.call(
         :recepcionar_lote_rps,
         soap_action: 'RecepcionarLoteRps',
@@ -17,8 +36,41 @@ module Rnfse::API::Abrasf10
       parse_response(response)
     end
 
+    def consultar_situacao_lote_rps(hash = {})
+      validate_options(hash)
+      xml = xml_builder.build_consultar_situacao_lote_rps_xml(hash)
+      response = self.soap_client.call(
+        :consultar_situacao_lote_rps,
+        soap_action: 'ConsultarSituacaoLoteRps',
+        message_tag: 'ConsultarSituacaoLoteRps',
+        message: { :'xml!' => "<![CDATA[#{xml}]]>" })
+      parse_response(response)
+    end
+
+    def consultar_nfse_por_rps(hash = {})
+      validate_options(hash)
+      xml = xml_builder.build_consultar_nfse_por_rps_xml(hash)
+      response = self.soap_client.call(
+        :consultar_nfse_por_rps,
+        soap_action: 'ConsultarNfsePorRps',
+        message_tag: 'ConsultarNfsePorRps',
+        message: { :'xml!' => "<![CDATA[#{xml}]]>" })
+      parse_response(response)
+    end
+
+    def consultar_nfse(hash = {})
+      validate_options(hash)
+      xml = xml_builder.build_consultar_nfse_xml(hash)
+      response = self.soap_client.call(
+        :consultar_nfse,
+        soap_action: 'ConsultarNfse',
+        message_tag: 'ConsultarNfse',
+        message: { :'xml!' => "<![CDATA[#{xml}]]>" })
+      parse_response(response)
+    end
+
     def consultar_lote_rps(hash = {})
-      validate(hash)
+      validate_options(hash)
       xml = xml_builder.build_consultar_lote_rps_xml(hash)
       response = self.soap_client.call(
         :consultar_lote_rps,
@@ -28,21 +80,32 @@ module Rnfse::API::Abrasf10
       parse_response(response)
     end
 
-    def consultar_situacao_lote_rps(hash = {})
-      validate(hash)
-      xml = xml_builder.build_consultar_situacao_lote_rps_xml(hash)
+    def cancelar_nfse(hash = {})
+      validate_options(hash)
+      xml = xml_builder.build_cancelar_nfse_xml(hash) do |inner_xml|
+        inner_xml.sign!(certificate: File.read(self.certificate), key: File.read(self.key))
+        inner_xml.to_xml(save_with: Nokogiri::XML::Node::SaveOptions::NO_DECLARATION).strip
+      end
       response = self.soap_client.call(
-        :consultar_situacao_lote_rps,
-        soap_action: 'ConsultarSituacaoLoteRps',
-        message_tag: 'ConsultarSituacaoLoteRps',
+        :cancelar_nfse,
+        soap_action: 'CancelarNfse',
+        message_tag: 'CancelarNfse',
         message: { :'xml!' => "<![CDATA[#{xml}]]>" })
       parse_response(response)
     end
 
     private
 
-    def validate(hash)
-      file = get_filepath("#{Rnfse::CallChain.caller_method}.json")
+    def validate_sign_options
+      if self.certificate.nil? or self.key.nil?
+        raise ArgumentError, 'opções de assinatura digital ' <<
+                             '(certificate e key) ao criar ' <<
+                             'o Rnfse::API faltando', caller
+      end
+    end
+
+    def validate_options(hash)
+      file = json_filepath("#{Rnfse::CallChain.caller_method}.json")
       json = Rnfse::Hash.camelize_and_symbolize_keys(hash, false).to_json
       errors = JSON::Validator.fully_validate(file, json)
       raise ArgumentError, errors, caller unless errors.empty?
@@ -50,17 +113,37 @@ module Rnfse::API::Abrasf10
 
     def parse_response(response)
       hash = Rnfse::Hash.new(response.body)
-      response_key = hash.keys.select { |k| k =~ /response$/ }.first
-      result_key = hash[response_key].keys.select { |k| k =~ /result$/ }.first
-      if !hash[response_key].nil? and hash[response_key]
+
+      response_key = hash.keys.select { |k| k =~ /response$/ }
+      response_key = response_key.first unless response_key.nil?
+
+      if hash[response_key]
+        result_key = hash[response_key].keys.select { |k| k =~ /result$/ }
+        result_key = result_key.first unless result_key.nil?
+      else
+        result_key = nil
+      end
+
+      if response_key and result_key
         xml = hash[response_key][result_key]
         hash[response_key][result_key] = Nori.new.parse(xml)
       end
       hash.underscore_and_symbolize_keys
     end
 
-    def get_filepath(filename)
-      File.join(File.expand_path(File.dirname(__FILE__)), 'abrasf_1_0', filename)
+    def json_folder
+      'abrasf_1_0'
+    end
+
+    def json_filepath(filename)
+      result = nil
+      folders = ['abrasf_1_0']
+      folders = folders.unshift(json_folder) unless folders.include?(json_folder)
+      folders.each do |folder|
+        path = File.join(File.expand_path(File.dirname(__FILE__)), folder, filename)
+        result = path if File.exists?(path)
+      end
+      result
     end
 
   end

data/lib/rnfse/api/abrasf_1_0/#definitions.json#

@@ -0,0 +1,413 @@
+{
+  "numeroNfse": {
+    "description": "Número da Nota Fiscal de Serviço Eletrônica, formado pelo ano com 04 (quatro) dígitos e um número seqüencial com 11 posições – Formato AAAANNNNNNNNNNN.",
+    "type": "integer",
+    "minimum": 190000000000000,
+    "maximum": 220099999999999
+  },
+   "codigoVerificacao": {
+    "description": "Código de verificação do número da nota",
+    "type": "string",
+    "maxLength": 9
+  },
+  "statusRps": {
+    "description": "Código de status do RPS 1 – Normal ; 2 – Cancelado",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 2
+  },
+  "statusNfse": {
+    "description": "Código de status da NFS-e 1 – Normal ; 2 – Cancelado",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 2
+  },
+  "naturezaOperacao": {
+    "description": "Código de natureza da operação 1 – Tributação no município ; 2 - Tributação fora do município ; 3 - Isenção ; 4 - Imune ; 5 – Exigibilidade suspensa por decisão judicial ; 6 – Exigibilidade suspensa por procedimento administrativo ",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 6
+  },
+  "regimeEspecialTributacao": {
+    "description": "Código de natureza da operação 1 – Tributação no município ; 2 - Tributação fora do município ; 3 - Isenção ; 4 - Imune ; 5 – Exigibilidade suspensa por decisão judicial ; 6 – Exigibilidade suspensa por procedimento administrativo ",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 6
+  },
+  "simNao": {
+    "type": "boolean"
+  },
+  "quantidadeRps": {
+    "description": "Quantidade de RPS do Lote",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 9999
+  },
+  "numeroRps": {
+    "description": "Número do RPS",
+    "type": "integer",
+    "minimum": 0,
+    "maximum": 999999999999999
+  },
+  "serieRps": {
+    "description": "Número de série do RPS",
+    "type": "string",
+    "maxLength": 5
+  },
+  "tipoRps": {
+    "description": "Código de tipo de RPS 1 - RPS ; 2 – Nota Fiscal Conjugada (Mista) ; 3 – Cupom",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 3
+  },
+  "outrasInformacoes": {
+    "description": "Informações adicionais ao documento",
+    "type": "string",
+    "maxLength": 255
+  },
+  "valor": {
+    "description": "Valor monetário. Formato: 0.00 (ponto separando casa decimal) Ex: 1.234,56 = 1234.56 ; 1.000,00 = 1000.00 ; 1.000,00 = 1000",
+    "type": "number",
+    "minimum": 0,
+    "maximum": 9999999999999.99
+  },
+  "itemListaServico": {
+    "description": "Código de item da lista de serviço",
+    "type": "string",
+    "maxLength": 5
+  },
+  "codigoCnae": {
+    "description": "Código CNAE. Formato: 0000-0/00",
+    "type": "string",
+    "pattern": "^[0-9]{4}-[0-9]{1}/[0-9]{2}$"
+  },
+  "codigoTributacao": {
+    "description": "Código de Tributação",
+    "type": "string",
+    "maxLength": 20
+  },
+  "aliquota": {
+    "description": "Alíquota. Valor percentual. Formato: 0.0000 Ex: 1% = 0.01 ; 25,5% = 0.255 ; 100% = 1.0000 ou 1",
+    "type": "numeric",
+    "minimum": 0,
+    "maximum": 1
+  },
+  "discriminacao": {
+    "description": "Discriminação do conteúdo da NFS-e",
+    "type": "string",
+    "maxLength": 2000
+  },
+  "codigoMunicipioIbge": {
+    "description": "Código de identificação do município conforme tabela do IBGE",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 9999999
+  },
+  "inscricaoMunicipal": {
+    "description": "Número de inscrição municipal",
+    "type": "string",
+    "maxLength": 15
+  },
+  "razaoSocial": {
+    "description": "Razão Social do contribuinte",
+    "type": "string",
+    "maxLength": 115
+  },
+  "nomeFantasia": {
+    "description": "Nome fantasia",
+    "type": "string",
+    "maxLength": 60
+  },
+  "cnpj": {
+    "description": "Número CNPJ. Formato: 00.000.000/0000-00",
+    "type": "string",
+    "pattern": "^[0-9]{2}\.[0-9]{3}\.[0-9]{3}/[0-9]{4}-[0-9]{2}$"
+  },
+  "endereco": {
+    "description": "Endereço",
+    "type": "string",
+    "maxLength": 125
+  },
+  "numeroEndereco": {
+    "description": "Número do endereço",
+    "type": "string",
+    "maxLength": 10
+  },
+  "complementoEndereco": {
+    "description": "Número do endereço",
+    "type": "string",
+    "maxLength": 60
+  },
+  "bairro": {
+    "description": "Bairro",
+    "type": "string",
+    "maxLength": 60
+  },
+  "uf": {
+    "description": "Sigla da unidade federativa",
+    "type": "string",
+    "enum": ["AC", "AL", "AP", "AM", "BA", "CE", "DF", "ES", "GO", "MA", "MT", "MS", "MG", "PA", "PB", "PR", "PE", "PI", "RJ", "RN", "RS", "RO", "RR", "SC", "SP", "SE", "TO"]
+  },
+  "cep": {
+    "description": "Número do CEP. Formato: 00000-000",
+    "type": "string",
+    "pattern": "^[0-9]{5}-[0-9]{3}$"
+  },
+  "email": {
+    "description": "E-mail",
+    "type": "string",
+    "format": "email"
+  },
+  "telefone": {
+    "description": "Telefone",
+    "type": "string",
+    "maxLength": 11
+  },
+  "cpf": {
+    "description": "Número de CPF. Formato: 000.000.000-00",
+    "type": "string",
+    "pattern": "^[0-9]{3}\.[0-9]{3}\.[0-9]{3}-[0-9]{2}$"
+  },
+  "indicacaoCpfCnpj": {
+    "description": "Indicador de uso de CPF ou CNPJ 1 – CPF ; 2 – CNPJ ; 3 – Não Informado",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 3
+  },
+  "codigoObra": {
+    "description": "Código de Obra",
+    "type": "string",
+    "maxLength": 15
+  },
+  "art": {
+    "description": "Código ART",
+    "type": "string",
+    "maxLength": 15
+  },
+  "numeroLote": {
+    "description": "Número do Lote de RPS",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 999999999999999
+  },
+  "numeroProtocolo": {
+    "description": "Número do protocolo de recebimento do RPS",
+    "type": "string",
+    "maxLength": 50
+  },
+  "situacaoLoteRps": {
+    "description": "Código de situação de lote de RPS 1 – Não Recebido ; 2 – Não Processado ; 3 – Processado com Erro ; 4 – Processado com Sucesso",
+    "type": "integer",
+    "minimum": 1,
+    "maximum": 4
+  },
+  "codigoMensagemAlerta": {
+    "description": "Código de mensagem de retorno de serviço",
+    "type": "string",
+    "maxLength": 4
+  },
+  "descricaoMensagemAlerta": {
+    "description": "Descrição da mensagem de retorno de serviço",
+    "type": "string",
+    "maxLength": 200
+  },
+  "codigoCancelamentoNfse": {
+    "description": "Código de cancelamento com base na tabela de Erros e alertas",
+    "type": "string",
+    "maxLength": 4
+  },
+  "idTag": {
+    "description": "Atributo de identificação da tag a ser assinada no documento XML",
+    "type": "string",
+    "maxLength": 255
+  },
+  "identificacaoRps": {
+    "description": "Dados de identificação do RPS",
+    "type": "object",
+    "properties": {
+      "numero": { "$ref": "#/numeroRps" },
+      "serie": { "$ref": "#/serieRps" },
+      "tipo": { "$ref": "#/tipoRps" }
+    },
+    "required": ["numero", "serie", "tipo"],
+    "additionalProperties": false
+  },
+  "dadosServico": {
+    "description": "Representa dados que compõe o serviço prestado",
+    "type": "object",
+    "properties": {
+      "valores": {
+        "type": "object",
+        "properties": {
+          "valorServicos": { "$ref": "#/valor" },
+          "valorDeducoes": { "$ref": "#/valor" },
+          "valorPis": { "$ref": "#/valor" },
+          "valorCofins": { "$ref": "#/valor" },
+          "valorInss": { "$ref": "#/valor" },
+          "valorIr": { "$ref": "#/valor" },
+          "valorCsll": { "$ref": "#/valor" },
+          "issRetido": { "type": "boolean" },
+          "valorIss": { "$ref": "#/valor" },
+          "outrasRetencoes": { "$ref": "#/valor" },
+          "baseCalculo": {
+            "description": "(Valor dos serviços - Valor das deduções - descontos incondicionados)",
+            "$ref": "#/valor" 
+          },
+          "aliquota": { "$ref": "#/aliquota" },
+          "valorLiquidoNfse": { 
+            "description": "(ValorServicos - ValorPIS - ValorCOFINS - ValorINSS - ValorIR - ValorCSLL - OutrasRetençoes - ValorISSRetido - DescontoIncondicionado - DescontoCondicionado)",
+            "$ref": "#/valor" 
+          },
+          "valorIssRetido": { "$ref": "#/valor" },
+          "descontoCondicionado": { "$ref": "#/valor" },
+          "descontoIncondicionado": { "$ref": "#/valor" }
+        },
+        "required": ["valorServicos", "issRetido", "baseCalculo"],
+        "additionalProperties": false
+      },
+      "itemListaServico": { "$ref": "#/itemListaServico" },
+      "codigoCnae": { "$ref": "#/codigoCnae" },
+      "codigoTributacaoMunicipio": { "$ref": "#/codigoTributacao" },
+      "discriminacao": { "$ref": "#/discriminacao" },
+      "codigoMunicipio": { "$ref": "#/codigoMunicipioIbge" }
+    },
+    "required": ["valores", "itemListaServico", "discriminacao", "codigoMunicipio"],
+    "additionalProperties": false
+  },
+  "identificacaoPrestador": {
+    "description": "Representa dados para identificação do prestador de serviço",
+    "oneOf": [
+      {
+        "type": "object",
+        "properties": {
+          "inscricaoMunicipal": { "$ref": "#/inscricaoMunicipal" },
+          "cnpj": { "$ref": "#/cnpj" }
+        },
+        "required": ["cnpj"],
+        "additionalProperties": false
+      },
+      {
+        "type": "object",
+        "properties": {
+          "inscricaoMunicipal": { "$ref": "#/inscricaoMunicipal" },
+          "cpf": { "$ref": "#/cpf" }
+        },
+        "required": ["cpf"],
+        "additionalProperties": false
+      }
+    ]
+  },
+  "dadosTomador": {
+    "description": "Representa dados do tomador de serviço",
+    "type": "object",
+    "properties": {
+      "identificacaoTomador": { "$ref": "#/identificacaoTomador" },
+      "razaoSocial": { "$ref": "#/razaoSocial" },
+      "endereco": { "$ref": "#/enderecoCompleto" },
+      "contato": { "$ref": "#/contato" }
+    },
+    "additionalProperties": false
+  },
+  "identificacaoTomador": {
+    "description": "Representa dados para identificação do tomador de serviço",
+    "oneOf": [
+      {
+        "type": "object",
+        "properties": {
+          "inscricaoMunicipal": { "$ref": "#/inscricaoMunicipal" },
+          "cnpj": { "$ref": "#/cnpj" }
+        },
+        "additionalProperties": false
+      },
+      {
+        "type": "object",
+        "properties": {
+          "cpf": { "$ref": "#/cpf" }
+        },
+        "additionalProperties": false
+      }
+    ]
+  },
+  "enderecoCompleto": {
+    "description": "Representação completa do endereço.",
+    "type": "object",
+    "properties": {
+      "endereco": { "$ref": "#/endereco" },
+      "numero": { "$ref": "#/numeroEndereco" },
+      "complemento": { "$ref": "#/complementoEndereco" },
+      "bairro": { "$ref": "#/bairro" },
+      "codigoMunicipio": { "$ref": "#/codigoMunicipioIbge" },
+      "uf": { "$ref": "#/uf" },
+      "cep": { "$ref": "#/cep" }
+    },
+    "required": [],
+    "additionalProperties": false
+  },
+  "contato": {
+    "description": "Representa forma de contato com a pessoa (física/jurídica)",
+    "type": "object",
+    "properties": {
+      "telefone": { "$ref": "#/telefone" },
+      "email": { "$ref": "#/email" }
+    },
+    "required": [],
+    "additionalProperties": false
+  },
+  "identificacaoIntermediarioServico": {
+    "description": "Representa dados para identificação de intermediário do serviço",
+    "oneOf": [
+      {
+        "type": "object",
+        "properties": {
+          "razaoSocial": { "$ref": "#/razaoSocial" },
+          "cnpj": { "$ref": "#/cnpj" },
+          "inscricaoMunicipal": { "$ref": "#/inscricaoMunicipal" }
+        },
+        "required": ["razaoSocial", "cnpj"],
+        "additionalProperties": false
+      },
+      {
+        "type": "object",
+        "properties": {
+          "razaoSocial": { "$ref": "#/razaoSocial" },
+          "cpf": { "$ref": "#/cpf" },
+          "inscricaoMunicipal": { "$ref": "#/inscricaoMunicipal" }
+        },
+        "required": ["cpf"],
+        "additionalProperties": false
+      }
+    ]
+  },
+  "dadosConstrucaoCivil": {
+    "description": "Representa dados para identificação de intermediário do serviço",
+    "type": "object",
+    "properties": {
+      "codigoObra": { "$ref": "#/codigoObra" },
+      "art": { "$ref": "#/art" }
+    },
+    "required": [],
+    "additionalProperties": false
+  },
+  "data": {
+    "description": "Data como representada no padrão RFC 3339 section 5.6",
+    "type": "string",
+    "format": "date-time"
+  },
+  "codigoCancelamentoNfse": {
+    "description": "Código de cancelamento com base na tabela de erros e alertas",
+    "type": "string",
+    "maxLength": 4
+  },
+  "identificacaoNfse": {
+    "description": "Representa dados que identificam uma Nota Fiscal de Serviços Eletrônica",
+    "type": "object",
+    "properties": {
+      "numero": { "$ref": "#/numeroNfse" },
+      "cnpj": { "$ref": "#/cnpj" },
+      "inscricaoMunicipal": { "$ref": "#/inscricaoMunicipal" },
+      "codigoMunicipio": { "$ref": "#/codigoMunicipioIbge" },      
+    },
+    "required": ["numero", "cnpj"],
+    "additionalProperties": false
+  }
+}