forumСоздать тему

Сказали «сделаем API-интеграцию» — как устроен процесс и чего ждут от нас?

NNuri N***УчастникУчастник сообщества
Дата регистрации
нояб. 2023 г.
Сообщение
4
#1

У нас в интернет-магазине в среднем 60–70 заказов в день. Раньше счета и движение по складу каждый вечер вручную забивал сотрудник в бухгалтерскую программу. Решили синхронизировать заказы контрагентов и остатки на автомате наняли сторонних разработчиков. Объявили бюджет 45.000 TL и срок 3 недели.

На первом созвоне бросили: «подготовьте эндпоинты API с той стороны и тестовый контур остальное мы сами». Но мы вообще не технари. Набрали разработчиков нашей бухгалтерии — те запросили 12.000 TL за апгрейд лицензии до API, кинули ссылку на документацию и умыли руки.

Как этот процесс API-интеграции выглядит на практике по шагам? в общем что конкретно мы со своей стороны должны предоставить — доступы аккаунты вводные данные, — чтобы все не встало? И насколько реален срок в 3 недели?

RRecep T***Новый участник
Должность
Полевой торговый представитель
Отрасль
Логистика
Тип организации
компания в составе холдинга
Дата регистрации
авг. 2026 г.
Сообщение
39

Doki · Настройка резервного копирования · 2023

Самый полезный#2

Если кратко: интеграция по API — это настройка автоматического обмена данными между вашим сайтом и учетной программой по заданным правилам. Чтобы дело пошло, вам нужно открыть API-лицензию в учетной системе, передать разработчикам документацию и обеспечить тестовый контур, где можно экспериментировать без риска для боевых данных.

Стандартно процесс делится на четыре этапа. Первый — маппинг данных: поля с сайта (имя покупателя, налоговый номер, артикул, ставка НДС, доставка) сопоставляются один к одному с полями в бухгалтерии. Второй этап — разработка и тесты в песочнице (sandbox): программисты создают тестовые заказы и смотрят, как они заходят в учетную систему.

Третий этап — отработка краевых сценариев и ошибок: что делать, если не указан TC kimlik, как сажать в счет промокоды и скидки, как списывать возвраты и отмены. Четвертый этап — прописка боевых API-ключей, запуск на реальных заказах и плотный мониторинг в первые несколько дней.

От вас потребуется в основном три вещи: 1) API-ключи и документация от разработчиков бухгалтерии, 2) доступ к тестовой базе, 3) письменное подтверждение бизнес-логики (момент выставления счета, принцип списания остатков, логика скидок). Если техподдержка бухгалтерии выдаст внятную доку без задержек, 3 недели — вполне адекватный срок; если же они будут тянуть, закладывайте все 5 недель.

UUfuk S***Участник
Должность
Первичная бухгалтерия
Отрасль
Сельское хозяйство
Тип организации
кооператив
Дата регистрации
июнь 2022 г.
Сообщение
74

Doki · Поддержка реагирования на инциденты · 2025

#3

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

CCanУчастник
Должность
SEO-специалист
Дата регистрации
март 2024 г.
Сообщение
172
#4

Сразу зафиксируйте на бумаге, односторонняя интеграция или двусторонняя. Только заказы уходят с сайта в бухгалтерию, или остатки и цены со склада тоже должны перезаписываться обратно на сайт? При двустороннем обмене встают лимиты на запросы к API и обработка конфликтов, а это сразу растягивает разработку.

KKader U***Участник
Должность
Продавец-консультант
Отрасль
Медиа и издательское дело
Тип организации
семейный бизнес
Дата регистрации
июнь 2024 г.
Сообщение
86
#5

В прошлом году делали точно такую же интеграцию. Только выбивание API-лицензии и тестовых ключей у поставщика учетки заняло 9 дней. Сами разработчики отписали код за 12 дней, но из-за того, что доставка и скидки криво садились в проводки, тесты растянулись еще на 8 дней. В итоге на прод вышли ровно на 29-й день.

OOrhan T***УчастникУчастник сообщества
Дата регистрации
март 2024 г.
Сообщение
242
#6

Чек-лист подготовки с вашей стороны: 1) Запросить у разработчиков бухгалтерии тестовую среду (sandbox) и доку. 2) Проговорить с бухгалтером и расписать регламент по отменам, возвратам и частичным доставкам. 3) До выкатки на прод прогнать минимум 15 разных сценариев тестовых заказов.

