Автоматични фактури със Stripe
Единствената интеграция на smetni.app: свържете Stripe и за всяко плащане се издава номерирана фактура от избран кочан, а данните на клиента се обновяват сами.
Настройки · 8 мин четене
Какво прави
Връзката слуша събитията във вашия акаунт в Stripe и ги превръща в документи. Всяко платено плащане поражда номерирана фактура от кочан, който вие избирате, и тя е платена от момента на издаването; възстановяванията пораждат кредитни известия; клиентските събития поддържат името, имейла, адреса и данъчния номер на клиента актуални. Клиентите, създадени по този път, носят отметката „Създаден от Stripe“ заедно с идентификатора си в Stripe.
Какво е нужно предварително
- Роля Админ: разделът „Интеграции“ се вижда само от администратор.
- Действащ кочан в Настройки, раздел „Номерация“: от него връзката взема номерата.
- Акаунт в Stripe, в който можете да създавате webhook.
Ако нямате кочан, разделът показва „Няма действащ кочан, от който връзката да взема номера“ и предлага връзка към Номерация. Как работят кочаните: Номериране на документи.
Как да свържете Stripe
- Отворете Настройки, раздел „Интеграции“, и натиснете „Свързване със Stripe“.
- В новата карта натиснете „Копиране“ до полето „Webhook URL“.
- В Stripe създайте нов webhook с този адрес и го абонирайте за същите събития, които сте отметнали в картата.
- Копирайте показания от Stripe Signing secret, поставете го в полето „Signing secret“ и натиснете „Запазване“.
- Проверете кочана в полето „Кочан“ и следващия номер до него.
- Включете ключа „Включване на връзката“; състоянието се сменя на „Включена“.
Докато настройката не е завършена, картата показва трите стъпки най-отгоре: „Копирайте Webhook URL“, „Поставете Signing secret“ и „Включете“. Изпълнената стъпка получава отметка.
Stripe показва подписващия ключ единствено при създаването на webhook-а. Без него събитията не могат да се проверят и връзката не се включва. Ако сте го изгубили, създайте нов webhook в Stripe и запишете новия ключ.
Събития
Обработва се само отметнатото събитие. Същите събития трябва да са абонирани и в Stripe, иначе те няма да стигнат до приложението.
| Събитие | Резултат | Пише в | Какво прави |
|---|---|---|---|
| invoice.paid | фактура | документи | Издава фактура за всяка платена абонаментна фактура в Stripe. |
| credit_note.created | кредитно известие | документи | Издава кредитно известие за възстановяванията и кредитите. |
| customer.updated | обновяване | клиенти | Обновява името, имейла и адреса на клиента при промяна на Stripe клиента. |
| customer.tax_id.created | обновяване | клиенти | Попълва липсващ ЕИК или ДДС номер, когато в Stripe бъде добавен данъчен номер. |
| customer.tax_id.updated | обновяване | клиенти | Попълва липсващ ЕИК или ДДС номер, когато в Stripe бъде коригиран данъчен номер. |
Под всяко отметнато събитие се изписва кога е получено последно, така че се вижда кое реално работи.
Полета
| Поле | Вид | Нужно за включване | Какво означава |
|---|---|---|---|
| Име | текст | не | Как наричате връзката. Променя се направо в картата и служи, когато имате повече от една връзка. |
| Webhook URL | адрес | да | Адресът, който поставяте в Stripe. Копира се с бутона до него. |
| Signing secret | ключ | да | Подписващият ключ от Stripe. Значка до полето показва „Записан“ или „Не е записан“. |
| Кочан | избор | да | Поредицата, от която се номерират автоматичните фактури. |
| Следващ номер | справка | не | Номерът, който ще получи следващата фактура от този кочан. |
| Изпращане на издадения документ до клиента | ключ | не | Когато е включено, клиентът получава PDF-а по имейл веднага след издаването. |
| Включване на връзката | ключ | да | Ключът, който пуска и спира издаването. |
Състояние на връзката
Картата показва „Включена“ или „Изключена“, а под тях „Последно събитие“ и „Последен документ“. При проблем се появява значка с броя на проблемите и списък с обяснения.
- Stripe не отговори на последната проверка: състоянието е неизвестно, проверете ключа и webhook адреса в Stripe.
- Записаните ключове не могат да бъдат дешифрирани: поставете отново подписващия ключ.
- Пренебрегнати събития от другия режим на Stripe: проверете дали ключът и webhook адресът са от един и същ акаунт и режим.
Ключът и webhook-ът трябва да са от един и същ акаунт и от един и същ режим в Stripe. Събитията от другия режим се пренебрегват и се броят, за да видите несъответствието. Броячът не се нулира сам.
Смяна на кочана
Кочанът се сменя от падащото меню в картата. Новият кочан продължава от собствения си следващ номер, а старият остава затворен, но валиден. Известията следват кочана на документа, който коригират, а не текущо избрания.
Изключване и изтриване
- Изключете ключа „Включване на връзката“, за да спрете издаването, без да губите настройките.
- Натиснете „Изтриване“ и потвърдете, за да махнете връзката напълно.
Включена връзка не може да бъде изтрита, нито ключът ѝ да бъде изчистен: приложението иска първо да я изключите. Изтриването спира издаването, но издадените документи остават. Имайте предвид, че ако по-късно дойде възстановяване по старо плащане, за него вече няма да се издаде кредитно известие.
Чести въпроси
Защо не виждам раздел „Интеграции“?
Разделът се показва само на администратори. Проверете ролята си в Настройки, раздел „Потребители“: Екип и роли.
Мога ли да имам повече от една връзка?
Да. Бутонът „Свързване със Stripe“ добавя следваща карта, а имената им ги разграничават. Всяка връзка има свой Webhook URL, свой ключ и свой кочан.
Клиентът получава ли фактурата автоматично?
Само ако сте включили изпращането на издадения документ до клиента. Иначе документът се издава и остава в списъка, а вие го изпращате, когато решите.
Какво става с номерата, ако спра връзката?
Нищо не се губи. Издадените номера остават заети, а кочанът продължава от следващия си номер, когато връзката бъде включена отново.
Кочаните и непрекъснатата номерация: Номериране на документи. Как изглеждат издадените документи и техните статуси: Изпращане и проследяване.