Интеграция с HubSpot в Польше
Передавайте контакты, deal-driven merch-комплекты и события отгрузки между HubSpot и Corp-Merch для Польши — с VAT 23% через KSeF.
Архитектура — HubSpot как CRM-запись
HubSpot остаётся системой записи для контактов, аккаунтов и сделок; Corp-Merch потребляет deal-driven триггеры (won/closed, продление, NPS-промоутер), чтобы отправлять merch-комплекты в Польше. Маппинг настраивается в дашборде: стадия сделки → бандл продукта → ship-to. VAT 23% рассчитывается по сущности биллинга аккаунта и выставляется через KSeF; id счёта пушится обратно в запись сделки HubSpot.
Как подключить — Workflows и API HubSpot
Установите приложение Corp-Merch с marketplace HubSpot; объёмы по объектам: Contact, Account, Opportunity/Deal плюс custom Object 'Shipment', который мы создаём при установке. Action'ы workflow: Send merch kit (sync), Resend on failure (async с retry), Issue invoice (KSeF). Webhooks подписываются на deal.stage_changed, синтетическое 'merch.fulfilled' возвращается в таймлайн HubSpot.
Эксплуатация и пограничные случаи — Валидация адресов, opt-out, возвраты
Валидация адресов запускается на смене стадии сделки, чтобы рэпы в Польше видели качество адреса до триггера отгрузки; opt-out из записи контакта учитывается на отправке. Возвраты возвращаются как activities, счёт KSeF автоматически кредитуется. Ключи идемпотентности из deal id + workflow execution id исключают дубли.
Частые вопросы
Какая редакция HubSpot нужна?
Любая редакция с поддержкой custom apps и workflows. Enterprise — sandbox + production-окружения и SSO.
Может ли HubSpot остаться источником истины для контактов?
Да — Corp-Merch читает из HubSpot и пишет только объект Shipment обратно.
Как обрабатывается НДС?
VAT 23% считается по сущности биллинга аккаунта; счета выставляются через KSeF после фулфилмента.
Поддерживаете custom objects?
Да — объект 'Shipment' создаётся при установке; расширьте его custom-полями, они вернутся из Corp-Merch.
Где показан VAT 23%?
В записи сделки, в объекте Shipment и в дашборде Corp-Merch до push — построчно, чтобы финансы могли проверить.