Сравнение версий

Старая версия 36

changes.mady.by.user Неизвестный пользователь (lupogozheva@1cbit.ru)

Сохранено

по сравнению с

Новая версия Текущий

changes.mady.by.user Коблев Мурат

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Версия 1.1421.1 0 от 1203.1207.20182019


Содержание

Оглавление



Протокол обмена

...

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
Predefined+BooleanПризнак предопределенного элемента
DeletionMark+BooleanПризнак пометки на удаление
Description+String (100)Наименование
ClientINN
String (12)ИНН клиента
Code
String (9)Код
PassportData
String (256)Серия и номер паспорта клиента. (Используется только при отсутствии ИНН клиента)
Latitude
Decimal (12.8)Широта (географические координаты)
Longitude
Decimal (12.8)Долгота (географические координаты)
Address
String (1000)Адрес
Contractor
GUIDИдентификатор связанного контрагента (Accounts.Id)

...

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
Predefined+BooleanПризнак предопределенного элемента
DeletionMark+BooleanПризнак пометки на удаление
Description+String (512)Наименование
Code
String (9)Код
IsFolder+BooleanПризнак, что элемент является группой и может выступать в качестве родительского
Parent
GUIDИдентификатор родительской записи (RIM.Id)
Price
Decimal (15.2)Цена за единицу
Service+BooleanПризнак услуги
SKU
GUIDИдентификатор элемента номенклатуры (SKU.Id)
Provider
GUIDИдентификатор элемента справочника "Поставщики" (Provider.Id)
Unit
String (5)Наименование единицы измерения
VAT+GUIDИдентификатор перечисления "Ставки НДС" (Enum.VATS)
Favorites+BooleanПризнак "избранного" товара
IsMarked-BitПризнак маркируемой продукции, 1 - маркируется, 0 или null - не маркируется


Catalog.Roles

НазваниеCatalog.Roles
НазначениеРоли
ОписаниеСписок ролей в системе

...

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
Posted+BooleanПризнак "проведенного" документа
DeletionMark+BooleanПризнак пометки на удаление
Date+DateTimeДата создания документа
Number
String (9)Номер документа
ApplicationJustification
String (500)
Client+GUIDИдентификатор Клиента (Client.Id, на которого назначена Заявка)
Address
GUIDИдентификатор строки с дополнительным адресом клиента
DivisionSource
String (500)Наименование подразделения, из которого поступила Заявка
KindEvent+GUIDТип Заявки(Enum.TypesEvents)
AnySale+BooleanВ рамках Заявки имеется одно или несколько "Уведомлений" с типом "Продажа"
AnyProblem+BooleanВ рамках Заявки имеется одно или несколько "Уведомлений" с типом "Проблема"
StartDatePlan
DateTimeПлановая дата начала Заявки
EndDatePlan
DateTimeПлановая дата окончания Заявки
ActualStartDate
DateTimeФактическая дата начала Заявки
ActualEndDate
DateTimeФактическая дата окончания Заявки
Author+GUIDИдентификатор сотрудника (User.Id, создавшего Заявку)
UserMA
GUIDИдентификатор Исполнителя - сотрудника (User.Id)
Comment
String (1000)Комментарий
DetailedDescription
String (1000)Подробное описание
CommentContractor
String (1000)Комментарий исполнителя
TargInteractions
String (100)Дата создания документа
ResultInteractions
String (100)Дата создания документа
Status+GUIDИдентификатор перечисления "Статуса Заявки" (Enum.StatusyEvents)
LatitudeStart
Decimal (12.8)Широта (координаты начала выполнения Заявки)
LongitudeStart
Decimal (12.8)Долгота (координаты начала выполнения Заявки)
LatitudeEnd
Decimal (12.8)Широта (координаты закрытия Заявки)
LongitudeEnd
Decimal (12.8)Долгота (координаты закрытия Заявки)
GPSTime
DateTimeВремя закрытия Заявки по данным GPS
ContactVisiting
GUIDКонтактное лицо (Contacts.Id)
TypesDepartures+GUIDИдентификатор "Типа оплаты" (TypesDepartures.Id)
Importance+GUIDВажность Заявки - идентификатор перечисления "Важность" (Enum.StatusImportance)
NumberOfExternalSystem+String (256)Номер Заявки во внешней учетной системе

Document.Event_CheckList

...

Reward-Decimal(15,2)Cумма вознаграждения комиссионера/агента, если включен компонент "Агент" в настройках
TimeInterval-GUIDИдентификатор интервала доставки из таблицы [Catalog].[TimeIntervals]
ContractId-GUIDИдентификатор контактного лица контрагента из таблицы [Catalog].[Contacts]

SubdivisionId

-GUIDИдентификатор подразделения из таблицы [Catalog].[Subdivisions]


Document.Event_CheckList

НазваниеDocument.Event_CheckList
НазначениеЗаявка - Чек-листы
ОписаниеХранит привязанные "Вопросы Чек-листов" с привязкой к "Чек-листу" к конкретной Заявке

Список полей:

FieldReqTypeDesc
Id+GUID

Список полей:

FieldReqTypeDesc
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Event.Id)
Action+GUIDИдентификатор "Вопроса чек-листов" (Actions.Id)
CheckListRef+GUIDИдентификатор Чек-листа, из которого подставлен вопрос (CheckList.Id)
Result
String (1000)Значение - ответ на вопрос Чек-лиса
ActionType+GUIDИдентификатор типа значения параметров (Enum.TypesDataParameters)
Required+BooleanПризнак обязательности ответа на вопрос
OrderId+GUIDИдентификатор Заказа (Order.ID)

...

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Event.Id)
UIDPhoto+GUIDИдентификатор файла "FileName" из таблицы "Заявка - Прикрепленные файлы"
Equipment+GUIDИдентификатор Оборудования (Equipment.Id)


Document.

...

Event_ServicesMaterials

НазваниеDocument.

...

Event_ServicesMaterials
Назначение

...

Заявка - Услуги и Материалы
ОписаниеВ таблице

...

содержатся услуги и материалы, которые должны были планово отгрузиться клиенту, а также информация о фактически отгруженных позициях и суммах. Состав таблицы является основанием для пробития фискального чека

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор

...

LineNumber
Integer

...

Порядковый номер (для сортировки)

...

Document.Order_OrderPayment

...

Список полей:

...

Ref+GUIDИдентификатор Заявки (Event.Id)
SKU+GUIDИдентификатор "Услуги и материала" (RIM.Id)
NomenclatureCode
String (64)Код товарной номенклатуры
Price
Decimal (15.2)Цена (без учета скидки), по которой отгружена позиция
AmountPlan
Decimal (10.3)Плановое количество к отгрузке
SumPlan
Decimal (15.2)Плановая сумма оплаты (без учета скидки)
Discount
Decimal (15.2)Сумма скидки на текущую строку. Сумма к оплате рассчитывается как (SumPlan - Discount)
AmountFact
Decimal (10.3)Фактически отгруженное количество
SumFact
Decimal (15.2)Фактически оплаченная сумма
TS
GUIDИдентификатор СНО в Catalog.SettingMobileApplication (возможные значения: OSN, USNDebit, USNDebitMinusCredit, ESHN, PSN и null)
OrderId
GUIDИдентификатор документа Document.Order
PaidSum
Decimal (15.2)Фактически оплаченна сумма (не используется, оставлена для совместимости. данные по оплатам нужно брать из чеков).
ChangeReasonId
GUIDИдентификатор причины изменения количества товара/услуги в заказе (ChangeProductOrServiceCountReasons.Id)
EquipmentNodeId
GUIDИдентификатор узла оборудования (EquipmentNodes.Id)
CustomsDeclaration
String (50)Номер ГТД
CountryCode
String (3)Код страны происхождения товара (по ОКСМ, код Альфа-3)
NomenclatureCode
String (64)Код номенклатуры (не используется, оставлен для совместимости)


Document.Event_ServicesMaterials_Marking

...

НазваниеDocument.Event_ServicesMaterials_Marking
НазначениеЗаявка - Услуги и МатериалыКоды маркировки 
ОписаниеВ таблице содержатся услуги и материалы, которые должны были планово отгрузиться клиенту, а также информация о фактически отгруженных позициях и суммах. Состав таблицы является основанием для пробития фискального чекахранятся серийные номера 

Список полей:

ПолеОбяз.ТипОписание
Idid+GUIDУникальный идентификаторLineNumberIntegerПорядковый номер (для сортировки)
ServicesMaterialsIdRef+GUIDИдентификатор Заявки (Event.Id)
SKU+GUIDИдентификатор "Услуги и материала" (RIM.Id)
Внешний ключ. Указывает на идентификатор товара в таблице [Document].[Event_ServicesMaterials]
GTIN+nvarchar(14)GTIN - код товара 
IsDeleted
BOOLEANПризнак, означающий, что позиция удалена
KeyFieldTimestamp
BIGINTtimestamp последнего изменения любого из ключевых полей таблицы
NomenclatureCode+nvarchar(50)Cерийный номер товарной позиции
ScanNomenclatureCode
nvarchar(150)Полный штрихкод для товарной позиции
IsScanned
BOOLEANПризнак, что данный маркировочный код отсканированPriceDecimal (15.2)Цена (без учета скидки), по которой отгружена позицияAmountPlanDecimal (10.3)Плановое количество к отгрузкеSumPlanDecimal (15.2)Плановая сумма оплаты (без учета скидки)DiscountDecimal (15.2)Сумма скидки на текущую строку. Сумма к оплате рассчитывается как (SumPlan - Discount)AmountFactDecimal (10.3)Фактически отгруженное количествоSumFactDecimal (15.2)Фактически оплаченная суммаTSGUIDИдентификатор СНО в Catalog.SettingMobileApplication (возможные значения: OSN, USNDebit, USNDebitMinusCredit, ESHN, PSN и null)ChangeReasonIdGUIDИдентификатор причины изменения количества товара/услуги в заказе (ChangeProductOrServiceCountReasons.Id)EquipmentNodeIdGUIDИдентификатор узла оборудования (EquipmentNodes.Id)


