Импорт данных из Stripe

В этом руководстве описывается файловый импорт платежей из Stripe с помощью шаблона импорта: что именно экспортировать, как настроить шаблон и что создается в результате импорта. Сведения об API приведены в разделе Импорт банковских операций и платежей.

1. Экспорт файла платежей из Stripe

В панели управления Stripe откройте Payments → Export (Платежи → Экспорт), выберите диапазон дат, оставьте вариант All columns (Все столбцы) и включите необходимые столбцы метаданных (Stripe экспортирует каждый ключ метаданных в виде столбца с именем <key> (metadata), например orderNo (metadata)). Загрузите CSV-файл. Подходит экспорт как в рабочем режиме (live), так и в режиме тестирования (test).

Строки, по которым не было движения денежных средств, при импорте пропускаются: неудачные, отмененные или требующие выбора способа оплаты попытки платежа, а также неподтвержденные списания.

2. Создание банковского счета для Stripe

Каждый импорт зачисляется на банковский счет. В разделе Bank (Банк) нажмите New bank account (Новый банковский счет), выберите Type: Stripe (Тип: Stripe) (у счета Stripe нет IBAN), назовите его, например, „Stripe“, укажите валюту, в которой принимаете платежи, и соответствующий бухгалтерский счет. Баланс Stripe ведет себя как банковский счет: поступают платежи, списываются комиссии, а выплаты переводят средства на ваш реальный банковский счет.

3. Создание шаблона импорта

В разделе Bank → Import templates (Банк → Шаблоны импорта) нажмите New import template (Новый шаблон импорта), выберите тип Stripe и укажите название.

Поля. Каждый столбец экспорта Stripe представляет собой строку. Флажок Required in file (Обязательно в файле) означает, что этот столбец должен присутствовать в загружаемом файле; если в файле отсутствует обязательный столбец, импорт отклоняется, а названия недостающих столбцов выводятся на экран. 19 столбцов Card … по умолчанию не отмечены, поскольку Stripe пропускает их для некоторых учетных записей.

Бухгалтерский счет. Для строк, связанных с движением денежных средств (Amount, Fee, Amount Refunded), можно назначить бухгалтерский счет — существующий или созданный заново на основе этой же строки. Каждая операция, сформированная из назначенного поля, проводятся в момент импорта: поступление денег дебетует банковский счет Stripe и кредитует назначенный счет, исходящие суммы отражаются зеркально, а банковская транзакция помечается как сопоставленная с данной проводкой. Стандартная настройка выглядит так:

Поле	Счет	Эффект
Fee	счет расходов на комиссию ПС (6800 в типовом плане счетов)	Каждая комиссия Stripe отражается как расход
Amount	оставьте значение „Not posted“ (Не проводить)	Платежи остаются открытыми для сопоставления со счетами (см. шаг 5)
Amount Refunded	оставьте значение „Not posted“ (Не проводить)	Возвраты обрабатываются с помощью кредитовых авизо (см. шаг 5)

Создание отсутствующих клиентов (Create missing customers). Установите этот флажок в строке Customer Email. Для каждого адреса электронной почты из файла, для которого еще нет контрагента, будет создан клиент: имя берется из Customer Description (или из email, если оно пустое), адрес — из столбцов Card Address …, если они заполнены. Существующие контрагенты распознаются по адресу электронной почты без учета регистра, поэтому дубликаты не создаются.

Создание контрагента Stripe (Create partner Stripe). Установите этот флажок в строке Fee. При импорте один раз создается контрагент-поставщик с именем Stripe (если контрагент с таким именем уже существует, он используется повторно), и каждая проводка по комиссии записывается в журнал с указанием Stripe в качестве контрагента, благодаря чему в учете видно, кому была выплачена комиссия.

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

• Создание или связывание счетов (Create or link invoices) - отмечает ключ, идентифицирующий заказ (шаг 5). Этот флаг может быть только у одной строки. Рядом с ним отображается ставка НДС для создаваемых счетов, а также опциональное поле Catalog item (Элемент каталога): если оно выбрано, каждая строка создаваемого при импорте счета ссылается на этот товар или услугу, поэтому выручка отражается на счете данного элемента; текст самой строки по-прежнему берется из платежа.
• Признак компании (Company flag) - отмечает ключ, значение которого указывает, что покупателем является юридическое лицо (true, 1, yes, company, business или b2b). Созданные по таким платежам клиенты получают статус компании; все остальные клиенты создаются как физические лица.

