tripletex_ruby_client 1.0.3 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9a7a3f094603d87532918aa23f1b605f4cd679ddab97da6b92256e6358770e6
-  data.tar.gz: f10bde3d91816dda8faf0cfd1f52c858f71e27c06c099582060bda8944cea7ce
+  metadata.gz: 5cc5ed9deb0b1961f486d3dcdda1dfc0947d05a279bbcbe4b50cb41d70e45e6b
+  data.tar.gz: c8aadc530518cded2246f000c85dd78eaee27fd0375b6f935ec06901d5c7e25b
 SHA512:
-  metadata.gz: b8dcddb6fc5fbc35d492ee2fac9b0bc440e10d9863c891683186e8bc5c5a6c1612822167648dc00f358936082e015045fc5691ba1e6947d14bc4df2364aa10fa
-  data.tar.gz: 63842cda91fbb9718cb7507e941770cca4d2ec099f845260412c03e1c4a8f64d3292b2fa801862132f855d99437465f15b84f1708401fa9f382b8dea0511bf70
+  metadata.gz: 8d37586cee50ae446fbcf6669578d16274cbf9c8321bf0d1402560fab14dc1bcb89d41f66f7d290c50ef443574e9a553bbea50281ecab62637170251388ab3f8
+  data.tar.gz: 41001b1d23ab2334ed0b59b3d29b2dd1b095a6b1c4cf3eebe01cc21aeed6ce23da8db1a4d838052e9875f7c18f0fc8d60c58223f2a4a815c60156734522aa8e5

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    tripletex_ruby_client (1.0.1)
+    tripletex_ruby_client (1.0.6)
       addressable (~> 2.3, >= 2.3.0)
       json (~> 2.1, >= 2.1.0)
       typhoeus (~> 1.0, >= 1.0.1)
@@ -14,18 +14,18 @@ GEM
       public_suffix (>= 2.0.2, < 5.0)
     autotest (4.4.6)
       ZenTest (>= 4.4.1)
-    autotest-fsevent (0.2.18)
+    autotest-fsevent (0.2.20)
       sys-uname
     autotest-growl (0.2.16)
     autotest-rails-pure (4.1.2)
     crack (0.4.5)
       rexml
     diff-lcs (1.4.4)
-    ethon (0.15.0)
+    ethon (0.16.0)
       ffi (>= 1.15.0)
-    ffi (1.15.4)
+    ffi (1.15.5)
     hashdiff (1.0.1)
-    json (2.6.1)
+    json (2.6.3)
     public_suffix (4.0.6)
     rake (12.3.3)
     rexml (3.2.5)

data/README.md

@@ -2,51 +2,22 @@
 
 TripletexRubyClient - the Ruby gem for the Tripletex API, at the courtesy of Rubynor AS.
 
