Обращение к интеграторам

[flosca]

Привет всем интеграторам Диадока.

Появилось ощущение, что документация выглядит довольно непричёсанной и запутанной. Бывают случаи (1, 2), когда за помощью приходят сюда, хотя ответы на эти вопросы должна давать документация.

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

Хочется собрать обратную связь от вас, насколько хорошо описаны наши SDK-клиенты. Часто ли вы обращаетесь за помощью в документацию? Будем очень признательны любому фидбеку. Пожелания, замечания, всё пригодится.

Свои мысли можно высказывать прямо здесь :)

[demions]

Добрый день.

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

Имею в виду следующее:

• Статья про подписание документа. Составить список документов, которые нужно подписывать напрямую и через генерацию титула, добавить ссылки на примеры (уже есть в примерах работы с СФ, накладными. С НФ тоже где-то было, кажется). Добавить, что есть возможность отправить документ без подписи, чтобы он висел в отправленных в кабинете.
• Статья про аннулирование документа. Описать обычный механизм запрос -> аннулирование, описать возможность одностороннего аннулирования, когда документ подписан только с одной стороны. Добавить, что после отказа в аннулировании и повторном запросе сущности от прошлого аннулирования удаляются из сообщения (при обработке изменений через GetNewEvents тогда приходят эвенты, у которых сущность и ее род. сущность не содержится в сообщении, долго разбирались в чем дело). Указать, что в роуминге документ не всегда поддерживает аннулирование и может возникнуть ошибка.

Не помешала бы статья про получение изменений в ящике и соответственно в документах. Разные варианты и решения. В последней интеграции мы все изменения анализируем по BoxEvent, поэтому приходится изучать какие действия как выглядят в эвентах. Простые еще понятно, но одностороннее аннулирование не помню чтоб было описано где-то. До сих пор остались неизвестными некоторые случаи (эвент без патча и сообщения, патч к подписи, которой нет в сообщении и пр.)

[shteynvargmv]

Хотелось бы больше примеров.

[sylfire]

добрый день. Хотелось бы пример заполнения GenerateSenderTitleXml, а именно что передавать в usercontractdata

[flosca]

@sylfire
Привет.

Но ведь на этой странице есть и пример, и инструкция: http://api-docs.diadoc.ru/ru/latest/http/GenerateSenderTitleXml.html

В теле запроса должен содержаться заполненный XML-файл, соответствующий XSD-схеме контракта для генерации титула отправителя данного типа документа. XSD-схема контракта, необходимого для генерации титула, может быть получена с помощью ссылки, доступной в поле UserDataXsdUrl контракта DocumentTitle, который можно получить с помощью метода GetDocumentTypes.

[sylfire]

@flosca
Пример не в виде работы sdk
http://api-docs.diadoc.ru/ru/latest/howto/example_send_invoice.html нужны примеры как тут
SDK
Пример кода на C# для отправки счета-фактуры:

очень удобно и понятно.

[arlecin]

Народ, привет..может кто нибудь дать комментарии как метод GenerateSenderTitleXml работает? xml самим создавать и потом в параметр передавать?
"XSD-схема контракта, необходимого для генерации титула, может быть получена с помощью ссылки, доступной в поле UserDataXsdUrl контракта DocumentTitle, который можно получить с помощью метода GetDocumentTypes." - не совсем понимаю, как это в коде должно выглядеть

[APanov2017]

В документации не хватает примеров типа:
скопировал код --> вставил к себе -->код отработал без ошибок -->
-->понял как работает -->исправил под себя.
Например такой вариант пригодился бы сейчас для 820-го приказа.
Если бы была XML-ка, которую можно было бы подставить в GenerateTitleXml и получить положительный ответ на тестовых ящиках. Было бы здорово!

[MayerS2006]

По ФНС 820 решение выглядит крайне сырым, что в плане кода, что в плане документации. Я б даже не назвал это решением, скорее что-то в духе "вон там XSD схема от ФНС, а вот вам два куска кода из первых ссылок StackOverflow, мы это не проверяли, но вы сами разберетесь". По сравнению с предыдущими решениями, когда Диадок предоставлял человеческое API со строгой типизацией, это ужасно.

[APanov2017]

MayerS2006, да согласен, решение сырое, но альтернативы к сожалению пока нет.
Хотя нет...
Есть СБИС.

[Kofeint]

Добрый день. Возник вопрос при формировании УПД для отправки.
В УПД есть строка :
Основания передачи (сдачи) / получения (приемки) (9)
Какое свойство UniversalTransferDocumentWithHyphens отвечает за заполнение этой строки?

[i82]

@Kofeint вам поможет структура TransferInfo, в частности TransferBases

[Edward72]

Мы планируем освежить информацию,

Прошло почти два года, а воз и ныне там...

В документации Диадок API в структуре TransferBase есть поле:
optional string BaseDocumentDate = 3;
То есть, судя по описанию, это поле не является обязательным. Но если я указываю как основание номер договора (BaseDocumentNumber), а поле BaseDocumentDate оставляю пустым, то конечно же получаю ошибку: AdditionalMessage=Invalid data UserContractData:/UniversalTransferDocument/TransferInfo/TransferBases/TransferBase: @BaseDocumentDate is required
Как это понимать? И что делать? Объясняю, почему оно должно быть на самом деле "optional".
В нашей энергосбытовой компании, при заключении договоров с бюджетниками, часто бывает такая ситуация: договор как бы еще не заключен, а электроэнергию уже нужно отпускать потребителю в счет заключаемого договора. договор может заключаться и месяц, и два. Это очень распространённое явление. Как в таком случае я должен указать основание передачи объемов потребления в УПД?