- Table of contents
- SimplBooks
- 01 Активация интеграции Docura в SimplBooks
- 02 Получение необходимых данных
- 03 Автоматическая обработка документов
- 04 Дополнительная информация
- 05 Руководство пользователя Docura EDI
- 06 Часто задаваемые вопросы
SimplBooks¶
01 Активация интеграции Docura в SimplBooks¶
Чтобы активировать интеграцию Docura в SimplBooks, выполните следующие действия:
- Откройте "Настройки → Интеграции" в главном меню.
- В появившемся списке выберите интеграцию Docura.

02 Получение необходимых данных¶
01 Активация данных через docura.net¶
Для активации интеграции вам потребуется логин и ключ API, которые можно получить на портале Docura:
- Войдите на портал docura.net и перейдите в меню Настройки → Пользователи.
- Если пользователь уже существует:
- Нажмите кнопку Копировать в столбце Ключ API, чтобы скопировать ключ API.
- Значение Логин можно взять из столбца Логин.
- Если пользователь еще не создан:
- Нажмите Добавить пользователей.
- Выберите Добавить пользователя для API, чтобы создать нового пользователя API.
02 Ввод данных в SimplBooks¶
После получения данных из Docura:
- Введите значение Логин в поле Client ID в SimplBooks.
- Введите API-ключ в поле Client secret.
- Сохраните настройки — и интеграция будет активирована в вашем ПО.
03 Автоматическая обработка документов¶
После успешной активации запускается автоматический ночной импорт документов из Docura. Проверьте Транзакции - Заказы на продажу
- Новые документы появляются либо в списке импортированных документов,
- либо сохраняются системой автоматически, если в настройках интерфейса Docura включена опция "Автоматическое сохранение":
- как заказ на продажу,
- или как подтверждение накладной.
- Если автоматическое сохранение по какой-либо причине не удается, документ остается видимым в списке импортированных документов со статусом "неисправен".

02 Обычный документооборот (2ДОК и 4ДОК)¶
- Типичный документооборот выглядит следующим образом:
- 2ДОК: Заказ покупателя → Счет-фактура
- 4ДОК: Заказ покупателя → Товарная накладная → Акт сверки → Счет-фактура
- Движение документов:
- Заказ покупателя импортируется из Docura.
- Товарная накладная отправляется в Docura.
- Акт сверки импортируется из Docura.
- Окончательный счет-фактура отправляется в Docura.
03 Настройка товаров¶
Для успешного использования интеграции EDI-Sale в SimplBooks должны быть:
- Введенный или импортированный список товаров.
- Для каждого товара должны быть указаны:
- внутренний код производителя/поставщика (ваш собственный код, SellerItemCode),
- и/или код EAN (GTIN).
- Если внутреннего кода нет, код EAN должен быть введен в поле общего кода товара, которое является обязательным полем в SimplBooks.
- При импорте система идентифицирует товар сначала по коду поставщика, а затем по EAN (GTIN).
04 Дополнительная информация¶
Интеграция с Docura уже доступна в пакете START, и за активацию или использование интеграции отдельная плата не взимается.
05 Руководство пользователя Docura EDI¶
Как это работает- Если в настройках интеграции включено автоматическое сохранение:
- Корректные заказы сразу попадают в раздел «Продажи».
- Они не отображаются в разделе «Импортированные документы».
- Некорректные документы остаются в разделе «Импортированные документы».
- Нажмите на значок страницы (рядом со значком человека).
- Откройте раздел «Импортированные документы».
- Выберите раздел «Ручной импорт» → «Импорт из Docura».
- Добавьте кнопку «Импорт из Docura» рядом с кнопкой «Импорт из Telema» — чтобы все происходило в одном окне, как раньше.
- Найдите его в разделе «Импортированные документы».
- Проверьте его и сохраните вручную.
06 Часто задаваемые вопросы¶
01 Проблемы с товарами и EAN-кодами¶
- Ошибки вызваны некорректными настройками в SimplBooks (товары, EAN-коды, параметры).
- В таком случае проблема регулярно повторяется с разными партнерами.
- Чаще всего проблема возникает из-за некорректных настроек со стороны SimplBooks.
Резюме
- Все документы, включая ошибочные, все равно импортируются в SimplBooks.
- Клиент должен самостоятельно правильно настроить данные о товарах в SimplBooks.
- Разработка API нецелесообразна, поскольку товары должны быть настроены в SimplBooks.
02 Заказ не был автоматически импортирован в SimplBooks.¶
- Заказ не был автоматически импортирован в систему SimplBooks.
- Причина: данные клиента были неполными или изменились после отправки, поэтому система не смогла обработать заказ.
- Импорт был выполнен вручную. После обновления данных клиента заказ был сохранен корректно.
- Нажмите на логотип SimplBooks (значок страницы), а затем на кнопку «Продолжить здесь» рядом с документами, которые необходимо импортировать.
- Если заказ не может быть импортирован автоматически, нажмите на него в списке документов.
- В открывшемся заказе для обновления данных клиента:
- Нажмите на значок карандаша рядом с именем клиента.
- Нажмите на ссылку «Нажмите здесь, чтобы загрузить новые данные».
- Нажмите кнопку «ОК» для подтверждения обновления.
- После обновления данных клиента сохраните заказ — импорт успешно завершен.
03 Регистрация кодов клиентов на портале Docura¶
В SimplBooks клиенты и поставщики представлены как объекты одного типа.
Каждый клиент (например, Prisma) может иметь несколько пунктов доставки, которые являются подобъектами, связанными с этим клиентом.
Пункты доставки идентифицируются уникальным системно сгенерированным ID, который пользователь не может изменить.
Клиенты могут экспортировать все или только выбранные пункты доставки в формате CSV или Excel, который также включает ID пунктов доставки.
В качестве альтернативы ID пунктов доставки можно проверить вручную, посмотрев на URL-адрес браузера при открытии конкретного адреса доставки в SimplBooks.
Эти ID важны для интеграции и должны быть переданы в Docura, где они используются в качестве PartyCode в системе Docura.
В качестве следующего шага клиентам SimplBooks понадобится руководство или скриншоты о том, как экспортировать пункты доставки вместе с ID.
После экспорта эти ID могут быть загружены в Docura, обеспечивая бесшовную интеграцию данных.
04 Проблемы с импортом заказов¶
- Клиенты хотели импортировать заказы.
- В ходе импорта возникли проблемы: причиной было отсутствие пользователя API или данные не были введены в SimplBooks.
- После создания пользователя API и добавления данных в SimplBooks импорт заказов должен теперь работать корректно.
05 Счет-фактура не пересылается в Docura¶
При создании счета-фактуры необходимо указать пункт доставки, потому что если пункт доставки не заполнен, счет-фактура не пересылается в Docura и не отображается на портале Docura.
Source version: 4 · Status: fresh · Roman Startsev