tachain-sdk 0.1.0 → 0.1.1

data/lib/tachain-sdk/models/api_production_raw_material_create_request.rb

@@ -0,0 +1,320 @@
+=begin
+#Tactic Chain Public API
+
+#Public integration endpoints. Set your own base URL and credential before calling.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.25.0
+
+=end
+
+require 'date'
+require 'time'
+
+module TachainSdk
+  # 新增专用集成请求；只接收本操作使用的业务字段。
+  class ApiProductionRawMaterialCreateRequest < ApiModelBase
+    # 采购订单明细ID
+    attr_accessor :purchase_order_detail_id
+
+    # 领料数量；计量单位自动使用所选采购订单行的采购单位。
+    attr_accessor :quantity_used
+
+    # 生产损耗率(%)；完整保存时请明确填写，无损耗填 0，审核前校验不可为空。 条件：生产审核前必填；无损耗填 0。更新按完整明细保存，省略会写为空。
+    attr_accessor :loss
+
+    # 订单编号
+    attr_accessor :order_number
+
+    # 采购订单日期。外部生产接口按订单号+日期+行号解析采购订单明细时使用。
+    attr_accessor :order_date
+
+    # 订单行号
+    attr_accessor :line_number
+
+    # 查询返回的客户公司 ID，可选。优先使用 CustomerName 或 CustomerCode。
+    attr_accessor :customer_id
+
+    # 客户英文名、当地语言名称或简称，精确匹配当前公司的有效客户关系。
+    attr_accessor :customer_name
+
+    # 当前公司维护的客户编码或启用的 Customer/Company 外部映射值。 条件：外部流水号或单号重复时用于消歧；多个客户字段必须一致。
+    attr_accessor :customer_code
+
+    # 查询返回的供应商公司 ID，可选。优先使用 SupplierName 或 SupplierCode。
+    attr_accessor :supplier_id
+
+    # 供应商英文名、当地语言名称或简称，精确匹配当前公司的有效供应商关系。
+    attr_accessor :supplier_name
+
+    # 当前公司维护的供应商编码或启用的 Supplier/Company 外部映射值。 条件：外部流水号或单号重复时用于消歧；多个供应商字段必须一致。
+    attr_accessor :supplier_code
+
+    # 买方外部系统的订单明细流水号；重复时补充交易对方和订单条件。
+    attr_accessor :customer_ext_no
+
+    # 卖方外部系统的订单明细流水号；重复时补充交易对方和订单条件。
+    attr_accessor :supplier_ext_no
+
+    # 查询返回的系统订单明细唯一流水号。
+    attr_accessor :unique_no
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'purchase_order_detail_id' => :'purchaseOrderDetailId',
+        :'quantity_used' => :'quantityUsed',
+        :'loss' => :'loss',
+        :'order_number' => :'orderNumber',
+        :'order_date' => :'orderDate',
+        :'line_number' => :'lineNumber',
+        :'customer_id' => :'customerId',
+        :'customer_name' => :'customerName',
+        :'customer_code' => :'customerCode',
+        :'supplier_id' => :'supplierId',
+        :'supplier_name' => :'supplierName',
+        :'supplier_code' => :'supplierCode',
+        :'customer_ext_no' => :'customerExtNo',
+        :'supplier_ext_no' => :'supplierExtNo',
+        :'unique_no' => :'uniqueNo'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'purchase_order_detail_id' => :'String',
+        :'quantity_used' => :'Float',
+        :'loss' => :'Float',
+        :'order_number' => :'String',
+        :'order_date' => :'Time',
+        :'line_number' => :'String',
+        :'customer_id' => :'String',
+        :'customer_name' => :'String',
+        :'customer_code' => :'String',
+        :'supplier_id' => :'String',
+        :'supplier_name' => :'String',
+        :'supplier_code' => :'String',
+        :'customer_ext_no' => :'String',
+        :'supplier_ext_no' => :'String',
+        :'unique_no' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'purchase_order_detail_id',
+        :'loss',
+        :'order_number',
+        :'order_date',
+        :'line_number',
+        :'customer_id',
+        :'customer_name',
+        :'customer_code',
+        :'supplier_id',
+        :'supplier_name',
+        :'supplier_code',
+        :'customer_ext_no',
+        :'supplier_ext_no',
+        :'unique_no'
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `TachainSdk::ApiProductionRawMaterialCreateRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `TachainSdk::ApiProductionRawMaterialCreateRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'purchase_order_detail_id')
+        self.purchase_order_detail_id = attributes[:'purchase_order_detail_id']
+      end
+
+      if attributes.key?(:'quantity_used')
+        self.quantity_used = attributes[:'quantity_used']
+      else
+        self.quantity_used = nil
+      end
+
+      if attributes.key?(:'loss')
+        self.loss = attributes[:'loss']
+      end
+
+      if attributes.key?(:'order_number')
+        self.order_number = attributes[:'order_number']
+      end
+
+      if attributes.key?(:'order_date')
+        self.order_date = attributes[:'order_date']
+      end
+
+      if attributes.key?(:'line_number')
+        self.line_number = attributes[:'line_number']
+      end
+
+      if attributes.key?(:'customer_id')
+        self.customer_id = attributes[:'customer_id']
+      end
+
+      if attributes.key?(:'customer_name')
+        self.customer_name = attributes[:'customer_name']
+      end
+
+      if attributes.key?(:'customer_code')
+        self.customer_code = attributes[:'customer_code']
+      end
+
+      if attributes.key?(:'supplier_id')
+        self.supplier_id = attributes[:'supplier_id']
+      end
+
+      if attributes.key?(:'supplier_name')
+        self.supplier_name = attributes[:'supplier_name']
+      end
+
+      if attributes.key?(:'supplier_code')
+        self.supplier_code = attributes[:'supplier_code']
+      end
+
+      if attributes.key?(:'customer_ext_no')
+        self.customer_ext_no = attributes[:'customer_ext_no']
+      end
+
+      if attributes.key?(:'supplier_ext_no')
+        self.supplier_ext_no = attributes[:'supplier_ext_no']
+      end
+
+      if attributes.key?(:'unique_no')
+        self.unique_no = attributes[:'unique_no']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @quantity_used.nil?
+        invalid_properties.push('invalid value for "quantity_used", quantity_used cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @quantity_used.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] quantity_used Value to be assigned
+    def quantity_used=(quantity_used)
+      if quantity_used.nil?
+        fail ArgumentError, 'quantity_used cannot be nil'
+      end
+
+      @quantity_used = quantity_used
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          purchase_order_detail_id == o.purchase_order_detail_id &&
+          quantity_used == o.quantity_used &&
+          loss == o.loss &&
+          order_number == o.order_number &&
+          order_date == o.order_date &&
+          line_number == o.line_number &&
+          customer_id == o.customer_id &&
+          customer_name == o.customer_name &&
+          customer_code == o.customer_code &&
+          supplier_id == o.supplier_id &&
+          supplier_name == o.supplier_name &&
+          supplier_code == o.supplier_code &&
+          customer_ext_no == o.customer_ext_no &&
+          supplier_ext_no == o.supplier_ext_no &&
+          unique_no == o.unique_no
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [purchase_order_detail_id, quantity_used, loss, order_number, order_date, line_number, customer_id, customer_name, customer_code, supplier_id, supplier_name, supplier_code, customer_ext_no, supplier_ext_no, unique_no].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/tachain-sdk/models/{production_raw_material_api_dto.rb → api_production_raw_material_response.rb}

@@ -14,9 +14,9 @@ require 'date'
 require 'time'
 
 module TachainSdk
-  # 生产原料使用明细表
-  class ProductionRawMaterialApiDto < ApiModelBase
-    # 原料记录ID
+  # 集成接口专用 ApiProductionRawMaterialResponse；只读业务返回字段，不参与写入模型。
+  class ApiProductionRawMaterialResponse < ApiModelBase
+    # 生产领料关联记录 ID；与 purchaseOrderDetailId 采购订单明细 ID 不同。
     attr_accessor :id
 
     # 生产批次ID
@@ -25,39 +25,21 @@ module TachainSdk
     # 采购订单明细ID
     attr_accessor :purchase_order_detail_id
 
-    # 原料名称（冗余）
+    # 所选采购订单行的原料名称。
     attr_accessor :material_name
 
-    # 使用数量
+    # 本次领料数量，按所选采购订单行的采购单位计量。
     attr_accessor :quantity_used
 
-    # 单位
+    # 领料数量 quantityUsed 的单位，自动取自所选采购订单行的 unit，不接收调用方写入。
     attr_accessor :unit
 
-    # 租户ID
-    attr_accessor :tenant_id
-
-    # 环境类型：0正式，1测试
-    attr_accessor :environment_type
-
-    # 创建用户ID
-    attr_accessor :created_by
-
     # 创建时间
     attr_accessor :created_at
 
-    # 公司ID
-    attr_accessor :company_id
-
-    # 成品入库单ID，(MTS Only)
-    attr_accessor :receipt_id
-
-    # -9 禁用, -1 删除, 0 正常
+    # 记录状态：0 正常，-1 已删除，-9 禁用。
     attr_accessor :status
 
-    # 修改用户ID
-    attr_accessor :updated_by
-
     # 更新时间
     attr_accessor :updated_at
 
@@ -67,10 +49,10 @@ module TachainSdk
     # 订单可用量
     attr_accessor :available_quantity
 
-    # 单位名称
+    # 计量单位名称。
     attr_accessor :u_name
 
-    # 订单编号
+    # 订单号。
     attr_accessor :order_number
 
     # 采购订单日期。外部生产接口按订单号+日期+行号解析采购订单明细时使用。
@@ -82,30 +64,22 @@ module TachainSdk
     # 订单唯一标识
     attr_accessor :unique_no
 
-    # 原料编码
+    # 所选采购订单行的原料编码。
     attr_accessor :material_code
 
-    # 关联采购订单行的阶段编码，用于快速申报领料回显和草稿保存。
+    # 关联采购订单明细的加工阶段编码。
     attr_accessor :scope_code
 
-    # 关联采购订单行用于纤维申报匹配的代表成分编码。
-    attr_accessor :single_component
-
-    # BOM 分组父级 ID，按 BOM 分组展开领料明细时用于保留层级关系。
-    attr_accessor :parent_id
-
-    # 供应商名称
+    # 供应商名称。
     attr_accessor :supplier_name
 
-    # 采购附件列表（合同/发票/付款证明/宣誓书）
-    attr_accessor :attachments
-
-    # 采购单订单数量
+    # 所选采购订单行的采购数量，来源为订单行 quantity。
     attr_accessor :quantity
 
-    # 采购单单位
+    # 所选采购订单行的采购单位，来源为订单行 unit。
     attr_accessor :po_unit
 
+    # 是否转运：0 否，1 是。
     attr_accessor :is_transfer
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -117,14 +91,8 @@ module TachainSdk
         :'material_name' => :'materialName',
         :'quantity_used' => :'quantityUsed',
         :'unit' => :'unit',
-        :'tenant_id' => :'tenantId',
-        :'environment_type' => :'environmentType',
-        :'created_by' => :'createdBy',
         :'created_at' => :'createdAt',
-        :'company_id' => :'companyId',
-        :'receipt_id' => :'receiptId',
         :'status' => :'status',
-        :'updated_by' => :'updatedBy',
         :'updated_at' => :'updatedAt',
         :'loss' => :'loss',
         :'available_quantity' => :'availableQuantity',
@@ -135,10 +103,7 @@ module TachainSdk
         :'unique_no' => :'uniqueNo',
         :'material_code' => :'materialCode',
         :'scope_code' => :'scopeCode',
-        :'single_component' => :'singleComponent',
-        :'parent_id' => :'parentId',
         :'supplier_name' => :'supplierName',
-        :'attachments' => :'attachments',
         :'quantity' => :'quantity',
         :'po_unit' => :'poUnit',
         :'is_transfer' => :'isTransfer'
@@ -164,14 +129,8 @@ module TachainSdk
         :'material_name' => :'String',
         :'quantity_used' => :'Float',
         :'unit' => :'String',
-        :'tenant_id' => :'String',
-        :'environment_type' => :'Integer',
-        :'created_by' => :'String',
         :'created_at' => :'Time',
-        :'company_id' => :'String',
-        :'receipt_id' => :'Integer',
         :'status' => :'Integer',
-        :'updated_by' => :'String',
         :'updated_at' => :'Time',
         :'loss' => :'Float',
         :'available_quantity' => :'Float',
@@ -182,10 +141,7 @@ module TachainSdk
         :'unique_no' => :'String',
         :'material_code' => :'String',
         :'scope_code' => :'String',
-        :'single_component' => :'String',
-        :'parent_id' => :'String',
         :'supplier_name' => :'String',
-        :'attachments' => :'Array<Object>',
         :'quantity' => :'Float',
         :'po_unit' => :'String',
         :'is_transfer' => :'Integer'
@@ -201,14 +157,8 @@ module TachainSdk
         :'material_name',
         :'quantity_used',
         :'unit',
-        :'tenant_id',
-        :'environment_type',
-        :'created_by',
         :'created_at',
-        :'company_id',
-        :'receipt_id',
         :'status',
-        :'updated_by',
         :'updated_at',
         :'loss',
         :'available_quantity',
@@ -219,10 +169,7 @@ module TachainSdk
         :'unique_no',
         :'material_code',
         :'scope_code',
-        :'single_component',
-        :'parent_id',
         :'supplier_name',
-        :'attachments',
         :'quantity',
         :'po_unit',
         :'is_transfer'
@@ -233,14 +180,14 @@ module TachainSdk
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `TachainSdk::ProductionRawMaterialApiDto` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `TachainSdk::ApiProductionRawMaterialResponse` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `TachainSdk::ProductionRawMaterialApiDto`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `TachainSdk::ApiProductionRawMaterialResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
@@ -269,38 +216,14 @@ module TachainSdk
         self.unit = attributes[:'unit']
       end
 
-      if attributes.key?(:'tenant_id')
-        self.tenant_id = attributes[:'tenant_id']
-      end
-
-      if attributes.key?(:'environment_type')
-        self.environment_type = attributes[:'environment_type']
-      end
-
-      if attributes.key?(:'created_by')
-        self.created_by = attributes[:'created_by']
-      end
-
       if attributes.key?(:'created_at')
         self.created_at = attributes[:'created_at']
       end
 
-      if attributes.key?(:'company_id')
-        self.company_id = attributes[:'company_id']
-      end
-
-      if attributes.key?(:'receipt_id')
-        self.receipt_id = attributes[:'receipt_id']
-      end
-
       if attributes.key?(:'status')
         self.status = attributes[:'status']
       end
 
-      if attributes.key?(:'updated_by')
-        self.updated_by = attributes[:'updated_by']
-      end
-
       if attributes.key?(:'updated_at')
         self.updated_at = attributes[:'updated_at']
       end
@@ -341,24 +264,10 @@ module TachainSdk
         self.scope_code = attributes[:'scope_code']
       end
 
-      if attributes.key?(:'single_component')
-        self.single_component = attributes[:'single_component']
-      end
-
-      if attributes.key?(:'parent_id')
-        self.parent_id = attributes[:'parent_id']
-      end
-
       if attributes.key?(:'supplier_name')
         self.supplier_name = attributes[:'supplier_name']
       end
 
-      if attributes.key?(:'attachments')
-        if (value = attributes[:'attachments']).is_a?(Array)
-          self.attachments = value
-        end
-      end
-
       if attributes.key?(:'quantity')
         self.quantity = attributes[:'quantity']
       end
@@ -398,14 +307,8 @@ module TachainSdk
           material_name == o.material_name &&
           quantity_used == o.quantity_used &&
           unit == o.unit &&
-          tenant_id == o.tenant_id &&
-          environment_type == o.environment_type &&
-          created_by == o.created_by &&
           created_at == o.created_at &&
-          company_id == o.company_id &&
-          receipt_id == o.receipt_id &&
           status == o.status &&
-          updated_by == o.updated_by &&
           updated_at == o.updated_at &&
           loss == o.loss &&
           available_quantity == o.available_quantity &&
@@ -416,10 +319,7 @@ module TachainSdk
           unique_no == o.unique_no &&
           material_code == o.material_code &&
           scope_code == o.scope_code &&
-          single_component == o.single_component &&
-          parent_id == o.parent_id &&
           supplier_name == o.supplier_name &&
-          attachments == o.attachments &&
           quantity == o.quantity &&
           po_unit == o.po_unit &&
           is_transfer == o.is_transfer
@@ -434,7 +334,7 @@ module TachainSdk
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, production_id, purchase_order_detail_id, material_name, quantity_used, unit, tenant_id, environment_type, created_by, created_at, company_id, receipt_id, status, updated_by, updated_at, loss, available_quantity, u_name, order_number, order_date, line_number, unique_no, material_code, scope_code, single_component, parent_id, supplier_name, attachments, quantity, po_unit, is_transfer].hash
+      [id, production_id, purchase_order_detail_id, material_name, quantity_used, unit, created_at, status, updated_at, loss, available_quantity, u_name, order_number, order_date, line_number, unique_no, material_code, scope_code, supplier_name, quantity, po_unit, is_transfer].hash
     end
 
     # Builds the object from hash