Сохраните шаблон.

4. Импорт файла

В разделе Bank (Банк) выберите банковский счет Stripe, шаблон и файл, а затем нажмите Import (Импортировать). Кнопка будет отображать индикатор загрузки до завершения процесса; обработка большого файла может занять несколько минут, так как счета выставляются по одному. В строке результатов отображается информация о том, сколько транзакций было импортировано, сколько уже существовало, сколько проводок было сформировано, а также сколько клиентов, счетов и кредитовых авизо было создано. В предупреждениях перечисляются заказы, которые не удалось обработать, с указанием причин.

Повторный импорт того же файла безопасен: транзакции распознаются по идентификатору платежа Stripe, клиенты — по адресу электронной почты, а заказы — по значению их метаданных.

5. Что делает функция создания или связывания счетов („Create or link invoices“)

Платежи и возвраты группируются по значению выбранного ключа метаданных (номеру заказа).

• Если счет на продажу с таким значением уже существует (заказ на продажу, внешним справочным номером которого является это значение, или счет с соответствующим номером), платежи сопоставляются с ним как оплата.
• В противном случае для клиента создается счет на продажу: по одной строке на каждый платеж, с текстом строки из платежа и суммой платежа в качестве цены с учетом НДС по ставке, указанной в шаблоне, датированный днем первого платежа. Счет выставляется и проводится немедленно, а платежи сопоставляются с ним, благодаря чему он отображается как оплаченный. В системе фиксируется заказ на продажу с каналом stripe и номером заказа, поэтому следующий импорт свяжет платеж с существующим документом, а не создаст новый.
• Каждый возврат в группе превращается в выставленное кредитовое авизо к этому счету на сумму возврата, а транзакция возврата сопоставляется с ним.

Группы без электронной почты клиента, с платежами в разных валютах, а также группы, чей существующий счет все еще находится в статусе черновика или уже оплачен, пропускаются и выводятся в списке предупреждений. Их транзакции остаются несопоставленными в разделе Bank → Transactions (Банк → Транзакции).

Номера счетов берутся из нумерации текущего года, даже если платежи датированы прошлыми годами, поэтому ретроспективный импорт не пересекается с существующими номерами.

6. Шесть необязательных полей в нижней части шаблона

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

Почему выпадающие списки выглядят пустыми

В трех выпадающих списках типов операций перечислены типы операций, созданные вашей компанией в разделе Account → Operation types (Счет → Типы операций). Если вы не создали ни одного типа, список будет пустым. Это не ошибка: сначала создайте тип операции или оставьте поле пустым.

В выпадающем списке Lender metadata field (Поле метаданных кредитора) выводятся названия столбцов метаданных, введенные в список Metadata fields (Поля метаданных) выше в этой же форме. Сначала добавьте поле метаданных там, и оно появится здесь.

Метка частичного возврата и Метка полного возврата

Когда при импорте создается кредитовое авизо для возврата, эти параметры определяют слово, печатаемое в верхней части PDF-файла такого кредитового авизо.

Ситуация	Используемое слово	Значение по умолчанию
Сумма возврата меньше итоговой суммы счета	Метка частичного возврата (Partial refund label)	DEPOZITAS
Сумма возврата равна итоговой сумме счета	Метка полного возврата (Full refund label)	ANULIAVIMAS

Изменяйте их только в том случае, если ваша компания использует другие формулировки на таких документах. Они не влияют на нумерацию и бухгалтерский учет.

Тип операции авторизации (Authorization operation type)

Авторизация по карте — это сумма на карте клиента, зарезервированная, но еще не списанная вами. В экспорте Stripe такие строки имеют значение Captured (Подтверждено): false. Обычно импорт игнорирует их, так как движения денег не произошло.

