moysklad 0.2.1 → 0.3.0

data/lib/moysklad/entities/customer_order.rb

@@ -1,42 +1,135 @@
+require_relative 'entity'
+require_relative 'owner'
+require_relative 'group'
+require_relative 'rate'
+require_relative 'customer_order_position'
+require_relative 'time'
+
 module Moysklad::Entities
   # Пример:
-  # https://support.moysklad.ru/hc/ru/articles/203402923-Пример-загрузки-заказа-покупателя-через-REST-API
+  # https://online.moysklad.ru/api/remap/1.1/doc/index.html#документ-заказ-покупателя
   #
-  class CustomerOrder < Base
-    include CommonObject
-    include XmlFix
+  class CustomerOrder < Entity
+
+    # АТРИБУТЫ СУЩНОСТИ ¶
+    #
+    # meta - Метаданные о Заказе покупателя
+    # id - ID в формате UUID Только для чтения
+    # accountId - ID учетной записи Только для чтения
+    attribute :accountId,          String
+
+    # syncId - ID синхронизации Только для чтения
+    attribute :syncId,          String
+
+    # version - Версия сущности Только для чтения
+    # updated - Момент последнего обновления сущности Только для чтения
+    # deleted - Момент последнего удаления сущности Только для чтения
+    # name - номер Заказа покупателя
+    # description - Комментарий Заказа покупателя
+    attribute :description, String
+
+    # externalCode - Внешний код Заказа покупателя
+    # moment - Дата Заказа
+    attribute :moment, Time
+
+    # applicable - Отметка о проведении
+    attribute :applicable, Boolean
+
+    # vatIncluded - Включен ли НДС в цену
+    attribute :vatIncluded, Boolean
+
+    # vatEnabled - Учитывается ли НДС
+    attribute :vatEnabled, Boolean
+
+    # sum - Сумма Заказа в установленной валюте Только для чтения
+    attribute :sum, Integer
+
+    # rate - Валюта
+    attribute :rate, Rate
+
+    # owner - Владелец (Сотрудник)
+    attribute :owner, Owner
+    # shared - Общий доступ
+
+    attribute :shared, Boolean
+
+    # group - Отдел сотрудника
+    attribute :group, Group
+
+    # organization - Ссылка на ваше юрлицо в формате Метаданных Необходимое
+    attribute :organization, Entity
+
+    # agent - Ссылка на контрагента в формате Метаданных Необходимое
+    attribute :agent, Entity
+
+    # store - Ссылка на склад в формате Метаданных
+    attribute :store, Entity
+
+    # contract - Ссылка на договор в формате Метаданных
+    attribute :contract, Entity
+
+    # state - Статус Заказа в формате Метаданных
+
+    attribute :state, Entity
 
-    tag 'customerOrder'
+    # organizationAccount - Ссылка на счёт вашего юрлица в формате Метаданных
+    attribute :organizationAccount, Entity
 
-    attribute :created,     Time 
-    attribute :createdBy,   String
+    # agentAccount - Ссылка на счёт контрагента в формате Метаданных
+    attribute :agentAccount, Entity
 
-    attribute :reservedSum,     Float
+    # attributes - Коллекция доп. полей.
+    # attribute :attributes, Hash
 
-    attribute :sourceStoreUuid, String
-    attribute :sourceAccountUuid, String
-    attribute :sourceAgentUuid, String
+    # documents - Список печатных форм в формате Метаданных
+    attribute :documents, Entity
 
-    attribute :targetAgentUuid, String
-    attribute :targetAccountUuid, String
 
-    attribute :applicable,      Boolean
-    attribute :moment,          Time 
+    # Поля при expand’е:
+    #
+    # name - номер документа
+    # moment - дата печати
+    # href - ссылка на файл печатной формы
+    # fileName - название файла печатной формы
+    # updated - дата последнего изменения
+    # created - Дата создания Только для чтения
+    #
 
-    attribute :payerVat,        Boolean
+    # vatSum - Сумма НДС Только для чтения
+    attribute :vatSum, Integer
 
-    attribute :consignmentUuid, String
+    # positions - Ссылка на позиции в Заказе в формате Метаданных
+    attribute :positions, Object # Array[CustomerOrderPosition] или CollectionMeta
 
-    attribute :rate,            Float
+    # reservedSum - Сумма товаров в резерве Только для чтения
+    attribute :reservedSum, Integer
 
-    attribute :vatIncluded,     Boolean
-    attribute :name,            String
+    # deliveryPlannedMoment - Планируемая дата отгрузки
+    attribute :deliveryPlannedMoment, Time
 
-    element   :sum,             Moysklad::Entities::Price, tag: :sum
+    # payedSum - Сумма входящих платежей по Заказу Только для чтения
+    attribute :payedSum, Integer
 
