Доставка
Источник данных
Коннектор может работать с четырьмя типами источников файлов:
Настройка серверов включает в себя специальные параметры (например, тип подключения, тип авторизации, путь к рабочей папке) и общие параметры для каждого типа источника файлов: группировка документов в пакеты и их связывание.
Чтобы отправить документы в одном письме, нужно сгруппировать их любым из способов:
Ниже на схемах приведены примеры группировки файлов в письма при установке уровня вложенности «0» или «1».
Схема 1. Пример группировки файлов в письма с уровнем вложенности «0».
Схема 2. Пример группировки файлов в письма с уровнем вложенности «1».
Типы и форматы документов
Коннектор позволяет отправлять любые типы документов, которые поддерживает Диадок.
Основные типы документов:
Поддерживаемые форматы формализованных документов, которые закреплены законодательством: 820@, 736@, 551@, 552@.
Некоторые неформализованные документы требуют дополнительных данных, таких как: дата, номер, сумма. Их можно указать в имени исходного файла документа.
Если учетная система не может выгрузить счета-фактуры, накладные, акты или УПД в формате установленном ФНС или в формате, который необходим для отправки в электронном виде (произвольный PDF или XML), то можно воспользоваться функцией преобразования документов. Поддерживаемые форматы исходных файлов, для которых применима функция преобразования:
Возможен вариант сложного преобразования, когда из одного файла требуется сформировать несколько файлов.
Эти настройки выполняются в индивидуальном порядке через менеджера.
Загрузка документов в Диадок
Для отправки документа потребуется задать правила маршрутизации для определения:
Исходящие для последующей отправки и подписи.
Подписать и оправить документы получателям. Потребуется обязательная авторизация пользователя в коннекторе под сертификатом.
Получатель документа может быть определен по:
При маршрутизации по паре ИНН-КПП применяется следующий порядок поиска организации в Диадоке:
Поиск по КПП одновременно происходит как по реквизитам ящика организации, так и по реквизитам подразделений ящика организации.
Отправка документов в роуминговые ящики осуществляется в головное подразделение.
Исключение составляют документы с типом «Приглашение». Для них нет проверок на наличие получателя в списке контрагентов.
Более гибкие настройки по маршрутизации документов представляет «файл маршрутизации». Это текстовый файл, который содержит строки, состоящие из пары ключ–значение, разделенные пробелами. Кодировка файла: UTF-8 или UTF-8 (без BOM). Если указан ключ, то должно быть указано значение.
Файл маршрутизации определяется по имени, которое удовлетворяет заданному регулярному выражению (подробнее смотрите в разделе «Использование регулярных выражений» ). Файл маршрутизации не должен располагаться в корне рабочей папки. Его можно разместить в подпапке вместе с отправляемыми документами или на уровень выше.
GetDocuments¶
Элементы в списке DocumentList.Documents идут в порядке возрастания меток времени (поля Document.TimestampTicks). В поле DocumentList.TotalCount указывается общее количество документов, удовлетворяющих запросу.
В массиве DocumentList.Documents содержится не более 1000 элементов; для получения остальных документов нужно вызывать метод GetDocuments с теми же параметрами, меняя значение afterIndexKey.
Первая часть этой строки задает тип документа и может следующие значения:
| Вариант | Описание | Примечание |
|---|---|---|
| Строковый идентификатор любого доступного в организации типа (см. поле TypeNamedId ) | Например, Invoice, XmlAcceptanceCertificate, Nonformalized и т.п. | |
| Any | Аггрегированный запрос для всех документов в ящике без учета по типу | |
| AnyInvoiceDocumentType | Аггрегированный запрос только для типов Invoice, InvoiceRevision, InvoiceCorrection, InvoiceCorrectionRevision | более не поддерживается и не рекомендуется к использованию |
| AnyBilateralDocumentType | Аггрегированный запрос только для типов Nonformalized, Torg12, AcceptanceCertificate, XmlTorg12, XmlAcceptanceCertificate, TrustConnectionRequest, PriceList, PriceListAgreement, CertificateRegistry, ReconciliationAct, Contract, Torg13 | более не поддерживается и не рекомендуется к использованию |
| AnyUnilateralDocumentType | Аггрегированный запрос только для типов ProformaInvoice, ServiceDetails | более не поддерживается и не рекомендуется к использованию |
Строка DocumentClass задает класс документа и может принимать следующие значения:
| Вариант | Описание |
|---|---|
| Inbound | Только входящие |
| Outbound | Только исходящие |
| Internal | Только внутренние |
| Proxy | Только документы, переданные через промежуточного получателя |
Строка DocumentStatus задает статус документа и может принимать следующие значения:
| Вариант | Описание |
|---|---|
| Пустое значение | Любой документ указанного класса Class |
| NotRead | Документ не прочитан |
| NoRecipientSignatureRequest | Документ без запроса ответной подписи |
| WaitingForRecipientSignature | Документ в ожидании ответной подписи |
| WithRecipientSignature | Документ с ответной подписью |
| WithSenderSignature | Документ с подписью отправителя |
| RecipientSignatureRequestRejected | Документ с отказом от формирования ответной подписи |
| WaitingForSenderSignature | Документ, требующий подписания и отправки |
| InvalidSenderSignature | Документ с невалидной подписью отправителя, требующий повторного подписания и отправки |
| InvalidRecipientSignature | Документ с невалидной подписью получателя, требующий повторного подписания и отправки |
| Approved | Согласованный документ |
| Disapproved | Документ с отказом согласования |
| WaitingForResolution | Документ, находящийся на согласовании или подписи |
| SignatureRequestRejected | Документ с отказом в запросе подписи сотруднику |
| Finished | Документ с завершенным документооборотом |
| HaveToCreateReceipt | Требуется подписать извещение о получении |
| NotFinished | Документ с незавершенным Документооборотом |
| InvoiceAmendmentRequested | Документ, по которому было запрошено уточнение |
| RevocationIsRequestedByMe | Документ, по которому было запрошено аннулирование |
| RequestsMyRevocation | Документ, по которому контрагент запросил аннулирование |
| RevocationAccepted | Аннулированный документ |
| RevocationRejected | Документ, запрос на аннулирование которого был отклонен |
| RevocationApproved | Документ, запрос на аннулирование которого был согласован |
| RevocationDisapproved | Документ с отказом согласования запроса на аннулирование |
| WaitingForRevocationApprovement | Документ, находящийся на согласовании запроса аннулирования |
| NotRevoked | Неаннулированный документ |
| WaitingForProxySignature | Документ в ожидании подписи промежуточного получателя |
| WithProxySignature | Документ с подписью промежуточного получателя |
| InvalidProxySignature | Документ с невалидной подписью промежуточного получателя, требующий повторного подписания и отправки |
| ProxySignatureRejected | Документ с отказом от формирования подписи промежуточным получателем |
| WaitingForInvoiceReceipt | Документ в ожидании получения извещения о получении счета-фактуры |
| WaitingForReceipt | Документ в ожидании получения извещения о получении |
| RequestsMySignature | Документ, по которому контрагент запросил подпись |
| RoamingNotificationError | Документ с ошибкой доставки в роуминге |
Примеры строки filterCategory:
Необязательный параметр counteragentBoxId позволяет ограничить выдачу только теми документами, у которых идентификатор ящика контрагента совпадает с counteragentBoxId.
Необязательные параметры timestampFromTicks и timestampToTicks позволяют задать интервал времени, в котором осуществляется поиск.
Необязательные параметры fromDocumentDate и toDocumentDate также позволяют задать интервал времени, в котором осуществляется поиск.
Однако при этом фильтрация списка документов производится по дате формирования документа в учетной системе (реквизиту самого документа), а не по метке времени, связанной с загрузкой документа в ящик Диадока.
Если какой-то параметр отсутствует в запросе, то его значение неявно принимается равным +/- бесконечности. В выдачу метода GetDocuments попадают только те документы, у которых заполнен реквизит «Дата документа».
Параметры fromDocumentDate и toDocumentDate задаются в формате ДД.ММ.ГГГГ, то есть представляют собой только даты, а не полноценные метки времени.
Необязательный параметр afterIndexKey позволяет итерироваться по списку документов, удовлетворяющих фильтру.
Если в запросе присутствует параметр afterIndexKey, то список документов в выдаче начинается с документа, следующего за документом, имеющим ключ afterIndexKey (поле Document.IndexKey ).
Cам документ с ключом afterIndexKey в выдачу при этом не попадает. Если данный параметр в запросе отсутствует, то выдается начало списка документов, удовлетворяющих фильтру.
OrganizationInfo¶
Структура данных OrganizationInfo служит для представления реквизитов организаций-контрагентов при формировании счетов-фактур (см. InvoiceInfo ), товарных накладных (см. Torg12SellerTitleInfo ) и актов о выполнении работ / оказании услуг (см. AcceptanceCertificateSellerTitleInfo ) в XML-формате.
В зависимости от контекста использования структуры OrganizationInfo требования к обязательности заполнения ее полей могут меняться. Однако в любом случае всегда требуется указывать название организации (OrganizationInfo.Name) и ее адрес ( OrganizationInfo.Address ).
Стоит отметить, что при формировании XML счетов-фактур (при заполнении структуры InvoiceInfo) используются только поля Name, Inn, Kpp, Address, IsSoleProprietor, FnsParticipantId.
Структура данных DiadocOrganizationInfo также служит для представления реквизитов организаций. Она используется в тех случаях, когда организация заведомо должна быть зарегистрирована в справочнике организация Диадока (например, организация-продавец или организация-покупатель при формировании XML счета-фактуры).
В этом случае реквизиты организации (DiadocOrganizationInfo.OrgInfo) можно явно не заполнять, и тогда будут использоваться данные из БД учетных записей| Диадока, ассоциированные с соответствующим ящиком (DiadocOrganizationInfo.BoxId). В структуре DiadocOrganizationInfo должно быть заполнено хотя бы одно из полей BoxId, или OrgInfo. Если поле OrgInfo заполнено, то будут использоваться данные из него; обращений к справочнику организаций Диадока не будет.
Структура данных DocflowParticipant содержит данные, необходимые для идентификации участника электронного документооборота. Вне зависимости от контекста использования, одно из полей DocflowParticipant.BoxId или DocflowParticipant.Inn должно быть заполнено. Для определения идентификатора участника системе требуется его ИНН-КПП, который может быть определен на основе значения DocflowParticipant.BoxId, если поле DocflowParticipant.Inn не заполнено.
Коннектор.Выгрузка
Вы просматриваете старую версию данной страницы. Смотрите текущую версию.
Коннектор.Выгрузка предназначен для ведения локального архива, а так же выгрузки статусов документов из Диадока.
Из системы Диадок через Коннектор.Выгрузка могут быть выгружены:
Ниже представлена схема получения документов из Диадока.
1. После запуска Коннектора происходит поиск документов в ящике Диадока по указанным параметрам при настройке:
2. Найденные документы постепенно выгружаются на доступный файловый ресурс:
3. По окончании выгрузки Коннектор завершает свою работу. В файловом ресурсе содержатся выгруженные данные за указанный период.
Если среди найденных событий есть те, которые соответствуют правилам выгрузки, то Коннектор начинает выгрузку документов и их данных. Если по документу было множество событий, то по каждому из них выгружается состояние документа на дату события с удалением данных по предыдущему из места выгрузки.
Фильтры выгрузки
Под ними понимаются все возможные фильтры по документам и их данным для выгрузки из Диадока.
Подразделение. Текущее местоположение документа в ящике Диадока. Можно настроить выгрузку документов как из конкретного подразделения, так и из множества. Если у подразделения есть дочерние, то можно организовать выгрузку сразу по всем.
Список контрагентов. Используется для получения документов только от определенных организаций.
Счет-фактура и корректировки
УПД и корректировки
Первичный документ (акт выполненных работ/оказанных услуг и накладная ТОРГ-12)
Протокол согласования цен
Дополнительное соглашение к договору
и другие типы документов.
К дате отправки/получения документов. Промежуток времени, указанный в настройках, будет применен только к отправленным/полученным документам за этот период. Если документ был создан за пределами указанного периода, а событие произошла в рамках этого периода, то документ выгружен не будет.
Выгрузка пакетов. Для выгрузки документов можно использовать разные режимы в зависимости от требуемого результата:
Примечание. Рекомендуется в шаблоне выгрузки для группировки документов внутри корневой папки выгрузки использовать макросы
Пример использования выгрузки из Входящих
1. Пакетная выгрузка без ограничений. Требуется выгружать СФ с завершенным ЭДО и все связанные с ней документы вне зависимости от их статуса и типа.
2. Пакетная выгрузка с ограничениями. Требуется выгружать СФ с завершенным ЭДО и все связанные с ней документы, по которым завершен ЭДО. Минимальное количество документов в пакете должно быть равно двум.
Данные по документам
В стандартном режиме всегда осуществляется выгрузка всех файлов документооборота по документу. Дополнительное ограничение на выгружаемые данные по документам настраивается менеджером, а именно:
Для всех типов документов:
Для двусторонних документов:
Для формализованных актов и накладных:
Коннектор позволяет выгружать метаданные по документу в отдельный файл формата TXT с использованием специальных макроподстановок.
Шаблон выгрузки метаданных прописывается в файле settings\MetadataTemplate.txt.
Например, необходимо выгружать данные в виде ключ-значение, то в файле settings\MetadataTemplate.txt пишем:
В результате выгрузки метаданных Коннектором будет сформирован файл вида:
Путь выгрузки
Выгрузка всегда происходит в файловую систему компьютера. Опционально доступно дублирование выгрузки документов на FTP-сервер или SFTP-сервер.
Внутри корневой папки задается структура подпапкок на основе макроподстановок.
Макрос
Расшифровка
Формат
Макросы даты и времени выгрузки документа из Диадока (часовой пояс МСК)
Год дня выгрузки в формате четырьмя цифрами
Ваш браузер устарел, пожалуйста обновите ваш браузер пройдя по ссылке www.microsoft.com/download
Для работы с HTTP API нужно получить Ключ разработчика (ddauth_api_client_id).
Описание статусов документа:
1. Сначала нужно авторизоваться в API и получить token.
-Делаю post запрос метод /Authenticate
-В параметры метода нужно указать логин и пароль входа на сайт диадока.
-В заголовки подставляю Ключ разработчика.
HTTPЗапрос2.Заголовки.Вставить(«Authorization», «DiadocAuth ddauth_api_client_id=»+ddauth_api_client);
-в теле ответа 200 приходит token.
2. Ключ и Token нужно Подставлять в заголовок любых последующих методов.
HTTPЗапрос2.Заголовки.Вставить(«Authorization», «DiadocAuth ddauth_api_client_id=»+ddauth_api_client+»,ddauth_token=»+token);
-посылаю Get запрос метод /V3/GetDocument в параметры которого нужно передать
boxId – указан в свойствах документа ИдентификаторЯщикДокументаВДиадок
А вот messageId и entityId нужно получить вызвав функцию Документ_2_DocumentID(Документ)
(Эта функция из ИдентификаторДокументаВДиадок) делает большой Идентификатор, который если разделить пополам по 36 символов, то получим искомые параметры.
Метод GetDocument возвращает в теле ответа json, который преобразуется в Структуру, из которой можно получить все свойства документа.
Обработку тестировал на платформе 1С:Предприятие 8.3 (8.3.10.2466).
Конфигурация УПП. В обработке есть запрос к РегистрСведений.ЗначенияСвойствОбъектов. Если его нет в конфигурации, то его нужно заменить на регистр, который хранит свойства объектов.
Скачать файлы
Специальные предложения
Обновление 19.02.18 18:41
См. также
10.06.2014 40507 67 kns77 87
Конструктор подключения к внешним источникам
Какую строку подключения использовать к новому источнику? Эта обработка позволяет создать и проверить множество строк подключения сразу.
20.09.2021 1589 1 kraynev-navi 2
Пример обмена данными через XDTO
Пример обмена данными между 1С и сторонним приложением посредством механизма XDTO.
01.03.2021 5298 7 user925427 2
Улучшенная обработка универсального обмена данными в формате XML (УФ)
Улучшенная обработка «Универсальный обмен данными» с полноценными возможностями СКД для выборки данных (не только для отборов).
23.06.2020 12870 135 Lem0n 1
Загрузка данных из М-Аптеки+ в 1С:Бухгалтерия 8 (ред. 3.0) Промо
Обработка для загрузки файлов выгрузки из программы для автоматизации аптек и аптечных сетей М-Аптека+ в 1С:Бухгалтерия 8, редакция 3.0.
11.07.2014 42131 72 1C_MApteka 42
И еще раз о HTTP-сервисах
Как разработать подсистему обмена с сильно ограниченными правами доступа к базе вопрошающего субъекта с использованием различных вариантов маршрутизации.
28.04.2020 8141 8 zavsom 2
Взаимодействие HTML (COM объект, WebKit) с 1С (обычные и управляемые формы)
Показан пример использования HTML (COM объект, WebKit) в 1С (8.3).
18.01.2020 13226 33 Deniskinr83 0
Синхронизация с гугл диском легко и просто!
05.12.2019 24290 39 zykov_vitaliy 26
Менеджер загрузки данных из весов с печатью этикеток Промо
Программное обеспечение «Менеджер загрузки данных из весов с печатью этикеток» предназначено для автоматического получения данных по сети Ethernet из весов МАССА-К моделей ВПМ и ТВ_Р3 (модификация MF) в режиме On-Line.
20.12.2011 29045 81 hrip 10
Использование хранимых процедур MS SQL Server в 1С
Потребовалось мне как-то построить сложный запрос к внешнему источнику данных, на что платформа радостно послала меня в гугл. Немного подумав, решил написать в SQL процедуру, которая принимала бы какие-то параметры и возвращала какую-то таблицу значений с данными.
03.12.2019 17698 13 Dedushka 27
Обновление расширений с Google Drive
Предлагаемое расширение содержит обработку, которая считывает информацию с диска Google и при наличии новой версии производит обновление текущих расширений конфигурации.
03.10.2019 7365 3 Sedaiko 4
Получение изображения с IP-камеры
Получение изображения JPG с IP-камеры в виде двоичных данных. В 1С может применяться для фотографирования объектов.
10.09.2019 16173 44 sivin-alexey 10
Что нам стоит Push построить Промо
Попробовал некоторое время назад, push сообщения, реализованные в платформе. Понравилось, но есть несколько минусов, на примере одной программы сообщений (не буду показывать пальцем), спустя некоторое время, сообщения переставали приходить онлайн, а на компьютере приходили моментально, при этом сами смартфоны звались флагманами. Читал позднее статью, где описывалось, что проблема на стороне смартфонов, что-то вроде технологий энергосбережения, но точно не помню. Также немалый минус доступно только для смартфонов.
08.09.2016 32337 17 PloAl 8
Чтение файлов PDF из 1С
Насколько мне известно, у платформы 1С нет встроенных средств чтения на лету файлов PDF для их последующего анализа, и приходится использовать внешние инструменты. Об одном из таких вариантов и пойдет речь.
09.09.2019 20015 57 da_1c 6
Согласование задач из Outlook
Согласование задач непосредственно из почтовой программы, в моем случае Outlook 2013 без каких-либо дополнительных настроек. Из почты отправляется GET запрос к HTTP-сервису 1С, который в свою очередь выполняет задачу.
06.09.2019 12985 19 duhh 17
Телеграм 1С – почти коробка
Почему это решение называется «почти коробка»? Потому, что это почти коробочное решение. С его помощью, просто добавив подсистему в конфигурацию, уже можно начинать взаимодействовать с мессенджером Telegram.
20.08.2019 19940 38 zfilin 73
Загрузка из ГИС ЖКХ ИД домов/зданий, Лицевых счетов, приборов учета/счетчиков в 1С ЖКХ Промо
Загрузка из сайта ГИС ЖКХ идентификаторов ЖКУ(ИД) домов/зданий, Лицевых счетов, приборов учета/счетчиков в 1С ЖКХ
10.02.2018 33663 41 hachaturov 0
Расширение Бром для интеграции с 1С
Из этой статьи вы узнаете, как можно быстро и просто синтегрироваться с любой конфигурацией 1С при помощи расширения Бром.
06.08.2019 10626 5 itworks 23
Конфигурация для обмена данными (интеграционная шина)
Система позволяет организовать обмен данными, как с базами 1С, так и любыми другими приложениями. Система представляет собой отдельную конфигурацию. Система позволяет организовать гибкие возможности по настройке обмена. В качестве брокера сообщений, для передачи данных, используется отдельная самостоятельная конфигурация на 1С. Комплект поставки содержит файл расширения для «клиентской» части шины, данное расширение позволяет без снятия «ключа» организовать гибкий механизм обмена данными.
08.07.2019 20966 35 miha-28 17
Выгрузка почтовых отравлений в личный кабинет отправки Почты России; отслеживание почтовых отправлений через Почту России; расширение для интеграции Документооборот 8, УНФ с Почтой России
04.06.2019 18128 123 wtlz 76
Выгрузка и подготовка данных для программы «Перечень льготных профессий» для 1С: ЗУП 2.5 (ОТКРЫТЫЙ КОД) Промо
Обработка для формирования и редактирования данных для перечня льготных профессий. В связи с прекращением поддержки ЗУП 2.5 и отсутствием времени на доработку для сдачи годовой отчетности открыл код модуля. Не очередная выгрузка стажей, а практически полный аналог перечня для 1С. Формирование и редактирование стажей с последующей выгрузкой в формат перечня, но только ГОРАЗДО удобнее и быстрее. В общем, смотрите видео. Где-то половина времени на написание обработки ушла именно на удобство и скорость работы. Внимание: код модуля обработки открыт
09.11.2015 57847 63 Black-fog 62
Пример работы с viber из 1С, отправка сообщений из 1С в viber
Обработка разработана для примера отправки сообщений в viber из 1С.
16.05.2019 22973 106 Isa816 24
Шаблон http-сервиса для вашего проекта
Http-сервис для обмена данными в формате JSON. Обработчики этого сервиса находятся во внешней обработке, что позволяет дорабатывать его без изменения конфигурации. Также прилагаю пример мобильного приложения для работы с данным сервисом (получает номенклатуру и остатки на складе). Сервис очень быстро разворачивается и масштабируется под ваши задачи.
04.05.2019 27149 91 MarkoSokolov 48
WhatsApp чат для 1С
WhatsApp чат для 1С. Расширение конфигурации, подходит для любых конфигураций 1С (управляемые формы).
15.04.2019 15768 41 ManyakRus 22
Подсистема обмена данными с порталом ИМНС по электронным счетам-фактурам (автоматический обмен) Промо
Подсистема включает документы и обработки для автоматического обмена данными с порталом ИМНС через web-сервис. Присутствует возможность заполнения данными типовых операций за период, учёта входящих документов, учёта произвольных исходящих документов. Приложены обработки для запуска задания планировщика на автоматический обмен данными.
28.07.2016 38672 20 c1nil 4
Доработка функционала отправки дополнительных реквизитов 1С: ЭДО для Татнефть
Подключаемое расширение к конфигурации ERP с функционалом отправки дополнительных реквизитов 1С ЭДО для Татнефть (№ и дата договора, подразделение, автор, примечание) в электронных документах Счет-фактуры и ТОРГ-12 Проверялось на 1С:ERP Управление предприятием 2.4.6.160.
07.04.2019 14234 18 sapervodichka 12
Формирование xml файла ЭДО (СБИС, Диадок, Такском и т.п.) для типовых документов (счета-фактуры, накладные)
Не все типовые документы типовых конфигураций 1С можно выгрузить в файл формата xml ЭДО. Например счет-фактуру, на текущий момент момент это не предусмотрено. Обработка позволяет сделать это.
30.03.2019 73870 450 capitan 151
Генерация схемы xsd из файла xml
Утилита, генерирующая xsd схему на основании xml файла.
25.03.2019 23316 45 nbeliaev 11
Интеграция 1С и C#. Обращение к 1С через COM. Создание номенклатуры и выполнение запроса к 1С из C# на примере интеграции с Союз-PLM (система информационной поддержки жизненного цикла изделий). Обработка «Загрузка заказа на сборку». (ERP) Промо
Союз-PLM представляет собой полнофункциональный программный комплекс для решения широкого спектра задач управления инженерной технической информацией наукоемких изделий и сложных инженерных объектов в области машиностроения, приборостроения, архитектуры, строительства. На практике, это управление конструкторской документацией, интегрированное с САПР, бизнес-процессы, файловый архив. Все это работает в SQL и шевелится с помощью скриптов на C#. Скрипты свободно отлаживаются в MS Visual Studio. Подробнее смотрите на их сайте: http://www.programsoyuz.ru/products/system-soyuz-plm.html Редактирование, конструирование и использование бизнес-процессов на порядок лучше систем на базе 1С из тех, что я изучил.
25.07.2016 54417 5 milkers 2