Заполните это поле, и каждая такая строка превратится в выставленный документ продажи с использованием указанного типа операции и нумерации документов, к которой привязан этот тип операции. Если оставить поле пустым, такие строки будут пропущены, а в результатах импорта появится предупреждение „authorization(s) skipped: template has no authorization operation type“ (авторизация(и) пропущена: в шаблоне не указан тип операции авторизации).

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

Тип операции выплаты, тип операции комиссии и поле метаданных кредитора

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

Stripe передает эти данные в двух файлах. Экспорт платежей показывает, сколько заплатил каждый клиент. Отдельный экспорт переводов (transfers) показывает, какую часть этих средств вы перевели другой стороне. Импорту нужны оба файла, чтобы определить, что осталось у вас.

В разделе Bank (Банк) в форме импорта появится поле для файла Stripe transfers export (Экспорт переводов Stripe), если создан хотя бы один шаблон Stripe; выберите файл переводов рядом с файлом платежей. Через API за это отвечает поле transfersCsv в эндпоинте bank/statements/import.

Когда присутствуют оба файла:

Поле	Что оно делает
Тип операции выплаты (Payout operation type)	Для каждого перевода в пользу другой стороны формируется одна бухгалтерская проводка на переведенную сумму. Дебетовый и кредитовый счета берутся из этого типа операции. Если поле оставить пустым, вместо этого используются правила проводок по расчетам с продавцами и поставщиками.
Тип операции комиссии (Commission operation type)	Часть средств, которая остается у вас, рассчитывается как сумма платежа за вычетом комиссии Stripe и суммы осуществленного перевода, и записывается только в том случае, если результат больше нуля. Счета берутся из этого типа операции, в противном случае — из правил проводок по расчетам с продавцами и доходам от комиссий.
Поле метаданных кредитора (Lender metadata field)	Имя столбца метаданных Stripe, в котором указано, кому ушли деньги. Контрагент с таким значением создается (или используется повторно, если уже существует) и проставляется в обеих указанных выше проводках. Если поле оставить пустым или встретится строка без значения, появится предупреждение „lender not identified“ (кредитор не определен), а проводка будет создана без указания контрагента.

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

7. Выплаты на ваш банковский счет

В экспорте платежей нет строк выплат, поэтому средства, которые Stripe отправляет на ваш реальный банковский счет, отражаются в учете на основе отчета о выплатах. В панели управления Stripe откройте Reports → Payouts → Payout reconciliation, itemized (Отчеты → Выплаты → Сверка выплат с детализацией по позициям), загрузите его и импортируйте в разделе Bank → Settlements (Банк → Расчеты) на ваш реальный банковский счет, а затем проведите каждую выплату.

Для каждой строки выплаты, чьи платеж, комиссия или возврат уже были отражены данным импортом на банковском счете Stripe, проведение перемещает сальдо по этой строке с банковского счета Stripe на реальный банковский счет. Комиссии и платежи по счетам не проводятся повторно. Строки выплат от Stripe, которые этот импорт никогда не видел, проводятся так, как описано в разделе Импорт банковских операций и платежей.

Для каждой выплаты отображается показатель Difference to imported payments (Разница с импортированными платежами): сумма выплаты за вычетом средств на банковском счете Stripe по тем же платежам и возвратам. Нулевое значение означает, что выплата полностью закрывает сальдо по счету Stripe. Строка с разницей или с движением по счету Stripe, которое все еще не проведено, учитывается в показателе Lines to check (Строки для проверки). Экспорт платежей содержит только общую сумму возврата по каждому платежу, поэтому все строки возвратов для одного платежа сравниваются в совокупности с этой общей суммой.

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

8. Куда заглянуть после импорта

• Bank → Transactions (Банк → Транзакции) - каждое импортированное движение; сопоставленные транзакции связаны со счетом или бухгалтерской проводкой.
• Invoices (Счета) - созданные счета и кредитовые авизо с номером заказа в примечаниях.
• Partners (Контрагенты) - созданные клиенты.
• Ledger → Journal (Главная книга → Журнал) - проводки по комиссиям, платежам и счетам.

Биллинг

Файлы размером до 10 МБ и до 50 000 движений. Каждые 10 импортированных движений учитываются как один запрос к API.