deliveries 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2102df4101cad8142a4673ee79f2d18994309db3e7a5d70ea03281abb4d9c5c5
-  data.tar.gz: 7ffe9bf7dd2546132118c6e1d028cc36f216eb7e2eaad34b6543f76d4090452a
+  metadata.gz: bb252635f57203e34b0d593df80f4fc0aa033ebfb70675f646cf192fc946a647
+  data.tar.gz: 6e232ea5c543aaeaf298e618f2f97b7192b04b6de72f45de3204b1f2f4ab1d3f
 SHA512:
-  metadata.gz: 44eee42b323ffea42bbdb8d963a69084d5f9196b0b92fa3078954411bbf1e6d22a5e5229564edf53deefebc21cd6ab6e1a05cade53e80c83b214f1b7d4eb7e48
-  data.tar.gz: 7c07fb3e9f88692391d806b18960720f22cf1339574f335c10bce33cef2f14a123ea1ca5fe8cc116d2f5c5ffbee953861851cfacc85dd2a538353af93dad52f9
+  metadata.gz: 75e7cd7e1b1380f0b889d91515e7f356f5847b24106e98487c4b2cc1b1a907da87dfee8c184f29d7c6ffb6c9d89398b06d3ab30a67ee8535330a2263ff989a58
+  data.tar.gz: f09ac1de09045873b6a8e0f91d31e011f7b7a232c4924d6b391f9b87b99d40dc62d1d0923b00c8fd96138df8dccda169f80669f259664d974dca47a8952dbb77

data/.github/workflows/main.yml

@@ -1,19 +1,26 @@
 name: Ruby
 
-on: [push,pull_request]
+on: [push, pull_request]
 
 jobs:
   build:
     runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [2.6, 2.7, '3.0']
+
     steps:
     - uses: actions/checkout@v2
-    - name: Set up Ruby
+    - name: Install poppler-utils
+      run: sudo apt-get install poppler-utils
+    - name: Set up Ruby ${{ matrix.ruby }}
       uses: ruby/setup-ruby@v1
       with:
-        ruby-version: 2.6.7
+        ruby-version: ${{ matrix.ruby }}
     - name: Run the default task
       run: |
-        sudo apt-get install poppler-utils
         gem install bundler -v 2.2.4
         bundle install
         bundle exec rake

data/CHANGELOG.md

@@ -6,8 +6,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2021-11-26
+### Added
+- Envialia courier integration
+
+## [0.2.1] - 2021-11-04
+### Fixed
+- Field `clienteRecogida` must have the same value as `codDest` in Correos Express pickup.
+
+## [0.2.0] - 2021-11-03
+### Added
+- `Address` can now include a custom id for couriers that support it (currently only Correos Express).
+
+## [0.1.1] - 2021-10-11
+### Fixed
+- Fix keyword parameter passing to make it compatible with Ruby 3.0.
+
 ## [0.1.0] - 2021-09-27
 🎉 First release!
 
-[Unreleased]: https://github.com/ecommerce-ventures/deliveries/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/ecommerce-ventures/deliveries/releases/tag/v0.1.0
+[Unreleased]: https://github.com/ecommerce-ventures/deliveries/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/ecommerce-ventures/deliveries/compare/v0.2.1...v0.3.0
+[0.2.1]: https://github.com/ecommerce-ventures/deliveries/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/ecommerce-ventures/deliveries/compare/v0.1.1...v0.2.0
+[0.1.1]: https://github.com/ecommerce-ventures/deliveries/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/ecommerce-ventures/deliveries/releases/tag/v0.1.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    deliveries (0.1.0)
+    deliveries (0.3.0)
       activesupport (>= 5.2.0)
       hexapdf
       httparty
@@ -12,7 +12,7 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.1.4)
+    activesupport (6.1.4.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
@@ -35,49 +35,49 @@ GEM
     gyoku (1.3.1)
       builder (>= 2.1.2)
     hashdiff (1.0.1)
-    hexapdf (0.15.8)
+    hexapdf (0.19.0)
       cmdparse (~> 3.0, >= 3.0.3)
       geom2d (~> 0.3)
-    httparty (0.18.1)
+    httparty (0.20.0)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
-    httpi (2.4.5)
+    httpi (2.5.0)
       rack
       socksify
-    i18n (1.8.10)
+    i18n (1.8.11)
       concurrent-ruby (~> 1.0)
-    mime-types (3.3.1)
+    mime-types (3.4.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2021.0704)
+    mime-types-data (3.2021.1115)
     mini_magick (4.11.0)
     minitest (5.14.4)
     multi_xml (0.6.0)
-    nokogiri (1.12.3-x86_64-linux)
+    nokogiri (1.12.5-x86_64-linux)
       racc (~> 1.4)
     nori (2.6.0)
-    parallel (1.20.1)
+    parallel (1.21.0)
     parser (3.0.2.0)
       ast (~> 2.4.1)
     public_suffix (4.0.6)
-    racc (1.5.2)
+    racc (1.6.0)
     rack (2.2.3)
     rainbow (3.0.0)
     rake (13.0.6)
     regexp_parser (2.1.1)
     rexml (3.2.5)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.3)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.4)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.4)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
     rubocop (0.93.1)
       parallel (~> 1.10)
       parser (>= 2.7.1.5)
