Модули · 2 мин. за четене
Интеграции със Stripe
Свържете Stripe, за да се издават документи от поддържаните събития, и проверете резултата.
Последна актуализация: 3 ноември 2026
От Pro нагореПреди настройката
Интеграциите са от Pro нагоре и се управляват само от администратор в Настройки → Интеграции. Нужни са активен кочан и банкова сметка: новата връзка използва кочана по подразбиране, а без банкова сметка фактурите не могат да бъдат издадени.
Интеграцията обработва поддържани събития от Stripe. Тя не означава, че всяко движение или всеки вид плащане в Stripe автоматично става фактура в smetni.app. Фактура се издава само когато платената фактура в Stripe съдържа данъчен номер на клиента, например ЕИК или ДДС номер. За клиент без данъчен номер интеграцията не създава фактура. Плащанията през Stripe Checkout без фактура в Stripe се записват като продажби на дребно, а не като документ.
Свържете Stripe
- Натиснете Свързване със Stripe. Създава се изключена връзка с кочана по подразбиране. При нужда сменете името и кочана ѝ.
- Копирайте Webhook URL на връзката с Копиране.
- Добавете адреса като крайна точка в Stripe и изберете поддържаните събития. Събития от режим на Stripe, различен от този на smetni.app, се пренебрегват и се показват като проблем във връзката.
- Поставете Signing secret на тази крайна точка в полето Signing secret и натиснете Запазване.
- Включете връзката с превключвателя в заглавието ѝ. Без записан Signing secret връзката не може да бъде включена.
Пазете Signing secret като тайна. Не го изпращайте в снимки на екрана или в обикновени съобщения до поддръжката.
Поддържани събития
| Събитие | Предназначение |
|---|---|
| invoice.paid | Издаване на фактура за платена фактура в Stripe. |
| credit_note.created | Издаване на кредитно известие към фактурата, издадена от интеграцията. |
| customer.updated | Обновяване на данните на вече свързан клиент. |
| customer.tax_id.created / customer.tax_id.updated | Попълване на липсващ ЕИК или ДДС номер, без да се презаписва попълнен. |
Събитието трябва да е избрано и в Stripe, и в раздел „Събития“ на връзката в smetni.app. Неизбраните събития се пренебрегват.
Проверете резултата
Картата на връзката показва кога са получени последното събитие и последният документ, както и кога е получено за последно всяко събитие. Проблемите се показват с брояч „Проблеми“ и списък под него. Издадените фактури се записват като платени. Проверете в Продажби клиента, номерацията, сумите и данъчните данни и дали писмото е изпратено според настройката „Изпращане на издадения документ до клиента“, която по подразбиране е изключена.
При липсващ документ проверете доставката на събитието в Stripe, адреса, Signing secret, режима и дали връзката е включена. Събитията, получени, докато връзката е изключена, не се обработват по-късно: изпратете ги отново от Stripe, след като я включите. Не създавайте ръчно дубликат, преди да проверите дали документът вече е издаден.
Спиране и промени
Изключете връзката, когато трябва да спрете обработката. При промяна на настройките проверете автоматичното изпращане и кочана. Връзката може да бъде изтрита само когато е изключена, а вече издадените документи остават. Те се преглеждат и коригират по обичайния ред в Продажби.