papierkram_api_client 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3ca301db014f077381022d10aa1a30faa6e192e9cfe77e933e6aa8b0cd2f0a2
-  data.tar.gz: 57c63278246aae9764e6ee60d9f8aaa3ed50d076ebee4a43da7f130bf35243cc
+  metadata.gz: e1b8b7a1214d098bc7b757e9e7025b4f7c59a3711031eeb1b25304498bf14c7d
+  data.tar.gz: c9eb2be1ecd5d58614348b53f8ba4b80f93f90ce6a4d981baf7bbe0f1aecd45d
 SHA512:
-  metadata.gz: 3ba2d768a34ddf446dcf1ded72ec06e91db2391a4ce344e80d49876846acd6d4fbe951513879b11cbafffd805727f77d29785257d7ab077dedc1cceb52c7e5bd
-  data.tar.gz: 2050971c4a484acd2b01e5d75bd4c38a35c85811ee9c1b4f7175392f4dc584d80ed2a5b5c245d608eb4e610142b7662ac408df5272049f0a8ca73ec1249b2b6c
+  metadata.gz: 970159a1f873b3115c19ff378e42aef86ae3d7488c17d7d53372c795378aa0100d7a0c13315c7a85ac4e91005c4a22bb66ce29e2302bc4b14942a9135fe0c70b
+  data.tar.gz: 0d62509c7594db275108218d4d777c5a509348a5c4d06d1002dd99755ad237ef6a9f233c038fb3e038d86f1ef18f2a278751120897973a46fe3608211afe2981

data/.rubocop.yml

@@ -33,7 +33,7 @@ Metrics/ParameterLists:
     - "lib/api/v1/**/*"
 
 Metrics/ClassLength:
