zaikio-procurement 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f50427e350fe6e3c2a06efb244a9fef456e8ab840acf5c3d49384d0e242413b5
+  data.tar.gz: bb0358367208742ff48cd09762dc5187301d45e76a50f43015ba8a4a5606c99d
+SHA512:
+  metadata.gz: 5dd46c3947dc8be40214939fd975306ff6578b94a5e22dc4aa93a649a97354d9b4f0939aabd7e0bb15441f44438e8756d05e9e6b4a75404732a57a3c2315693b
+  data.tar.gz: e1ec9997f5c0545d6211612b08fa91553369cb73ba792ec0f9318639c1ac569041e5a4464ee721bcc36bd38a92f66592e416ea239e3137828c3d7b362cb0a36f

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2020 Zaikio GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,140 @@
+# Zaikio::Procurement
+
+Ruby API Client for Zaikio's Procurement Platform.
+
+## Installation
+
+### 1. Add this line to your application's Gemfile:
+
+```ruby
+gem 'zaikio-procurement'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install zaikio-procurement
+```
+
+### 2. Configure the gem:
+
+```rb
+# config/initializers/zaikio_procurement.rb
+
+Zaikio::Procurement.configure do |config|
+  config.environment = :production # sandbox or production
+end
+```
+
+
+## Usage
+
+The Procurement Client has an ORM like design.
+
+For the requests to work, a valid JSON Web token with the correct OAuth Scopes must always be provided. Please refer to [zakio-oauth_client](https://github.com/zaikio/zaikio-oauth_client).
+
+If you want to know which actions are available and which scopes are required, please refer to the [Procurement Consumer API Reference](https://docs.zaikio.com/api/procurement_consumers/procurement.html).
+
+### As an organization
+
+```rb
+token = "..." # Your valid JWT for an organization
+Zaikio::Procurement.with_token(token) do
+
+  # Fetch Data
+  Zaikio::Procurement::Article.all
+  Zaikio::Procurement::Article.find("7cbf51bd-35a8-47a1-84a2-57aa63140234")
+  Zaikio::Procurement::Article.list_by_article_type_or_supplier_slug("great_paper_company")
+
+  # Associations
+  article = Zaikio::Procurement::Article.find("7cbf51bd-35a8-47a1-84a2-57aa63140234")
+  article.supplier
+  article.variants
+
+  # Search for all variants of a substrate
+  search = Zaikio::Procurement::SubstrateSearch.new("Magno", grain: "long", paper_weight: 80)
+
+  # or by providing a supplier_id to search for all variants of a substrate of from a specific supplier
+  search = Zaikio::Procurement::SubstrateSearch.new("Magno", grain: "long", paper_weight: 80, supplier_id: "b5b14aa0-ae84-452b-9719-a38545365902")
+
+  search.results # Returns a list of matching variants
+  search.facets # Returns a list of search facets that can be used to further narrow down the results
+
+  # https://docs.zaikio.com/api/procurement_consumers/procurement.html#/LineItemSuggestions/post_variants__variant_id__line_item_suggestions
+  variant = Zaikio::Procurement::Variant.find("845a4d7e-db5a-46a6-9d30-bf2e884cb393")
+  variant.line_item_suggestion(amount: 10, unit: "sheet") # Returns a line item suggestion for a specifc variant
+
+  # https://docs.zaikio.com/api/procurement_consumers/procurement.html#/LineItemSuggestions/post_suppliers__supplier_id__line_item_suggestions
+  supplier = Zaikio::Procurement::Supplier.find("b5b14aa0-ae84-452b-9719-a38545365902")
+  supplier.line_item_suggestions(
+    variants: [
+      {
+        id: "0001b94e-4e87-4ee9-8b14-6ff9910b4f26",
+        amount: 2000,
+        exact_amount: false,
+        environmental_certification: "FSC Mix Credit",
+        unit: "sheet"
+      },
+      {
+        id: "10236394-ecd4-465b-ab72-0fbd79296e6a",
+        amount: 10,
+        exact_amount: false,
+        environmental_certification: "PEFC 100%",
+        unit: "sheet"
+      }
+    ]
+  ) # Returns line item suggestions for multiple variants of a supplier
+
+
+  # Create new resources
+  Zaikio::Procurement::Order.create(
+    contract_id: "fd677fc7-abd9-460c-b086-34de1a8349e8",
+    delivery_mode: "complete",
+    exclusive_sales_group_id: "42dcbaf6-e557-4423-96bc-707ebbc223c0",
+    references: ["CO/XXXXXX"],
+    state_event: "place",
+    deliveries_attributes: [
+      {
+        address_addressee: "Joey’s Print Ltd",
+        address_text: "Emmerich-Josef-Straße 1A, 55116 Mainz",
+        desired_delivery_date: "2021-01-29",
+        references: ["D/XXXXXX"]
+      }
+    ],
+    order_line_items_attributes: [
+      {
+        sku_id: "26b3aadc-928f-4d1a-ba2d-13ac3c8f523d",
+        amount: 108000
+      }
+    ]
+  )
+
+  order = Zaikio::Procurement::Order.find("86b4a0c5-6d54-4702-a059-da258643f260")
+  order.order_line_items.create(sku_id: "6535eeb0-45c2-4c63-8cb9-4814562bb875", amount: 68000)
+
+  # Update resources
+  line_item = Zaikio::Procurement::OrderLineItem.find("058a5513-925e-4d0c-923d-fa1ed4bfb3ce")
+  line_item.update(amount: 69000)
+
+  # Deleting resources
+  line_item = Zaikio::Procurement::OrderLineItem.find("2f5a99c2-9734-4aac-9cee-911b061d3a5a")
+  line_item.destroy
+end
+```
+
+### Error Handling
+
+If an unexpected error occurs with an API call (i.e. an error that has no status code `2xx`, `404` or `422`) then a `Zaikio::ConnectionError` is thrown automatically (for `404` there will be a `Zaikio::ResourceNotFound`).
+
+This can be easily caught using the `with_fallback` method. We recommend to always work with fallbacks.
+
+```rb
+Zaikio::Directory.with_token(token) do
+  Zaikio::Procurement::Article.with_fallback.find("7cbf51bd-35a8-47a1-84a2-57aa63140234") # => nil
+  Zaikio::Procurement::Article.with_fallback.all # Automatically uses empty array as fallback
+end
+```

data/Rakefile

@@ -0,0 +1,37 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+require 'rubocop/rake_task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Zaikio::Procurement'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test
+
+namespace :test do
+  desc 'Runs RuboCop on specified directories'
+  RuboCop::RakeTask.new(:rubocop) do |task|
+    task.fail_on_error = false
+  end
+end
+
+Rake::Task[:test].enhance ['test:rubocop']

data/lib/zaikio/procurement/article.rb

@@ -0,0 +1,35 @@
+module Zaikio
+  module Procurement
+    class Article < Base
+      include_root_in_json :article
+
+      # Class methods
+      class << self
+        # Spyke URI override
+        def uri
+          Zaikio::Procurement.configuration.flavor == :supplier ? "substrate/articles(/:id)" : "articles(/:id)"
+        end
+
+        def list_by_article_type_or_supplier_slug(type_or_slug)
+          with("#{type_or_slug}/articles").get
+        end
+
+        def list_by_article_type_and_supplier_slug(type, slug)
+          with("#{type}/#{slug}/articles").get
+        end
+      end
+
+      # Attributes
+      attributes :name, :base_unit, :coated, :description, :finish,
+                 :kind, :supplier_id, :created_at, :updated_at
+
+      # Associations
+      has_one :supplier,  class_name: "Zaikio::Procurement::Supplier",
+                          uri: nil
+      # Manually build variants association to work for consumers and suppliers
+      def variants
+        self.class.request(:get, "#{uri}/variants").data.collect { |v| Zaikio::Procurement::Variant.new(v) }
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/authorization_middleware.rb

@@ -0,0 +1,30 @@
+require "faraday"
+require "jwt"
+require "concurrent"
+
+module Zaikio
+  module Procurement
+    class AuthorizationMiddleware < Faraday::Middleware
+      def self.token
+        @token ||= Concurrent::ThreadLocalVar.new { nil }
+        @token.value
+      end
+
+      def self.token=(value)
+        @token ||= Concurrent::ThreadLocalVar.new { nil }
+        @token.value = value
+      end
+
+      def self.reset_token
+        self.token = nil
+      end
+
+      def call(request_env)
+        request_env[:request_headers]["Authorization"] = "Bearer #{self.class.token}" if self.class.token
+
+        @app.call(request_env).on_complete do |response_env|
+        end
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/base.rb

@@ -0,0 +1,7 @@
+module Zaikio
+  module Procurement
+    class Base < Zaikio::Client::Model
+      self.callback_methods = { create: :post, update: :patch }.freeze
+    end
+  end
+end

data/lib/zaikio/procurement/configuration.rb

@@ -0,0 +1,49 @@
+require "logger"
+
+module Zaikio
+  module Procurement
+    class Configuration
+      HOSTS = {
+        development: "https://procurement.zaikio.test",
+        test: "https://procurement.zaikio.test",
+        staging: "https://procurement.staging.zaikio.com",
+        sandbox: "https://procurement.sandbox.zaikio.com",
+        production: "https://procurement.zaikio.com"
+      }.freeze
+
+      FLAVORS = %i[consumer supplier].freeze
+
+      attr_accessor :host
+      attr_reader :environment, :flavor
+      attr_writer :logger
+
+      def initialize
+        @environment = :sandbox
+        @flavor      = :consumer
+      end
+
+      def logger
+        @logger ||= Logger.new($stdout)
+      end
+
+      def environment=(env)
+        @environment = env.to_sym
+        @host = host_for(environment)
+      end
+
+      def flavor=(flavor)
+        raise StandardError.new, "Invalid Zaikio::Procurement flavor '#{flavor}'" unless FLAVORS.include?(flavor)
+
+        @flavor = flavor
+      end
+
+      private
+
+      def host_for(environment)
+        HOSTS.fetch(environment) do
+          raise StandardError.new, "Invalid Zaikio::Procurement environment '#{environment}'"
+        end
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/contract.rb

@@ -0,0 +1,17 @@
+module Zaikio
+  module Procurement
+    class Contract < Base
+      uri "contracts(/:id)"
+      include_root_in_json :contract
+
+      # Attributes
+      attributes :currency, :customer_number, :references, :consumer_id,
+                 :consumer, :supplier_id, :created_at, :updated_at
+
+      # Associations
+      has_one :supplier,  class_name: "Zaikio::Procurement::Supplier",
+                          uri: nil
+      has_one :contract_request, uri: nil
+    end
+  end
+end

data/lib/zaikio/procurement/contract_request.rb

@@ -0,0 +1,19 @@
+module Zaikio
+  module Procurement
+    class ContractRequest < Base
+      uri "contract_requests(/:id)"
+      include_root_in_json :contract_request
+
+      # Attributes
+      attributes :accepted_at, :connectivity_checked_at, :contact_email, :contact_first_name,
+                 :contact_last_name, :contact_phone, :currency, :customer_number, :declined_at,
+                 :mapped_at, :references, :state, :vetted_at, :consumer_id, :consumer, :supplier_id,
+                 :created_at, :updated_at
+
+      # Associations
+      belongs_to :supplier, class_name: "Zaikio::Procurement::Supplier",
+                            uri: nil
+      has_one :contract, uri: nil
+    end
+  end
+end

data/lib/zaikio/procurement/current_supplier.rb

@@ -0,0 +1,17 @@
+module Zaikio
+  module Procurement
+    class CurrentSupplier < Base
+      self.primary_key = nil
+      uri "supplier"
+      include_root_in_json :supplier
+
+      def self.find
+        all.find_one
+      end
+
+      def self.find_with_fallback(fallback)
+        all.with_fallback(fallback).find_one
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/delivery.rb

@@ -0,0 +1,18 @@
+module Zaikio
+  module Procurement
+    class Delivery < Base
+      uri "deliveries(/:id)"
+      include_root_in_json :delivery
+
+      # Attributes
+      attributes :confirmed_delivery_date, :desired_delivery_date, :references,
+                 :address, :order_id, :created_at, :updated_at
+
+      # Associations
+      belongs_to :order,             class_name: "Zaikio::Procurement::Order",
+                                     uri: nil
+      has_many :delivery_line_items, class_name: "Zaikio::Procurement::DeliveryLineItem",
+                                     uri: "deliveries/:delivery_id/delivery_line_items(/:id)"
+    end
+  end
+end

data/lib/zaikio/procurement/delivery_line_item.rb

@@ -0,0 +1,17 @@
+module Zaikio
+  module Procurement
+    class DeliveryLineItem < Base
+      uri "delivery_line_items(/:id)"
+      include_root_in_json :delivery_line_item
+
+      # Attributes
+      attributes :amount, :created_at, :updated_at
+
+      # Associations
+      belongs_to :delivery,     class_name: "Zaikio::Procurement::Delivery",
+                                uri: nil
+      has_one :order_line_item, class_name: "Zaikio::Procurement::OrderLineItem",
+                                uri: nil
+    end
+  end
+end

data/lib/zaikio/procurement/invoice.rb

@@ -0,0 +1,8 @@
+module Zaikio
+  module Procurement
+    class Invoice < Base
+      uri "invoices(/:id)"
+      include_root_in_json :invoice
+    end
+  end
+end

data/lib/zaikio/procurement/material_requirement.rb

@@ -0,0 +1,19 @@
+module Zaikio
+  module Procurement
+    class MaterialRequirement < Base
+      uri "material_requirements(/:id)"
+      include_root_in_json :material_requirement
+
+      # Attributes
+      attributes :amount, :anticipated_costs, :archived_at, :archived_by, :article_category, :canceled_at, :currency,
+                 :description, :environmental_certification, :expected_at, :fulfilled_at, :material_required_at,
+                 :ordered_at, :order_number, :person, :price, :purchaser, :price_based_on_quantity, :processed_at,
+                 :references, :state, :unit, :created_at, :updated_at
+
+      # Associations
+      has_one :supplier, class_name: "Zaikio::Procurement::Supplier", uri: nil
+      has_one :variant, class_name: "Zaikio::Procurement::Variant", uri: nil
+      has_many :order_line_items, class_name: "Zaikio::Procurement::OrderLineItem", uri: nil
+    end
+  end
+end

data/lib/zaikio/procurement/order.rb

@@ -0,0 +1,25 @@
+module Zaikio
+  module Procurement
+    class Order < Base
+      uri "orders(/:id)"
+      include_root_in_json :order
+
+      # Attributes
+      attributes :canceled_by_consumer_at, :canceled_by_supplier_at, :cancelation_requested_at, :confirmed_at,
+                 :currency, :delivery_mode, :gross_total, :net_handling_fee, :net_shipping_fee, :net_total,
+                 :partially_shipped_at, :partially_shipped_remainder_canceled_at, :placed_at, :producing_at,
+                 :references, :shipped_at, :state, :state_reason, :taxes, :taxes_on_fees, :transfer_failed_at,
+                 :transferred_at, :contract_id, :exclusive_sales_group_id, :person_id, :created_at, :updated_at
+
+      # Associations
+      has_one :contract,              class_name: "Zaikio::Procurement::Contract",
+                                      uri: "contracts(/:id)"
+      has_one :exclusive_sales_group, class_name: "Zaikio::Procurement::SalesGroup",
+                                      uri: "sales_groups(/:id)"
+      has_many :order_line_items,     class_name: "Zaikio::Procurement::OrderLineItem",
+                                      uri: "orders/:order_id/order_line_items(/:id)"
+      has_many :deliveries,           class_name: "Zaikio::Procurement::Delivery",
+                                      uri: "orders/:order_id/deliveries(/:id)"
+    end
+  end
+end

data/lib/zaikio/procurement/order_line_item.rb

@@ -0,0 +1,19 @@
+module Zaikio
+  module Procurement
+    class OrderLineItem < Base
+      uri "order_line_items(/:id)"
+      include_root_in_json :order_line_item
+
+      # Attributes
+      attributes :amount, :amount_in_base_unit, :base_unit, :catalog_price, :confirmed_price, :description,
+                 :order_number, :tax_rate, :taxes, :total_gross_price, :total_net_price, :unit, :order_id,
+                 :sku_id, :created_at, :updated_at
+
+      # Associations
+      belongs_to :order, class_name: "Zaikio::Procurement::Order",
+                         uri: nil
+      has_one :sku,      class_name: "Zaikio::Procurement::Sku",
+                         uri: nil
+    end
+  end
+end

data/lib/zaikio/procurement/price.rb

@@ -0,0 +1,18 @@
+module Zaikio
+  module Procurement
+    class Price < Base
+      uri "prices(/:id)"
+      include_root_in_json :price
+
+      # Attributes
+      attributes :kind, :minimum_order_quantity, :order_number, :price, :valid_from,
+                 :valid_until, :sales_group_id, :sku_id, :created_at, :updated_at
+
+      # Associations
+      has_one :sku,         class_name: "Zaikio::Procurement::Sku",
+                            uri: nil
+      has_one :sales_group, class_name: "Zaikio::Procurement::SalesGroup",
+                            uri: nil
+    end
+  end
+end

data/lib/zaikio/procurement/sales_group.rb

@@ -0,0 +1,11 @@
+module Zaikio
+  module Procurement
+    class SalesGroup < Base
+      uri "sales_groups(/:id)"
+      include_root_in_json :sales_group
+
+      # Attributes
+      attributes :currency, :exclusive, :name, :created_at, :updated_at
+    end
+  end
+end

data/lib/zaikio/procurement/sales_group_membership.rb

@@ -0,0 +1,11 @@
+module Zaikio
+  module Procurement
+    class SalesGroupMembership < Base
+      uri "sales_group_memberships(/:id)"
+      include_root_in_json :sales_group_membership
+
+      # Attributes
+      attributes :contract, :sales_group, :created_at, :updated_at
+    end
+  end
+end

data/lib/zaikio/procurement/sku.rb

@@ -0,0 +1,28 @@
+module Zaikio
+  module Procurement
+    class Sku < Base
+      uri "skus(/:id)"
+      include_root_in_json :sku
+
+      # Attributes
+      attributes :amount, :amount_in_base_unit, :availability_in_days, :dimension_unit,
+                 :environmental_certification, :gross_weight, :height, :length, :net_weight,
+                 :order_number, :unit, :weight_unit, :width, :variant_id, :created_at, :updated_at
+
+      # Associations
+      has_many :prices, class_name: "Zaikio::Procurement::Price",
+                        uri: "skus/:sku_id/prices"
+
+      # Manually build variant association to work for consumers and suppliers
+      def variant
+        path = if Zaikio::Procurement.configuration.flavor == :supplier
+                 "substrate/variants/#{variant_id}"
+               else
+                 "variants/#{variant_id}"
+               end
+
+        Zaikio::Procurement::Variant.new(self.class.request(:get, path).data)
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/substrate_search.rb

@@ -0,0 +1,38 @@
+module Zaikio
+  module Procurement
+    class SubstrateSearch
+      def initialize(query = nil, options = {})
+        @query        = query
+        @supplier     = options.delete(:supplier_id)
+        @options      = options
+        @article_type = "substrate"
+
+        unless @options.respond_to?(:stringify_keys)
+          raise ArgumentError, "When using additional search parameters, you must pass a hash as an argument."
+        end
+
+        @response = Zaikio::Procurement::Base.with(path).get
+      end
+
+      def results
+        @response.results.collect { |variant| Zaikio::Procurement::Variant.new(variant) }
+      end
+
+      def facets
+        @response.facets
+      end
+
+      private
+
+      def path
+        String.new(@article_type).tap do |qp|
+          qp << "/#{@supplier}" if @supplier
+          qp << "/variants/search?"
+          qp << "query=#{@query}" if @query
+          qp << "&" if @query && @options.any?
+          qp << @options.to_query if @options
+        end
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/supplier.rb

@@ -0,0 +1,54 @@
+module Zaikio
+  module Procurement
+    class Supplier < Base
+      uri "suppliers(/:id)"
+
+      # Attributes
+      attributes :automatically_accept_contract_requests, :brand_color, :cancelation_policy, :display_name,
+                 :slug, :supports_split_delivery, :created_at, :updated_at
+
+      # Associations
+      has_many :contract_requests, class_name: "Zaikio::Procurement::ContractRequest",
+                                   uri: "suppliers/:supplier_id/contract_requests(/:id)"
+
+      def line_item_suggestions(**attributes)
+        variants = attributes.delete(:variants)
+
+        unless variants.is_a?(Array) && variants.all?(Hash)
+          raise ArgumentError, "For variants, you must pass an Array of Hashes"
+        end
+
+        self.class.request(
+          :post, line_item_suggestions_path, payload(attributes, variants)
+        ).data.deep_symbolize_keys
+      end
+
+      private
+
+      def payload(attributes, variants)
+        MultiJson.dump(
+          line_item_suggestions: {
+            exclusive_sales_group_id: attributes[:exclusive_sales_group_id],
+            variants: variant_payload(variants)
+          }.reject { |_k, v| v.blank? }
+        )
+      end
+
+      def variant_payload(variants)
+        variants.collect do |variant|
+          {
+            id: variant[:id],
+            amount: variant[:amount],
+            exact_amount: variant[:exact_amount] || false,
+            environmental_certification: variant[:environmental_certification],
+            unit: variant[:unit] || "sheet"
+          }
+        end
+      end
+
+      def line_item_suggestions_path
+        "suppliers/#{id}/line_item_suggestions"
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/variant.rb

@@ -0,0 +1,47 @@
+module Zaikio
+  module Procurement
+    class Variant < Base
+      include_root_in_json :variant
+
+      # Spyke URI override
+      def self.uri
+        Zaikio::Procurement.configuration.flavor == :supplier ? "substrate/variants(/:id)" : "variants(/:id)"
+      end
+
+      # Attributes
+      attributes :brightness, :category, :color, :dimensions_unit, :form, :grain, :height, :paper_weight,
+                 :paper_weight_unit, :roughness, :thickness, :transparency, :unit_system, :whiteness,
+                 :width, :article_id, :created_at, :updated_at
+
+      # Associations
+      has_one :article, class_name: "Zaikio::Procurement::Article",
+                        uri: nil
+      has_many :skus,   class_name: "Zaikio::Procurement::Sku",
+                        uri: "variants/:variant_id/skus"
+
+      def line_item_suggestion(**attributes)
+        self.class.request(
+          :post, line_item_suggestions_path, payload(attributes)
+        ).data.map(&:deep_symbolize_keys)
+      end
+
+      private
+
+      def line_item_suggestions_path
+        "variants/#{id}/line_item_suggestions"
+      end
+
+      def payload(attributes)
+        MultiJson.dump(
+          line_item_suggestion: {
+            amount: attributes[:amount] || 1,
+            unit: attributes[:unit],
+            exact_amount: attributes[:exact_amount],
+            environmental_certification: attributes[:environmental_certification],
+            exclusive_sales_group_id: attributes[:exclusive_sales_group_id]
+          }
+        )
+      end
+    end
+  end
+end

data/lib/zaikio/procurement/version.rb

@@ -0,0 +1,5 @@
+module Zaikio
+  module Procurement
+    VERSION = "0.1.0".freeze
+  end
+end

data/lib/zaikio/procurement.rb

@@ -0,0 +1,64 @@
+require "faraday"
+require "spyke"
+require "zaikio-client-helpers"
+require "zaikio/procurement/configuration"
+require "zaikio/procurement/authorization_middleware"
+
+# Models
+require "zaikio/procurement/base"
+require "zaikio/procurement/article"
+require "zaikio/procurement/variant"
+require "zaikio/procurement/substrate_search"
+require "zaikio/procurement/sku"
+require "zaikio/procurement/price"
+require "zaikio/procurement/supplier"
+require "zaikio/procurement/contract"
+require "zaikio/procurement/contract_request"
+require "zaikio/procurement/sales_group"
+require "zaikio/procurement/sales_group_membership"
+require "zaikio/procurement/order"
+require "zaikio/procurement/order_line_item"
+require "zaikio/procurement/delivery"
+require "zaikio/procurement/delivery_line_item"
+require "zaikio/procurement/current_supplier"
+require "zaikio/procurement/material_requirement"
+module Zaikio
+  module Procurement
+    class << self
+      attr_accessor :configuration
+
+      class_attribute :connection
+
+      def configure
+        self.connection = nil
+        self.configuration ||= Configuration.new
+        yield(configuration)
+
+        Base.connection = create_connection
+      end
+
+      def with_token(token)
+        AuthorizationMiddleware.token = token
+        yield
+      ensure
+        AuthorizationMiddleware.reset_token
+      end
+
+      def connection_path
+        "#{configuration.host}/#{configuration.flavor.to_s.pluralize}/api/v1/"
+      end
+
+      def create_connection
+        self.connection = Faraday.new(url: connection_path,
+                                      ssl: { verify: configuration.environment != :test }) do |c|
+          c.request     :json
+          c.response    :logger, configuration&.logger, headers: false
+          c.use         Zaikio::Client::Helpers::Pagination::FaradayMiddleware
+          c.use         Zaikio::Client::Helpers::JSONParser
+          c.use         AuthorizationMiddleware
+          c.adapter     Faraday.default_adapter
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: zaikio-procurement
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Zaikio GmbH
+- Sascha Weidlich
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-10-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: spyke
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zaikio-client-helpers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: Ruby API Client for Zaikio's Procurement Platform
+email:
+- sw@zaikio.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/zaikio/procurement.rb
+- lib/zaikio/procurement/article.rb
+- lib/zaikio/procurement/authorization_middleware.rb
+- lib/zaikio/procurement/base.rb
+- lib/zaikio/procurement/configuration.rb
+- lib/zaikio/procurement/contract.rb
+- lib/zaikio/procurement/contract_request.rb
+- lib/zaikio/procurement/current_supplier.rb
+- lib/zaikio/procurement/delivery.rb
+- lib/zaikio/procurement/delivery_line_item.rb
+- lib/zaikio/procurement/invoice.rb
+- lib/zaikio/procurement/material_requirement.rb
+- lib/zaikio/procurement/order.rb
+- lib/zaikio/procurement/order_line_item.rb
+- lib/zaikio/procurement/price.rb
+- lib/zaikio/procurement/sales_group.rb
+- lib/zaikio/procurement/sales_group_membership.rb
+- lib/zaikio/procurement/sku.rb
+- lib/zaikio/procurement/substrate_search.rb
+- lib/zaikio/procurement/supplier.rb
+- lib/zaikio/procurement/variant.rb
+- lib/zaikio/procurement/version.rb
+homepage: https://www.zaikio.com/
+licenses:
+- MIT
+metadata:
+  changelog_uri: https://github.com/zaikio/zaikio-procurement-ruby/blob/master/CHANGELOG.md
+  source_code_uri: https://github.com/zaikio/zaikio-procurement-ruby
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Ruby API Client for Zaikio's Procurement Platform
+test_files: []