@@ -87,7 +87,7 @@ GEM
       rubocop-ast (>= 0.6.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (1.10.0)
+    rubocop-ast (1.12.0)
       parser (>= 3.0.1.1)
     ruby-progressbar (1.11.0)
     savon (2.12.1)
@@ -101,7 +101,7 @@ GEM
     socksify (1.7.1)
     tzinfo (2.0.4)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (1.7.0)
+    unicode-display_width (1.8.0)
     wasabi (3.6.1)
       addressable
       httpi (~> 2.0)
@@ -110,7 +110,7 @@ GEM
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.4.2)
+    zeitwerk (2.5.1)
 
 PLATFORMS
   x86_64-linux

data/README.md

@@ -6,7 +6,7 @@ Deliveries is a gem that gives you the ability to integrate multiple shipping se
 
 Add the following line to your Gemfile
 
-```bash
+```ruby
 gem 'deliveries'
 ```
 Then run:
@@ -20,7 +20,7 @@ bundle install
 Each courier requires a different configuration, below we will leave some examples
 
 #### 1. Mondial Relay
-```bash
+```ruby
 Deliveries.courier(:mondial_relay).configure do |config|
   config.mondial_relay_merchant = '...'
   config.mondial_relay_key = '...'
@@ -28,7 +28,7 @@ end
 ```
 
 #### 2. Mondial Relay Dual
-```bash
+```ruby
 Deliveries.courier(:mondial_relay_dual).configure do |config|
   config.dual_carrier_login = '...'
   config.dual_carrier_password = '...'
@@ -48,7 +48,7 @@ end
 ```
 
 #### 3. Correos Express
-```bash
+```ruby
 Deliveries.courier(:correos_express).configure do |config|
   config.username = '...'
   config.password = '...'
@@ -67,7 +67,7 @@ end
 ```
 
 #### 4. Spring