-This was built using swagger-codegen first, from [https://tripletex.no/v2-docs/](https://tripletex.no/v2-docs/)
-and it needed change in config and auth to work for us. 
+Used in production.
 
-We can't see how the other tripletex ruby client gems work, but this is working for us.
+This was built using swagger-codegen first, from [https://tripletex.no/v2-docs/](https://tripletex.no/v2-docs/), then changed manually for it to work.
 
-## Installation
+To help make it better, fork it and create Pull Request, thanks ! 
 
-### Build a gem
+Team Rubynor
 
-To build the Ruby code into a gem:
-
-```shell
-gem build tripletex_ruby_client.gemspec
-```
-
-Then either install the gem locally:
-
-```shell
-gem install ./tripletex_ruby_client-1.0.0.gem
-```
-(for development, run `gem install --dev ./tripletex_ruby_client-1.0.0.gem` to install the development dependencies)
-
-or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
-
-Finally add this to the Gemfile:
-
-    gem 'tripletex_ruby_client', '~> 1.0.0'
-
-### Install from Git
-
-If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:
+## Getting Started
 
-    gem 'tripletex_ruby_client', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
+Gemfile
 
-### Include the Ruby code directly
+    gem 'tripletex_ruby_client'
 
-Include the Ruby code directly using `-I` as follows:
+Usage
 
-```shell
-ruby -Ilib script.rb
-```
-
-## Getting Started
-
-Please follow the [installation](#installation) procedure and then run the following code:
 ```ruby
 # Load the gem
 require 'tripletex_ruby_client'
@@ -81,6 +52,9 @@ begin
   p result
 rescue TripletexRubyClient::ApiError => e
   puts "Exception when calling ActivityApi->get: #{e}"
+  
+  validation_errors = JSON.parse(error.response_body)["validationMessages"]
+  # do your stuff
 end
 
 ```
@@ -94,6 +68,24 @@ This SDK is automatically generated by the [Swagger Codegen](https://github.com/
 - Build package: io.swagger.codegen.languages.RubyClientCodegen
 For more information, please visit [https://github.com/Tripletex/tripletex-api2](https://github.com/Tripletex/tripletex-api2)
 
+## Build a gem
+
+To build the Ruby code into a gem:
+
+```shell
+gem build tripletex_ruby_client.gemspec
+```
+
+Then either install the gem locally:
+
+```shell
+gem install ./tripletex_ruby_client-1.0.0.gem
+```
+(for development, run `gem install --dev ./tripletex_ruby_client-1.0.0.gem` to install the development dependencies)
+
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
+
+
 ## Documentation for API Endpoints
 
 All URIs are relative to *https://tripletex.no/v2*

data/lib/tripletex_ruby_client/api/invoice_api.rb

@@ -3,7 +3,7 @@
 
 ### Usage  - **Download the spec** [swagger.json](/v2/swagger.json) file, it is a [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification).  - **Generating a client** can easily be done using tools like [swagger-codegen](https://github.com/swagger-api/swagger-codegen) or other that accepts [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification) specs.     - For swagger codegen it is recommended to use the flag: **--removeOperationIdPrefix**.        Unique operation ids are about to be introduced to the spec, and this ensures forward compatibility - and results in less verbose generated code.   ## Overview  - Partial resource updating is done using the `PUT` method with optional fields instead of the `PATCH` method.  - **Actions** or **commands** are represented in our RESTful path with a prefixed `:`. Example: `/v2/hours/123/:approve`.  - **Summaries** or **aggregated** results are represented in our RESTful path with a prefixed `>`. Example: `/v2/hours/>thisWeeksBillables`.  - **Request ID** is a key found in all responses in the header with the name `x-tlx-request-id`. For validation and error responses it is also in the response body. If additional log information is absolutely necessary, our support division can locate the key value.  - **version** This is a revision number found on all persisted resources. If included, it will prevent your PUT/POST from overriding any updates to the resource since your GET.  - **Date** follows the **[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)** standard, meaning the format `YYYY-MM-DD`.  - **DateTime** follows the **[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)** standard, meaning the format `YYYY-MM-DDThh:mm:ss`.  - **Searching** is done by entering values in the optional fields for each API call. The values fall into the following categories: range, in, exact and like.  - **Missing fields** or even **no response data** can occur because result objects and fields are filtered on authorization.  - **See [GitHub](https://github.com/Tripletex/tripletex-api2) for more documentation, examples, changelog and more.**  - **See [FAQ](https://tripletex.no/execute/docViewer?articleId=906&language=0) for additional information.**   ## Authentication  - **Tokens:** The Tripletex API uses 3 different tokens    - **consumerToken** is a token provided to the consumer by Tripletex after the API 2.0 registration is completed.    - **employeeToken** is a token created by an administrator in your Tripletex account via the user settings and the tab \"API access\". Each employee token must be given a set of entitlements. [Read more here.](https://tripletex.no/execute/docViewer?articleId=1505&languageId=0)    - **sessionToken** is the token from `/token/session/:create` which requires a consumerToken and an employeeToken created with the same consumer token, but not an authentication header.  - **Authentication** is done via [Basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)    - **username** is used to specify what company to access.      - `0` or blank means the company of the employee.      - Any other value means accountant clients. Use `/company/>withLoginAccess` to get a list of those.    - **password** is the **sessionToken**.    - If you need to create the header yourself use `Authorization: Basic <encoded token>` where `encoded token` is the string `<target company id or 0>:<your session token>` Base64 encoded.   ## Tags  - `[BETA]` This is a beta endpoint and can be subject to change. - `[DEPRECATED]` Deprecated means that we intend to remove/change this feature or capability in a future \"major\" API release. We therefore discourage all use of this feature/capability.   ## Fields  Use the `fields` parameter to specify which fields should be returned. This also supports fields from sub elements, done via `<field>(<subResourceFields>)`. `*` means all fields for that resource. Example values: - `project,activity,hours`  returns `{project:..., activity:...., hours:...}`. - just `project` returns `\"project\" : { \"id\": 12345, \"url\": \"tripletex.no/v2/projects/12345\"  }`. - `project(*)` returns `\"project\" : { \"id\": 12345 \"name\":\"ProjectName\" \"number.....startDate\": \"2013-01-07\" }`. - `project(name)` returns `\"project\" : { \"name\":\"ProjectName\" }`. - All resources and some subResources :  `*,activity(name),employee(*)`.   ## Sorting  Use the `sorting` parameter to specify sorting. It takes a comma separated list, where a `-` prefix denotes descending. You can sort by sub object with the following format: `<field>.<subObjectField>`. Example values: - `date` - `project.name` - `project.name, -date`   ## Changes  To get the changes for a resource, `changes` have to be explicitly specified as part of the `fields` parameter, e.g. `*,changes`. There are currently two types of change available:  - `CREATE` for when the resource was created - `UPDATE` for when the resource was updated  **NOTE** > For objects created prior to October 24th 2018 the list may be incomplete, but will always contain the CREATE and the last change (if the object has been changed after creation).   ## Rate limiting  Rate limiting is performed on the API calls for an employee for each API consumer. Status regarding the rate limit is returned as headers: - `X-Rate-Limit-Limit` - The number of allowed requests in the current period. - `X-Rate-Limit-Remaining` - The number of remaining requests. - `X-Rate-Limit-Reset` - The number of seconds left in the current period.  Once the rate limit is hit, all requests will return HTTP status code `429` for the remainder of the current period.   ## Response envelope  #### Multiple values  ```json {   \"fullResultSize\": ###, // {number} [DEPRECATED]   \"from\": ###, // {number} Paging starting from   \"count\": ###, // {number} Paging count   \"versionDigest\": \"###\", // {string} Hash of full result, null if no result   \"values\": [...{...object...},{...object...},{...object...}...] } ```  #### Single value  ```json {   \"value\": {...single object...} } ```   ## WebHook envelope  ```json {   \"subscriptionId\": ###, // Subscription id   \"event\": \"object.verb\", // As listed from /v2/event/   \"id\": ###, // Id of object this event is for   \"value\": {... single object, null if object.deleted ...} } ```   ## Error/warning envelope  ```json {   \"status\": ###, // {number} HTTP status code   \"code\": #####, // {number} internal status code of event   \"message\": \"###\", // {string} Basic feedback message in your language   \"link\": \"###\", // {string} Link to doc   \"developerMessage\": \"###\", // {string} More technical message   \"validationMessages\": [ // {array} List of validation messages, can be null     {       \"field\": \"###\", // {string} Name of field       \"message\": \"###\" // {string} Validation message for field     }   ],   \"requestId\": \"###\" // {string} Same as x-tlx-request-id  } ```   ## Status codes / Error codes  - **200 OK** - **201 Created** - From POSTs that create something new. - **204 No Content** - When there is no answer, ex: \"/:anAction\" or DELETE. - **400 Bad request** -   -  **4000** Bad Request Exception   - **11000** Illegal Filter Exception   - **12000** Path Param Exception   - **24000** Cryptography Exception - **401 Unauthorized** - When authentication is required and has failed or has not yet been provided   -  **3000** Authentication Exception - **403 Forbidden** - When AuthorisationManager says no.   -  **9000** Security Exception - **404 Not Found** - For resources that does not exist.   -  **6000** Not Found Exception - **409 Conflict** - Such as an edit conflict between multiple simultaneous updates   -  **7000** Object Exists Exception   -  **8000** Revision Exception   - **10000** Locked Exception   - **14000** Duplicate entry - **422 Bad Request** - For Required fields or things like malformed payload.   - **15000** Value Validation Exception   - **16000** Mapping Exception   - **17000** Sorting Exception   - **18000** Validation Exception   - **21000** Param Exception   - **22000** Invalid JSON Exception   - **23000** Result Set Too Large Exception - **429 Too Many Requests** - Request rate limit hit - **500 Internal Error** - Unexpected condition was encountered and no more specific message is suitable   - **1000** Exception 
 
-OpenAPI spec version: 2.69.5
+OpenAPI spec version: 2.70.15
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.24
@@ -20,12 +20,13 @@ module TripletexRubyClient
       @api_client = api_client
     end
     # Creates a new Invoice representing a credit memo that nullifies the given invoice. Updates this invoice and any pre-existing inverse invoice.
-    # 
+    #
     # @param id Invoice id
     # @param date Credit note date
     # @param [Hash] opts the optional parameters
     # @option opts [String] :comment Comment
-    # @option opts [String] :credit_note_email The credit note will be sent electronically if this field is filled out
+    # @option opts [String] :credit_note_email The credit note will not be sent if the customer send type is email and this field is empty
+    # @option opts [BOOLEAN] :send_to_customer Equals (default to true)
     # @return [ResponseWrapperInvoice]
     def create_credit_note(id, date, opts = {})
       data, _status_code, _headers = create_credit_note_with_http_info(id, date, opts)
@@ -33,12 +34,13 @@ module TripletexRubyClient
     end
 
     # Creates a new Invoice representing a credit memo that nullifies the given invoice. Updates this invoice and any pre-existing inverse invoice.
-    # 
+    #
     # @param id Invoice id
     # @param date Credit note date
     # @param [Hash] opts the optional parameters
     # @option opts [String] :comment Comment
-    # @option opts [String] :credit_note_email The credit note will be sent electronically if this field is filled out
+    # @option opts [String] :credit_note_email The credit note will not be sent if the customer send type is email and this field is empty
+    # @option opts [BOOLEAN] :send_to_customer Equals
     # @return [Array<(ResponseWrapperInvoice, Fixnum, Hash)>] ResponseWrapperInvoice data, response status code and response headers
     def create_credit_note_with_http_info(id, date, opts = {})
       if @api_client.config.debugging
@@ -60,6 +62,7 @@ module TripletexRubyClient
       query_params[:'date'] = date
       query_params[:'comment'] = opts[:'comment'] if !opts[:'comment'].nil?
       query_params[:'creditNoteEmail'] = opts[:'credit_note_email'] if !opts[:'credit_note_email'].nil?
+      query_params[:'sendToCustomer'] = opts[:'send_to_customer'] if !opts[:'send_to_customer'].nil?
 
       # header parameters
       header_params = {}
@@ -83,7 +86,7 @@ module TripletexRubyClient
       return data, status_code, headers
     end
     # Create invoice reminder and sends it by the given dispatch type. Supports the reminder types SOFT_REMINDER, REMINDER and NOTICE_OF_DEBT_COLLECTION. DispatchType NETS_PRINT must have type NOTICE_OF_DEBT_COLLECTION. SMS and NETS_PRINT must be activated prior to usage in the API.
-    # 
+    #
     # @param id Element ID
     # @param type type
     # @param date yyyy-MM-dd. Defaults to today.
@@ -99,7 +102,7 @@ module TripletexRubyClient
     end
 
     # Create invoice reminder and sends it by the given dispatch type. Supports the reminder types SOFT_REMINDER, REMINDER and NOTICE_OF_DEBT_COLLECTION. DispatchType NETS_PRINT must have type NOTICE_OF_DEBT_COLLECTION. SMS and NETS_PRINT must be activated prior to usage in the API.
-    # 
+    #
     # @param id Element ID
     # @param type type
     # @param date yyyy-MM-dd. Defaults to today.
@@ -173,6 +176,7 @@ module TripletexRubyClient
     # 
     # @param invoice_id Invoice ID from which PDF is downloaded.
     # @param [Hash] opts the optional parameters
+    # @option opts [BOOLEAN] :download Equals (default to true)
     # @return [String]
     def download_pdf(invoice_id, opts = {})
       data, _status_code, _headers = download_pdf_with_http_info(invoice_id, opts)
@@ -180,9 +184,10 @@ module TripletexRubyClient
     end
 
     # Get invoice document by invoice ID.
-    # 
+    #
     # @param invoice_id Invoice ID from which PDF is downloaded.
     # @param [Hash] opts the optional parameters
+    # @option opts [BOOLEAN] :download Equals
     # @return [Array<(String, Fixnum, Hash)>] String data, response status code and response headers
     def download_pdf_with_http_info(invoice_id, opts = {})
       if @api_client.config.debugging
@@ -197,6 +202,7 @@ module TripletexRubyClient
 
       # query parameters
       query_params = {}
+      query_params[:'download'] = opts[:'download'] if !opts[:'download'].nil?
 
       # header parameters
       header_params = {}
@@ -408,7 +414,7 @@ module TripletexRubyClient
     # [BETA] Create multiple invoices. Max 100 at a time.
     # 
     # @param [Hash] opts the optional parameters
-    # @option opts [Array<Invoice>] :body JSON representing a list of new object to be created. Should not have ID and version set.
+    # @option opts [Array<Invoice>] :body JSON representing a list of new objects to be created. Should not have ID and version set.
     # @option opts [BOOLEAN] :send_to_customer Equals (default to true)
     # @option opts [String] :fields Fields filter pattern (default to *)
     # @return [ListResponseInvoice]
@@ -418,9 +424,9 @@ module TripletexRubyClient
     end
 
     # [BETA] Create multiple invoices. Max 100 at a time.
-    # 
+    #
     # @param [Hash] opts the optional parameters
-    # @option opts [Array<Invoice>] :body JSON representing a list of new object to be created. Should not have ID and version set.
+    # @option opts [Array<Invoice>] :body JSON representing a list of new objects to be created. Should not have ID and version set.
     # @option opts [BOOLEAN] :send_to_customer Equals
     # @option opts [String] :fields Fields filter pattern
     # @return [Array<(ListResponseInvoice, Fixnum, Hash)>] ListResponseInvoice data, response status code and response headers
@@ -576,8 +582,8 @@ module TripletexRubyClient
         fail ArgumentError, "Missing the required parameter 'send_type' when calling InvoiceApi.send"
       end
       # verify enum value
-      if @api_client.config.client_side_validation && !['EMAIL', 'EHF', 'AVTALEGIRO', 'EFAKTURA', 'VIPPS', 'PAPER'].include?(send_type)
-        fail ArgumentError, "invalid value for 'send_type', must be one of EMAIL, EHF, AVTALEGIRO, EFAKTURA, VIPPS, PAPER"
+      if @api_client.config.client_side_validation && !['EMAIL', 'EHF', 'AVTALEGIRO', 'EFAKTURA', 'VIPPS', 'PAPER', 'MANUAL'].include?(send_type)
+        fail ArgumentError, "invalid value for 'send_type', must be one of EMAIL, EHF, AVTALEGIRO, EFAKTURA, VIPPS, PAPER, MANUAL"
       end
       # resource path
       local_var_path = '/invoice/{id}/:send'.sub('{' + 'id' + '}', id.to_s)

data/lib/tripletex_ruby_client/api/reminder_api.rb

@@ -3,7 +3,7 @@
 
 ### Usage  - **Download the spec** [swagger.json](/v2/swagger.json) file, it is a [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification).  - **Generating a client** can easily be done using tools like [swagger-codegen](https://github.com/swagger-api/swagger-codegen) or other that accepts [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification) specs.     - For swagger codegen it is recommended to use the flag: **--removeOperationIdPrefix**.        Unique operation ids are about to be introduced to the spec, and this ensures forward compatibility - and results in less verbose generated code.   ## Overview  - Partial resource updating is done using the `PUT` method with optional fields instead of the `PATCH` method.  - **Actions** or **commands** are represented in our RESTful path with a prefixed `:`. Example: `/v2/hours/123/:approve`.  - **Summaries** or **aggregated** results are represented in our RESTful path with a prefixed `>`. Example: `/v2/hours/>thisWeeksBillables`.  - **Request ID** is a key found in all responses in the header with the name `x-tlx-request-id`. For validation and error responses it is also in the response body. If additional log information is absolutely necessary, our support division can locate the key value.  - **version** This is a revision number found on all persisted resources. If included, it will prevent your PUT/POST from overriding any updates to the resource since your GET.  - **Date** follows the **[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)** standard, meaning the format `YYYY-MM-DD`.  - **DateTime** follows the **[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)** standard, meaning the format `YYYY-MM-DDThh:mm:ss`.  - **Searching** is done by entering values in the optional fields for each API call. The values fall into the following categories: range, in, exact and like.  - **Missing fields** or even **no response data** can occur because result objects and fields are filtered on authorization.  - **See [GitHub](https://github.com/Tripletex/tripletex-api2) for more documentation, examples, changelog and more.**  - **See [FAQ](https://tripletex.no/execute/docViewer?articleId=906&language=0) for additional information.**   ## Authentication  - **Tokens:** The Tripletex API uses 3 different tokens    - **consumerToken** is a token provided to the consumer by Tripletex after the API 2.0 registration is completed.    - **employeeToken** is a token created by an administrator in your Tripletex account via the user settings and the tab \"API access\". Each employee token must be given a set of entitlements. [Read more here.](https://tripletex.no/execute/docViewer?articleId=1505&languageId=0)    - **sessionToken** is the token from `/token/session/:create` which requires a consumerToken and an employeeToken created with the same consumer token, but not an authentication header.  - **Authentication** is done via [Basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)    - **username** is used to specify what company to access.      - `0` or blank means the company of the employee.      - Any other value means accountant clients. Use `/company/>withLoginAccess` to get a list of those.    - **password** is the **sessionToken**.    - If you need to create the header yourself use `Authorization: Basic <encoded token>` where `encoded token` is the string `<target company id or 0>:<your session token>` Base64 encoded.   ## Tags  - `[BETA]` This is a beta endpoint and can be subject to change. - `[DEPRECATED]` Deprecated means that we intend to remove/change this feature or capability in a future \"major\" API release. We therefore discourage all use of this feature/capability.   ## Fields  Use the `fields` parameter to specify which fields should be returned. This also supports fields from sub elements, done via `<field>(<subResourceFields>)`. `*` means all fields for that resource. Example values: - `project,activity,hours`  returns `{project:..., activity:...., hours:...}`. - just `project` returns `\"project\" : { \"id\": 12345, \"url\": \"tripletex.no/v2/projects/12345\"  }`. - `project(*)` returns `\"project\" : { \"id\": 12345 \"name\":\"ProjectName\" \"number.....startDate\": \"2013-01-07\" }`. - `project(name)` returns `\"project\" : { \"name\":\"ProjectName\" }`. - All resources and some subResources :  `*,activity(name),employee(*)`.   ## Sorting  Use the `sorting` parameter to specify sorting. It takes a comma separated list, where a `-` prefix denotes descending. You can sort by sub object with the following format: `<field>.<subObjectField>`. Example values: - `date` - `project.name` - `project.name, -date`   ## Changes  To get the changes for a resource, `changes` have to be explicitly specified as part of the `fields` parameter, e.g. `*,changes`. There are currently two types of change available:  - `CREATE` for when the resource was created - `UPDATE` for when the resource was updated  **NOTE** > For objects created prior to October 24th 2018 the list may be incomplete, but will always contain the CREATE and the last change (if the object has been changed after creation).   ## Rate limiting  Rate limiting is performed on the API calls for an employee for each API consumer. Status regarding the rate limit is returned as headers: - `X-Rate-Limit-Limit` - The number of allowed requests in the current period. - `X-Rate-Limit-Remaining` - The number of remaining requests. - `X-Rate-Limit-Reset` - The number of seconds left in the current period.  Once the rate limit is hit, all requests will return HTTP status code `429` for the remainder of the current period.   ## Response envelope  #### Multiple values  ```json {   \"fullResultSize\": ###, // {number} [DEPRECATED]   \"from\": ###, // {number} Paging starting from   \"count\": ###, // {number} Paging count   \"versionDigest\": \"###\", // {string} Hash of full result, null if no result   \"values\": [...{...object...},{...object...},{...object...}...] } ```  #### Single value  ```json {   \"value\": {...single object...} } ```   ## WebHook envelope  ```json {   \"subscriptionId\": ###, // Subscription id   \"event\": \"object.verb\", // As listed from /v2/event/   \"id\": ###, // Id of object this event is for   \"value\": {... single object, null if object.deleted ...} } ```   ## Error/warning envelope  ```json {   \"status\": ###, // {number} HTTP status code   \"code\": #####, // {number} internal status code of event   \"message\": \"###\", // {string} Basic feedback message in your language   \"link\": \"###\", // {string} Link to doc   \"developerMessage\": \"###\", // {string} More technical message   \"validationMessages\": [ // {array} List of validation messages, can be null     {       \"field\": \"###\", // {string} Name of field       \"message\": \"###\" // {string} Validation message for field     }   ],   \"requestId\": \"###\" // {string} Same as x-tlx-request-id  } ```   ## Status codes / Error codes  - **200 OK** - **201 Created** - From POSTs that create something new. - **204 No Content** - When there is no answer, ex: \"/:anAction\" or DELETE. - **400 Bad request** -   -  **4000** Bad Request Exception   - **11000** Illegal Filter Exception   - **12000** Path Param Exception   - **24000** Cryptography Exception - **401 Unauthorized** - When authentication is required and has failed or has not yet been provided   -  **3000** Authentication Exception - **403 Forbidden** - When AuthorisationManager says no.   -  **9000** Security Exception - **404 Not Found** - For resources that does not exist.   -  **6000** Not Found Exception - **409 Conflict** - Such as an edit conflict between multiple simultaneous updates   -  **7000** Object Exists Exception   -  **8000** Revision Exception   - **10000** Locked Exception   - **14000** Duplicate entry - **422 Bad Request** - For Required fields or things like malformed payload.   - **15000** Value Validation Exception   - **16000** Mapping Exception   - **17000** Sorting Exception   - **18000** Validation Exception   - **21000** Param Exception   - **22000** Invalid JSON Exception   - **23000** Result Set Too Large Exception - **429 Too Many Requests** - Request rate limit hit - **500 Internal Error** - Unexpected condition was encountered and no more specific message is suitable   - **1000** Exception 
 
-OpenAPI spec version: 2.69.5
+OpenAPI spec version: 2.70.15
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.24
@@ -20,7 +20,7 @@ module TripletexRubyClient
       @api_client = api_client
     end
     # Get reminder by ID.
-    # 
+    #
     # @param id Element ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :fields Fields filter pattern
@@ -31,7 +31,7 @@ module TripletexRubyClient
     end
 
     # Get reminder by ID.
-    # 
+    #
     # @param id Element ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :fields Fields filter pattern
@@ -72,6 +72,58 @@ module TripletexRubyClient
       end
       return data, status_code, headers
     end
+    # Get reminder document by reminder ID.
+    #
+    # @param reminder_id Reminder ID from which PDF is downloaded.
+    # @param [Hash] opts the optional parameters
+    # @return [String]
+    def download_pdf(reminder_id, opts = {})
+      data, _status_code, _headers = download_pdf_with_http_info(reminder_id, opts)
+      data
+    end
+
+    # Get reminder document by reminder ID.
+    #
+    # @param reminder_id Reminder ID from which PDF is downloaded.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(String, Fixnum, Hash)>] String data, response status code and response headers
+    def download_pdf_with_http_info(reminder_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReminderApi.download_pdf ...'
+      end
+      # verify the required parameter 'reminder_id' is set
+      if @api_client.config.client_side_validation && reminder_id.nil?
+        fail ArgumentError, "Missing the required parameter 'reminder_id' when calling ReminderApi.download_pdf"
+      end
+      # resource path
+      local_var_path = '/reminder/{reminderId}/pdf'.sub('{' + 'reminderId' + '}', reminder_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/octet-stream'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['tokenAuthScheme']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'String')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReminderApi#download_pdf\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
     # Find reminders corresponding with sent data.
     # 
     # @param date_from From and including

data/lib/tripletex_ruby_client/api_client.rb

@@ -62,10 +62,7 @@ module TripletexRubyClient
           fail ApiError.new(:code => 0,
                             :message => response.return_message)
         else
-          fail ApiError.new(:code => response.code,
-                            :response_headers => response.headers.to_h,
-                            :response_body => response.body),
-               response.status_message
+          raise_error(response)
         end
       end
 
@@ -387,5 +384,25 @@ module TripletexRubyClient
         fail "unknown collection format: #{collection_format.inspect}"
       end
     end
+
+    private
+
+    def raise_error(response)
+      error_klass = case response.code
+                    when 401
+                      UnauthorizedError
+                    when 429
+                      RateLimitExceededError
+                    when (400..499)
+                      ClientError
+                    when (500..599)
+                      ServerError
+                    else
+                      ApiError
+                     end
+      fail error_klass.new(code: response.code,
+                           response_headers: response.headers.to_h,
+                           response_body: response.body), response.status_message
+    end
   end
 end

data/lib/tripletex_ruby_client/api_error.rb

@@ -43,4 +43,16 @@ module TripletexRubyClient
       end.to_s
     end
   end
+
+  class ClientError < ApiError
+  end
+
+  class ServerError < ApiError
+  end
+
+  class RateLimitExceededError < ClientError
+  end
+
+  class UnauthorizedError < ClientError
+  end
 end

data/lib/tripletex_ruby_client/models/invoice.rb

@@ -3,7 +3,7 @@
 
 ### Usage  - **Download the spec** [swagger.json](/v2/swagger.json) file, it is a [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification).  - **Generating a client** can easily be done using tools like [swagger-codegen](https://github.com/swagger-api/swagger-codegen) or other that accepts [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification) specs.     - For swagger codegen it is recommended to use the flag: **--removeOperationIdPrefix**.        Unique operation ids are about to be introduced to the spec, and this ensures forward compatibility - and results in less verbose generated code.   ## Overview  - Partial resource updating is done using the `PUT` method with optional fields instead of the `PATCH` method.  - **Actions** or **commands** are represented in our RESTful path with a prefixed `:`. Example: `/v2/hours/123/:approve`.  - **Summaries** or **aggregated** results are represented in our RESTful path with a prefixed `>`. Example: `/v2/hours/>thisWeeksBillables`.  - **Request ID** is a key found in all responses in the header with the name `x-tlx-request-id`. For validation and error responses it is also in the response body. If additional log information is absolutely necessary, our support division can locate the key value.  - **version** This is a revision number found on all persisted resources. If included, it will prevent your PUT/POST from overriding any updates to the resource since your GET.  - **Date** follows the **[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)** standard, meaning the format `YYYY-MM-DD`.  - **DateTime** follows the **[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)** standard, meaning the format `YYYY-MM-DDThh:mm:ss`.  - **Searching** is done by entering values in the optional fields for each API call. The values fall into the following categories: range, in, exact and like.  - **Missing fields** or even **no response data** can occur because result objects and fields are filtered on authorization.  - **See [GitHub](https://github.com/Tripletex/tripletex-api2) for more documentation, examples, changelog and more.**  - **See [FAQ](https://tripletex.no/execute/docViewer?articleId=906&language=0) for additional information.**   ## Authentication  - **Tokens:** The Tripletex API uses 3 different tokens    - **consumerToken** is a token provided to the consumer by Tripletex after the API 2.0 registration is completed.    - **employeeToken** is a token created by an administrator in your Tripletex account via the user settings and the tab \"API access\". Each employee token must be given a set of entitlements. [Read more here.](https://tripletex.no/execute/docViewer?articleId=1505&languageId=0)    - **sessionToken** is the token from `/token/session/:create` which requires a consumerToken and an employeeToken created with the same consumer token, but not an authentication header.  - **Authentication** is done via [Basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication)    - **username** is used to specify what company to access.      - `0` or blank means the company of the employee.      - Any other value means accountant clients. Use `/company/>withLoginAccess` to get a list of those.    - **password** is the **sessionToken**.    - If you need to create the header yourself use `Authorization: Basic <encoded token>` where `encoded token` is the string `<target company id or 0>:<your session token>` Base64 encoded.   ## Tags  - `[BETA]` This is a beta endpoint and can be subject to change. - `[DEPRECATED]` Deprecated means that we intend to remove/change this feature or capability in a future \"major\" API release. We therefore discourage all use of this feature/capability.   ## Fields  Use the `fields` parameter to specify which fields should be returned. This also supports fields from sub elements, done via `<field>(<subResourceFields>)`. `*` means all fields for that resource. Example values: - `project,activity,hours`  returns `{project:..., activity:...., hours:...}`. - just `project` returns `\"project\" : { \"id\": 12345, \"url\": \"tripletex.no/v2/projects/12345\"  }`. - `project(*)` returns `\"project\" : { \"id\": 12345 \"name\":\"ProjectName\" \"number.....startDate\": \"2013-01-07\" }`. - `project(name)` returns `\"project\" : { \"name\":\"ProjectName\" }`. - All resources and some subResources :  `*,activity(name),employee(*)`.   ## Sorting  Use the `sorting` parameter to specify sorting. It takes a comma separated list, where a `-` prefix denotes descending. You can sort by sub object with the following format: `<field>.<subObjectField>`. Example values: - `date` - `project.name` - `project.name, -date`   ## Changes  To get the changes for a resource, `changes` have to be explicitly specified as part of the `fields` parameter, e.g. `*,changes`. There are currently two types of change available:  - `CREATE` for when the resource was created - `UPDATE` for when the resource was updated  **NOTE** > For objects created prior to October 24th 2018 the list may be incomplete, but will always contain the CREATE and the last change (if the object has been changed after creation).   ## Rate limiting  Rate limiting is performed on the API calls for an employee for each API consumer. Status regarding the rate limit is returned as headers: - `X-Rate-Limit-Limit` - The number of allowed requests in the current period. - `X-Rate-Limit-Remaining` - The number of remaining requests. - `X-Rate-Limit-Reset` - The number of seconds left in the current period.  Once the rate limit is hit, all requests will return HTTP status code `429` for the remainder of the current period.   ## Response envelope  #### Multiple values  ```json {   \"fullResultSize\": ###, // {number} [DEPRECATED]   \"from\": ###, // {number} Paging starting from   \"count\": ###, // {number} Paging count   \"versionDigest\": \"###\", // {string} Hash of full result, null if no result   \"values\": [...{...object...},{...object...},{...object...}...] } ```  #### Single value  ```json {   \"value\": {...single object...} } ```   ## WebHook envelope  ```json {   \"subscriptionId\": ###, // Subscription id   \"event\": \"object.verb\", // As listed from /v2/event/   \"id\": ###, // Id of object this event is for   \"value\": {... single object, null if object.deleted ...} } ```   ## Error/warning envelope  ```json {   \"status\": ###, // {number} HTTP status code   \"code\": #####, // {number} internal status code of event   \"message\": \"###\", // {string} Basic feedback message in your language   \"link\": \"###\", // {string} Link to doc   \"developerMessage\": \"###\", // {string} More technical message   \"validationMessages\": [ // {array} List of validation messages, can be null     {       \"field\": \"###\", // {string} Name of field       \"message\": \"###\" // {string} Validation message for field     }   ],   \"requestId\": \"###\" // {string} Same as x-tlx-request-id  } ```   ## Status codes / Error codes  - **200 OK** - **201 Created** - From POSTs that create something new. - **204 No Content** - When there is no answer, ex: \"/:anAction\" or DELETE. - **400 Bad request** -   -  **4000** Bad Request Exception   - **11000** Illegal Filter Exception   - **12000** Path Param Exception   - **24000** Cryptography Exception - **401 Unauthorized** - When authentication is required and has failed or has not yet been provided   -  **3000** Authentication Exception - **403 Forbidden** - When AuthorisationManager says no.   -  **9000** Security Exception - **404 Not Found** - For resources that does not exist.   -  **6000** Not Found Exception - **409 Conflict** - Such as an edit conflict between multiple simultaneous updates   -  **7000** Object Exists Exception   -  **8000** Revision Exception   - **10000** Locked Exception   - **14000** Duplicate entry - **422 Bad Request** - For Required fields or things like malformed payload.   - **15000** Value Validation Exception   - **16000** Mapping Exception   - **17000** Sorting Exception   - **18000** Validation Exception   - **21000** Param Exception   - **22000** Invalid JSON Exception   - **23000** Result Set Too Large Exception - **429 Too Many Requests** - Request rate limit hit - **500 Internal Error** - Unexpected condition was encountered and no more specific message is suitable   - **1000** Exception 
 
-OpenAPI spec version: 2.69.5
+OpenAPI spec version: 2.70.15
 
 Generated by: https://github.com/swagger-api/swagger-codegen.git
 Swagger Codegen version: 2.4.24
@@ -111,15 +111,20 @@ module TripletexRubyClient
     # Invoice debt collection and reminders.
     attr_accessor :reminders
 
-    # Invoice remarks - automatically stops reminder/notice of debt collection if specified.
+    # Deprecated Invoice remarks - please use the 'invoiceRemark' instead.
     attr_accessor :invoice_remarks
 
+    # Invoice remark - automatically stops reminder/notice of debt collection until specified date.
+    attr_accessor :invoice_remark
+
     # [BETA] Optional. Used to specify payment type for prepaid invoices. Payment type can be specified here, or as a parameter to the /invoice API endpoint.
     attr_accessor :payment_type_id
 
     # [BETA] Optional. Used to specify the prepaid amount of the invoice. The paid amount can be specified here, or as a parameter to the /invoice API endpoint.
     attr_accessor :paid_amount
 
+    attr_accessor :is_periodization_possible
+
     # [Deprecated] EHF (Peppol) send status. This only shows status for historic EHFs.
     attr_accessor :ehf_send_status
 
@@ -185,8 +190,10 @@ module TripletexRubyClient
         :'postings' => :'postings',
         :'reminders' => :'reminders',
         :'invoice_remarks' => :'invoiceRemarks',
+        :'invoice_remark' => :'invoiceRemark',
         :'payment_type_id' => :'paymentTypeId',
         :'paid_amount' => :'paidAmount',
+        :'is_periodization_possible' => :'isPeriodizationPossible',
         :'ehf_send_status' => :'ehfSendStatus'
       }
     end
@@ -231,8 +238,10 @@ module TripletexRubyClient
         :'postings' => :'Array<Posting>',
         :'reminders' => :'Array<Reminder>',
         :'invoice_remarks' => :'String',
+        :'invoice_remark' => :'InvoiceRemark',
         :'payment_type_id' => :'Integer',
         :'paid_amount' => :'Float',
+        :'is_periodization_possible' => :'BOOLEAN',
         :'ehf_send_status' => :'String'
       }
     end
@@ -407,6 +416,10 @@ module TripletexRubyClient
         self.invoice_remarks = attributes[:'invoiceRemarks']
       end
 
+      if attributes.has_key?(:'invoiceRemark')
+        self.invoice_remark = attributes[:'invoiceRemark']
+      end
+
       if attributes.has_key?(:'paymentTypeId')
         self.payment_type_id = attributes[:'paymentTypeId']
       end
@@ -415,6 +428,10 @@ module TripletexRubyClient
         self.paid_amount = attributes[:'paidAmount']
       end
 
+      if attributes.has_key?(:'isPeriodizationPossible')
+        self.is_periodization_possible = attributes[:'isPeriodizationPossible']
+      end
+
       if attributes.has_key?(:'ehfSendStatus')
         self.ehf_send_status = attributes[:'ehfSendStatus']
       end
@@ -547,8 +564,10 @@ module TripletexRubyClient
           postings == o.postings &&
           reminders == o.reminders &&
           invoice_remarks == o.invoice_remarks &&
+          invoice_remark == o.invoice_remark &&
           payment_type_id == o.payment_type_id &&
           paid_amount == o.paid_amount &&
+          is_periodization_possible == o.is_periodization_possible &&
           ehf_send_status == o.ehf_send_status
     end
 
@@ -561,7 +580,7 @@ module TripletexRubyClient
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [id, version, changes, url, invoice_number, invoice_date, customer, credited_invoice, is_credited, invoice_due_date, kid, invoice_comment, comment, orders, order_lines, travel_reports, project_invoice_details, voucher, delivery_date, amount, amount_currency, amount_excluding_vat, amount_excluding_vat_currency, amount_roundoff, amount_roundoff_currency, amount_outstanding, amount_currency_outstanding, amount_outstanding_total, amount_currency_outstanding_total, sum_remits, currency, is_credit_note, is_charged, is_approved, postings, reminders, invoice_remarks, payment_type_id, paid_amount, ehf_send_status].hash
+      [id, version, changes, url, invoice_number, invoice_date, customer, credited_invoice, is_credited, invoice_due_date, kid, invoice_comment, comment, orders, order_lines, travel_reports, project_invoice_details, voucher, delivery_date, amount, amount_currency, amount_excluding_vat, amount_excluding_vat_currency, amount_roundoff, amount_roundoff_currency, amount_outstanding, amount_currency_outstanding, amount_outstanding_total, amount_currency_outstanding_total, sum_remits, currency, is_credit_note, is_charged, is_approved, postings, reminders, invoice_remarks, invoice_remark, payment_type_id, paid_amount, is_periodization_possible, ehf_send_status].hash
     end
 
     # Builds the object from hash