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

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

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

Сохранено

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

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

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

Сохранено

Ключ

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

...

ПолеОбяз.ТипОписание
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)Номер Заявки во внешней учетной системе
Reward-Decimal(15,2)Cумма вознаграждения комиссионера/агента, если включен компонент "Агент" в настройках
TimeInterval-GUIDИдентификатор интервала доставки из таблицы [Catalog].[TimeIntervals]
ContractId-GUIDИдентификатор контактного лица контрагента из таблицы [Catalog].[Contacts]

SubdivisionId

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


Document.Event_CheckList

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

...

ПолеОбяз.ТипОписание
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

...

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

...

+GUIDИдентификатор Заявки (Event.Id)
SKU+
GUIDИдентификатор

...

"

...

Услуги и материала" (

...

RIM.

...

Id)

...

Document.Order_OrderPayment

...

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

...

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

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

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

ПолеОбяз.ТипОписание
Idid+GUIDУникальный идентификатор
ServicesMaterialsIdLineNumber+IntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Event.Id)
SKU+GUIDИдентификатор "Услуги и материала" (RIM.Id)
NomenclatureCodeString (64)Код товарной номенклатуры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

...

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

...

Document.Cheque

...

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

...

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


Document.Event_TypeDepartures

НазваниеDocument.Event_TypeDepartures
НазначениеЗаявка - Типы оплат
ОписаниеВ таблицу нужно добавить одну строку - тип оплаты, соотвествующую реквизиту Event.TypesDepartures

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

ПолеОбяз.ТипОписание
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
Decimal (15.2)Сумма чека
FptrNumber
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_Nomenclature
НазначениеЧек - Товары и услуги
ОписаниеПеречень позиций чека, цены, количество, суммы

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

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


Document.Cheque_Nomenclature_Marking

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

...

Document.Cheque_Nomenclature

НазваниеDocument.Cheque_Nomenclature
НазначениеЧек - Товары и услуги
ОписаниеПеречень позиций чека, цены, количество, суммы

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

ПолеОбяз.ТипОписаниеОписание
id
Id+GUIDУникальный идентификатор
LineNumberIntegerПорядковый номер (для сортировки)
Ref+GUIDИдентификатор Заявки (Cheque.Id)
RIM+GUIDИдентификатор "Услуги и материала" (RIM.Id)
PriceFact+Decimal (15.2)Фактическая цена
AmountFact+Decimal (10.3)Фактическое количество
SumFact+Decimal (15.2)Фактическая сумма
VAT+GUIDИдентификатор переисления "Ставки НДС" (Enum.VAT)
Уникальный идентификатор
ChequeNomenclatureId+GUIDВнешний ключ. Указывает на идентификатор номенклатуры из чека [Document].[Cheque_Nomenclature]
GTIN+nvarchar(14)GTIN - код товара 
IsDeleted
BOOLEANПризнак, означающий, что позиция удалена
KeyFieldTimestamp
BIGINTtimestamp последнего изменения любого из ключевых полей таблицы
NomenclatureCode+nvarchar(50)Cерийный номер товарной позиции
ScanNomenclatureCode
nvarchar(150)Полный штрихкод для товарной позицииDiscountAmountDecimal (15.2)Сумма скидки на позициюPositionPaymentTypeGUIDИдентификатор перечисления "Признак способа расчета" (Enum.PositionPaymentType)

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)Идентификатор эквайринговой транзакции

...

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


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

...

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

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

...

Как передать код товарной номенклатуры

  1. Включить настройку EnableCodePrint в таблице Catalog.SettingsMobileApplication значение из поля NomenclatureCode таблицы Document.EventServicesMaterials будет передано на фискальник. 
  2. Передать код товара следующего формата: 1-ая часть это GTIN (14 символов), 2-ая часть SerialNumber(на текущий момент может быть только 7 и 19 символов для табака и меховых изделий соответственно).

Например: имеется код 98765432101234ABC1234
первые 14 символов GTIN = 98765432101234
последние 7 символов SerialNumber = ABC1234

...

Enum.OrderStatus

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

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

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

...

Примечание. 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.

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Исходная публикация