-```bash
+```ruby
 Deliveries.courier(:spring).configure do |config|
   config.api_key = '...'
   config.countries = {
@@ -89,7 +89,7 @@ end
 ```
 
 #### 5. UPS
-```bash
+```ruby
 Deliveries.courier(:ups).configure do |config|
   config.license_number = '...'
   config.username = '...'
@@ -103,25 +103,36 @@ Deliveries.courier(:ups).configure do |config|
 end
 ```
 
+#### Time Zone
+
+This library uses Active Support's Time extension, so a time zone must be set before using it:
+
+```ruby
+require 'active_support/time'
+
+# Configure time zone
+Time.zone = 'Madrid'
+```
+
 ## Usage
 
 #### Get collection point by country and postcode
 
-```bash
+```ruby
 # Example Using Ups
 
 Deliveries.courier(:ups).get_collection_points(postcode: '...', country: 'it')
 ```
 #### Get collection point info
 
-```bash
+```ruby
 # Example Using Mondial Relay
 
 Deliveries.courier(:mondial_relay).get_collection_point(global_point_id: 'mondial_relay~fr~00000~XXXXXX')
 ```
 
 #### Create a Shipment
-```bash
+```ruby
 # Example Using Correos Express
 
 sender = Deliveries::Address.new(
@@ -158,7 +169,7 @@ response = Deliveries.courier(:correos_express).create_shipment(
 ```
 
 #### Create a Pickup
-```bash
+```ruby
 # Example Using Spring
 
 sender = Deliveries::Address.new(
@@ -193,7 +204,7 @@ response = Deliveries.courier(:spring).create_pickup(
 ```
 
 #### Download a Label
-```bash
+```ruby
 # Example Using Spring
 
 label = Deliveries.courier(:spring).get_label(tracking_code: '...')

data/deliveries.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
 
   spec.metadata['homepage_uri'] = spec.homepage
   spec.metadata['source_code_uri'] = 'https://github.com/ecommerce-ventures/deliveries'
-  spec.metadata['changelog_uri'] = 'https://github.com/ecommerce-ventures/deliveries/CHANGELOG.md'
+  spec.metadata['changelog_uri'] = 'https://github.com/ecommerce-ventures/deliveries/blob/master/CHANGELOG.md'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.

data/lib/deliveries/address.rb

@@ -1,6 +1,6 @@
 module Deliveries
   class Address
-    attr_accessor :name, :email, :phone, :country, :state, :city, :street, :postcode
+    attr_accessor :name, :email, :phone, :country, :state, :city, :street, :postcode, :address_id
 
     COUNTRY_PHONE_PREFIXES = {
       be: 32,
@@ -30,6 +30,7 @@ module Deliveries
       self.city = attributes[:city]
       self.street = attributes[:street]
       self.postcode = attributes[:postcode]
+      self.address_id = attributes[:address_id]
     end
 
     def courierize(courier_id)

data/lib/deliveries/couriers/correos_express/pickups/create/format_params.rb

@@ -24,8 +24,8 @@ module Deliveries
                 solicitante: CorreosExpress.config(:client_code),
                 refRecogida: reference_code,
                 fechaRecogida: pickup_date&.strftime('%d%m%Y') || '',
-                clienteRecogida: CorreosExpress.config(:pickup_receiver_code),
-                codRemit: '',
+                clienteRecogida: receiver.address_id || CorreosExpress.config(:pickup_receiver_code),
+                codRemit: sender.address_id || '',
                 nomRemit: sender.name,
                 nifRemit: '',
                 dirRecog: sender.street,
@@ -34,7 +34,7 @@ module Deliveries
                 contRecog: sender.name,
                 tlfnoRecog: sender.phone,
                 emailRecog: sender.email,
-                codDest: CorreosExpress.config(:pickup_receiver_code),
+                codDest: receiver.address_id || CorreosExpress.config(:pickup_receiver_code),
                 nomDest: receiver.name,
                 dirDest: receiver.street,
                 pobDest: receiver.city,

data/lib/deliveries/couriers/correos_express/shipments/create/format_params.rb

@@ -23,7 +23,7 @@ module Deliveries
             def execute
               params = {
                 solicitante: CorreosExpress.config(:client_code),
-                codRte: CorreosExpress.config(:shipment_sender_code),
+                codRte: sender.address_id || CorreosExpress.config(:shipment_sender_code),
                 ref: reference_code,
                 fecha: format_date(shipment_date),
                 nomRte: sender.name,
@@ -33,6 +33,7 @@ module Deliveries
                 contacRte: sender.name,
                 telefRte: sender.phone,
                 emailRte: sender.email,
+                codDest: receiver.address_id || '',
                 nomDest: receiver.name,
                 dirDest: receiver.street,
                 pobDest: receiver.city,

data/lib/deliveries/couriers/correos_express.rb

@@ -51,7 +51,7 @@ module Deliveries
         points = CollectionPoints::Search.new(postcode: postcode).execute
         points.each do |point|
           collection_point_params = CollectionPoints::Search::FormatResponse.new(response: point).execute
-          collection_points << Deliveries::CollectionPoint.new(collection_point_params)
+          collection_points << Deliveries::CollectionPoint.new(**collection_point_params)
         end
 
         collection_points
@@ -79,7 +79,7 @@ module Deliveries
         ).execute
 
         tracking_info_params = Shipments::Trace::FormatResponse.new(response: response).execute
-        Deliveries::TrackingInfo.new(tracking_info_params)
+        Deliveries::TrackingInfo.new(**tracking_info_params)
       end
 
       def pickup_info(tracking_code:, **)
@@ -89,7 +89,7 @@ module Deliveries
 
         tracking_info_params = Pickups::Trace::FormatResponse.new(response: response).execute
 
-        Deliveries::TrackingInfo.new(tracking_info_params)
+        Deliveries::TrackingInfo.new(**tracking_info_params)
       end
 
       def get_label(tracking_code:, **)

data/lib/deliveries/couriers/envialia/authentication.rb

@@ -0,0 +1,50 @@
+require 'httparty'
+
+module Deliveries
+  module Couriers
+    module Envialia
+      module Authentication
+        include HTTParty
+
+        def session_id
+          response = HTTParty.post(
+            login_endpoint,
+            body: login_body,
+            headers: login_headers,
+            debug_output: Deliveries.debug ? Deliveries.logger : nil
+          )
+
+          raise Deliveries::ClientError unless response.success?
+
+          response.dig('Envelope', 'Header', 'ROClientIDHeader', 'ID')
+        end
+
+        def login_body
+          <<~XML
+            <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
+              <soapenv:Body>
+                <tns:LoginWSService___LoginCli2 xmlns:tns="http://tempuri.org/">
+                  <strCodAge>#{Deliveries.courier(:envialia).config(:agency_code)}</strCodAge>
+                  <strCliente>#{Deliveries.courier(:envialia).config(:username)}</strCliente>
+                  <strPass>#{Deliveries.courier(:envialia).config(:password)}</strPass>
+                </tns:LoginWSService___LoginCli2>
+              </soapenv:Body>
+            </soapenv:Envelope>
+          XML
+        end
+
+        def login_headers
+          { 'Content-Type' => 'application/json;charset=UTF-8', 'Accept' => 'application/json' }
+        end
+
+        def login_endpoint
+          if Envialia.live?
+            Envialia::ENVIALIA_LOGIN_ENDPOINT_LIVE
+          else
+            Envialia::ENVIALIA_LOGIN_ENDPOINT_TEST
+          end
+        end
+      end
+    end
+  end
+end

data/lib/deliveries/couriers/envialia/labels/generate.rb

@@ -0,0 +1,88 @@
+require 'httparty'
+
+module Deliveries
+  module Couriers
+    module Envialia
+      module Labels
+        class Generate
+          include HTTParty
+          include Authentication
+
+          attr_accessor :tracking_codes
+
+          def initialize(tracking_codes:)
+            self.tracking_codes = tracking_codes.respond_to?(:each) ? tracking_codes : [tracking_codes]
+          end
+
+          def execute
+            decoded_labels = []
+
+            tracking_codes.each do |tracking_code|
+              response = self.class.post(
+                api_endpoint,
+                body: body(tracking_code),
+                headers: headers,
+                debug_output: Deliveries.debug ? Deliveries.logger : nil
+              )
+
+              raise Deliveries::ClientError unless response.success?
+
+              labels = response.dig('Envelope', 'Body', 'WebServService___ConsEtiquetaEnvio6Response', 'strEtiquetas')
+
+              if labels.blank?
+                raise Deliveries::APIError.new(
+                  'No hay etiqutas disponibles',
+                  404
+                )
+              else
+                decoded_labels << Base64.decode64(labels).force_encoding('binary')
+              end
+            end
+
+            decoded_labels
+          end
+
+          private
+
+          def body(tracking_code)
+            <<~XML
+              <?xml version="1.0" encoding="utf-8"?>
+              <soap:Envelope
+                xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+                <soap:Header>
+                  <ROClientIDHeader xmlns="http://tempuri.org/">
+                    <ID>#{session_id}</ID>
+                  </ROClientIDHeader>
+                </soap:Header>
+                <soap:Body>
+                  <WebServService___ConsEtiquetaEnvio6>
+                    <strCodAgeOri>#{Deliveries.courier(:envialia).config(:agency_code)}</strCodAgeOri>
+                    <strAlbaran>#{tracking_code}</strAlbaran>
+                    <strBulto></strBulto>
+                    <boPaginaA4>false</boPaginaA4>
+                    <intNumEtiqImpresasA4>0</intNumEtiqImpresasA4>
+                    <strFormato>PDF</strFormato>
+                  </WebServService___ConsEtiquetaEnvio6>
+                </soap:Body>
+              </soap:Envelope>
+            XML
+          end
+
+          def headers
+            { 'Content-Type' => 'application/json;charset=UTF-8', 'Accept' => 'application/json' }
+          end
+
+          def api_endpoint
+            if Envialia.live?
+              Envialia::ENVIALIA_ENDPOINT_LIVE
+            else
+              Envialia::ENVIALIA_ENDPOINT_TEST
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/deliveries/couriers/envialia/pickups/create.rb

@@ -0,0 +1,147 @@
+require 'httparty'
+
+module Deliveries
+  module Couriers
+    module Envialia
+      module Pickups
+        class Create
+          include HTTParty
+          include Authentication
+
+          attr_accessor :sender, :receiver, :parcels,
+                        :reference_code, :pickup_date, :remarks, :tracking_code
+
+          def initialize(sender:, receiver:, parcels:,
+                         reference_code:, pickup_date:, remarks:, tracking_code:)
+
+            self.sender = sender
+            self.receiver = receiver
+            self.parcels = parcels
+            self.reference_code = reference_code
+            self.pickup_date = pickup_date
+            self.remarks = remarks
+            self.tracking_code = tracking_code
+          end
+
+          def execute
+            response = self.class.post(
+              api_endpoint,
+              body: body,
+              headers: headers,
+              debug_output: Deliveries.debug ? Deliveries.logger : nil
+            )
+
+            raise Deliveries::ClientError unless response.success?
+
+            pickup_number = response.dig('Envelope', 'Body', 'WebServService___GrabaRecogida3Response', 'strCodOut')
+
+            if pickup_number
+              Deliveries::Pickup.new(
+                courier_id: 'envialia',
+                sender: sender,
+                receiver: receiver,
+                parcels: parcels,
+                reference_code: reference_code,
+                tracking_code: pickup_number,
+                pickup_date: pickup_date
+              )
+            else
+              exception = response.dig('Envelope', 'Body', 'Fault')
+
+              if exception['faultcode'].eql?('Exception')
+                exception_code, exception_str = exception['faultstring'].split(':')
+              else
+                exception_code = 400
+                exception_str = exception['faultstring']
+              end
+
+              raise Deliveries::APIError.new(
+                exception_str.strip,
+                exception_code.to_i
+              )
+            end
+          end
+
+          private
+
+          def body
+            <<~XML
+              <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+                <soap:Header>
+                <ROClientIDHeader xmlns="http://tempuri.org/">
+                  <ID>#{session_id}</ID>
+                </ROClientIDHeader>
+                </soap:Header>
+                <soap:Body>
+                <WebServService___GrabaRecogida3 xmlns="http://tempuri.org/">
+                  <strCod></strCod>
+                  <strAlbaran>#{tracking_code}</strAlbaran>
+                  <strCodAgeCargo>#{Deliveries.courier(:envialia).config(:agency_code)}</strCodAgeCargo>
+                  <strCodAgeOri></strCodAgeOri>
+                  <dtFecRec>#{pickup_date.strftime('%Y/%m/%d')}</dtFecRec>
+                  <strNomOri>#{sender.name}</strNomOri>
+                  <strPobOri>#{sender.city}</strPobOri>
+                  <strDirOri>#{sender.street}</strDirOri>
+                  <strCPOri>#{format_postcode(sender.postcode, sender.country)}</strCPOri>
+                  <strTlfOri>#{sender.phone}</strTlfOri>
+                  <strNomDes>#{receiver.name}</strNomDes>
+                  <strPobDes>#{receiver.city}</strPobDes>
+                  <strDirDes>#{receiver.street}</strDirDes>
+                  <strCPDes>#{format_postcode(receiver.postcode, receiver.country)}</strCPDes>
+                  <strTlfDes>#{receiver.phone}</strTlfDes>
+                  <strCodPais>#{receiver.country}</strCodPais>
+                  <intBul>#{parcels}</intBul>
+                  <strCodTipoServ>72</strCodTipoServ>
+                  <dPesoOri>0</dPesoOri>
+                  <dAltoOri>0</dAltoOri>
+                  <dAnchoOri>0</dAnchoOri>
+                  <dLargoOri>0</dLargoOri>
+                  <dReembolso>0</dReembolso>
+                  <dValor>0</dValor>
+                  <dAnticipo>0</dAnticipo>
+                  <dCobCli>0</dCobCli>
+                  <strObs>#{remarks}</strObs>
+                  <boSabado>false</boSabado>
+                  <boRetorno>false</boRetorno>
+                  <boGestOri>false</boGestOri>
+                  <boGestDes>false</boGestDes>
+                  <boAnulado>false</boAnulado>
+                  <boAcuse>false</boAcuse>
+                  <strRef>#{reference_code}</strRef>
+                  <dBaseImp>0</dBaseImp>
+                  <dImpuesto>0</dImpuesto>
+                  <boPorteDebCli>false</boPorteDebCli>
+                  <strDesDirEmails>#{receiver.email}</strDesDirEmails>
+                  <boCampo5>false</boCampo5>
+                  <boPagoDUAImp>false</boPagoDUAImp>
+                  <boPagoImpDes>false</boPagoImpDes>
+                </WebServService___GrabaRecogida3>
+              </soap:Body>
+              </soap:Envelope>
+            XML
+          end
+
+          def headers
+            { 'Content-Type' => 'application/json;charset=UTF-8', 'Accept' => 'application/json' }
+          end
+
+          def api_endpoint
+            if Envialia.live?
+              Envialia::ENVIALIA_ENDPOINT_LIVE
+            else
+              Envialia::ENVIALIA_ENDPOINT_TEST
+            end
+          end
+
+          def format_postcode(postcode, country)
+            if country.to_sym.downcase == :pt
+              postcode&.split('-')&.first
+            else
+              postcode
+            end
+          end
+        end
+      end
+    end
+  end
+end