Document.Event_TypeDepartures

...

ПолеОбяз.ТипОписание
Id+GUID.Уникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Event.Id)
TypeDeparture+GUIDИдентификатор "Тип оплаты" (TypesDepartures.Id)
Active+BooleanПризнак активности строки. Активной может быть только одна строка


Document.

...

Order


НазваниеDocument.

...

Order
Назначение

...

Заказ
ОписаниеВ таблице

...

хранятся записи о заказах сделаных в рамках наряда


Список полей:


ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор

...

Number
String (256)Порядковый номер (для сортировки)

...

Description
String (256)Описание заказа
DeletionMark+BooleanПризнак пометки на удаление
Status

...


GUIDИдентификатор перечисления "

...

Статуса Заказа" (Enum.

...

OrderStatus)

...

State
GUIDИдентификатор перечисления "

...

Состояния Заказа" (Enum.

...

OrderStates)
EquipmentId

...


GUIDИдентификатор

...

оборудования (Catalog.

...

Equipment)

...


Document.Order_OrderPayment


НазваниеDocument.Order_OrderPaymentType
НазначениеЗаказ - статус оплаты
ОписаниеПеречень статусов оплаты заказа


Список полей:


ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заказа
OrderPaymentType+GUIDИдентификатор "Статус оплаты"
Sum+

...

Decimal (15.2)Сумма

...

по указанному статусу оплаты


Document.Cheque

НазваниеDocument.Cheque
НазначениеДокумент "Чек"
ОписаниеВ таблице оформленные документы "Чек" с необходимыми фискальными реквизитами

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
IsFiscalCheque+BooleanПорядковый номер (для сортировки)
ChequeType
GUIDИдентификатор перечисления "Тип чека" (Enum.ChequeType)
PositionPaymentType
GUIDИдентификатор перечисления "Признак способа расчета" (Enum.PositionPaymentType) (в текущей версии задается для чека в целом)
Client
GUIDИдентификатор "Клиента" (Catalog.Client)
IsMainCheque+BooleanПризнак чека "Основой" - оформлен в рамках отгрузки Заказа (в текущей версии всегда True)
OriginalSalesCheck
GUIDТолько для чеков возврата - Идентификатор документа "Чек" (Document.Cheque), по которому оформлялся возврат
ApplicationForDelivery
GUIDИдентификатор документа "Заявка" (Document.Event), в рамках которой оформлялся Чек
DateOfCheckPrinting
DateTimeДата и время оформления Чека
ShiftNumber
IntegerНомер смены фискального регистратора (ФР)
TotalAmount

...

Document.Cheque_Nomenclature

...

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumberIntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Cheque.Id)
RIM+GUIDИдентификатор "Услуги и материала" (RIM.Id)
PriceFact+
Decimal (15.2)Фактическая ценаСумма чека
AmountFactFptrNumber+Decimal (10.3)Фактическое количество
SumFact+Decimal (15.2)Фактическая сумма
VAT+GUIDИдентификатор переисления "Ставки НДС" (Enum.VAT)
DiscountAmountDecimal (15.2)Сумма скидки на позициюPositionPaymentTypeGUIDИдентификатор перечисления "Признак способа расчета" (Enum.PositionPaymentType)

Document.Cheque_Payment

...

Список полей:

...


String (100)Заводской номер ФР
FiscalStorageNumber
String (100)Номер фискального накопителя (ФН)
DocumentNumberWithinTheShift
IntegerНомер чека в рамках смены
FiscalSignOfTheDocument
Decimal (15.3)Фискальный номер документа
Latitude
Decimal (12.8)Географические координаты (широта)
Longitude
Decimal (12.8)Географические координаты (долгота)
GPSDateTime
DateTime2Дата и время по данным датчика GPS
ClientAddress
String (1000)Адрес клиента (как он был отпечатан на чеке)
Comment
String (1000)Коммментарий
PhoneOrEmail
String (1000)Телефон или email покупателя (если был указан)
AppliedTaxSystem
String (1000)Система налогообложения
AuthorMA
GUIDИдентификатор Исполнителя - сотрудника (User.Id)


Document.Cheque_Nomenclature

...

НазваниеDocument.Cheque_ChequePhotoNomenclature
НазначениеЗаявка - Фотографии оборудованияЧек - Товары и услуги
ОписаниеПеречень позиций чека, цены, количество, суммы

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Cheque.Id)
PhotoIdRIM+GUIDВнутренне имя файла (автоматически формируется в формате GUID)CommentString (1000)Комментарий к фото

Document.EventHistory

...

Идентификатор "Услуги и материала" (RIM.Id)
PriceFact+Decimal (15.2)Фактическая цена
AmountFact+Decimal (10.3)Фактическое количество
SumFact+Decimal (15.2)Фактическая сумма
VAT+GUIDИдентификатор переисления "Ставки НДС" (Enum.VAT)
DiscountAmount
Decimal (15.2)Сумма скидки на позицию
PositionPaymentType

Список полей:

+Статуса ЗаявкиStatusyEvents
ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
DateDateTimeПорядковый номер (для сортировки)
DeletionMark+BooleanПризнак пометки на удаление
Status
GUIDИдентификатор перечисления "Признак способа расчета" (Enum.PositionPaymentType)
Event+GUIDИдентификатор "Заявки" (Event.Id)
AuthorGUIDИдентификатор сотрудника (User.Id, создавшего Заявки)UserMAGUIDИдентификатор Исполнителя - сотрудника (User.Id)

...


Document.Cheque_Nomenclature_Marking

НазваниеDocument.NeedMatEvent_Photos
НазначениеЗаявка на материалыЧек - Коды маркировки 
ОписаниеКоды маркировки номенклатуры чека 

Список полей:

ПолеОбяз.ТипОписание
Idid+GUIDУникальный идентификатор
PostedChequeNomenclatureId+BooleanПризнак "проведенного" документа
DeletionMark+BooleanПризнак пометки на удаление
Date+DateTimeДата создания документа
NumberString (9)Номер документаDocInGUIDИдентификатор "Заявки" (Event.Id), в рамках которого оформлена "Заявка на материалы"
StatsNeed+GUIDИдентификатор значения перечисления "Статусы Заявки на материалы" (Enum.StatsNeedNum)
SR+GUIDИдентификатор сотрудника (User.Id, создавшего Заявку)
FillFull+BooleanПризнак, что Заявка создана "по норме". При обработке такой заявки игнорируется кол-во затребованных позиций, а состав заявки формируется с учетом норм и остатков
SRMCommentString (1000)Комментарий сотрудника, обрабатывающего ЗаявкуSRCommentString (1000)Комментарий автора Заявки

Document.NeedMat_Matireals

GUIDВнешний ключ. Указывает на идентификатор номенклатуры из чека [Document].[Cheque_Nomenclature]
GTIN+nvarchar(14)GTIN - код товара 
IsDeleted
BOOLEANПризнак, означающий, что позиция удалена
KeyFieldTimestamp
BIGINTtimestamp последнего изменения любого из ключевых полей таблицы
NomenclatureCode+nvarchar(50)Cерийный номер товарной позиции
ScanNomenclatureCode
nvarchar(150)Полный штрихкод для товарной позиции

Document.Cheque_Payment

НазваниеDocument.Cheque_Payment
НазначениеЧек - Оплаты
ОписаниеПеречень оплат и сумм

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Чека (Cheque.Id)
PaymentType+GUIDИдентификатор "Тип оплаты" (Catalog.ListOfPayments)
PaymentAmount+Decimal (15.2)Сумма по указанному Типу оплаты
RRN

String (50)Номер транзации для выполнения возврата эквайринговой операции на ККТ Азур
TransactionId
String (80)Идентификатор эквайринговой транзакции


Document.Cheque_ChequePhoto

НазваниеDocument.Cheque_ChequePhoto
НазначениеЗаявка - Фотографии оборудования
Описание
НазваниеDocument.NeedMat_Matireals
НазначениеЗаявка на материалы - Состав
ОписаниеСписок и количество затребованных и отгруженных материалов

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки на материалы (NeedMatCheque.Id)
SKUPhotoId+GUIDИдентификатор "Услуги и материала" (RIM.Id)
Count+Decimal (15.3)Количество затребованных / отгруженных материалов

...

Внутренне имя файла (автоматически формируется в формате GUID)
Comment
String (1000)Комментарий к фото


Document.EventHistory

НазваниеDocument.ReminderEventHistory
НазначениеУведомлениеИстория оборудования
ОписаниеСписок уведомлений о продажах и проблемах в рамках ЗаявкокВ таблице хранятся записи о всех работах, проведенных с оборудованием

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
PostedDate+Boolean
DateTimeПорядковый номер (для сортировки)Признак "проведенного" документа
DeletionMark+BooleanПризнак пометки на удаление
DateStatus+DateTimeДата создания документаGUIDИдентификатор перечисления "Статуса Заявки" (Enum.StatusyEvents)
EventNumberString (9)Номер документаReminders+GUIDИдентификатор "Заявки" (Event.Id), в рамках которого оформлено УведомлениеViewReminder+
Author
GUIDИдентификатор значения перечисления "Типы Уведомлений" (Enum.FoReminders)CommentString (1000)Комментарий

...

сотрудника (User.Id, создавшего Заявки)
UserMA
GUIDИдентификатор Исполнителя - сотрудника (User.Id)


Document.NeedMat

НазваниеDocument.Reminder_PhotoNeedMat
НазначениеУведомление - ФотографииЗаявка на материалы
Описание

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
PostedLineNumber+IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Reminder.Id)
BooleanПризнак "проведенного" документа
DeletionMark+BooleanПризнак пометки на удаление
Date+DateTimeДата создания документа
Number
String (9)Номер документа
DocIn
GUIDИдентификатор "Заявки" (Event.Id), в рамках которого оформлена "Заявка на материалы"
StatsNeedIDPhoto+GUIDИдентификатор файла

Document.Task

