upwork-api 1.0.0

data/lib/upwork/api/routers/organization/teams.rb

@@ -0,0 +1,49 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      module Organization
+        # Teams inside Organization
+        class Teams
+          ENTRY_POINT = 'api'
+          
+          # Init
+          #
+          # Arguments:
+          #  client: (Client)
+          def initialize(client)
+            @client = client
+            @client.epoint = ENTRY_POINT 
+          end
+          
+          # Get Teams info
+          def get_list
+            $LOG.i "running " + __method__.to_s
+            @client.get '/hr/v2/teams'
+          end
+          
+          # Get Users in Team
+          #
+          # Arguments:
+          #  team_reference: (String)
+          def get_users_in_team(team_reference)
+            $LOG.i "running " + __method__.to_s
+            @client.get '/hr/v2/teams/' + team_reference + '/users'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/upwork/api/routers/organization/users.rb

@@ -0,0 +1,49 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      module Organization
+        # Users inside Organization
+        class Users
+          ENTRY_POINT = 'api'
+          
+          # Init
+          #
+          # Arguments:
+          #  client: (Client)
+          def initialize(client)
+            @client = client
+            @client.epoint = ENTRY_POINT 
+          end
+          
+          # Get Auth User Info
+          def get_my_info
+            $LOG.i "running " + __method__.to_s
+            @client.get '/hr/v2/users/me'
+          end
+          
+          # Get Specific User Info
+          #
+          # Arguments:
+          #  user_reference: (String)
+          def get_specific(user_reference)
+            $LOG.i "running " + __method__.to_s
+            @client.get '/hr/v2/users/' + user_reference
+          end
+        end
+      end
+    end
+  end
+end

data/lib/upwork/api/routers/payments.rb

@@ -0,0 +1,42 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      # Custom Payments
+      class Payments
+        ENTRY_POINT = 'api'
+        
+        # Init
+        #
+        # Arguments:
+        #  client: (Client)
+        def initialize(client)
+          @client = client
+          @client.epoint = ENTRY_POINT 
+        end
+        
+        # Submit bonus
+        #
+        # Arguments:
+        #  team_reference: (String)
+        #  params: (Hash)
+        def submit_bonus(team_reference, params)
+          $LOG.i "running " + __method__.to_s
+          @client.post '/hr/v2/teams/' + team_reference + '/adjustments', params
+        end
+      end
+    end
+  end
+end

data/lib/upwork/api/routers/reports/finance/accounts.rb

