beyond_api 0.5.1.pre → 0.6.0.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b482e3ba36e154ce480dbc1a7ac833456f73e14b3b1f033c4a8af702793c16d4
-  data.tar.gz: 6ef513a870018c2fc11fd9f21779fb48057179a45ba9d3cb78d5bd609f4452fb
+  metadata.gz: 31b8f47b376a95d1575e48fb7661397aa5c4e374fc6ac680b44d16dcd7bb4e5d
+  data.tar.gz: 5fb3e444da729827dee2f3ae336771b6ffc9d278150bcd371b115d9e7496dd7d
 SHA512:
-  metadata.gz: 1a5247f113f75d39102103cf411c7cbc4370083d1b7c456d07cfe48d846bd91229557e997999e150db5e1bc5f30654f449e67de40d7b9a9ea72765d5863e0a7b
-  data.tar.gz: fdd24ad0101b5da1af79993fe75992b06bd2703b57ff1f3d5646fbf29017d629331d97560adc11bf79663b8c788325e083b28e2579764675fd74f5787acac017
+  metadata.gz: fcf18ac9f5037a904f630cef79698edfe2ab1d4a9bdc417cf27a1f9e354d0df760dd2ff18416790774dc451bba569c7227de8c5bee7644b42cce35796dccc82a
+  data.tar.gz: 1126ed97396c7db4fdf721106a49471ba9c68c4f6c61f0a35f061b23e262acbdf78a9ea091a53eb8052a65ddb7edf9cb02a18a1920ae108fd949464745a1d692

data/CHANGELOG.md

@@ -1,7 +1,61 @@
+### v0.6.0.pre
+
+* bug-fixes
+  * Fix `Carts#create` method
+  * Fix `Carts#set_shipping_method_to_default` method
+  * Fix `OrderSettings#update` method
+  * Fix `Orders#capture_payment_process` method
+  * Fix `Orders#create_cancelation_process` method
+  * Fix `Products#attachments` method
+  * Fix `Products#adjust_stock_level` method
+  * Fix `Products#add_image` method
+  * Fix `Products#set_image_as_default` method
+  * Fix `ProductsView#all` method
+  * Fix `Shops#legal_content` method
+  * Fix `Shops#legal_contents` method
+  * Fix `Shops#update` method
+  * Fix `Users#verify_password` method
+
+* deprecations
+  * Remove `Orders#send_invoice` method
+  * Remove all product_settings methods
+  * Remove `ProductsView#search_by_query` method
+  * `Orders#update_order_note` receives parameter `order_note` instead of `body`
+  * `Products#adjust_stock_level` receives parameter `relative_amount` instead of `body`
+  * `Products#update_reserve_stock` receives parameter `stock_threshold` instead of `body`
+
+* features
+  * Add customers methods
+    * `Customers#all`
+    * `Customers#create`
+    * `Customers#delete`
+    * `Customers#find`
+    * `Customers#update`
+  * Add `Orders#send_order_document` method
+  * Add products cross-sells methods
+    * `ProductCrossSells#create_cross_sell`
+    * `ProductCrossSells#cross_sell`
+    * `ProductCrossSells#cross_sells`
+    * `ProductCrossSells#delete_cross_sell`
+    * `ProductCrossSells#update_cross_sell`
+  * Add products videos methods
+    * `ProductVideos#add_video`
+    * `ProductVideos#delete_video`
+    * `ProductVideos#update_video`
+    * `ProductVideos#video`
+    * `ProductVideos#videos`
+  * Add `Products#sort_images` method
+  * Add variation images methods
+    * `VariationImages#add_image`
+    * `VariationImages#delete_image`
+    * `VariationImages#image`
+    * `VariationImages#images`
+    * `VariationImages#upload_image`
+
 ### v0.5.1.pre
 
 * bug-fixes
-  * Fix `adjust_stock_level` method
+  * Fix `Products#adjust_stock_level` method
 
 ### v0.5.0.pre
 
