@mamindom/contracts 1.0.193 → 1.0.201

package/proto/calculation.proto

@@ -7,15 +7,44 @@ import "common_promo.proto";
 service PromoCalculationService {
   rpc ValidateAndCalculate(ValidateAndCalculateRequest) returns (ValidateAndCalculateResponse);
 
-  rpc ApplyPromotion(ApplyPromotionRequest) returns (SuccessResponse);
+  
+  rpc ValidateCoupon(ValidateCouponRequest) returns (ValidateCouponResponse);
+}
+
+message ValidateCouponRequest {
+  string code = 1;
+  string user_id = 2;
+  
+  repeated CartItem items = 3;
+  double order_total = 4;
+  bool is_first_order = 5;
+  int32 order_count = 6;
+  repeated string user_groups = 7;
+}
+
+message ValidateCouponResponse {
+  bool usable = 1;
+
+  string reason = 2;
+  
+  bool permanent = 3;
+  double discount_amount = 4;
+ 
+  double min_order_amount = 5;
 }
 
 message CartItem {
   string product_id = 1;
+
+  
   string category_id = 2;
+
   string brand_id = 3;
   int32 quantity = 4;
   double price = 5;
+
+ 
+  repeated string category_ids = 6;
 }
 
 message ValidateAndCalculateRequest {
@@ -35,13 +64,22 @@ message ValidateAndCalculateResponse {
   double final_total = 3;
 
   repeated AppliedPromotion applied_promotions = 4;
+
+  
   optional AppliedCoupon applied_coupon = 5;
 
   optional string error_message = 6;
+
   
   optional string coupon_error = 7;
 
+
+  optional string coupon_error_reason = 10;
+
   repeated GiftSuggestion gift_suggestions = 8;
+
+ 
+  repeated AppliedCoupon applied_coupons = 9;
 }
 
 message GiftSuggestion {
@@ -65,10 +103,3 @@ message AppliedCoupon {
   double discount_amount = 4;
 }
 
-message ApplyPromotionRequest {
-  string user_id = 1;
-  string order_id = 2;
-  double discount_amount = 3;
-  optional string coupon_code = 4;
-  repeated string promotion_ids = 5;
-}

package/proto/cart.proto

@@ -8,6 +8,7 @@ service CartService {
   rpc GetCart(GetCartRequest) returns (CartResponse);
 
   rpc AddItem(AddItemRequest) returns (CartResponse);
+  rpc AddItems(AddItemsRequest) returns (AddItemsResponse);
   rpc UpdateItemQty(UpdateItemQtyRequest) returns (CartResponse);
   rpc RemoveItem(RemoveItemRequest) returns (CartResponse);
   rpc ClearCart(ClearCartRequest) returns (SuccessResponse);
@@ -56,6 +57,11 @@ message CartItem {
   double line_discount = 14;
   double line_total = 15;
   string size = 16;
+
+  
+  bool unavailable = 17;
+  
+  int32 available_stock = 18;
 }
 
 message AppliedPromotion {
@@ -80,9 +86,13 @@ message AppliedCertificate {
   string error = 6;
 }
 
+
 message AppliedBonuses {
   double available = 1;
+  
   double applied = 2;
+  
+  double requested = 3;
 }
 
 message Recipient {
@@ -116,6 +126,7 @@ message CartTotals {
   double promo_discount = 2;
   double coupon_discount = 3;
   double certificate_applied = 4;
+  
   double bonuses_applied = 5;
   double shipping_cost = 6;
   double grand_total = 7;
@@ -165,6 +176,10 @@ message WishlistItem {
 
 message WishlistResponse {
   repeated WishlistItem items = 1;
+
+  
+  bool ok = 2;
+  string error_message = 3;
 }
 
 message CartOwner {
@@ -193,6 +208,34 @@ message AddItemRequest {
   int32 quantity = 4;
 }
 
+message AddItemInput {
+  string product_id = 1;
+  string variant_id = 2;
+  int32 quantity = 3;
+}
+
+
+message AddItemsRequest {
+  CartOwner owner = 1;
+  repeated AddItemInput items = 2;
+}
+
+message AddItemResult {
+  string product_id = 1;
+  string variant_id = 2;
+  bool ok = 3;
+ 
+  string reason = 4;
+}
+
+message AddItemsResponse {
+  bool ok = 1;
+  Cart cart = 2;
+  string error_message = 3;
+  repeated AddItemResult results = 4;
+  string error_code = 5;
+}
+
 message UpdateItemQtyRequest {
   CartOwner owner = 1;
   string variant_id = 2;
@@ -266,6 +309,8 @@ message SetCheckoutDraftRequest {
   bool has_delivery = 8;
   bool has_payment = 9;
   bool has_comment = 10;
+ 
+  bool has_do_not_call = 11;
 }
 
 message RecalculateRequest {
@@ -291,6 +336,8 @@ message CartResponse {
   bool ok = 1;
   Cart cart = 2;
   string error_message = 3;
+  
+  string error_code = 4;
 }
 
 message SuccessResponse {

package/proto/category.proto

@@ -145,6 +145,7 @@ message UpdateCategoryRequest {
   map<string, string> meta_h1 = 12;
 
   optional string image_id = 13;
+  optional string guid1c = 14;
 }
 
 message DeleteCategoryRequest {

package/proto/coupon.proto

@@ -81,6 +81,9 @@ message GenerateCouponsRequest {
 
   optional int32 usage_limit_per_user = 5;
   optional string expires_at = 6;
+
+  
+  optional int32 usage_limit_total = 7;
 }
 
 message GenerateCouponsResponse {

package/proto/delivery_settings.proto

@@ -18,7 +18,8 @@ message DeliverySettingsResponse {
 
   double default_declared_value = 3;
 
-  optional string np_sender_warehouse_ref = 4;
+  
+  reserved 4;
 
   string updated_at = 5;
 }
@@ -29,8 +30,7 @@ message UpdateDeliverySettingsRequest {
   optional double default_item_weight_kg = 1;
   optional double free_shipping_threshold = 2;
   optional double default_declared_value = 3;
-  optional string np_sender_warehouse_ref = 4;
-  bool clear_np_sender_warehouse_ref = 5;
+  reserved 4, 5;
 }
 
 message ListCarriersRequest {}

package/proto/notification.proto

@@ -44,6 +44,80 @@ service NotificationLogsService {
   rpc ListLogs(ListLogsRequest) returns (ListLogsResponse);
 }
 
+
+service NotificationConsentService {
+  rpc VerifyUnsubscribeToken(VerifyUnsubscribeTokenRequest) returns (VerifyUnsubscribeTokenResponse);
+  rpc ApplyUnsubscribe(ApplyUnsubscribeRequest) returns (ApplyUnsubscribeResponse);
+}
+
+
+service NewsletterService {
+  rpc Subscribe(NewsletterSubscribeRequest) returns (NewsletterSubscribeResponse);
+  rpc ListSubscribers(ListNewsletterSubscribersRequest) returns (ListNewsletterSubscribersResponse);
+}
+
+message NewsletterSubscribeRequest {
+  string email = 1;
+  optional string locale = 2;
+  optional string source = 3;
+}
+
+message NewsletterSubscribeResponse {
+  bool ok = 1;
+  string error_message = 2;
+  
+  bool already_subscribed = 3;
+}
+
+message ListNewsletterSubscribersRequest {
+  int32 page = 1;
+  int32 limit = 2;
+  optional string search = 3;
+ 
+  optional bool active = 4;
+}
+
+message NewsletterSubscriberItem {
+  string id = 1;
+  string email = 2;
+  string locale = 3;
+  string source = 4;
+  bool active = 5;
+  string created_at = 6;
+  optional string unsubscribed_at = 7;
+}
+
+message ListNewsletterSubscribersResponse {
+  repeated NewsletterSubscriberItem items = 1;
+  int32 total = 2;
+  int32 page = 3;
+  int32 limit = 4;
+  int32 active_total = 5;
+}
+
+message VerifyUnsubscribeTokenRequest {
+  string token = 1;
+}
+
+message VerifyUnsubscribeTokenResponse {
+  bool ok = 1;
+  string error_message = 2;
+  optional string email = 3;
+  optional string user_id = 4;
+  repeated string unsubscribed_from = 5;
+}
+
+message ApplyUnsubscribeRequest {
+  string token = 1;
+  repeated string categories = 2;
+}
+
+message ApplyUnsubscribeResponse {
+  bool ok = 1;
+  string error_message = 2;
+  repeated string categories = 3;
+}
+
 service TelegramChatsService {
   rpc ListChats(ListChatsRequest) returns (ListChatsResponse);
   rpc UpsertChat(UpsertChatRequest) returns (TelegramChatResponse);
@@ -240,6 +314,9 @@ enum CampaignRecipientStatusEnum {
   RECIPIENT_FAILED = 3;
   RECIPIENT_SKIPPED_OPT_OUT = 4;
   RECIPIENT_SKIPPED_NO_CONTACT = 5;
+
+  
+  RECIPIENT_SENDING = 6;
 }
 
 service BrandingService {
@@ -373,6 +450,9 @@ message UpsertTemplateRequest {
   string body_text = 9;
   string variables_json = 10;
   bool is_active = 11;
+
+  
+  optional string actor_id = 12;
 }
 
 message UpdateTemplateRequest {
@@ -380,8 +460,10 @@ message UpdateTemplateRequest {
   optional string title = 2;
   optional string subject = 3;
   optional string content_json = 4;
-  string body_html = 5;
-  string body_text = 6;
+
+ 
+  optional string body_html = 5;
+  optional string body_text = 6;
   optional string variables_json = 7;
   optional bool is_active = 8;
 

package/proto/order.proto

@@ -23,6 +23,7 @@ service OrderService {
   rpc RemoveTag(RemoveTagRequest) returns (OrderResponse);
 
   rpc EditItems(EditItemsRequest) returns (OrderResponse);
+  rpc PreviewRecalculation(PreviewRecalculationRequest) returns (PreviewRecalculationResponse);
   rpc SetTrackingNumber(SetTrackingNumberRequest) returns (OrderResponse);
 
   rpc ApplyRecalculation(ApplyRecalculationRequest) returns (OrderResponse);
@@ -248,7 +249,10 @@ message Order {
   OrderPayment payment = 10;
   OrderTotals totals = 11;
 
-  string promo_code = 12;
+
+  reserved 12;
+  repeated string promo_codes = 27;
+
   string certificate_code = 13;
   bool do_not_call = 14;
   string comment = 15;
@@ -418,6 +422,33 @@ message EditItemsRequest {
   string id = 1;
   repeated OrderItemInput items = 2;
   string actor_id = 3;
+
+ 
+  bool accept_discount_change = 4;
+}
+
+
+message PreviewRecalculationRequest {
+  string id = 1;
+  repeated OrderItemInput items = 2;
+}
+
+message DiscountChange {
+
+  string kind = 1;
+  string name = 2;
+  double before = 3;
+  double after = 4;
+}
+
+message PreviewRecalculationResponse {
+  bool ok = 1;
+  string error_message = 2;
+  OrderTotals before = 3;
+  OrderTotals after = 4;
+  repeated DiscountChange discount_changes = 5;
+  
+  bool discounts_decreased = 6;
 }
 
 message ApplyRecalculationRequest {
@@ -429,8 +460,11 @@ message ApplyRecalculationRequest {
   double coupon_discount = 6;
   double certificate_applied = 7;
   double bonuses_used = 8;
+  
   double shipping_cost = 9;
   double grand_total = 10;
+
+  string idempotency_key = 11;
 }
 
 message SetTrackingNumberRequest {
@@ -445,12 +479,20 @@ message ReorderOrderRequest {
   string user_id = 2;
 }
 
+message ReorderSkippedItem {
+  string product_id = 1;
+  string variant_id = 2;
+  
+  string reason = 3;
+}
+
 message ReorderResponse {
   bool ok = 1;
   string cart_id = 2;
   int32 added = 3;
   int32 skipped = 4;
   string error = 5;
+  repeated ReorderSkippedItem skipped_items = 6;
 }
 
 message ListHistoryRequest {

package/proto/payment.proto

@@ -12,6 +12,9 @@ service PaymentService {
 
   
   rpc Capture(CaptureRequest) returns (PaymentResponse);
+
+  
+  rpc MarkPaidOffline(MarkPaidOfflineRequest) returns (PaymentResponse);
   
   rpc Cancel(CancelRequest) returns (PaymentResponse);
 
@@ -30,6 +33,10 @@ service PaymentService {
   rpc GetProviderConfig(GetProviderConfigRequest) returns (ProviderConfigResponse);
   
   rpc UpdateProviderConfig(UpdateProviderConfigRequest) returns (ProviderConfigResponse);
+
+  
+  rpc GetPaymentsMode(GetPaymentsModeRequest) returns (PaymentsModeResponse);
+  rpc SetPaymentsMode(SetPaymentsModeRequest) returns (PaymentsModeResponse);
 }
 
 
@@ -52,6 +59,10 @@ message Payment {
   int64  captured_at = 16;
   int64  cancelled_at = 17;
   int64  refunded_at = 18;
+
+  
+  string capture_source = 19;
+  string capture_note = 20;
 }
 
 message PaymentProviderInfo {
@@ -62,9 +73,14 @@ message PaymentProviderInfo {
   string description  = 5;
 
   bool   configured   = 6;
-  // Для installment-провайдерів — максимум частин оплати (з конфігу `parts`).
-  // 0 для звичайних провайдерів. Фронт показує «до N платежів» без env-синхронізації.
+  
   int32  installment_max_parts = 7;
+
+  
+  string environment = 8;
+
+  
+  bool   blocked_by_mode = 9;
 }
 
 
@@ -119,6 +135,15 @@ message CaptureRequest {
   string actor_id = 3;
 }
 
+message MarkPaidOfflineRequest {
+  string id = 1;
+ 
+  double amount = 2;
+  
+  string note = 3;
+  string actor_id = 4;
+}
+
 message CancelRequest {
   string id       = 1;
   string reason   = 2;
@@ -201,3 +226,25 @@ message UpdateProviderConfigRequest {
   repeated ProviderConfigPatch fields = 2;
   string actor_id = 3;
 }
+
+
+message GetPaymentsModeRequest {}
+
+message SetPaymentsModeRequest {
+  
+  string mode = 1;
+  string actor_id = 2;
+
+  
+  string confirmation = 3;
+}
+
+message PaymentsModeResponse {
+  bool   ok = 1;
+  string mode = 2;
+  int64  updated_at = 3;
+  string updated_by = 4;
+
+  
+  repeated string blocked_providers = 5;
+}

package/proto/post.proto

@@ -191,6 +191,11 @@ message UpdatePostRequest {
   repeated PostImagePayload images   = 14;
 
   string updated_by_id = 15;
+
+ 
+  bool clear_categories = 16;
+  bool clear_tags       = 17;
+  bool clear_images     = 18;
 }
 
 

package/proto/post_comment.proto

@@ -42,8 +42,11 @@ message CommentResponse {
 message GetCommentsRequest {
   PaginationRequest pagination = 1;
 
-  optional string        post_id = 2; 
-  optional CommentStatus status  = 3; 
+  optional string        post_id = 2;
+  optional CommentStatus status  = 3;
+
+  
+  bool public_view = 4;
 }
 
 message GetCommentsResponse {

package/proto/product.proto

@@ -189,7 +189,7 @@ message ProductListItemResponse {
 
   string updated_at = 25;
 
-  // Артикул із 1С. Неунікальний, на відміну від sku, тож зберігається окремо.
+ 
   optional string article1c = 26;
 }
 
@@ -248,6 +248,9 @@ message ProductDetailResponse {
 
 
   repeated string barcodes = 42;
+
+  
+  map<string, string> seo_text = 43;
 }
 
 
@@ -414,6 +417,9 @@ message CreateProductRequest {
   map<string, string> color_label = 25;
    optional string color_hex = 26;
   optional double weight_kg = 27;
+
+
+  map<string, string> seo_text = 28;
 }
 
 message UpdateProductRequest {
@@ -451,18 +457,13 @@ message UpdateProductRequest {
   optional double weight_kg = 26;
   optional string guid1c = 27;
 
-  // Явне очищення списків.
-  //
-  // У proto3 `repeated` не відрізняє «не передано» від «передано порожнім»,
-  // тож порожній масив сам по собі означає «не чіпати». Раніше цього
-  // розрізнення не було: клієнт, який не надіслав `images`, отримував від
-  // gateway [] — і всі фото товару видалялися разом із файлами в S3.
-  //
-  // Той самий підхід уже застосований в UpdateProductVariantRequest.
+  
   bool clear_images = 28;
   bool clear_categories = 29;
   bool clear_stickers = 30;
   bool clear_attributes = 31;
+
+  map<string, string> seo_text = 32;
 }
 
 message SetManualRatingRequest {
@@ -618,9 +619,9 @@ message ProductGroupMember {
   double price = 7;
   ProductStatus status = 8;
 
-  // Потрібен вітрині: перемикач кольору веде на картку сусіда за ЧПУ.
+  
   string slug = 9;
-  // Чи є що купити — сусід без залишку показується неактивним, а не зникає.
+ 
   bool in_stock = 10;
 }
 

package/proto/promotion.proto

@@ -302,6 +302,10 @@ message UpdatePromotionRequest {
   optional string cascade_steps   = 25;
   optional double bundle_price    = 26;
   optional int32  bundle_size     = 27;
+
+  
+  optional bool replace_conditions = 28;
+  optional bool replace_exclusions = 29;
 }
 
 message DeletePromotionRequest {

package/proto/shop_filters.proto

@@ -63,7 +63,7 @@ message ShopFilterOption {
   
   optional string slug = 4;
 
-  // Для розмірів: атрибут-джерело значення (вкладки у фільтрі «Розмір»).
+
   optional string group_slug = 5;
   optional string group_label = 6;
 }

package/proto/site_settings.proto

@@ -42,6 +42,8 @@ message SiteSettingsResponse {
 
   optional string working_hours       = 7;
   optional string working_hours_note  = 8;
+
+  optional string size_category_slugs = 9;
 }
 
 
@@ -62,4 +64,6 @@ message UpdateSiteSettingsRequest {
 
   optional string working_hours      = 9;
   optional string working_hours_note = 10;
+
+  optional string size_category_slugs = 11;
 }