correios_sigep 0.2.4 → 0.2.5

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZGUyY2U0NTg5N2FmZmRjNDk4NzcyZTRlYzIxYTM1ZjY4OTI1ZTY0Ng==
+    NGI0YjllYmVmNWNmMjI5MmEzYjdkOWQ3MDc4Yzc0ZmEwY2QzNzZlNA==
   data.tar.gz: !binary |-
-    NGE1NDdjNGUzM2VjZDExYmI1ZDMwNDUzNzBjN2VhYzNjNGU5ZDg1Mw==
+    NmRkZDgxODAyYzYxMzY5MTMzMDVlZDNhMzk2ZDYxYjhmNzgxMjMzMA==
 SHA512:
   metadata.gz: !binary |-
-    ZTUwNmQyZWYwNDEzYThiMDI2MGVkZTg5Nzc3NWRiYjdmYmRkMjdjNWEzNTk2
-    ZGQ1ZDgwZDE3M2U2OTIyZjlhZTY1OGIyMWM4ZjQ0OWFiNDZjMWQxYTk0NTE4
-    OGNmMDM5MzYxNDgyY2ExZjA3YjFkMjRjYjNmNzZhZThhMzNjNTY=
+    ZGFiOTMwMDRmMmJkNzE2MDMxNjg5OGM5YzQ1NmE0NDUzZDc5ZGY2ZDY2ZDg3
+    ZGYyOTM2YjY3YWZlODViNjRkYWZlMGY0MWJkOTc0ZmYwNDA1OTI1NjNlMzUw
+    YzQwOTEyZDE2ODk5YmQ5OGU3MDZjYjVmZWY5NTM4MWYwZjE1Yzg=
   data.tar.gz: !binary |-
-    ZjEyOTFmNjc3NDZkNzk0NzljMTViMzA5NjFhNzYwZDI2MzI4ZjNmZDViN2Iz
-    MjcyOWQyZmNjN2FmMWE3MDRkY2QyMWM1YzAzN2E5MTI1NjljZGEzYjUwZmNh
-    ZjZmNGM4ODFkMjNkNjUyNjAyYTI5OGM1Y2U0MTVmNGEwMTk1ZDA=
+    OWY2ZTFhNDBhZTJjOTdiODUyM2NhYzNkMTU4MWQ4ZGVmMTQzZTBkYzg1ZmIy
+    YjFhY2VjMTkyZDc4NWRhOTViNTc3NWE4MjM2NGM2NjBmYTUxZjQ5YTgwZDIy
+    Y2E5NGM1YTczMjI2ZTA0NmZiMTk0YmJjZTAyMzYxY2FkODEwODM=

data/README.md

@@ -26,9 +26,114 @@ Ou instale manualmente com:
 
     $ gem install correios_sigep
 
+## Utilizando
+
+### Configurando
+Para utilizar a gem, é necessário configurar os campos necessários com base nos dados contrato com os Correios.
+
+```ruby
+CorreiosSigep.configure do |config|
+  config.user                   = '60618043'
+  config.password               = '8o8otn'
+  config.administrative_code    = '08082650'
+  config.card                   = '0057018901'
+  config.contract               = '9912208555'
+  config.service_code           = '41076'
+end
+```
+
+Se for necessário, é possível adicionar também um proxy.
+
+```ruby
+  config.proxy = 'http://px.myproxy.com'
+```
+
+### Logistica Reversa
+
+#### Solicitar Postagem Reversa
+(pg. 36 da documentação)
+
+```ruby
+  recipient = CorreiosSigep::Models::Recipient.new({
+    address: 'Endereco',
+    area_code: 'DDD',
+    city: 'Cidade',
+    complement: 'Complemento',
+    email: 'Email',
+    name: 'Nome',
+    neighborhood: 'Bairro',
+    number: 'Numero',
+    phone: 'Telefone',
+    postal_code: 'CEP',
+    reference: 'Referencia',
+    state: 'Estado'
+  })
+  sender    = CorreiosSigep::Models::Sender.new({
+    address: 'Endereco',
+    area_code: 'DDD',
+    city: 'Cidade',
+    complement: 'Complemento',
+    email: 'Email',
+    name: 'Nome',
+    neighborhood: 'Bairro',
+    number: 'Numero',
+    phone: 'Telefone',
+    postal_code: 'CEP',
+    reference: 'Referencia',
+    state: 'Estado'
+  })
+  objects   = [
+    {
+      item: 'Item',
+      id: '1',
+      description: 'Descricao',
+      num: '',
+    },
+    {
+      item: 'Item',
+      id: '2',
+      description: 'Descricao',
+      num: '',
+    }
+  ]
+
+  # Produto: pag 67 da documentação oficial dos correios
+  product   = CorreiosSigep::Models::Product.new({
+    code: '116600403',
+    type: '0',
+    quantity: 1
+  })
+  collect   = CorreiosSigep::Models::Collect.new({
+    aditional_service: '10.00',
+    ag: '5',
+    ar: '1',
+    card: '',
+    checklist: '2',
+    client_id: '102030',
+    declared_value: '1000.00',
+    description: 'Descricao',
+    number: '',
+    type: 'A'
+  }.merge(sender: sender, objects: objects, product: product))
+
+  logistic_reverse = CorreiosSigep::Models::LogisticReverse.new(recipient: recipient, collect: collect)
+  collect_number = CorreiosSigep::LogisticReverse::RequestCollectNumber.new(logistic_reverse).process
+
+```
+
+#### Possíveis erros mapeados
+```ruby
+TICKET_ALREADY_USED                   = 195 # NÚMERO DE E-TICKET JÁ UTILIZA
+UNAVAILABLE_SERVICE                   = 210 # SERVIÇO INDISPONÍVEL NO MOMENTO
+INEXISTENT_ZIPCODE                    = 113 # CEP DO DESTINATÁRIO INEXISTENTE
+UNAVAILABLE_HOUSE_COLLECT             = 111 # COLETA DOMICILIAR NÃO DISPONÍVEL PARA O SERVIÇO SEDEX 10
+COLLECT_NOT_ANSWERED_FOR_THE_ZIPCODE  = 117 # CEP DO REMETENTE INEXISTENTE
+NOT_CONFIGURED_CLIENT                 = 105 # CLIENTE NÃO CONFIGURADO PARA USAR O SISTEMA
+```
+
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/correios_sigep/fork )
+1. Fork it ( https://github.com/duduribeiro/correios_sigep/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)

data/lib/correios_sigep/logistic_reverse/request_collect_number.rb

@@ -51,8 +51,8 @@ module CorreiosSigep
           raise Models::Errors::NotConfiguredClient.new error_message
 
         else
-          error_message = result_node.search('//msg-erro | //msg_erro').text
-          invalid_xml_message = response_doc.search("//return").text
+          error_message = result_node.search('//msg-erro | //msg_erro').text rescue ''
+          invalid_xml_message = response_doc.search("//return").text rescue ''
 
           raise Models::Errors::UnknownError.new [error_message, invalid_xml_message].join(', ')
         end

data/lib/correios_sigep/version.rb

@@ -1,3 +1,3 @@
 module CorreiosSigep
-  VERSION = '0.2.4'
+  VERSION = '0.2.5'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: correios_sigep
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.5
 platform: ruby
 authors:
 - Carlos Ribeiro
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-17 00:00:00.000000000 Z
+date: 2015-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: savon