@@ -16,8 +70,8 @@
 ### v0.4.0.pre
 
 * bug-fixes
-  * Fix product attribute definition `create` method
-  * Fix product attribute definition `delete` method
+  * Fix `ProductAttributeDefinitions#create` method
+  * Fix `ProductAttributeDefinitions#delete` method
   * Fix product custom attribute module name
   * Include `BeyondApi::ProductCustomAttributes` module into `BeyondApi::Products` class
   * Include `BeyondApi::ProductImages` module into `BeyondApi::Products` class

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    beyond_api (0.5.1.pre)
+    beyond_api (0.6.0.pre)
       faraday (~> 0.15)
 
 GEM
@@ -13,7 +13,7 @@ GEM
     dotenv (2.7.5)
     faker (2.4.0)
       i18n (~> 1.6.0)
-    faraday (0.17.1)
+    faraday (0.17.3)
       multipart-post (>= 1.2, < 3)
     i18n (1.6.0)
       concurrent-ruby (~> 1.0)
@@ -52,4 +52,4 @@ DEPENDENCIES
   yard (~> 0.9)
 
 BUNDLED WITH
-   2.0.2
+   2.1.0.pre.3

data/lib/beyond_api/resources/carts.rb

@@ -43,8 +43,8 @@ module BeyondApi
     # @example
     #   @cart = session.carts.create
     #
-    def create(body)
-      response, status = BeyondApi::Request.post(@session, "/carts", body)
+    def create
+      response, status = BeyondApi::Request.post(@session, "/carts")
 
       handle_response(response, status)
     end
@@ -202,7 +202,7 @@ module BeyondApi
     # @return true
     #
     # @example
-    #   session.carts.delete_line_item("2fa7dc36-8305-4628-b961-f2c3f7dda47d")
+    #   session.carts.delete_shipping_address("2fa7dc36-8305-4628-b961-f2c3f7dda47d")
     #
     def delete_shipping_address(cart_id)
       response, status = BeyondApi::Request.delete(@session, "/carts/#{cart_id}/shipping-address")
@@ -290,6 +290,7 @@ module BeyondApi
     #     "_ref" => "f084553c-ea77-4745-b1bd-71c64c8419fd",
     #     "quantity" => 2
     #   }
+    #
     #   @cart = session.carts.replace_line_item("f73629e5-fecf-4474-9b04-6b2fcd4663c4", "2c9c0f38-0b9e-4fa7-bcbe-960098ff63aa", body)
     #
     def replace_line_item(cart_id, line_item_id, body)
@@ -311,8 +312,13 @@ module BeyondApi
     # @return [OpenStruct]
     #
     # @example
-    #   body = [{"_type":"PRODUCT","_ref":"0612362d-9856-4b40-94c6-a36abec0cf8c","quantity":1}]
-    #   @cart = session.carts.replace_line_item("c1436110-e283-49b3-a748-0321efec6d35", body)
+    #   body = [ {
+    #     "_type" => "PRODUCT",
+    #     "_ref" => "0612362d-9856-4b40-94c6-a36abec0cf8c",
+    #     "quantity" => 1 
+    #   } ]
+    #
+    #   @cart = session.carts.replace_line_items("c1436110-e283-49b3-a748-0321efec6d35", body)
     #
     def replace_line_items(cart_id, body)
       response, status = BeyondApi::Request.put(@session, "/carts/#{cart_id}/line-items", body)
@@ -361,6 +367,7 @@ module BeyondApi
     #     "taxNumber" => "123-34-6789",
     #     "birthDate" => "1985-03-20"
     #   }
+    #
     #   @cart = session.carts.set_billing_address("01da6aa7-8aa2-4383-a496-6611a14afbc9", body)
     #
     def set_billing_address(cart_id, body)
@@ -453,6 +460,7 @@ module BeyondApi
     #     "taxNumber" => "123-34-6789",
     #     "birthDate" => "1985-03-20"
     #   }