@@ -0,0 +1,56 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      module Reports
+        module Finance
+          # Generate Financial Reports for Accounts
+          class Accounts
+            ENTRY_POINT = 'gds'
+            
+            # Init
+            #
+            # Arguments:
+            #  client: (Client)
+            def initialize(client)
+              @client = client
+              @client.epoint = ENTRY_POINT 
+            end
+            
+            # Generate Financial Reports for an owned Account
+            #
+            # Arguments:
+            #  freelancer_reference: (String)
+            #  params: (Hash)
+            def get_owned(freelancer_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/financial_account_owner/' + freelancer_reference, params
+            end
+            
+            # Generate Financial Reports for a Specific Account
+            #
+            # Arguments:
+            #  entity_reference: (String)
+            #  params: (Hash)
+            def get_specific(entity_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/financial_accounts/' + entity_reference, params
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/upwork/api/routers/reports/finance/billings.rb

@@ -0,0 +1,86 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      module Reports
+        module Finance
+          # Generate Billing Reports
+          class Billings
+            ENTRY_POINT = 'gds'
+            
+            # Init
+            #
+            # Arguments:
+            #  client: (Client)
+            def initialize(client)
+              @client = client
+              @client.epoint = ENTRY_POINT 
+            end
+            
+            # Generate Billing Reports for a Specific Freelancer
+            #
+            # Arguments:
+            #  freelancer_reference: (String)
+            #  params: (Hash)
+            def get_by_freelancer(freelancer_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/providers/' + freelancer_reference + '/billings', params
+            end
+            
+            # Generate Billing Reports for a Specific Freelancer's Team
+            #
+            # Arguments:
+            #  freelancer_team_reference: (String)
+            #  params: (Hash)
+            def get_by_freelancers_team(freelancer_team_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/provider_teams/' + freelancer_team_reference + '/billings', params
+            end
+            
+            # Generate Billing Reports for a Specific Freelancer's Company
+            #
+            # Arguments:
+            #  freelancer_company_reference: (String)
+            #  params: (Hash)
+            def get_by_freelancers_company(freelancer_company_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/provider_companies/' + freelancer_company_reference + '/billings', params
+            end
+            
+            # Generate Billing Reports for a Specific Buyer's Team
+            #
+            # Arguments:
+            #  buyer_team_reference: (String)
+            #  params: (Hash)
+            def get_by_buyers_team(buyer_team_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/buyer_teams/' + buyer_team_reference + '/billings', params
+            end
+            
+            # Generate Billing Reports for a Specific Buyer's Company
+            #
+            # Arguments:
+            #  buyer_company_reference: (String)
+            #  params: (Hash)
+            def get_by_buyers_company(buyer_company_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/buyer_companies/' + buyer_company_reference + '/billings', params
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/upwork/api/routers/reports/finance/earnings.rb

@@ -0,0 +1,86 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      module Reports
+        module Finance
+          # Generate Earning Reports
+          class Earnings
+            ENTRY_POINT = 'gds'
+            
+            # Init
+            #
+            # Arguments:
+            #  client: (Client)
+            def initialize(client)
+              @client = client
+              @client.epoint = ENTRY_POINT 
+            end
+            
+            # Generate Earning Reports for a Specific Freelancer
+            #
+            # Arguments:
+            #  freelancer_reference: (String)
+            #  params: (Hash)
+            def get_by_freelancer(freelancer_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/providers/' + freelancer_reference + '/earnings', params
+            end
+            
+            # Generate Earning Reports for a Specific Freelancer's Team
+            #
+            # Arguments:
+            #  freelancer_team_reference: (String)
+            #  params: (Hash)
+            def get_by_freelancers_team(freelancer_team_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/provider_teams/' + freelancer_team_reference + '/earnings', params
+            end
+            
+            # Generate Earning Reports for a Specific Freelancer's Company
+            #
+            # Arguments:
+            #  freelancer_company_reference: (String)
+            #  params: (Hash)
+            def get_by_freelancers_company(freelancer_company_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/provider_companies/' + freelancer_company_reference + '/earnings', params
+            end
+            
+            # Generate Earning Reports for a Specific Buyer's Team
+            #
+            # Arguments:
+            #  buyer_team_reference: (String)
+            #  params: (Hash)
+            def get_by_buyers_team(buyer_team_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/buyer_teams/' + buyer_team_reference + '/earnings', params
+            end
+            
+            # Generate Earning Reports for a Specific Buyer's Company
+            #
+            # Arguments:
+            #  buyer_company_reference: (String)
+            #  params: (Hash)
+            def get_by_buyers_company(buyer_company_reference, params)
+              $LOG.i "running " + __method__.to_s
+              @client.get '/finreports/v2/buyer_companies/' + buyer_company_reference + '/earnings', params
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/upwork/api/routers/reports/time.rb

@@ -0,0 +1,114 @@
+# Licensed under the Upwork's API Terms of Use;
+# you may not use this file except in compliance with the Terms.
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author::    Maksym Novozhylov (mnovozhilov@upwork.com)
+# Copyright:: Copyright 2014(c) Upwork.com
+# License::   See LICENSE.txt and TOS - https://developers.upwork.com/api-tos.html
+
+module Upwork
+  module Api
+    module Routers
+      module Reports
+        # Time reports
+        class Time
+          ENTRY_POINT = 'gds'
+          
+          # Init
+          #
+          # Arguments:
+          #  client: (Client)
+          def initialize(client)
+            @client = client
+            @client.epoint = ENTRY_POINT 
+          end
+          
+          # Generate Time Reports for a Specific Team (with financial info)
+          #
+          # Arguments:
+          #  company: (String)
+          #  team: (String)
+          #  params: (Hash)
+          def get_by_team_full(company, team, params)
+            $LOG.i "running " + __method__.to_s
+            get_by_type(company, team, nil, params, false)
+          end
+          
+          # Generate Time Reports for a Specific Team (hide financial info)
+          #
+          # Arguments:
+          #  company: (String)
+          #  team: (String)
+          #  params: (Hash)
+          def get_by_team_limited(company, team, params)
+            $LOG.i "running " + __method__.to_s
+            get_by_type(company, team, nil, params, true)
+          end
+          
+          # Generating Agency Specific Reports
+          #
+          # Arguments:
+          #  company: (String)
+          #  agency: (String)
+          #  params: (Hash)
+          def get_by_agency(company, agency, params)
+            $LOG.i "running " + __method__.to_s
+            get_by_type(company, nil, agency, params, false)
+          end
+          
+          # Generating Company Wide Reports
+          #
+          # Arguments:
+          #  company: (String)
+          #  params: (Hash)
+          def get_by_company(company, params)
+            $LOG.i "running " + __method__.to_s
+            get_by_type(company, nil, nil, params, false)
+          end
+          
+          # Generating Freelancer's Specific Reports (hide financial info)
+          #
+          # Arguments:
+          #  freelancer_id: (String)
+          #  params: (Hash)
+          def get_by_freelancer_limited(freelancer_id, params)
+            $LOG.i "running " + __method__.to_s
+            @client.get '/timereports/v1/providers/' + freelancer_id, params
+          end
+          
+          # Generating Freelancer's Specific Reports (with financial info)
+          #
+          # Arguments:
+          #  freelancer_id: (String)
+          #  params: (Hash)
+          def get_by_freelancer_full(freelancer_id, params)
+            $LOG.i "running " + __method__.to_s
+            @client.get '/timereports/v1/providers/' + freelancer_id, params
+          end
+          
+          private
+          
+          def get_by_type(company, team, agency, params, hide_fin_data)
+            $LOG.i "running " + __method__.to_s
+            url = '';
+            if (team != nil)
+                url = '/teams/' + team;
+                if (hide_fin_data)
+                    url = url + '/hours';
+                end
+            elsif (agency != nil)
+                url = '/agencies/' + agency
+            end
+    
+            @client.get '/timereports/v1/companies/' + company + url, params
+          end
+        end
+      end
+    end
+  end
+end