значения перечисления "Статусы Заявки на материалы" (Enum.StatsNeedNum)
SR+GUIDИдентификатор сотрудника (User.Id, создавшего Заявку)
FillFull+BooleanПризнак, что Заявка создана "по норме". При обработке такой заявки игнорируется кол-во затребованных позиций, а состав заявки формируется с учетом норм и остатков
SRMComment
String (1000)Комментарий сотрудника, обрабатывающего Заявку
SRComment
String (1000)Комментарий автора Заявки


Document.NeedMat_Matireals

НазваниеDocument.NeedMat_Matireals
НазначениеЗаявка на материалы - Состав
ОписаниеСписок и количество затребованных и отгруженных материалов
НазваниеDocument.Task
НазначениеЗадача
ОписаниеЗадачи - это отдельные сущности, исполнение которых можно отслеживать в рамках Заявки. Задачи могут быть назначены: 

- на Клиента (будет отображаться во всех Заявках по клиенту)

- на Оборудование (будет отображаться во всех Заявках, где есть указанное Оборудование),

- на Заявку (будет отображаться в конкретной Заявке)

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
PostedLineNumber
IntegerПорядковый номер (для сортировки)
Ref+BooleanПризнак "проведенного" документаDeletionMark+BooleanGUIDПризнак пометки на удалениеИдентификатор Заявки на материалы (NeedMat.Id)
SKUDate+DateTimeДата создания документаNumberString (9)Номер документаDescriptionString (1000)Описание ЗадачиClientGUIDИдентификатор Клиента (Client.Id, на которого назначена Задача)EquipmentGUIDИдентификатор Оборудования (Equipment.Id), на которое назначена ЗадачаEventGUIDИдентификатор "Заявки" (Event.Id), на который назначена ЗадачаTaskTypeString (100)

...

GUIDИдентификатор "Услуги и материала" (RIM.Id)
Count+Decimal (15.3)Количество затребованных / отгруженных материалов


Document.Reminder

НазваниеDocument.Task_StatusReminder
НазначениеЗадача - СтатусыУведомление
ОписаниеТаблица для отслеживания статусов Задач. Дополнительно зраним исполнителя, который выполнил Задачу, и Заявка, в рамках которой Задача была выполненаСписок уведомлений о продажах и проблемах в рамках Заявкок

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
Posted+LineNumberIntegerПорядковый номер (для сортировки)BooleanПризнак "проведенного" документа
DeletionMarkRef+GUIDBooleanИдентификатор Заявки на материалы (NeedMat.Id)Признак пометки на удаление
Date+DateTimeДата создания документа
NumberCommentContractor+
String (10009)Комментарий исполнителяНомер документа
StatusReminders+GUIDИдентификатор значения перечисления "Статусы ЗадачЗаявки" (EnumEvent.StatusTasks)Id), в рамках которого оформлено Уведомление
ViewReminderUserMA+GUIDИдентификатор выполнившего Исполнителя (User.Id)
ActualEndDate+DateTimeДата выполнения Задачи
CloseEvent+GUIDИдентификатор "Заявки" (Event.Id), в рамках которого выполнена Задача

...

значения перечисления "Типы Уведомлений" (Enum.FoReminders)
Comment
String (1000)Комментарий


Document.Reminder_Photo

НазваниеDocument.TaskReminder_TargetsPhoto
НазначениеЗадача Уведомление - ЦелиФотографии
ОписаниеПо каждой задаче может быть поставлено несколько целей. В таблице отслеживается исполнение этих целей.

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки на материалы (NeedMatReminder.Id)
DescriptionIDPhoto+GUIDОписание целей
IsDone+BooleanПризнак, что цель достигнута

Типовые фильтры

Для уменьшения данных, хранимых на мобильном устройстве, а также для минимизации трафика при обмене между мобильным приложением и сервером в решении на таблицы накладываются дополнительные фильтры, отсекающие лишние данные.

Ниже приведены фильтры, наложенные на основные таблицы. На таблицы, связанные с основными (у которых имя представляет собой <ИмяОсновной>_<ИмяСвязанной>) - дублируются фильтры основных таблиц

Таблица: “Catalog.TypesDepartures”

Описание фильтра:

“Типы оплаты” никак не фильтруются - на все устройства таблица с типами выездов попадает полностью.

Запрос для фильтрации (в формате SQL):

<отсутствует>

Таблица: “Catalog.RIM”

Описание фильтра:

“Услуги и материалы” не фильтруются. На все устройства попадают все “Услуги и материалы”, чтобы мобильные сотрудники могли в рамках Заявки отгружать клиенту любые услуги и материалы.

При включенном функционале “Рюкзак” дополнительная фильтрация отображаемых услуг и материалов выполняется на мобильном устройстве.

Запрос для фильтрации (в формате SQL):

<отсутствует>

Таблица: “Document.Reminder”

Описание фильтра:

Уведомления не фильтруются. Их передача осуществляется только с мобильного приложения на сервер

Запрос для фильтрации (в формате SQL):

<отсутствует>

Таблица: “Document.Event”

Описание фильтра:

На мобильное устройство уходят Заявки, соответствующие следующим условиям:

  • назначенный исполнитель соотвествует пользователю, авторизованному на мобильном устройстве
  • плановая дата Заявки находится текущая либо в будущем и статус один из: ....
  • плановая дата Заявки на 31 день в прошлом и статус один из: …