+    #
     #   @cart = session.carts.set_shipping_address("01da6aa7-8aa2-4383-a496-6611a14afbc9", body)
     #
     def set_shipping_address(cart_id, body)
@@ -489,7 +497,7 @@ module BeyondApi
     # A +PUT+ request is used to set the shipping method to the current default shipping method.
     # The default shipping method is the one with the highest priority of the applicable shipping methods.
     #
-    #   $ curl 'https://api-shop.beyondshop.cloud/api/carts/64efe22b-2699-4032-a2c9-c94a2e4fa425/shipping-methods/default' -i -X PUT \
+    #   $ curl 'https://api-shop.beyondshop.cloud/api/carts/c31c5d06-4460-4f89-9e09-47f9956dea98/shipping-methods/default' -i -X PUT \
     #       -H 'Content-Type: application/json' \
     #       -H 'Accept: application/json'
     #
@@ -498,11 +506,10 @@ module BeyondApi
     # @return [OpenStruct]
     #
     # @example
-    #   @cart = session.carts.set_shipping_method_to_default("a4e7922a-f895-4a7d-8cb1-6ecf74d7ceba")
+    #   @cart = session.carts.set_shipping_method_to_default("c31c5d06-4460-4f89-9e09-47f9956dea98")
     #
     def set_shipping_method_to_default(cart_id)
-      response, status = BeyondApi::Request.put(@session, "/carts/#{cart_id}/shipping-methods/current",
-                                                "#{session.api_url}/shipping-zones/#{shipping_zone_id}/shipping-methods/#{shipping_method_id}")
+      response, status = BeyondApi::Request.put(@session, "/carts/#{cart_id}/shipping-methods/default")
 
       handle_response(response, status)
     end
@@ -523,6 +530,7 @@ module BeyondApi
     #
     def shipping_method(cart_id)
       response, status = BeyondApi::Request.get(@session, "/carts/#{cart_id}")
+
       handle_response(response, status)
     end
 
@@ -541,6 +549,7 @@ module BeyondApi
     #
     def shipping_methods(cart_id)
       response, status = BeyondApi::Request.get(@session, "/carts/#{cart_id}")
+
       handle_response(response, status)
     end
   end

data/lib/beyond_api/resources/categories.rb

@@ -96,7 +96,7 @@ module BeyondApi
     # @return [OpenStruct]
     #
     # @example
-    #   @category = session.categories.find(category_id)
+    #   @category = session.categories.find("27a94b71-9b17-4f06-9596-fbbf4d18021f")
     #
     def find(category_id)
       response, status = BeyondApi::Request.get(@session, "/categories/#{category_id}")
@@ -135,7 +135,7 @@ module BeyondApi
     end
 
     #
-    # A PUT request is issued to update all category properties with application/json content type.
+    # A +PUT+ request is issued to update all category properties with application/json content type.
     #
     #   $ curl 'https://api-shop.beyondshop.cloud/api/categories/cb2058dc-871a-4e64-83ac-39a0be9e6f82' -i -X PUT \
     #       -H 'Content-Type: application/json' \

data/lib/beyond_api/resources/categories_view.rb

@@ -126,12 +126,23 @@ module BeyondApi
     #     }
     #   }'
     #
-    # @param product_id [String] the product UUID of the category
+    # @param body [Hash] the request body
+    # @option params [Integer] :size the page size
+    # @option params [Integer] :page the page number
     #
     # @return [OpenStruct]
     #
     # @example
-    #   @category = session.categories_view.search_by_product_id("ba68427f-603c-4741-9185-3b379f7769b5")
+    #   body = {
+    #     "tags" => [ "books" ],
+    #     "manufacturer" => "The Standard Manufacturer",
+    #     "sales_price" => {
+    #       "amount" => 10.0,
+    #       "currency" => "EUR"
+    #     }
+    #   }
+    #
+    #   @categories = session.categories_view.search_by_product(body, { size: 100, page: 0 })
     #
     def search_by_product(body, params = {})
       response, status = BeyondApi::Request.post(@session, "/product-view/categories/search/find-by-product", body, params)