-    element   :deleted,         Time
+    # shippedSum - Сумма отгруженного Только для чтения
+    attribute :shippedSum, Integer
 
-    has_many  :customerOrderPosition, Moysklad::Entities::CustomerOrderPosition
+    # invoicedSum - Сумма счетов покупателю Только для чтения
+    attribute :invoicedSum, Integer
 
+    # project - Ссылка на проект в формате Метаданных
+    #
+    # СВЯЗИ С ДРУГИМИ ДОКУМЕНТАМИ
+    #
+    # purchaseOrders - Массив ссылок на связанные заказы поставщикам
+    # demands - Массив ссылок на связанные отгрузки
+    # payments - Массив ссылок на связанные платежи
+    # invoicesOut - Массив ссылок на связанные счета покупателям
+    #def state universe
+      #cache :customer_order_states, universe do
+        #fail "No stateUuid in CustomerOrder #{uuid}" unless stateUuid
+        #workflow = universe.workflows.findWhere name: 'CustomerOrder'
+        #workflow.states.find { |s| s.uuid == stateUuid }
+      #end
+    #end
   end
 end

data/lib/moysklad/entities/customer_order_position.rb

@@ -1,22 +1,14 @@
+require_relative 'base'
+require_relative 'meta'
+require_relative 'assortment'
+
 module Moysklad::Entities
   class CustomerOrderPosition < Base
-    include HappyMapper
-    include XmlFix
-
-    tag 'customerOrderPosition'
-
-    attribute :vat,       Integer
-    attribute :goodUuid,  String
-    attribute :consignmentUuid, String
-    attribute :quantity,  Float
-    attribute :discount,  Float
-    attribute :consignmentUuid, String
-
-    element :deleted,   Time
-
-    element :basePrice, Moysklad::Entities::Price, tag: :basePrice
-    element :price,     Moysklad::Entities::Price, tag: :price
-    element :reserve,   Float
+    attribute :quantity, Integer
+    attribute :price, Integer
+    attribute :discount, Integer
+    attribute :vat, Integer
+    attribute :reserve, Integer
+    attribute :assortment, Assortment
   end
-
 end

data/lib/moysklad/entities/employee.rb

@@ -0,0 +1,7 @@
+require_relative 'meta'
+
+module Moysklad::Entities
+  class Employee < Base
+    attribute :meta, Meta
+  end
+end

data/lib/moysklad/entities/entity.rb

@@ -0,0 +1,42 @@
+require_relative 'base'
+require_relative 'meta'
+
+module Moysklad::Entities
+  class Entity < Base
+
+    # product, productfolder, feature
+    #meta - Метаданные объекта
+    #id - ID услуги в формате UUID Только для чтения
+    #accountId - ID учетной записи Только для чтения
+    #version - Версия сущности Только для чтения
+    #updated - Момент последнего обновления сущности Только для чтения
+    #name - Наименование товара с Модификацией
+    #code - Код Модификации
+    #externalCode - Внешний код Модификации
+    #archived - Добавлен ли товар в архив
+
+    attribute :meta, Meta
+    attribute :id,                String
+    attribute :version,           Integer
+    attribute :updated,           String
+    attribute :name,              String
+    attribute :code,              String
+    attribute :externalCode,      String
+    attribute :archived,          Boolean
+
+    def to_s
+      attributes.to_s
+    end
+
+    private
+
+    def cache ns, key
+      @cache||={}
+      @cache[ns]||={}
+      cc = @cache[ns]
+
+      cc[key] = yield unless cc.has_key? key
+      cc[key]
+    end
+  end
+end

data/lib/moysklad/entities/good_folder.rb

@@ -5,5 +5,6 @@ module Moysklad::Entities
     tag 'goodFolder'
 
     attribute :productCode,   String
+    attribute :parentUuid,    String
   end
 end

data/lib/moysklad/entities/group.rb

@@ -0,0 +1,7 @@
+require_relative 'meta'
+
+module Moysklad::Entities
+  class Group < Base
+    attribute :meta, Meta
+  end
+end

data/lib/moysklad/entities/image.rb

@@ -0,0 +1,17 @@
+require_relative 'base'
+module Moysklad::Entities
+  class Image < Base
+    attribute :meta,  Meta
+    attribute :title, String
+    attribute :filename, String
+    attribute :size, Integer
+
+    attribute :updated, Time
+    attribute :miniature, Meta
+    attribute :tiny, Meta
+
+    def download(client, dir)
+      client.download meta.href, dir + filename
+    end
+  end
+end

data/lib/moysklad/entities/images.rb