Запрос для фильтрации (в формате SQL):

Идентификатор файла


Document.Task

НазваниеDocument.Task
НазначениеЗадача
ОписаниеЗадачи - это отдельные сущности, исполнение которых можно отслеживать в рамках Заявки. Задачи могут быть назначены: 

- на Клиента (будет отображаться во всех Заявках по клиенту)

- на Оборудование (будет отображаться во всех Заявках, где есть указанное Оборудование),

- на Заявку (будет отображаться в конкретной Заявке)

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
Posted+BooleanПризнак "проведенного" документа
DeletionMark+BooleanПризнак пометки на удаление
Date+DateTimeДата создания документа
Number
String (9)Номер документа
Description
String (1000)Описание Задачи
Client
GUIDИдентификатор Клиента (Client.Id, на которого назначена Задача)
Equipment
GUIDИдентификатор Оборудования (Equipment.Id), на которое назначена Задача
Event
GUIDИдентификатор "Заявки" (Event.Id), на который назначена Задача
TaskType
String (100)


Document.Task_Status

НазваниеDocument.Task_Status
НазначениеЗадача - Статусы
ОписаниеТаблица для отслеживания статусов Задач. Дополнительно зраним исполнителя, который выполнил Задачу, и Заявка, в рамках которой Задача была выполнена

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки на материалы (NeedMat.Id)
CommentContractor+String (1000)Комментарий исполнителя
Status+GUIDИдентификатор значения перечисления "Статусы Задач" (Enum.StatusTasks)
UserMA+GUIDИдентификатор выполнившего Исполнителя (User.Id)
ActualEndDate+DateTimeДата выполнения Задачи
CloseEvent+GUIDИдентификатор "Заявки" (Event.Id), в рамках которого выполнена Задача


Document.Task_Targets

НазваниеDocument.Task_Targets
НазначениеЗадача - Цели
ОписаниеПо каждой задаче может быть поставлено несколько целей. В таблице отслеживается исполнение этих целей.

Список полей:

ПолеОбяз.ТипОписание
Id+GUIDУникальный идентификатор
LineNumber
IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки на материалы (NeedMat.Id)
Description+GUIDОписание целей
IsDone+BooleanПризнак, что цель достигнута

Типовые фильтры

Для уменьшения данных, хранимых на мобильном устройстве, а также для минимизации трафика при обмене между мобильным приложением и сервером в решении на таблицы накладываются дополнительные фильтры, отсекающие лишние данные.

Ниже приведены фильтры, наложенные на основные таблицы. На таблицы, связанные с основными (у которых имя представляет собой <ИмяОсновной>_<ИмяСвязанной>) - дублируются фильтры основных таблиц

...

Таблица: “Catalog.TypesDepartures”

Описание фильтра:

“Типы оплаты” никак не фильтруются - на все устройства таблица с типами выездов попадает полностью.

Запрос для фильтрации (в формате SQL):

<отсутствует>

...

Таблица: “Catalog.RIM”

Описание фильтра:

“Услуги и материалы” не фильтруются. На все устройства попадают все “Услуги и материалы”, чтобы мобильные сотрудники могли в рамках Заявки отгружать клиенту любые услуги и материалы.

При включенном функционале “Рюкзак” дополнительная фильтрация отображаемых услуг и материалов выполняется на мобильном устройстве.

Запрос для фильтрации (в формате SQL):

<отсутствует>

...

Таблица: “Document.Reminder”

Описание фильтра:

Уведомления не фильтруются. Их передача осуществляется только с мобильного приложения на сервер

Запрос для фильтрации (в формате SQL):

<отсутствует>

...

Таблица: “Document.Event”

Описание фильтра:

На мобильное устройство уходят Заявки, соответствующие следующим условиям:

  • назначенный исполнитель соотвествует пользователю, авторизованному на мобильном устройстве
  • плановая дата Заявки находится текущая либо в будущем и статус один из: ....
  • плановая дата Заявки на 31 день в прошлом и статус один из: …

Запрос для фильтрации (в формате SQL):