YYaseminУчастник
Должность
Владелец МСП
Дата регистрации
июль 2024 г.
Сообщение
98
#7

Ваша бухгалтерская программа облачная или стоит на локальном сервере у вас в офисе? Если она крутится на офисном компе понадобится статический IP и проброс портов на сервер. А это и дыра в безопасности, и если в офисе отрубится интернет, интеграция встанет; вы этот момент обсуждали?

TTaner E***Участник
Должность
Руководитель отдела закупок
Отрасль
кожа
Тип организации
стартап на ранней стадии
Дата регистрации
июнь 2023 г.
Сообщение
132
#8

у нас бухгалтер первое время выдавал ошибку на счетах для иностранных клиентов без tc kimlik numarası. если принимаете заказы из-за рубежа или выставляете счета юрлицам, сразу обсудите маппинг этих полей, а то потом заказы просто зависают в системе.

edit: выше написал неправильно, извините.

SSinemЭксперт
Должность
Руководитель проектов
Дата регистрации
окт. 2023 г.
Сообщение
176
#9

Объедините команду разработчиков и техподдержку вашей бухгалтерской программы в общей почтовой рассылке или чате. Вы не обязаны разбираться в технических терминах и быть испорченным телефоном. Пусть технари напрямую сами между собой разбираются с параметрами и эндпоинтами.

VVahide K***Участник
Должность
Графический дизайнер
Отрасль
Энергетика
Тип организации
Компания на 120 человек
Дата регистрации
нояб. 2023 г.
Сообщение
411
#10

На нашей первой интеграции мы зажали 12.000 TL за тестовую среду и тестили прямо на боевой базе. Программист выставил тестовый счет а реальному клиенту улетели e-arşiv fatura и SMS-уведомления. В тот день мы очень четко поняли что деньги за тестовый контур — это самая дешевая страховка.

OOnur M***Эксперт
Должность
Бухгалтер
Отрасль
Пластик
Тип организации
среднее предприятие
Дата регистрации
май 2023 г.
Сообщение
7
#11

Сохранил.

HHüseyin S***ВетеранУчастник сообщества
Дата регистрации
июль 2022 г.
Сообщение
175
#12

Ответ выше точно передал суть вопроса. Главное не цифра, а то, на основе чего она получена.

Спешка в решениях оборачивается исправлениями через полгода. Интересно, есть ли те, кто делает иначе.

İİbrahim Y***УчастникУчастник сообщества
Дата регистрации
дек. 2024 г.
Сообщение
182
#13

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

Интересно, есть ли те, кто делает иначе.

HHilal B***Ветеран
Должность
Графический дизайнер
Отрасль
Электротехника и электроника
Тип организации
региональный дилер
Дата регистрации
дек. 2023 г.
Сообщение
17
#14

Поделюсь своим опытом. Доступы должны открываться на компанию, а не на личные аккаунты.

Оставлю как заметку, пригодится.

İİbrahim Y***УчастникУчастник сообщества
Дата регистрации
февр. 2026 г.
Сообщение
3
#15

согласен.

EElifУчастник
Должность
Владелец сети кафе
Тип организации
Производственная компания из 40 человек
Дата регистрации
авг. 2024 г.
Сообщение
63

Doki · Поддержка реагирования на инциденты · 2024

#16

Не упустите: Самое дешевое предложение обычно самое непродуманное.

Я бы пошел этим путем.

HHavva K***УчастникУчастник сообщества
Дата регистрации
июль 2024 г.
Сообщение
111
#17

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

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

MMehmet A***Эксперт
Должность
Разработчик ПО
Отрасль
Обучение
Тип организации
Компания на 300 человек
Дата регистрации
июль 2022 г.
Сообщение
2
#18

Хочу предупредить. Любой пункт, не зафиксированный письменно, в будущем обе стороны будут помнить по-разному.

Я бы пошел этим путем.

KKübra G***Эксперт
Должность
ИТ-директор
Отрасль
Спорт и фитнес
Тип организации
компания из 20 человек
Дата регистрации
нояб. 2025 г.
Сообщение
10
#19

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

Начните с небольшого эксперимента, не привязывайте всё сразу. Удачи.

OOsman K***УчастникУчастник сообщества
Дата регистрации
март 2024 г.
Сообщение
117
#20

Спасибо, что написали об этом, это действительно так. Спешка в решениях оборачивается исправлениями через полгода.

Не стесняйтесь спрашивать, молчание всегда обходится дороже. На этом всё, извините, если затянул.

Написать ответ