@@ -0,0 +1,10 @@
+module Moysklad::Entities
+  class Images < Base
+    include HappyMapper
+    include Moysklad::Entities::XmlFix
+
+    tag 'images'
+
+    has_many :image, Moysklad::Entities::Image
+  end
+end

data/lib/moysklad/entities/meta.rb

@@ -0,0 +1,14 @@
+require_relative 'base'
+
+module Moysklad::Entities
+  class Meta < Base
+    attribute :href, String
+    attribute :metadataHref, String
+    attribute :type, String
+    attribute :mediaType, String # application/json
+
+    def id
+      @id ||= href.split('/').last
+    end
+  end
+end

data/lib/moysklad/entities/organization.rb

@@ -0,0 +1,19 @@
+require_relative 'entity'
+
+module Moysklad::Entities
+  class Organization < Entity
+    attribute :externalCode, String
+    attribute :archived, Boolean
+    attribute :companyType, String
+    attribute :legalTitle, String
+    attribute :legalAddress, String
+    attribute :inn, String
+    attribute :okpo, String
+    attribute :email, String
+    attribute :phone, String
+    attribute :director, String
+    attribute :payerVat, Boolean
+    attribute :isEgaisEnable, Boolean
+    attribute :attrs, Array[Hash]
+  end
+end

data/lib/moysklad/entities/owner.rb

@@ -0,0 +1,4 @@
+module Moysklad::Entities
+  class Owner < Base
+  end
+end

data/lib/moysklad/entities/price.rb

@@ -1,15 +1,12 @@
+require_relative 'currency'
 module Moysklad::Entities
   class Price < Base
-    include HappyMapper
-    include Moysklad::Entities::XmlFix
+    attribute :value, Float
+    attribute :currency, Currency
+    attribute :priceType, String # Цена продажи/ Распродажа
 
     def self.from_money money
-      p = new
-      p.sumInCurrency = p.sum = money.cents
-      p
+      raise 'not implemented'
     end
-
-    attribute :sumInCurrency, Float
-    attribute :sum,           Float
   end
 end

data/lib/moysklad/entities/price_type.rb

@@ -1,13 +1,7 @@
+require_relative 'base'
+
 module Moysklad::Entities
   class PriceType < Base
-    include CommonObject
-    include Moysklad::Entities::XmlFix
-    tag 'priceType'
-
-    attribute :updated,     Time
-    attribute :updatedBy,   String
     attribute :name,        String
-
-    attribute :index,       Integer
   end
 end

data/lib/moysklad/entities/product.rb

@@ -0,0 +1,54 @@
+require_relative 'currency'
+require_relative 'productfolder'
+require_relative 'uom'
+require_relative 'entity'
+require_relative 'attribute_metadata'
+require_relative 'image'
+
+module Moysklad::Entities
+  class Product < Entity
+    attribute :accountId,         String
+    attribute :owner,             Owner
+    attribute :group,             Group
+    attribute :description,       String
+    # attribute :shared,            Shared
+    attribute :vat, Float
+    attribute :effectiveVat, Float
+    attribute :pathName,          String
+    attribute :productFolder,     Productfolder
+
+    attribute :uom,               Uom
+
+    attribute :minPrice,          Float
+    attribute :buyPrice,          Currency
+    attribute :salePrices,        Array[Price]
+
+    attribute :image,             Image
+
+    attribute :article,           String
+    attribute :weighed,           Boolean
+    attribute :attrs,             Array[Attribute]
+    attribute :weight,            Float
+    attribute :volume,            Float
+    attribute :barcodes,          Array[String]
+
+    attribute :isSerialTrackable, Boolean
+
+    attribute :modificationsCount, Integer
+
+
+    # Когда загружаем через ассортименты эти поля устанавливаются
+    attribute :stock, Float
+    attribute :reserve, Float
+    attribute :inTransit, Float
+    attribute :quantity, Float
+
+    # preferences
+
+    def features universe
+      cache :features, universe do
+        universe.features.where goodUuid: uuid
+      end
+    end
+  end
+end

data/lib/moysklad/entities/productfolder.rb

@@ -0,0 +1,13 @@
+require_relative 'entity'
+
+module Moysklad::Entities
+  class Productfolder < Entity
+    attribute :accountId,         String
+    attribute :owner,             Owner
+    attribute :group,             Group
+    attribute :description,       String
+    attribute :vat, Float
+    attribute :effectiveVat, Float
+    attribute :productFolder, self
+  end
+end

data/lib/moysklad/entities/rate.rb

@@ -0,0 +1,9 @@
+require_relative 'base'
+require_relative 'currency'
+
+module Moysklad::Entities
+  class Rate < Base
+    attribute :currency, Currency
+    attribute :value, Integer
+  end
+end