@restorecommerce/protos 6.11.1 → 6.11.3

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [6.11.3](https://github.com/restorecommerce/libs/compare/@restorecommerce/protos@6.11.2...@restorecommerce/protos@6.11.3) (2025-05-19)
+
+
+### Bug Fixes
+
+* **protos:** add persistent export information ([680ff84](https://github.com/restorecommerce/libs/commit/680ff8499f927812dd906304137b6d7be493e058))
+
+
+
+
+
+## [6.11.2](https://github.com/restorecommerce/libs/compare/@restorecommerce/protos@6.11.1...@restorecommerce/protos@6.11.2) (2025-05-14)
+
+
+### Bug Fixes
+
+* **protos:** add collection (name) to message Deleted for kafka DeletedAll event ([807ca4c](https://github.com/restorecommerce/libs/commit/807ca4cce3624720c6a2436afdee407ec181029c))
+* **protos:** add costums declaration to fulfillment ([0797faa](https://github.com/restorecommerce/libs/commit/0797faa53388cbc81340203d58c92340f7443514))
+* **protos:** fix typos in proto, load meta in acs decorater, refactor logger filePath detector ([8f02eee](https://github.com/restorecommerce/libs/commit/8f02eee6460b9c48f2f8416b08017f6ba11caf4e))
+
+
+
+
+
 ## [6.11.1](https://github.com/restorecommerce/libs/compare/@restorecommerce/protos@6.11.0...@restorecommerce/protos@6.11.1) (2025-03-31)
 
 

package/io/restorecommerce/country.proto

@@ -46,7 +46,9 @@ message Country {
   optional string id = 1;
   optional io.restorecommerce.meta.Meta meta = 2;
   optional string name = 3;
-  optional string country_code = 4;
+  optional string country_code = 4; // primaly used in target application (fallback)
   optional string geographical_name = 5;
   repeated string economic_areas = 6;
+  optional string country_code_alpha_2 = 7; // ISO 3166-1 alpha-2
+  optional string country_code_alpha_3 = 8; // ISO 3166-1 alpha-3
 }

package/io/restorecommerce/file.proto

@@ -4,19 +4,28 @@ package io.restorecommerce.file;
 
 import "io/restorecommerce/image.proto";
 
+message Blob {
+  bytes data = 1;
+  string encoding = 2;
+}
+
 message File {
   optional string id = 1;
   optional uint32 ordinal = 2;
   optional string caption = 3;
   optional string filename = 4;
   optional string content_type = 5;
-  optional string url = 6;
-  optional int64 bytes = 7;
-  repeated string tags = 8;
-  optional io.restorecommerce.image.Image thumbnail = 9;
+  oneof type {
+    string url = 6;
+    Blob blob = 7;
+  }
+  optional int64 bytes = 8;
+  repeated string tags = 9;
+  optional io.restorecommerce.image.Image thumbnail = 10;
 }
 
 message FileList {
   repeated File items = 1;
   optional uint32 total_count = 2;
-}
+}
+

package/io/restorecommerce/fulfillment.proto

@@ -15,6 +15,7 @@ import "io/restorecommerce/options.proto";
 import "io/restorecommerce/price.proto";
 import "io/restorecommerce/amount.proto";
 import "io/restorecommerce/invoice.proto";
+import "io/restorecommerce/file.proto";
 import "google/protobuf/timestamp.proto";
 
 // Used by resolvers
@@ -91,26 +92,46 @@ service FulfillmentService {
 
 enum FulfillmentState {
   PENDING = 0;
-  SUBMITTED = 2;
-  SUBMIT_NOTIFIED = 3;
-  IN_TRANSIT = 4;
-  TRANSIT_NOTIFIED = 5;
-  COMPLETED = 6;
-  COMPLETION_NOTIFIED = 7;
-  CANCELLED = 8;
-  CANCELATION_NOTIFIED = 9;
-  WITHDRAWN = 10;
-  WITHDRAW_NOTIFIED = 11;
-  FAILED = 12;
-  FAIL_NOTIFIED = 13;
-  INVALID = 14;
+  SUBMITTED = 1;
+  IN_TRANSIT = 2;
+  COMPLETE = 3;
+  CANCELLED = 4;
+  WITHDRAWN = 5;
+  RETOURE = 6;
+  RETOURE_COMPLETE = 7;
+  FAILED = 8;
+  INVALID = 9;
+}
+
+enum ExportType {
+  OTHER = 0;
+  PRESENT = 1;
+  COMMERCIAL_SAMPLE = 2;
+  DOCUMENT = 3;
+  RETURN_OF_GOODS = 4;
+  COMMERCIAL_GOODS = 5;
+}
+
+enum ShippingCondition {
+  DDU = 0;
+  DPA = 1;
+  DAP = 2;
+  DDP = 3;
+  DDX = 4;
+  DXV = 5;
 }
 
 message Item {
   optional string product_id = 1;
   optional string variant_id = 2;
   optional int32 quantity = 3;
-  optional io.restorecommerce.product.Package package = 4;
+  optional string name = 4;
+  optional string description = 5;
+  optional string taric_code = 6;
+  optional string hs_code = 7;
+  optional string origin_country_id = 8;
+  optional io.restorecommerce.amount.Amount value = 9;
+  optional io.restorecommerce.product.Package package = 10;
 }
 
 message Parcel {
@@ -128,19 +149,35 @@ message Parcel {
   repeated Item items = 4;
   optional io.restorecommerce.price.Price price = 5;
   optional io.restorecommerce.amount.Amount amount = 6;
-  optional io.restorecommerce.product.Package package = 8;
+  optional io.restorecommerce.product.Package package = 7;
 }
 
 message Label {
-  oneof type {
-    string url = 1;
-    string pdf = 2;
-    string png = 3;
-  }
-  optional string parcel_id = 4;
-  optional string shipment_number = 5; //filled on Order
-  optional FulfillmentState state = 6; //update by Track
-  optional io.restorecommerce.status.Status status = 7; //API status
+  optional string id = 1;
+  optional string parcel_id = 2;
+  optional io.restorecommerce.file.File file = 3; 
+  optional string shipment_number = 4; //filled on Order
+  optional FulfillmentState state = 5; //update by Track
+  optional io.restorecommerce.status.Status status = 6; //API status
+}
+
+message Charge {
+  optional string description = 1;
+  optional io.restorecommerce.amount.Amount charge = 2; 
+}
+
+message CustomsDeclaration {
+  optional string export_type = 1; // should be ExportType (but unconstrained)
+  optional string export_description = 2;
+  optional string invoice_number = 3;
+  optional string consignee_ref = 4;
+  optional string shipper_ref = 5;
+  optional string MRN = 6;
+  optional string permit_number = 7; // for e.g. rare goods
+  optional string attestation = 8; // for e.g. medical goods
+  optional string shipping_condition = 9; // should be ShippingCondition (unconstrained)
+  repeated Charge charges = 10; 
+  optional bool notify = 11;
 }
 
 message Packaging {
@@ -148,9 +185,7 @@ message Packaging {
   optional io.restorecommerce.address.ShippingAddress sender = 2;
   optional io.restorecommerce.address.ShippingAddress recipient = 3;
   optional string notify = 4;
-  optional string export_type = 5;
-  optional string export_description = 6;
-  optional string invoice_number = 7;
+  optional CustomsDeclaration customs_declaration = 5;
 }
 
 message Event {

package/io/restorecommerce/fulfillment_courier.proto

@@ -6,6 +6,7 @@ import "google/protobuf/any.proto";
 import "io/restorecommerce/resource_base.proto";
 import "io/restorecommerce/meta.proto";
 import "io/restorecommerce/auth.proto";
+import "io/restorecommerce/attribute.proto";
 import "io/restorecommerce/status.proto";
 import "io/restorecommerce/options.proto";
 
@@ -26,6 +27,10 @@ service FulfillmentCourierService {
   rpc Delete (io.restorecommerce.resourcebase.DeleteRequest) returns (io.restorecommerce.resourcebase.DeleteResponse);
 }
 
+enum SupportedAPI {
+  DHLRest = 0;
+}
+
 message FulfillmentCourier {
   option (restorecommerce.options.kafka_subscriber) = {
     plural: "fulfillmentCouriers"
@@ -50,10 +55,10 @@ message FulfillmentCourier {
   optional string description = 5;
   optional string logo = 6;
   optional string website = 7;
-  optional string stub_type = 8; // obsolete, use api
-  optional string credential_id = 9;
-  optional google.protobuf.Any configuration = 10;
-  optional string api = 11;
+  optional string credential_id = 8;
+  optional google.protobuf.Any configuration = 9;
+  optional string api = 10; // should be SupportedAPI (but unconstrained)
+  repeated io.restorecommerce.attribute.Attribute attributes = 11; 
 }
 
 message FulfillmentCourierList {

package/io/restorecommerce/product.proto

@@ -33,9 +33,35 @@ service ProductService {
   rpc Update (ProductList) returns (ProductListResponse);
   rpc Upsert (ProductList) returns (ProductListResponse);
 
+  /*
+   * Response with resolved product-variants in a flatten message
+   */
   rpc GetVariant (IndividualProductVariantListRequest) returns (IndividualProductVariantListResponse) {
     option (io.restorecommerce.options.is_query) = true;
   };
+
+  /* 
+   * Response with resolved product-variants
+   * Claims a requested quantity from stock level permanently.
+   * Response with an error status if requested quantity is not in stock.
+   */
+  rpc ClaimVariant (IndividualProductVariantListRequest) returns (IndividualProductVariantListResponse);
+  
+  /* 
+   * Response with resolved product-variants
+   * Releases a requested quantity back to stock level.
+   */
+  rpc ReleaseVariant (IndividualProductVariantListRequest) returns (IndividualProductVariantListResponse);
+
+  /* 
+   * Claim all products assigned to a session permanently
+   */
+  rpc ResolveSession (Session) returns (IndividualProductVariantListResponse);
+
+  /*
+   * Drop session and instantly release all claimed products
+   */
+  rpc DropSession (Session) returns (IndividualProductVariantListResponse);
 }
 
 enum AssociationType {
@@ -114,7 +140,6 @@ message IndividualProduct {
       field_name: "origin_country",
     }
   ];
-  optional string taric_code = 5;
   oneof classification {
     string prototype_id = 6 [
       (io.restorecommerce.options.resolver) = {
@@ -195,10 +220,13 @@ message PhysicalVariant {
   repeated io.restorecommerce.property.Property properties = 10;
   repeated string tax_ids = 11;
   optional bool active = 12;
-  optional google.protobuf.Timestamp valid_from = 13;
+  optional google.protobuf.Timestamp valid_from = 13; // valid for sale
   optional google.protobuf.Timestamp valid_to = 14;
   repeated io.restorecommerce.attribute.Attribute attibutes = 15;
   optional Package package = 16; // size for shipping
+  optional string taric_code = 17;
+  optional string hs_code = 18;
+  optional string export_description = 19;
 }
 
 message ServiceVariant {
@@ -214,7 +242,7 @@ message ServiceVariant {
   repeated io.restorecommerce.property.Property properties = 10;
   repeated string tax_ids = 11;
   optional bool active = 12;
-  optional google.protobuf.Timestamp valid_from = 13;
+  optional google.protobuf.Timestamp valid_from = 13;  // valid for sale
   optional google.protobuf.Timestamp valid_to = 14;
   repeated io.restorecommerce.attribute.Attribute attibutes = 15;
 }
@@ -262,9 +290,24 @@ message BundleProduct {
   optional double price_ratio = 4; //Price ratio in relation to the bundle price
 }
 
+message Session {
+  optional string id = 1; // get a new id if empty
+  optional google.protobuf.Timestamp from = 2; // required field to start a session
+  optional google.protobuf.Timestamp to = 3; // leave empty for auto max session
+}
+
 message IndividualProductVariantRequest {
+  message Localization {
+    optional string country_id = 1;
+    optional string locale_id = 2;
+    optional string currency_id = 3;
+  }
+
   optional string product_id = 1;
   optional string variant_id = 2;
+  optional uint32 quantity = 3;
+  optional Session session = 4;
+  optional Localization localization = 5; // for taxing, currency, etc.?
 }
 
 message IndividualProductVariantListRequest {
@@ -341,8 +384,9 @@ message IndividualProductVariant {
   optional bool active = 23;
   optional google.protobuf.Timestamp valid_from = 24;
   optional google.protobuf.Timestamp valid_to = 25;
-  repeated io.restorecommerce.attribute.Attribute attibutes = 26;
+  repeated io.restorecommerce.attribute.Attribute attributes = 26;
   optional Package package = 27; // size for shipping
+  optional string hs_code = 28;
 }
 
 message IndividualProductVariantResponse {
@@ -351,7 +395,8 @@ message IndividualProductVariantResponse {
 }
 
 message IndividualProductVariantListResponse {
-  repeated ProductResponse items = 1;
+  repeated IndividualProductVariantResponse items = 1;
   optional uint32 total_count = 2;
   optional io.restorecommerce.status.OperationStatus operation_status = 3;
+  optional Session session = 4;
 }

package/io/restorecommerce/resource_base.proto

@@ -141,4 +141,5 @@ message Resource {
 
 message Deleted {
   optional string id = 1;
+  optional string collection = 2;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@restorecommerce/protos",
-  "version": "6.11.1",
+  "version": "6.11.3",
   "description": "Protobuf descriptors for Restorecommerce services",
   "author": "n-fuse GmbH",
   "repository": {
@@ -15,5 +15,5 @@
     "protobufs"
   ],
   "scripts": {},
-  "gitHead": "bbc9ec50fc18105dac297345e4f3377ee29a30cd"
+  "gitHead": "c35fee3d7b022c3460597d803e668bc93d2a13fb"
 }