data/lib/beyond_api/resources/checkout_settings.rb

@@ -32,13 +32,28 @@ module BeyondApi
     #       -H 'Content-Type: application/json' \
     #       -H 'Accept: application/hal+json' \
     #       -H 'Authorization: Bearer <Access token>' \
-    #       -d ' {
+    #       -d '{
     #       "minimumOrderValue" : {
     #         "currency" : "EUR",
     #         "amount" : 50
     #       },
     #       "mustAcceptTermsAndConditions" : true
     #   }'
+    #
+    # @beyond_api.scopes +cset:u+
+    #
+    # @return [OpenStruct]
+    #
+    # @example
+    #   body = {
+    #       "minimum_order_value" => {
+    #         "currency" => "EUR",
+    #         "amount" => 50
+    #       },
+    #       "must_accept_terms_and_conditions" => true
+    #   }
+    #   @checkout_settiongs = session.checkout_settings.update(body)
+    #
     def update(body)
       response, status = BeyondApi::Request.put(@session, "/checkout-settings", body)
 

data/lib/beyond_api/resources/customers.rb

@@ -0,0 +1,333 @@
+# frozen_string_literal: true
+
+require "beyond_api/utils"
+
+module BeyondApi
+  class Customers < Base
+    include BeyondApi::Utils
+
+    #
+    # A +GET+ request is used to list all customers of the shop in a paged way. Each item in the response represents a summary of the customer data.
+    #
+    #   $ curl 'https://api-shop.beyondshop.cloud/api/customers' -i -X GET \
+    #       -H 'Authorization: Bearer <Access token>'
+    #
+    # @beyond_api.scopes +cust:r+
+    #
+    # @option params [Integer] :size the page size
+    # @option params [Integer] :page the page number
+    #
+    # @return [OpenStruct]
+    #
+    # @example
+    #   @customers = session.customers.all(size: 20, page: 0)
+    #
+    def all(params = {})
+      response, status = BeyondApi::Request.get(@session, "/customers", params)
+
+      handle_response(response, status)
+    end
+
+    #
+    # A +POST+ request is used to create a customer.
+    #
+    #   $ curl 'https://api-shop.beyondshop.cloud/api/customers' -i -X POST \
+    #       -H 'Content-Type: application/json' \
+    #       -H 'Accept: application/hal+json' \
+    #       -H 'Authorization: Bearer <Access token>' \
+    #       -d '{
+    #       "defaultPaymentMethodId" : "69923864-74a7-4ea9-92c7-0d17181b39f4",
+    #       "defaultShippingMethodId" : "a5976ec2-d99a-4d16-bd2b-1fa5c48d68aa",
+    #       "shippingAddress" : {
+    #         "salutation" : "Mrs",
+    #         "gender" : "FEMALE",
+    #         "company" : "Astrid Alster GmbH",
+    #         "title" : "",
+    #         "firstName" : "Astrid",
+    #         "middleName" : "Agnes",
+    #         "lastName" : "Alster",
+    #         "street" : "Alsterwasserweg",
+    #         "houseNumber" : "2",
+    #         "street2" : "Erdgeschoss",
+    #         "addressExtension" : "Hinterhof",
+    #         "postalCode" : "20999",
+    #         "dependentLocality" : "Seevetal",
+    #         "city" : "Alsterwasser",
+    #         "country" : "DE",
+    #         "state" : "Hamburg",
+    #         "email" : "a.alsterh@example.com",
+    #         "phone" : "(800) 555-0102",
+    #         "mobile" : "(800) 555-0103",
+    #         "doorCode" : "456",
+    #         "_id" : null
+    #       },
+    #       "email" : "a.alsterh@example.com",
+    #       "initialPassword" : "MyVeryStrongPassword",
+    #       "billingAddress" : {
+    #         "salutation" : "Mrs",
+    #         "gender" : "FEMALE",
+    #         "company" : "Astrid Alster GmbH",
+    #         "title" : "",
+    #         "firstName" : "Astrid",
+    #         "middleName" : "Agnes",
+    #         "lastName" : "Alster",
+    #         "street" : "Alsterwasserweg",
+    #         "houseNumber" : "2",
+    #         "street2" : "Erdgeschoss",
+    #         "addressExtension" : "Hinterhof",
+    #         "postalCode" : "20999",
+    #         "dependentLocality" : "Seevetal",
+    #         "city" : "Alsterwasser",
+    #         "country" : "DE",
+    #         "state" : "Hamburg",
+    #         "email" : "a.alsterh@example.com",
+    #         "phone" : "(800) 555-0102",
+    #         "mobile" : "(800) 555-0103",
+    #         "vatId" : "DE123456789",
+    #         "taxNumber" : "HRE 987654/32123/864516",
+    #         "birthDate" : "1985-05-11",
+    #         "_id" : "b61ca0e0-411f-485e-83f3-035d717095da"
+    #       }
+    #   }'
+    #
+    # @beyond_api.scopes +cust:c+
+    #
+    # @param body [Hash] the request body
+    #
+    # @return [OpenStruct]
+    #
+    # @example
+    #   body = {
+    #     "defaultPaymentMethodId" : "69923864-74a7-4ea9-92c7-0d17181b39f4",
+    #     "defaultShippingMethodId" : "a5976ec2-d99a-4d16-bd2b-1fa5c48d68aa",
+    #     "shippingAddress" : {
+    #       "salutation" : "Mrs",
+    #       "gender" : "FEMALE",
+    #       "company" : "Astrid Alster GmbH",
+    #       "title" : "",
+    #       "firstName" : "Astrid",
+    #       "middleName" : "Agnes",
+    #       "lastName" : "Alster",
+    #       "street" : "Alsterwasserweg",
+    #       "houseNumber" : "2",
+    #       "street2" : "Erdgeschoss",
+    #       "addressExtension" : "Hinterhof",
+    #       "postalCode" : "20999",
+    #       "dependentLocality" : "Seevetal",
+    #       "city" : "Alsterwasser",
+    #       "country" : "DE",
+    #       "state" : "Hamburg",
+    #       "email" : "a.alsterh@example.com",
+    #       "phone" : "(800) 555-0102",
+    #       "mobile" : "(800) 555-0103",
+    #       "doorCode" : "456",
+    #       "_id" : null
+    #     },
+    #     "email" : "a.alsterh@example.com",
+    #     "initialPassword" : "MyVeryStrongPassword",
+    #     "billingAddress" : {
+    #       "salutation" : "Mrs",
+    #       "gender" : "FEMALE",
+    #       "company" : "Astrid Alster GmbH",
+    #       "title" : "",
+    #       "firstName" : "Astrid",
+    #       "middleName" : "Agnes",
+    #       "lastName" : "Alster",
+    #       "street" : "Alsterwasserweg",
+    #       "houseNumber" : "2",
+    #       "street2" : "Erdgeschoss",
+    #       "addressExtension" : "Hinterhof",
+    #       "postalCode" : "20999",
+    #       "dependentLocality" : "Seevetal",
+    #       "city" : "Alsterwasser",
+    #       "country" : "DE",
+    #       "state" : "Hamburg",
+    #       "email" : "a.alsterh@example.com",
+    #       "phone" : "(800) 555-0102",
+    #       "mobile" : "(800) 555-0103",
+    #       "vatId" : "DE123456789",
+    #       "taxNumber" : "HRE 987654/32123/864516",
+    #       "birthDate" : "1985-05-11",
+    #       "_id" : "b61ca0e0-411f-485e-83f3-035d717095da"
+    #     }
+    #   }
+    #
+    #   @customer = session.customers.create(body)
+    #
+    def create(body)
+      response, status = BeyondApi::Request.post(@session, "/customers", body)
+
+      handle_response(response, status)
+    end
+
+    #
+    # A +DELETE+ request is used to delete a customer.
+    #
+    #   $ curl 'https://api-shop.beyondshop.cloud/api/customers/9e2a61d9-a1ac-4771-bd02-32bf50386392' -i -X DELETE \
+    #       -H 'Authorization: Bearer <Access token>'
+    #
+    # @beyond_api.scopes +cust:d+
+    #
+    # @param customer_id [String] the customer UUID
+    #
+    # @return true
+    #
+    # @example
+    #   session.customers.delete("9e2a61d9-a1ac-4771-bd02-32bf50386392")
+    #
+    def delete(customer_id)
+      response, status = BeyondApi::Request.delete(@session, "/customers/#{customer_id}")
+
+      handle_response(response, status, respond_with_true: true)
+    end
+
+    #
+    # A +GET+ request is used to retrieve the details of a customer.
+    #
+    #   $ curl 'https://api-shop.beyondshop.cloud/api/customers/d6a8132e-29b3-4258-b8c0-aee34df42aa1' -i -X GET \
+    #       -H 'Authorization: Bearer <Access token>'
+    #
+    # @beyond_api.scopes +cust:r+
+    #
+    # @param customer_id [String] the customer UUID
+    #
+    # @return [OpenStruct]
+    #
+    # @example
+    #   @customer = session.customers.find("d6a8132e-29b3-4258-b8c0-aee34df42aa1")
+    #
+    def find(customer_id)
+      response, status = BeyondApi::Request.get(@session, "/customers/#{customer_id}")
+
+      handle_response(response, status)
+    end
+
+    #
+    # A +PUT+ request is used to update a customer.
+    #
+    #   $ curl 'https://api-shop.beyondshop.cloud/api/customers/34c5566b-e82a-486d-9a7d-3c3aafef6901' -i -X PUT \
+    #       -H 'Content-Type: application/json' \
+    #       -H 'Accept: application/hal+json' \
+    #       -H 'Authorization: Bearer <Access token>' \
+    #       -d '{
+    #       "defaultPaymentMethodId" : "d94790cd-ec27-4461-85a9-457fffcc0271",
+    #       "defaultShippingMethodId" : "976e7d66-0eb2-4ca3-8b44-5e6d0aeb9e63",
+    #       "shippingAddress" : {
+    #         "salutation" : "Mrs",
+    #         "gender" : "FEMALE",
+    #         "company" : "Astrid Alster GmbH",
+    #         "title" : "",
+    #         "firstName" : "Astrid",
+    #         "middleName" : "Agnes",
+    #         "lastName" : "Alster",
+    #         "street" : "Alsterwasserweg",
+    #         "houseNumber" : "2",
+    #         "street2" : "Erdgeschoss",
+    #         "addressExtension" : "Hinterhof",
+    #         "postalCode" : "20999",
+    #         "dependentLocality" : "Seevetal",
+    #         "city" : "Alsterwasser",
+    #         "country" : "DE",
+    #         "state" : "Hamburg",
+    #         "email" : "a.alsterh@example.com",
+    #         "phone" : "(800) 555-0102",
+    #         "mobile" : "(800) 555-0103",
+    #         "doorCode" : "456",
+    #         "_id" : "112d46ff-fc72-4be8-9e48-588b4f5c7829"
+    #       },
+    #       "billingAddress" : {
+    #         "salutation" : "Mrs",
+    #         "gender" : "FEMALE",
+    #         "company" : "Astrid Alster GmbH",
+    #         "title" : "",
+    #         "firstName" : "Astrid",
+    #         "middleName" : "Agnes",
+    #         "lastName" : "Alster",
+    #         "street" : "Alsterwasserweg",
+    #         "houseNumber" : "2",
+    #         "street2" : "Erdgeschoss",
+    #         "addressExtension" : "Hinterhof",
+    #         "postalCode" : "20999",
+    #         "dependentLocality" : "Seevetal",
+    #         "city" : "Alsterwasser",
+    #         "country" : "DE",
+    #         "state" : "Hamburg",
+    #         "email" : "a.alsterh@example.com",
+    #         "phone" : "(800) 555-0102",
+    #         "mobile" : "(800) 555-0103",
+    #         "vatId" : "DE123456789",
+    #         "taxNumber" : "HRE 987654/32123/864516",
+    #         "birthDate" : "1985-05-11",
+    #         "_id" : "85de80fc-8467-46ca-b20c-55f5d4d1eaec"
+    #       }
+    #   }'
+    #
+    # @beyond_api.scopes +cust:u+
+    #
+    # @param customer_id [String] the customer UUID
+    # @param body [Hash] the request body
+    #
+    # @return [OpenStruct]
+    #
+    # @example
+    #   body = {
+    #     "defaultPaymentMethodId" : "d94790cd-ec27-4461-85a9-457fffcc0271",
+    #     "defaultShippingMethodId" : "976e7d66-0eb2-4ca3-8b44-5e6d0aeb9e63",
+    #     "shippingAddress" : {
+    #       "salutation" : "Mrs",
+    #       "gender" : "FEMALE",
+    #       "company" : "Astrid Alster GmbH",
+    #       "title" : "",
+    #       "firstName" : "Astrid",
+    #       "middleName" : "Agnes",
+    #       "lastName" : "Alster",
+    #       "street" : "Alsterwasserweg",
+    #       "houseNumber" : "2",
+    #       "street2" : "Erdgeschoss",
+    #       "addressExtension" : "Hinterhof",
+    #       "postalCode" : "20999",
+    #       "dependentLocality" : "Seevetal",
+    #       "city" : "Alsterwasser",
+    #       "country" : "DE",
+    #       "state" : "Hamburg",
+    #       "email" : "a.alsterh@example.com",
+    #       "phone" : "(800) 555-0102",
+    #       "mobile" : "(800) 555-0103",
+    #       "doorCode" : "456",
+    #       "_id" : "112d46ff-fc72-4be8-9e48-588b4f5c7829"
+    #     },
+    #     "billingAddress" : {
+    #       "salutation" : "Mrs",
+    #       "gender" : "FEMALE",
+    #       "company" : "Astrid Alster GmbH",
+    #       "title" : "",
+    #       "firstName" : "Astrid",
+    #       "middleName" : "Agnes",
+    #       "lastName" : "Alster",
+    #       "street" : "Alsterwasserweg",
+    #       "houseNumber" : "2",
+    #       "street2" : "Erdgeschoss",
+    #       "addressExtension" : "Hinterhof",
+    #       "postalCode" : "20999",
+    #       "dependentLocality" : "Seevetal",
+    #       "city" : "Alsterwasser",
+    #       "country" : "DE",
+    #       "state" : "Hamburg",
+    #       "email" : "a.alsterh@example.com",
+    #       "phone" : "(800) 555-0102",
+    #       "mobile" : "(800) 555-0103",
+    #       "vatId" : "DE123456789",
+    #       "taxNumber" : "HRE 987654/32123/864516",
+    #       "birthDate" : "1985-05-11",
+    #       "_id" : "85de80fc-8467-46ca-b20c-55f5d4d1eaec"
+    #     }
+    #   }
+    #   @customer = session.customers.update("34c5566b-e82a-486d-9a7d-3c3aafef6901", body)
+    #
+    def update(customer_id, body)
+      response, status = BeyondApi::Request.put(@session, "/customers/#{customer_id}", body)
+
+      handle_response(response, status)
+    end
+  end
+end

data/lib/beyond_api/resources/newsletter_target.rb

@@ -60,7 +60,7 @@ module BeyondApi
     # @return [OpenStruct]
     #
     # @example
-    #   session.newsletter_target.find
+    #   @newsletter_target = session.newsletter_target.find
     #
     def find
       response, status = BeyondApi::Request.get(@session, "/newsletter-target")