erp_integration 1.2.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63c63386156abec358b4a911669ec462ccc287806f515a42748bee8adb5688e1
-  data.tar.gz: 1a614a32dc1e84fb577355c823a1d5c3b8e02fa30a019d3a109e3a35cc2da23b
+  metadata.gz: e27a92ae0de43ed91d4194cc581766cbb646a0fb8da4786c61ec7537de3888bb
+  data.tar.gz: 729b2b3a413fddd6074ce95828d9db0d0070d563906dd455a6e8ca9d5b37d993
 SHA512:
-  metadata.gz: 001ba2ddcc6a601823be103d98273ac88fd39a8ec39e971e44b12a951e312d3661cd8841ab822cc431fdcf30f63196239a04a2cab9a0229858ede8ffab569bc3
-  data.tar.gz: d43b7377eaa12ef82ce1b7e5351dfd7d49333a1d5b9a6bec865de64b5f76f1e63f45df935c984b323f1bed80afd872395e1446de619fba4cfc17ad67342b2e22
+  metadata.gz: d83791e26dba6eb86b7eeb20f3845d0e44d8ea62cf2fbaa0ce2563510bb28ede1bc8b74b6ba6bfd4e4d65b8c072f9a741f355c30a8282755cb6fc50b95a02f04
+  data.tar.gz: abfc2d03026c926aecc9cc17853295a31d4ebea6ae86e4eb1fcae12404ee5cae479b10f38d4fe2d1911a1c42edfa814a00679966af3a6416ae7a2e4a3bca55c3

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [v.1.4.0](https://github.com/mejuri-inc/erp-integration/tree/v.1.4.0) (2026-05-18)
+
+[Full Changelog](https://github.com/mejuri-inc/erp-integration/compare/v.1.3.0...v.1.4.0)
+
+**Merged pull requests:**
+
+- \[BACK-2275\] Add bulk create endpoint [\#233](https://github.com/mejuri-inc/erp-integration/pull/233) ([ikzekly](https://github.com/ikzekly))
+
+## [v.1.3.0](https://github.com/mejuri-inc/erp-integration/tree/v.1.3.0) (2026-05-13)
+
+[Full Changelog](https://github.com/mejuri-inc/erp-integration/compare/v.1.2.0...v.1.3.0)
+
+**Merged pull requests:**
+
+- \[BACK-2271\] Add ProductOptionSet resource [\#231](https://github.com/mejuri-inc/erp-integration/pull/231) ([ikzekly](https://github.com/ikzekly))
+
+## [v.1.2.0](https://github.com/mejuri-inc/erp-integration/tree/v.1.2.0) (2026-05-07)
+
+[Full Changelog](https://github.com/mejuri-inc/erp-integration/compare/v.1.1.0...v.1.2.0)
+
+**Merged pull requests:**
+
+- \[BACK-2222\] Rename `salable` to `sellable` for Product [\#229](https://github.com/mejuri-inc/erp-integration/pull/229) ([ikzekly](https://github.com/ikzekly))
+
 ## [v.0.1.0](https://github.com/mejuri-inc/erp-integration/tree/v.0.1.0) (2021-07-28)
 
 [Full Changelog](https://github.com/mejuri-inc/erp-integration/compare/a411f1240265c1e67ed4f07275cb357ffbbdb681...v.0.1.0)

data/lib/erp_integration/configuration.rb

@@ -98,6 +98,11 @@ module ErpIntegration
     # @return [Symbol] The configured adapter for the product option.
     attr_writer :product_option_adapter
 
+    # Allows configuring an adapter for the `ProductOptionSet` resource. When
+    # none is configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the product option set.
+    attr_writer :product_option_set_adapter
+
     # Allows configuring an adapter for the `ProductTemplate` resource. When none is
     # configured, it will default to Fulfil.
     # @return [Symbol] The configured adapter for the product templates.
@@ -263,6 +268,10 @@ module ErpIntegration
       @product_option_adapter || :fulfil
     end
 
+    def product_option_set_adapter
+      @product_option_set_adapter || :fulfil
+    end
+
     def product_template_adapter
       @product_template_adapter || :fulfil
     end

data/lib/erp_integration/fulfil/persistence.rb

@@ -16,6 +16,31 @@ module ErpIntegration
         [attributes, [extract_error_message(e)]]
       end
 
+      # Creates several resources in Fulfil with a single HTTP request.
+      #
+      # Fulfil's bulk endpoint is atomic: if any record fails validation, the
+      # whole batch is rejected with a single error message. There is no
+      # per-record error breakdown. Callers needing per-record errors should
+      # validate inputs client-side or fall back to per-record `#create`.
+      #
+      # @param attributes_list [Array<Hash>] One hash per resource to create.
+      # @return [Array(Array<Hash>, Array<String>?)] A tuple of the input
+      #   attributes (with `:id` merged in on success) and an array of error
+      #   messages (nil on success).
+      def bulk_create(attributes_list)
+        normalized = normalize_attributes(attributes_list)
+        ids = client.post("model/#{model_name}", normalized)
+
+        unless ids.size == normalized.size
+          raise ErpIntegration::Error, "Fulfil returned #{ids.size} ids for #{normalized.size} records"
+        end
+
+        ids.each_with_index { |id, i| normalized[i][:id] = id }
+        [normalized, nil]
+      rescue ErpIntegration::HttpError::BadRequest => e
+        [normalized, [extract_error_message(e)]]
+      end
+
       # Updates the resource with the given attributes.
       #
       # @param resource_id [Integer] The ID of the resource.

data/lib/erp_integration/fulfil/resources/product_option_set.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative '../api_resource'
+
+module ErpIntegration
+  module Fulfil
+    module Resources
+      # Maps `ErpIntegration::ProductOptionSet` to Fulfil's
+      # `product_option_set` model. Reachable at
+      # `/api/v2/model/product_option_set` on the merchant's Fulfil host.
+      #
+      # @see https://mejuri.fulfil.io/developer/api-reference/v2/product_option_set
+      class ProductOptionSet < ApiResource
+        self.model_name = 'product_option_set'
+      end
+    end
+  end
+end

data/lib/erp_integration/product_option_set.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # Groups one or more `ProductOption` records into a named bundle that
+  # attaches to product templates. In Fulfil, the option set is what lives
+  # on a product template, and its `options` field carries the ids of the
+  # individual `ProductOption` records that surface to order lines.
+  #
+  # @see https://mejuri.fulfil.io/developer/api-reference/v2/product_option_set
+  class ProductOptionSet < Resource
+    attr_accessor :id, :name, :options
+  end
+end

data/lib/erp_integration/resources/persistence.rb

@@ -18,6 +18,25 @@ module ErpIntegration
           new_resource.validate_with(error_messages)
           new_resource
         end
+
+        # Creates many resources in the ERP with a single request.
+        #
+        # The underlying adapter call is atomic: a single validation failure
+        # rejects the whole batch. On failure, every returned resource is
+        # marked invalid with the same shared error message.
+        #
+        # @param attributes_array [Array<Hash>] Per-record attribute hashes.
+        # @return [Array<ErpIntegration::Resource>] The created (or errored)
+        #   resources, in input order.
+        def bulk_create(attributes_array)
+          attrs_list, error_messages = adapter.bulk_create(attributes_array)
+
+          attrs_list.map do |attrs|
+            new_resource = new(attrs)
+            new_resource.validate_with(error_messages)
+            new_resource
+          end
+        end
       end
 
       # Determines whether a `ErpIntegration::Resource` is considered to be persisted.

data/lib/erp_integration/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ErpIntegration
-  VERSION = '1.2.0'
+  VERSION = '1.4.0'
 end

data/lib/erp_integration.rb

@@ -46,6 +46,7 @@ module ErpIntegration
   autoload :Product, 'erp_integration/product'
   autoload :ProductCategory, 'erp_integration/product_category'
   autoload :ProductOption, 'erp_integration/product_option'
+  autoload :ProductOptionSet, 'erp_integration/product_option_set'
   autoload :ProductTemplate, 'erp_integration/product_template'
   autoload :ProductionOrder, 'erp_integration/production_order'
   autoload :PurchaseOrder, 'erp_integration/purchase_order'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erp_integration
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Stefan Vermaas
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-07 00:00:00.000000000 Z
+date: 2026-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -272,6 +272,7 @@ files:
 - lib/erp_integration/fulfil/resources/product.rb
 - lib/erp_integration/fulfil/resources/product_category.rb
 - lib/erp_integration/fulfil/resources/product_option.rb
+- lib/erp_integration/fulfil/resources/product_option_set.rb
 - lib/erp_integration/fulfil/resources/product_template.rb
 - lib/erp_integration/fulfil/resources/production_order.rb
 - lib/erp_integration/fulfil/resources/purchase_order.rb
@@ -303,6 +304,7 @@ files:
 - lib/erp_integration/product.rb
 - lib/erp_integration/product_category.rb
 - lib/erp_integration/product_option.rb
+- lib/erp_integration/product_option_set.rb
 - lib/erp_integration/product_template.rb
 - lib/erp_integration/production_order.rb
 - lib/erp_integration/purchase_order.rb