t.[t.[Id] IN(SELECT DISTINCT EV.[Id] FROM [Document].[Event] EV JOIN [Enum].[StatusyEvents] SE ON EV.[Status] = SE.[Id] LEFT JOIN [Document].[EventHistory] EH ON EH.Event = EV.Id WHERE (EV.[UserMA] = @UserId OR (EH.UserMA = @UserId AND EH.Date &gt;(getDate()-14))) AND EV.[StartDatePlan] &gt;(getDate() - 14) AND (NOT (SE.[Name] = 'New')) AND (NOT (SE.[Name] = 'Done' OR SE.[Name] = 'Cancel' OR SE.[Name] = 'DoneWithTrouble' OR SE.[Name] = 'Close' OR SE.[Name] = 'NotDone' OR SE.[Name] = 'OnTheApprovalOf') OR ((SE.[Name] = 'Done' OR SE.[Name] = 'Cancel' OR SE.[Name] = 'DoneWithTrouble' OR SE.[Name] = 'Close' OR SE.[Name] = 'NotDone' OR SE.[Name] = 'OnTheApprovalOf') AND EV.[ActualEndDate] &gt;(getDate() - 1))) OR SE.[Name] = 'OnRefund')

...

редактирования количество услуг относительно плановогоUsedCalculateUsedCalculateMaterials
Наименование настройкиЗначение (логическое)Значение (числовое)Описание
AddUnPlanMaterials10Возможность добавлять материалы кроме плановых
AddUnPlanService10Возможность добавлять услуги роме плановых
AllowGalery10Возможность вставлять фотографии не только с камеры, но и из галереи мобильного устройства
EditPlanMaterials10Возможность редактирования количество материалов относительно планового
EditPlanService10Возможность редактирования количество услуг относительно планового
HistoryLength190Видимость истории и ее длительность в днях
PictureSize02500Максимальный размер фотографии в точках по длинной стороне
UsedCalculate10Отображать цену и сумму
UsedCalculateMaterials10Отображать цену и сумму по материалам
UsedCalculateService10Отображать цену и сумму по услугам
UsedCheckLists10Использование чек-листов
UsedEquipment10Возможность работы с оборудованием
UsedGpsFix00Использование GPS
UsedServiceBag00Использование “Рюкзака”
EnableFPTREditPlanMaterials10Возможность редактирования количество материалов относительно плановогоEditPlanServiceработы с фискальным регистратором на мобильном устройстве
IsMultipleTS10Возможность
HistoryLength190Видимость истории и ее длительность в днях
PictureSize02500Максимальный размер фотографии в точках по длинной стороне
работы с различными системами налогообложения
PaymentAgent10Возможность работы в режиме "Платежный агент"
PaymentReward10Отображать цену и суммуПечать агентского вознаграждения в чеке
EnableCodePrint10Отображать цену и сумму по материалам
UsedCalculateService10Отображать цену и сумму по услугам
UsedCheckLists10Использование чек-листов
UsedEquipment10Возможность работы с оборудованием
UsedGpsFix00Использование GPS
UsedServiceBag00Использование “Рюкзака”
EnableFPTR10Возможность работы с фискальным регистратором на мобильном устройстве
IsMultipleTS10Возможность работы с различными системами налогообложения
PaymentAgent10Возможность работы в режиме "Платежный агент"
PaymentReward10Печать агентского вознаграждения в чеке

Использование статусов заказа и оплаты при разных сценариях работы

Системой Grotem Express тот или иной сценарий работы с заказами, имеющими различные способы расчета, определяется через статусы заказов и статусы оплаты. Ниже рассмотрены сценарии работы с такими заказами.

Полная оплата и отгрузка

Передача кода товарной номенклатуры на фискальный регистратор


Использование статусов заказа и оплаты при разных сценариях работы

Системой Grotem Express тот или иной сценарий работы с заказами, имеющими различные способы расчета, определяется через статусы заказов и статусы оплаты. Ниже рассмотрены сценарии работы с такими заказами.

Полная оплата и отгрузка

При отгрузке товара по заказу с получением полной его оплаты в Grotem Express выгружается заказ со статусом «Delivery»:


Статус заказаЗапись в таблицуТаблица перечисления
DeliveryDocument.OrderEnum.OrderStatus

После получения курьером оплаты в таблицу Document.Order_OrderPayment делается запись со статусом «DeliveryPayment»:

Статус платежаЗапись в таблицуТаблица перечисления
DeliveryPaymentDocument.Order_OrderPaymentEnum.OrderPaymentTypes


Отгрузка в кредит

При отгрузке товара по заказу без получения оплаты по нему, товар передается в кредит. При этом в Grotem Express выгружается заказ со статусом «Delivery»:

Статус заказаЗапись в таблицуТаблица перечисления
DeliveryDocument.OrderEnum.OrderStatus

После получения курьером оплаты в таблицу Document.Order_OrderPayment делается запись со статусом «DeliveryPayment»:

Статус платежаЗапись в таблицуТаблица перечисления
DeliveryPaymentDocument.Order_OrderPaymentEnum.OrderPaymentTypes

Оплата кредита

При получении оплаты кредита за заказ, который ранее был отгружен, При отгрузке товара по заказу с получением полной его оплаты в Grotem Express выгружается заказ со статусом «Delivery»«Credit»:

Статус заказаЗапись в таблицуТаблица перечисления
CreditDocument.OrderEnum.OrderStatus

После получения курьером оплаты в таблицу Document.Order_OrderPayment делается запись со статусом «CreditPayment»:

Статус платежаЗапись в таблицуТаблица перечисления
DeliveryDocument.OrderEnum.OrderStatus

После получения курьером оплаты в таблицу Document.Order_OrderPayment делается запись со статусом «DeliveryPayment»:

...

CreditPaymentDocument.Order_OrderPaymentEnum.OrderPaymentTypes

Как настроить отправку пуш-уведомлений

В endpoint на Grotem сервере: /push/sendmessage надо отправить POST запрос следующего вида:

В теле запроса должен быть json:

{

"Data":"ххххххххх",

"AdditionalInfo":"ххххххх",

"Recipients":["71E1C7EF-1387-11E6-B0E4-6C71D97753D2"],

"EventId":"71E1C804-1387-11E6-B0E4-6C71D97753D2",

"EventNumber":"12234",

"ClientName":"ххххх"

}

где:

"Recipients" - это "UserId" (массив);

Примечание. EventNumber и ClientName указывать не обязательно.


Загрузка номенклатуры с кодами маркировки

В endpoint на Grotem сервере: http(s)://<внешний адрес клиента>:<порт >/<сервер>/<решение>/admin/SyncSolutionDatabase надо отправить POST запрос следующего вида:

В теле запроса должен быть json: пример json-файла


Версии документа и внесенные изменения

ВерсияДата публикацииВнесенные изменения
1.21.003.07.2019В Catalog.Client добавлено поле ИНН клиента (ClientINN); в Document.EventServicesMaterials добавлен код товарной номенклатуры (NomenclatureCode); в Catalog.SettingMobileApplication добавлена настройка EnableCodePrint (передавать код товарной номенклатуры)
1.20.006.06.2019

В связи с расширением объектной модели добавлено описание новых справочников и документов: Catalog.ChangeProductOrServiceCountReasons, Catalog.Coefficients, Document.Contract, Document.Contract_Coefficients, Catalog.EquipmentNodes, Catalog.TimeIntervals, Enum.CashBalanceStatuses, Enum.OrderPaymentTypes, Enum.RouteStatuses, Document.CorrectionOrderPhotos, Enum.SettingType, Catalog.Subdivisions

Добавлены новые поля в Document.Cheque_Payment, Document.Event_CheckList, Document.Event_ServicesMaterials.

Отгрузка в кредит

При отгрузке товара по заказу без получения оплаты по нему, товар передается в кредит. При этом в Grotem Express выгружается заказ со статусом «Delivery»:

...

После получения курьером оплаты в таблицу Document.Order_OrderPayment делается запись со статусом «DeliveryPayment»:

...

Оплата кредита

При получении оплаты кредита за заказ, который ранее был отгружен, в Grotem Express выгружается заказ со статусом «Credit»:

...

После получения курьером оплаты в таблицу Document.Order_OrderPayment делается запись со статусом «CreditPayment»:

...

Версии документа и внесенные изменения

Внесенные изменения
ВерсияДата публикации

1.14.1

12.12.2018

Добавлен раздел "Использование статусов заказа и оплаты при разных сценариях работы".

1.1404.12.2018

Добавлены документы: Document.Order, Document.Order_OrderPayment. В документ Document.Cheque_Nomenclature добавлено поле: PositionPaymentType.

В перечисление Enum.VATs добавлены значения ставок 18/118 и 10/110.

Добавлены перечисления Enum.OrderStatus (статусы заказа) и Enum.OrderPaymentTypes (статусы оплаты)


1.1309.10.2018Добавлено поле "ИНН кассира" в справочник "Сотрудники".
1.1012.04.2018

Размер столбца "Description" Catalog.RIM увеличен до 512 символов включительно.

Поле Root таблицы Catalog.User удалено. Вместо него используется поле Root таблицы ролей Catalog.Roles.

Поле NumberOfExternalSystem таблицы Document.Event - стало обязательным. Используйте его для передачи номера заявки.

1.9

07.02.2018

Структура таблиц приведена в соответствие с релизом 1.9.0.0

Добавлен справочник "Поставщики"

В "Заявку" добавлены "СНО" для каждой позиции

В "Заявку" добавлен "Поставщик" для каждой позиции

В "справочник работ и материалов" добавлен идентификатор элемента справочника "Поставщики" (Provider.Id)


1.610.08.2017Описание TypeDeparture изменено с "Тип выезда" на "Тип оплаты"
1.609.08.2017Структура таблиц приведена в соответствие с релизом 1.6.0.0
  • В "Заявку" добавлена скидка для каждой позиции
  • Для "Заявок" есть возможность указывать номер из внешней системы
  • Добавлено новое право на работу со скидками
  • Добавлен новый статус "Заявки" - "Возврат"
1.411.07.2017Структура таблиц приведена в соответствие с релизом 1.4.0.0
  • Добавлена таблица с адресами Клиента
  • В документ "Заявка" добалена возможность указать адреса клиента
1.326.06.2017Структура таблиц приведена в соответствие с релизом 1.3.0.0
1.210.04.2017
  • Добавлено описание документа "Чек" и связанных с ним таблиц
  • Добавлено перечисление "Типы чеков"
  • Добавлено перечисление "Признак способа расчета"
  • Добавлен справочник "Типы оплат"
  • Добавлен справочник "Должности". Добавлена связка с Пользователями.
  • Исключено описание для отправки подтверждения
  • Исправлены заголовки
  • Новый адрес точки подключения
  • Небольшие исправления
  • Исправлены реквизиты Заявки (добавлены координаты начала и окончания)
  • Исправлены ошибки
  • Актуализирована обязательность полей 
1.117.03.2017Исходная публикация