-  Max: 150
+  Max: 250
   CountAsOne:
     - "array"
     - "hash"

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.4.0] - 2023-12-02
+
+### Changes (BREAKING! ⚠️)
+
+- [#92](https://github.com/simonneutert/papierkram_api_client/pull/92) changes how updating a company person works. [@simonneutert](https://github.com/simonneutert)
+
+### Added
+
+- [#90](https://github.com/simonneutert/papierkram_api_client/pull/90) crud ops for time_entries. [@simonneutert](https://github.com/simonneutert)
+- [#89](https://github.com/simonneutert/papierkram_api_client/pull/89) CRUD for tracker tasks. [@simonneutert](https://github.com/simonneutert)
+- [#88](https://github.com/simonneutert/papierkram_api_client/pull/88) Adds Income::PaymentTerm endpoints. [@simonneutert](https://github.com/simonneutert)
+
 ## [0.3.1] - 2023-10-05
 
 ### Updated

data/Gemfile

@@ -8,9 +8,9 @@ gemspec
 gem 'minitest', '~> 5.17'
 gem 'minitest-vcr', '~> 1.4'
 gem 'pry', '~> 0.14.2'
-gem 'rake', '~> 13.0'
-gem 'rubocop', '~> 1.56', require: false
-gem 'rubocop-minitest', '~> 0.32.2', require: false
+gem 'rake', '~> 13.1'
+gem 'rubocop', '~> 1.58', require: false
+gem 'rubocop-minitest', '~> 0.33.0', require: false
 gem 'rubocop-performance', '~> 1.19', require: false
 gem 'rubocop-rake', '~> 0.6.0', require: false
 gem 'vcr', '~> 6.2'

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    papierkram_api_client (0.3.1)
+    papierkram_api_client (0.4.0)
       faraday (~> 2.7)
-      httpx (>= 0.22.5, < 0.25.0)
+      httpx (>= 0.22.5, < 1.2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -11,20 +11,20 @@ GEM
     addressable (2.8.5)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
-    base64 (0.1.1)
+    base64 (0.2.0)
     coderay (1.1.3)
     crack (0.4.5)
       rexml
-    faraday (2.7.11)
+    faraday (2.7.12)
       base64
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
     faraday-net_http (3.0.2)
     hashdiff (1.0.1)
-    http-2-next (0.5.1)
-    httpx (0.24.6)
-      http-2-next (>= 0.4.1)
-    json (2.6.3)
+    http-2-next (1.0.1)
+    httpx (1.1.5)
+      http-2-next (>= 1.0.1)
+    json (2.7.0)
     language_server-protocol (3.17.0.3)
     method_source (1.0.0)
     minispec-metadata (2.0.0)
@@ -35,33 +35,32 @@ GEM
       minitest (>= 4.7.5)
       vcr (>= 2.9)
     parallel (1.23.0)
-    parser (3.2.2.3)
+    parser (3.2.2.4)
       ast (~> 2.4.1)
       racc
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     public_suffix (5.0.3)
-    racc (1.7.1)
+    racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.8.1)
+    rake (13.1.0)
+    regexp_parser (2.8.2)
     rexml (3.2.6)
-    rubocop (1.56.4)
-      base64 (~> 0.1.1)
+    rubocop (1.58.0)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.3)
+      parser (>= 3.2.2.4)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.29.0)
+    rubocop-ast (1.30.0)
       parser (>= 3.2.1.0)
-    rubocop-minitest (0.32.2)
+    rubocop-minitest (0.33.0)
       rubocop (>= 1.39, < 2.0)
     rubocop-performance (1.19.1)
       rubocop (>= 1.7.0, < 2.0)
@@ -87,13 +86,13 @@ DEPENDENCIES
   minitest-vcr (~> 1.4)
   papierkram_api_client!
   pry (~> 0.14.2)
-  rake (~> 13.0)
-  rubocop (~> 1.56)
-  rubocop-minitest (~> 0.32.2)
+  rake (~> 13.1)
+  rubocop (~> 1.58)
+  rubocop-minitest (~> 0.33.0)
   rubocop-performance (~> 1.19)
   rubocop-rake (~> 0.6.0)
   vcr (~> 6.2)
   webmock (~> 3.19)
 
 BUNDLED WITH
-   2.4.19
+   2.4.20

data/README.md

@@ -37,6 +37,7 @@ Schau bitte dort um alle Rückgabefelder/-werte zu checken, bis ich (oder du mit
 - [x] Expense::Voucher (Ausgabe Belege)
 - [x] Income::Estimate (Angebote)
 - [x] Income::Invoice (Rechnungen)
+- [x] Income::PaymentTerms (Zahlungsbedingungen)
 - [x] Income::Proposition (Waren / Dienstleistungen)
 - [x] Info
 - [x] Project (Projekte)
@@ -90,6 +91,9 @@ Ziele:
     - [alle Rechnungen](#alle-rechnungen)
     - [eine Rechnung](#eine-rechnung)
     - [eine Rechnung als PDF](#eine-rechnung-als-pdf)
+  - [Income::PaymentTerms (Zahlungsbedingungen)](#incomepaymentterms-zahlungsbedingungen)
+    - [eine Zahlungsbedingung](#eine-zahlungsbedingung)
+    - [alle Zahlungsbedingungen](#alle-zahlungsbedingungen)
   - [Income::Proposition (Waren / Dienstleistungen)](#incomeproposition-waren--dienstleistungen)
     - [alle Waren / Dienstleistungen](#alle-waren--dienstleistungen)
     - [eine Ware / Dienstleistung](#eine-ware--dienstleistung)
@@ -110,9 +114,19 @@ Ziele:
   - [Tracker::Task (Aufgabe)](#trackertask-aufgabe)
     - [alle Aufgaben](#alle-aufgaben)
     - [eine Aufgabe](#eine-aufgabe)
+    - [erstelle eine Aufgabe](#erstelle-eine-aufgabe)
+    - [aktualisiere eine Aufgabe](#aktualisiere-eine-aufgabe)
+    - [lösche eine Aufgabe](#lösche-eine-aufgabe)
+    - [archiviere eine Aufgabe](#archiviere-eine-aufgabe)
+    - [unarchiviere eine Aufgabe](#unarchiviere-eine-aufgabe)
   - [Tracker::TimeEntry (Zeiteintrag)](#trackertimeentry-zeiteintrag)
     - [alle Zeiteinträge](#alle-zeiteinträge)
     - [einen Zeiteintrag](#einen-zeiteintrag)
+    - [erstelle einen Zeiteintrag](#erstelle-einen-zeiteintrag)
+    - [aktualisiere einen Zeiteintrag](#aktualisiere-einen-zeiteintrag)
+    - [lösche einen Zeiteintrag](#lösche-einen-zeiteintrag)
+    - [archiviere einen Zeiteintrag](#archiviere-einen-zeiteintrag)
+    - [unarchiviere einen Zeiteintrag](#unarchiviere-einen-zeiteintrag)
   - [Verbleibendes Quota](#verbleibendes-quota)
 - [Business Intelligence](#business-intelligence)
   - [Business::Intelligence (BI) ExpenseByCategory (Ausgaben nach Kategorie)](#businessintelligence-bi-expensebycategory-ausgaben-nach-kategorie)
@@ -325,8 +339,10 @@ Siehe [Companies#create_customer](lib/papierkram_api/v1/endpoints/contact/compan
 #### aktualisiere ein Unternehmen
 
 ```ruby
-company = client.contact_companies
-                .update_by(id: 1, attributes: { name: 'Test GmbH' })
+company = client.contact_companies.update_by(
+  id: 1, 
+  name: 'Test GmbH'
+)
 puts company.headers
 puts company.body
 ```
@@ -381,11 +397,9 @@ puts company.body
 
 ```ruby
 company = client.contact_companies_persons.create(
-  company_id: 1, 
-  attributes: { 
-    first_name: 'Max',
-    last_name: 'Mustermann'
-  }
+  company_id: 1,
+  first_name: 'Max',
+  last_name: 'Mustermann'
 )
 puts company.headers
 puts company.body
@@ -396,8 +410,11 @@ Siehe [CompaniesPersons#create](lib/papierkram_api/v1/endpoints/contact/companie
 #### aktualisiere eine Kontaktperson (eines Unternehmens)
 
 ```ruby
-company = client.contact_companies_persons
-                .update_by(company_id: 1, id: 1, attributes: { first_name: 'Moritz' })
+company = client.contact_companies_persons.update_by(
+  id: 1,
+  company_id: 1,
+  first_name: 'Moritz'
+)
 puts company.headers
 puts company.body
 ```
@@ -502,6 +519,28 @@ puts PapierkramApi::V1::Helpers::PdfFromResponse.new(invoice).to_pdf
 # => {response: Faraday::Response, path_to_pdf_file: 'path/to/tempfile_pdf.pdf'}
 ```
 
+### Income::PaymentTerms (Zahlungsbedingungen)
+
+Der Endpunkt `/papierkram_api/v1/endpoints/income/payment_terms` liefert Informationen über die Zahlungsbedingungen. Die Informationen werden als `Faraday::Response` zurückgegeben.
+
+#### eine Zahlungsbedingung
+
+```ruby
+payment_term = client.income_payment_terms.find_by(id: 1)
+puts payment_term.headers
+puts payment_term.body
+```
+
+#### alle Zahlungsbedingungen
+
+Siehe [PaymentTerms](lib/papierkram_api/v1/endpoints/income/payment_terms.rb) für mögliche Parameter.
+
+```ruby
+payment_terms = client.income_payment_terms.all
+puts payment_terms.headers
+puts payment_terms.body
+```
+
 ### Income::Proposition (Waren / Dienstleistungen)
 
 Der Endpunkt `/papierkram_api/v1/endpoints/income/propositions` liefert Informationen über die Waren / Dienstleistungen. Die Informationen werden als `Faraday::Response` zurückgegeben.
@@ -547,10 +586,8 @@ Siehe [Propositions#create](lib/papierkram_api/v1/endpoints/income/propositions.
 ```ruby
 client.income_propositions.update_by(
   id: 1,
-  attributes: {
-    name: 'Software design',
-    vat_rate: '19%' # verpflichtend bei Änderung
-  }
+  name: 'Software design',
+  vat_rate: '19%' # verpflichtend bei Änderung
 )
 ```
 
@@ -621,7 +658,10 @@ Siehe [Projects](lib/papierkram_api/v1/endpoints/projects.rb) für mögliche Par
 #### aktualisiere ein Projekt
 
 ```ruby
-project = client.projects.update_by(id: 1, attributes: { name: 'Projekt 2' })
+project = client.projects.update_by(
+  id: 1,
+  name: 'Projekt 2'
+)
 puts project.headers
 puts project.body
 ```
@@ -674,6 +714,50 @@ puts task.headers
 puts task.body
 ```
 
+#### erstelle eine Aufgabe
+
+siehe [Tasks#create](lib/papierkram_api/v1/endpoints/tracker/tasks.rb) für mögliche Parameter.
+
+```ruby
+task = client.tracker_tasks.create(name: 'Aufgabe 1')
+puts task.headers
+puts task.body
+```
+
+#### aktualisiere eine Aufgabe
+
+siehe [Tasks#update_by](lib/papierkram_api/v1/endpoints/tracker/tasks.rb) für mögliche Parameter.
+
+```ruby
+task = client.tracker_tasks.update_by(id: 1, name: 'Aufgabe 2' )
+puts task.headers
+puts task.body
+```
+
+#### lösche eine Aufgabe
+
+```ruby
+task = client.tracker_tasks.delete_by(id: 1)
+puts task.headers
+puts task.body
+```
+
+#### archiviere eine Aufgabe
+
+```ruby
+task = client.tracker_tasks.archive_by(id: 1)
+puts task.headers
+puts task.body
+```
+
+#### unarchiviere eine Aufgabe
+
+```ruby
+task = client.tracker_tasks.unarchive_by(id: 1)
+puts task.headers
+puts task.body
+```
+
 ### Tracker::TimeEntry (Zeiteintrag)
 
 Der Endpunkt `/papierkram_api/v1/tracker/time_entries` liefert Informationen über die Zeiteinträge. Die Informationen werden als `Faraday::Response` zurückgegeben.
@@ -682,6 +766,8 @@ Der Endpunkt `/papierkram_api/v1/tracker/time_entries` liefert Informationen üb
 
 #### alle Zeiteinträge
 
+siehe [TimeEntries](lib/papierkram_api/v1/endpoints/tracker/time_entries.rb) für mögliche Parameter.
+
 ```ruby
 time_entries = client.tracker_time_entries.all
 puts time_entries.headers
@@ -696,6 +782,58 @@ puts time_entry.headers
 puts time_entry.body
 ```
 
+#### erstelle einen Zeiteintrag
+
+siehe [TimeEntries](lib/papierkram_api/v1/endpoints/tracker/time_entries.rb) für mögliche Parameter.
+
+```ruby
+time_entry = client.tracker_time_entries.create(
+  task_id: 1,
+  date: '2020-01-01',
+  duration: 60,
+  description: 'Test'
+)
+puts time_entry.headers
+puts time_entry.body
+```
+
+#### aktualisiere einen Zeiteintrag
+
+siehe [TimeEntries](lib/papierkram_api/v1/endpoints/tracker/time_entries.rb) für mögliche Parameter.
+
+```ruby
+time_entry = client.tracker_time_entries.update_by(
+  id: 1,
+ comments: 'Test'
+)
+puts time_entry.headers
+puts time_entry.body
+```
+
+#### lösche einen Zeiteintrag
+
+```ruby
+time_entry = client.tracker_time_entries.delete_by(id: 1)
+puts time_entry.headers
+puts time_entry.body
+```
+
+#### archiviere einen Zeiteintrag
+
+```ruby
+time_entry = client.tracker_time_entries.archive_by(id: 1)
+puts time_entry.headers
+puts time_entry.body
+```
+
+#### unarchiviere einen Zeiteintrag
+
+```ruby
+time_entry = client.tracker_time_entries.unarchive_by(id: 1)
+puts time_entry.headers
+puts time_entry.body
+```
+
 ### Verbleibendes Quota
 
 Jede API Anfrage "kostet" 1 Quota. Das Quota wird bei jedem Request aktualisiert. Um das verbleibende Quota zu erhalten, kann die Methode `remaining_quota` aufgerufen werden.

data/UPGRADING.md

@@ -1,3 +1,13 @@
+## From 0.3 to 0.4
+
+Some endpoints are calling `update` have changed. Instead of `update_by(id: 123, attributes: { ... })` you now use keywords e.g. `update_by(id: 123, name: 'New name')`.
+
+Please check the [CHANGELOG](CHANGELOG.md) for more details.
+
+- Income::Propositions
+- Projects
+- Contact::Companies
+
 ## From 0.2 to 0.3
 
 Finding specific records has changed. Instead of `by(id: 123)` you now use `find_by(id: 123)`.

data/lib/papierkram_api/client.rb

@@ -70,6 +70,11 @@ module PapierkramApi
         PapierkramApi::V1::Endpoints::Income::Invoices.new(@client)
     end
 
+    def income_payment_terms
+      @income_payment_terms ||=
+        PapierkramApi::V1::Endpoints::Income::PaymentTerms.new(@client)
+    end
+
     def income_propositions
       @income_propositions ||=
         PapierkramApi::V1::Endpoints::Income::Propositions.new(@client)

data/lib/papierkram_api/v1/endpoints/contact/companies.rb

@@ -134,11 +134,62 @@ module PapierkramApi
             http_post("#{@url_api_path}/contact/companies", body)
           end
 
-          def update_by(id:, attributes: {})
+          def update_by( # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity, Metrics/ParameterLists
+            id:,
+            name: nil,
+            contact_type: nil,
+            phone: nil,
+            fax: nil,
+            email: nil,
+            website: nil,
+            twitter: nil,
+            ust_idnr: nil,
+            delivery_method: nil,
+            postal_street: nil,
+            postal_zip: nil,
+            postal_city: nil,
+            postal_country: nil,
+            physical_street: nil,
+            physical_zip: nil,
+            physical_city: nil,
+            physical_country: nil,
+            bank_account_no: nil,
+            bank_blz: nil,
+            bank_institute: nil,
+            bank_bic: nil,
+            bank_iban: nil,
+            notes: nil,
+            color: nil
+          )
             raise ArgumentError, 'id must be an Integer' unless id.is_a?(Integer)
-            raise ArgumentError, 'attributes must be a Hash' unless attributes.is_a?(Hash)
 
-            http_put("#{@url_api_path}/contact/companies/#{id}", attributes)
+            body = {}
+            body[:name] = name if name
+            body[:contact_type] = contact_type if contact_type
+            body[:phone] = phone if phone
+            body[:fax] = fax if fax
+            body[:email] = email if email
+            body[:website] = website if website
+            body[:twitter] = twitter if twitter
+            body[:ust_idnr] = ust_idnr if ust_idnr
+            body[:delivery_method] = delivery_method if delivery_method
+            body[:postal_street] = postal_street if postal_street
+            body[:postal_zip] = postal_zip if postal_zip
+            body[:postal_city] = postal_city if postal_city
+            body[:postal_country] = postal_country if postal_country
+            body[:physical_street] = physical_street if physical_street
+            body[:physical_zip] = physical_zip if physical_zip
+            body[:physical_city] = physical_city if physical_city
+            body[:physical_country] = physical_country if physical_country
+            body[:bank_account_no] = bank_account_no if bank_account_no
+            body[:bank_blz] = bank_blz if bank_blz
+            body[:bank_institute] = bank_institute if bank_institute
+            body[:bank_bic] = bank_bic if bank_bic
+            body[:bank_iban] = bank_iban if bank_iban
+            body[:notes] = notes if notes
+            body[:color] = color if color
+
+            http_put("#{@url_api_path}/contact/companies/#{id}", body)
           end
 
           def delete_by(id:)

data/lib/papierkram_api/v1/endpoints/contact/companies_persons.rb

@@ -54,12 +54,44 @@ module PapierkramApi
             http_post("#{@url_api_path}/contact/companies/#{company_id}/persons", body)
           end
 
-          def update_by(company_id:, id:, attributes: {})
-            raise ArgumentError, 'attributes must be a Hash' unless attributes.is_a?(Hash)
+          def update_by( # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/ParameterLists, Metrics/MethodLength
+            id:,
+            company_id:,
+            title: nil,
+            salutation: nil,
+            first_name: nil,
+            last_name: nil,
+            position: nil,
+            department: nil,
+            phone: nil,
+            skype: nil,
+            fax: nil,
+            email: nil,
+            flagged: nil,
+            mobile: nil,
+            comment: nil,
+            default: nil
+          )
             raise ArgumentError, 'company_id must be an Integer' unless company_id.is_a?(Integer)
             raise ArgumentError, 'id must be an Integer' unless id.is_a?(Integer)
 
-            http_put("#{@url_api_path}/contact/companies/#{company_id}/persons/#{id}", attributes)
+            body = {}
+            body[:title] = title if title
+            body[:salutation] = salutation if salutation
+            body[:first_name] = first_name if first_name
+            body[:last_name] = last_name if last_name
+            body[:position] = position if position
+            body[:department] = department if department
+            body[:phone] = phone if phone
+            body[:skype] = skype if skype
+            body[:fax] = fax if fax
+            body[:email] = email if email
+            body[:flagged] = flagged if flagged
+            body[:mobile] = mobile if mobile
+            body[:comment] = comment if comment
+            body[:default] = default if default
+
+            http_put("#{@url_api_path}/contact/companies/#{company_id}/persons/#{id}", body)
           end
 
           def delete_by(company_id:, id:)

data/lib/papierkram_api/v1/endpoints/income/payment_terms.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module PapierkramApi
+  module V1
+    module Endpoints
+      module Income
+        # This class is responsible for all the API calls related to income propositions.
+        class PaymentTerms < PapierkramApi::V1::Endpoints::Base
+          def find_by(id:)
+            http_get("#{@url_api_path}/income/payment_terms/#{id}")
+          end
+
+          def all(page: 1,
+                  page_size: 100,
+                  order_by: nil,
+                  order_direction: nil)
+            query = {
+              page: page,
+              page_size: page_size
+            }
+            query[:order_by] = order_by if order_by
+            query[:order_direction] = order_direction if order_direction
+
+            http_get("#{@url_api_path}/income/payment_terms", query)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/papierkram_api/v1/endpoints/income/propositions.rb

@@ -36,12 +36,27 @@ module PapierkramApi
             http_post("#{@url_api_path}/income/propositions", body)
           end
 
-          def update_by(id:, attributes: {})
-            if attributes[:vat_rate] && (attributes[:vat_rate].empty? || !attributes[:vat_rate].include?('%'))
-              raise ArgumentError, 'vat_rate must be a percentage and include a % sign'
-            end
+          def update_by( # rubocop:disable Metrics/CyclomaticComplexity
+            id:,
+            name: nil,
+            description: nil,
+            article_no: nil,
+            price: nil,
+            proposition_type: nil,
+            time_unit: nil,
+            vat_rate: nil
+          )
+
+            body = {}
+            body[:name] = name if name
+            body[:description] = description if description
+            body[:article_no] = article_no if article_no
+            body[:price] = price if price
+            body[:proposition_type] = proposition_type if proposition_type
+            body[:time_unit] = time_unit if time_unit
+            body[:vat_rate] = vat_rate if vat_rate
 
-            http_put("#{@url_api_path}/income/propositions/#{id}", attributes)
+            http_put("#{@url_api_path}/income/propositions/#{id}", body)
           end
 
           def delete_by(id:)

data/lib/papierkram_api/v1/endpoints/projects.rb

@@ -55,10 +55,39 @@ module PapierkramApi
           http_post("#{@url_api_path}/projects", body)
         end
 
-        def update_by(id:, attributes: {})
-          raise ArgumentError, 'attributes must be a Hash' unless attributes.is_a?(Hash)
+        def update_by( # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/ParameterLists
+          id:,
+          name: nil,
+          customer_id: nil,
+          description: nil,
+          start_date: nil,
+          end_date: nil,
+          flagged: nil,
+          budget_type: nil,
+          budget_money: nil,
+          budget_time: nil,
+          budget_time_unit: nil,
+          color: nil,
+          default_proposition: nil,
+          team_members: nil
+        )
+
+          body = {}
+          body[:name] = name if name
+          body[:customer] = { id: customer_id } if customer_id
+          body[:description] = description if description
+          body[:start_date] = start_date if start_date
+          body[:end_date] = end_date if end_date
+          body[:flagged] = flagged if flagged
+          body[:budget_type] = budget_type if budget_type
+          body[:budget_money] = budget_money if budget_money
+          body[:budget_time] = budget_time if budget_time
+          body[:budget_time_unit] = budget_time_unit if budget_time_unit
+          body[:color] = color if color
+          body[:default_proposition] = default_proposition if default_proposition
+          body[:team_members] = team_members if team_members
 
-          http_put("#{@url_api_path}/projects/#{id}", attributes)
+          http_put("#{@url_api_path}/projects/#{id}", body)
         end
 
         def delete_by(id:)

data/lib/papierkram_api/v1/endpoints/tracker/tasks.rb

@@ -26,6 +26,69 @@ module PapierkramApi
             query[:proposition_id] = proposition_id if proposition_id
             http_get("#{@url_api_path}/tracker/tasks", query)
           end
+
+          def create(
+            name:,
+            project_id:,
+            proposition_id: nil,
+            deadline: nil,
+            relative_costs: nil,
+            complete: nil,
+            flagged: nil,
+            user_id: nil
+          )
+            body = {}
+            body[:name] = name
+            body[:project] = { id: project_id }
+            body[:proposition] = { id: proposition_id } if proposition_id
+            body[:deadline] = deadline if deadline
+            body[:relative_costs] = relative_costs if relative_costs
+            body[:complete] = complete if complete
+            body[:flagged] = flagged if flagged
+            body[:user] = { id: user_id } if user_id
+
+            http_post("#{@url_api_path}/tracker/tasks", body)
+          end
+
+          def update_by( # rubocop:disable Metrics/ParameterLists
+            id:,
+            name:,
+            project_id:,
+            proposition_id: nil,
+            deadline: nil,
+            relative_costs: nil,
+            complete: nil,
+            flagged: nil,
+            user_id: nil
+          )
+            body = {}
+            body[:name] = name
+            body[:project] = { id: project_id }
+            body[:proposition] = { id: proposition_id } if proposition_id
+            body[:deadline] = deadline if deadline
+            body[:relative_costs] = relative_costs if relative_costs
+            body[:complete] = complete if complete
+            body[:flagged] = flagged if flagged
+            body[:user] = { id: user_id } if user_id
+
+            http_put("#{@url_api_path}/tracker/tasks/#{id}", body)
+          end
+
+          def delete_by(id:)
+            http_delete("#{@url_api_path}/tracker/tasks/#{id}")
+          end
+
+          def archive_by(id:)
+            raise ArgumentError, 'id must be an Integer' unless id.is_a?(Integer)
+
+            http_post("#{@url_api_path}/tracker/tasks/#{id}/archive")
+          end
+
+          def unarchive_by(id:)
+            raise ArgumentError, 'id must be an Integer' unless id.is_a?(Integer)
+
+            http_post("#{@url_api_path}/tracker/tasks/#{id}/unarchive")
+          end
         end
       end
     end

data/lib/papierkram_api/v1/endpoints/tracker/time_entries.rb

@@ -42,6 +42,65 @@ module PapierkramApi
             http_get("#{@url_api_path}/tracker/time_entries", query)
           end
 
+          def create(
+            entry_date:,
+            started_at_time:,
+            ended_at_time:,
+            task_id:,
+            user_id:,
+            comments: nil,
+            billable_duration: nil,
+            unbillable: nil
+          )
+            body = {}
+            body[:entry_date] = entry_date
+            body[:started_at_time] = started_at_time
+            body[:ended_at_time] = ended_at_time
+            body[:task] = { id: task_id }
+            body[:user] = { id: user_id }
+            body[:comments] = comments if comments
+            body[:billable_duration] = billable_duration if billable_duration
+            body[:unbillable] = unbillable if unbillable
+
+            http_post("#{@url_api_path}/tracker/time_entries", body)
+          end
+
+          def update_by( # rubocop:disable Metrics/ParameterLists, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+            id:,
+            entry_date: nil,
+            started_at_time: nil,
+            ended_at_time: nil,
+            task_id: nil,
+            user_id: nil,
+            comments: nil,
+            billable_duration: nil,
+            unbillable: nil
+          )
+            body = {}
+            body[:entry_date] = entry_date if entry_date
+            body[:started_at_time] = started_at_time if started_at_time
+            body[:ended_at_time] = ended_at_time if ended_at_time
+            body[:task] = { id: task_id } if task_id
+            body[:user] = { id: user_id } if user_id
+            body[:comments] = comments if comments
+            body[:billable_duration] = billable_duration if billable_duration
+            body[:unbillable] = unbillable if unbillable
+
+            http_put("#{@url_api_path}/tracker/time_entries/#{id}", body)
+          end
+
+          def delete_by(id:)
+            http_delete("#{@url_api_path}/tracker/time_entries/#{id}")
+          end
+
+          def archive_by(id:)
+            http_post("#{@url_api_path}/tracker/time_entries/#{id}/archive")
+          end
+
+          def unarchive_by(id:)
+            http_post("#{@url_api_path}/tracker/time_entries/#{id}/unarchive")
+          end
+
           private
 
           def validate!(billing_state:, start_time_range_start:, start_time_range_end:)

data/lib/papierkram_api_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PapierkramApiClient
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
 end

data/lib/papierkram_api_client.rb

@@ -17,6 +17,7 @@ require_relative 'papierkram_api/v1/endpoints/contact/companies_persons'
 require_relative 'papierkram_api/v1/endpoints/expense/vouchers'
 require_relative 'papierkram_api/v1/endpoints/income/estimates'
 require_relative 'papierkram_api/v1/endpoints/income/invoices'
+require_relative 'papierkram_api/v1/endpoints/income/payment_terms'
 require_relative 'papierkram_api/v1/endpoints/income/propositions'
 require_relative 'papierkram_api/v1/endpoints/info'
 require_relative 'papierkram_api/v1/endpoints/projects'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: papierkram_api_client
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Simon Neutert
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-10-05 00:00:00.000000000 Z
+date: 2023-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -33,7 +33,7 @@ dependencies:
         version: 0.22.5
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.25.0
+        version: 1.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -43,7 +43,7 @@ dependencies:
         version: 0.22.5
     - - "<"
       - !ruby/object:Gem::Version
-        version: 0.25.0
+        version: 1.2.0
 description: Papierkram API Client, um deine Buchhaltung auf das nächste Level zu
   bringen.
 email:
@@ -76,6 +76,7 @@ files:
 - lib/papierkram_api/v1/endpoints/expense/vouchers.rb
 - lib/papierkram_api/v1/endpoints/income/estimates.rb
 - lib/papierkram_api/v1/endpoints/income/invoices.rb
+- lib/papierkram_api/v1/endpoints/income/payment_terms.rb
 - lib/papierkram_api/v1/endpoints/income/propositions.rb
 - lib/papierkram_api/v1/endpoints/info.rb
 - lib/papierkram_api/v1/endpoints/projects.rb