Nordlet

← Dokumentācija / Ceļveži

Importēšana no Stripe

Eksportējiet maksājumus no Stripe, iestatiet importēšanas veidni un ļaujiet Nordlet iegrāmatot komisijas maksa, klientus, rēķinus un atmaksas.

Šajā ceļvedī ir apskatīta Stripe maksājumu failu importēšana, izmantojot importēšanas veidni: kas ir jāeksportē, kā iestatīt veidni un ko importēšana izveido. Sīkāka informācija par API ir pieejama sadaļā Bankas un maksājumu importēšana.

1. Eksportējiet maksājumu failu no Stripe

Stripe informācijas panelī atveriet Payments → Export, izvēlieties datumu diapazonu, saglabājiet opciju All columns (Visas kolonnas) un iekļaujiet izmantotās metadatu kolonnas (Stripe eksportē katru metadatu atslēgu kā kolonnu ar nosaukumu <key> (metadata), piemēram, orderNo (metadata)). Lejupielādējiet CSV failu. Darbojas gan reālās vides (live), gan testa režīma eksports.

Rindas, par kurām nav pārvietota nauda, importēšanas laikā tiek izlaistas: neizdevušies maksājumu mēģinājumi, atceltie maksājumi vai maksājumi, kuriem joprojām ir nepieciešama maksājuma metode, kā arī maksas, kas nekad nav tikušas iekasētas.

2. Izveidojiet bankas kontu Stripe vajadzībām

Katrs imports tiek ieskaitīts bankas kontā. Sadaļā Bank nospiediet New bank account, izvēlieties Type: Stripe (Stripe kontam nav IBAN), nosauciet to, piemēram, par "Stripe", izvēlieties norēķinu valūtu un tās virsgrāmatas kontu. Stripe atlikums darbojas līdzīgi bankas kontam: ienāk maksājumi, tiek novirzītas komisijas maksas, savukārt izmaksas pārvieto atlikumu uz jūsu reālo banku.

3. Izveidojiet importēšanas veidni

Sadaļā Bank → Import templates nospiediet New import template, izvēlieties tipu Stripe un piešķiriet tam nosaukumu.

Lauki. Katra Stripe eksporta kolonna ir rinda. Izvēles rūtiņa Required in file norāda, ka kolonnai ir jābūt augšupielādētajā failā; fails, kurā trūkst obligātās kolonnas, tiek noraidīts un trūkstošie nosaukumi tiek parādīti. 19 Card … kolonnas pēc noklusējuma ir neatzīmētas, jo Stripe tās dažiem kontiem neiekļauj.

Virsgrāmatas konts. Rindas, kurās ir naudas līdzekļi (Amount, Fee, Amount Refunded), var piesaistīt virsgrāmatas kontam, izmantojot vai nu esošo kontu, vai jaunu kontu, kas izveidots no tās pašas rindas. Katra kustība, ko rada piesaistīts lauks, tiek iegrāmatota importēšanas brīdī: ienākošie līdzekļi tiek debetēti Stripe bankas kontā un kreditēti piesaistītajā kontā, izejošie līdzekļi darbojas pretēji, un bankas darījums tiek atzīmēts kā saskaņots ar šo grāmatojumu. Parasti iestatījums ir šāds:

Lauks Konts Efekts
Fee PSP komisijas maksu izdevumu konts (standarta kontu plānā 6800) Katra Stripe komisijas maksa tiek iegrāmatota kā izdevumi
Amount atstāt "Not posted" (Neiegrāmatots) Maksājumi paliek atvērti rēķinu saskaņošanai (skatiet 5. soli)
Amount Refunded atstāt "Not posted" (Neiegrāmatots) Atmaksas tiek apstrādātas, izmantojot kredītrēķinus (skatiet 5. soli)

Izveidot trūkstošos klientus. Atzīmējiet šo rūtiņu rindā Customer Email. Katram failā esošajam e-pastam, kuram vēl nav partnera, tiek izveidots klienta ieraksts: nosaukums tiekņemts no Customer Description (ja tas ir tukšs, tiek izmantots e-pasts), adrese no Card Address … kolonnām, ja tādas ir pieejamas. Esošie partneri tiek atpazīti pēc e-pasta, neņemot vērā lielos un mazos burtus, tāpēc nekas netiek izveidots divreiz.

Izveidot partneri Stripe. Atzīmējiet šo rūtiņu rindā Fee. Imports vienu reizi izveido piegādātāja partneri ar nosaukumu Stripe (esošs partneris ar šādu nosaukumu tiek izmantots atkārtoti) un reģistrē katru komisijas maksas ierakstu virsgrāmatā ar partneri Stripe, lai komisijas maksas grāmatojumos būtu redzams, kam samaksāts.

Metadatu lauki. Pievienojiet vienu rindas ierakstu katrai metadatu atslēgai, kuru vēlaties nolasīt importēšanas laikā, piemēram, orderNo. Šīm rindām var iestatīt divus karodziņus:

  • Izveidot vai saistīt rēķinus – atzīmē atslēgu, kas identificē pasūtījumu (5. solis). To var iestatīt tikai vienā rindā. Blakus tam parādās PVN likme izveidotajiem rēķiniem, kā arī izvēles lauks Catalog item: ja tas ir izvēlēts, katra rēķina rinda, ko imports izveido, atsaucas uz šo preci vai pakalpojumu, tāpēc ieņēmumi tiek grāmatoti uz preces kontu; rindas teksts joprojām tiek ņemts no maksājuma.
  • Uzņēmuma karodziņš – atzīmē atslēgu, kuras vērtība norāda, ka pircējs ir uzņēmums (true, 1, yes, company, business vai b2b). Klienti, kas izveidoti no šādiem maksājumiem, ir uzņēmuma tipa partneri; visi pārējie ir fiziskas personas.

Saglabājiet veidni.

4. Importējiet failu

Sadaļā Bank izvēlieties Stripe bankas kontu, veidni un failu, pēc tam nospiediet Import. Poga rāda ielādes animāciju, līdz imports ir pabeidzis darbu; liels fails var aizņemt vairākas minūtes, jo rēķini tiek izrakstīti pa vienam. Rezultātu rindiņā tiek sniegts pārskats par to, cik darījumu tika importēti, cik jau pastāvēja, cik kustību tika iegrāmatotas un cik klientu, rēķinu un kredītrēķinu tika izveidoti. Brīdinājumos ir uzskaitīti pasūtījumi, kurus nebija iespējams apstrādāt, un iemesli tam.

Tā paša faila atkārtota importēšana ir droša: darījumi tiek atpazīti pēc Stripe maksājuma ID, klienti pēc e-pasta, bet pasūtījumi pēc to metadatu vērtības.

5. Ko dara funkcija "Izveidot vai saistīt rēķinus"

Maksājumi un atmaksas tiek grupēti pēc izvēlētās metadatu atslēgas vērtības (pasūtījuma numura).

  • Ja šai vērtībai jau pastāv pārdošanas rēķins – pārdošanas pasūtījums, kura ārējā atsauce ir šī vērtība, vai rēķins, kura numurs ir šī vērtība – maksājumi tiek saskaņoti ar to kā ienākošie maksājumi.
  • Pretējā gadījumā klienta vajadzībām tiek izveidots pārdošanas rēķins: viena rinda uz vienu maksājumu, iekļaujot maksājuma rindas tekstu un maksājuma summu kā cenu ar PVN atbilstoši veidnes PVN likmei, un ar datumu, kas atbilst pirmajam maksājumam. Tas tiek nekavējoties izrakstīts un iegrāmatots, un maksājumi tiek saskaņoti ar to, tāpēc tas parādās kā apmaksāts. Pārdošanas pasūtījums ar kanālu stripe tiek reģistrēts ar pasūtījuma numuru, lai nākamais imports veiktu sasaisti, nevis jauna dokumenta izveidi.
  • Katra grupas atmaksas operācija kļūst par izrakstītu kredītrēķinu attiecīgajam rēķinam par atmaksāto summu, un atmaksas darījums tiek saskaņots ar to.

Grupas bez klienta e-pasta, ar maksājumiem dažādās valūtās vai grupas, kuru esošais rēķins joprojām ir melnraksts vai jau ir apmaksāts, tiek izlaistas un uzskaitītas brīdinājumos. To darījumi paliek nesaskaņoti sadaļā Bank → Transactions.

Rēķinu numuri tiek ņemti no kārtējā gada sērijas pat tiem maksājumiem, kuru datums ir agrākos gados, tāpēc vēsturiskie importi nekonfliktē ar esošajiem numuriem.

6. Seši izvēles lauki veidnes apakšdaļā

Lielākā daļa uzņēmumu atstāj visus sešus laukus tukšus, un imports darbojas pilnīgi identiski. Tie pastāv divām šaurām situācijām: ja vēlaties, lai karšu rezervācijas tiktu reģistrētas kā dokumenti, vai ja iekasējat naudu, kas daļēji pieder kādam citam.

Kāpēc nolaižamās izvēlnes izskatās tukšas

Trīs "operācijas veida" nolaižamās izvēlnes uzskaita operāciju veidus, ko jūsu uzņēmums ir izveidojis sadaļā Account → Operation types. Ja neesat izveidojis nevienu, nolaižamajā izvēlnē nebūs nekā. Tā nav kļūda; vispirms izveidojiet operācijas veidu vai atstājiet lauku tukšu.

Nolaižamā izvēlne Lender metadata field uzskaita metadatu kolonna nosaukumus, kurus ierakstījāt Metadata fields sarakstā augstāk šajā pašā veidlapā. Vispirms pievienojiet tur metadatu lauku, un tas parādīsies šeit.

Daļējas atmaksas apzīmējums un Pilnas atmaksas apzīmējums

Kad imports izveido kredītrēķinu atmaksai, šie lauki nosaka vārdu, kas tiek drukāts šī kredītrēķina PDF augšdaļā.

Situācija Izmantotais vārds Noklusējums
Atmaksa ir mazāka par rēķina kopsummu Daļējas atmaksas apzīmējums DEPOZITAS
Atmaksa vienāda ar rēķina kopsummu Pilnas atmaksas apzīmējums ANULIAVIMAS

Mainiet tos tikai tad, ja jūsu uzņēmums uz šādiem dokumentiem drukā citus vārdus. Tie neietekmē numerāciju un grāmatvedību.

Autorizācijas operācijas veids

Kartes autorizācija ir nauda, kas rezervēta uz klienta kartes, kuru jūs vēl neesat saņēmis. Stripe eksportā šīm rindām opcija Captured ir iestatīta uz false. Imports parasti tās ignorē, jo nauda nav pārvietota.

Aizpildiet šo lauku, un katra šāda rinda kļūs par izrakstītu pārdošanas dokumentu, izmantojot šo operācijas veidu un dokumentu sēriju, uz kuru norāda šis operācijas veids. Atstājiet to tukšu, un šīs rindas tiks izlaistas, savukārt importa rezultāts parādīs brīdinājumu "authorization(s) skipped: template has no authorization operation type" (autorizācija(-s) izlaista: veidnei nav autorizācijas operācijas veida).

Ja iepriekš nezinājāt, ka jūsu uzņēmumam ir jāuzrāda rezervācijas kā dokumenti, atstājiet šo lauku tukšu.

Izmaksu operācijas veids, Komisijas maksas operācijas veids un Aizdevēja metadatu lauks

Pilnībā izlaidiet šo sadaļu, ja vien jūsu uzņēmums neiekasē naudu, kas pieder kādam citam, piemēram, tirdzniecības vieta (marketplace), kas maksā pārdevējiem, vai platforma, kas maksā aizdevējiem. Parasts veikals šos laukus neaizpilda nekad.

Stripe šo informāciju sniedz divos failos. Maksājumu (payments) eksports norāda, ko katrs klients samaksāja. Atsevišķs pārskaitījumu (transfers) eksports norāda, cik lielu daļu no tā jūs pārsūtījāt otrai pusei. Lai noteiktu, ko paturējāt sev, importam ir nepieciešami abi faili.

Sadaļā Bank importēšanas veidlapā parādās Stripe transfers export faila logs, ja eksistē vismaz viena Stripe veidne; blakus maksājumu failam tur izvēlieties pārskaitījumu failu. Izmantojot API, tas ir bank/statements/import pieprasījuma lauks transfersCsv.

Ja ir pieejami abi faili:

Lauks Ko tas dara
Izmaksu operācijas veids Par katru pārskaitījumu otrai pusei tiek ierakstīts viens virsgrāmatas ieraksts par pārsūtīto summu. Debeta un kredīta konti tiek ņemti no šī operācijas veida. Ja lauks tiek atstāts tukšs, ierakstā tiek izmantoti pārdevēja parādu un piegādātāja parādu grāmatošanas noteikumi.
Komisijas maksas operācijas veids Jūsu paturētā daļa, kas tiek aprēķināta kā maksājuma summa, no kuras atskaitīta Stripe komisijas maksa un izskaitītā summa, un tiek ierakstīta tikai tad, ja tā ir lielāka par nulli. Konti tiek ņemti no šī operācijas veida, pretējā gadījumā no pārdevēja parādu un komisijas ieņēmumu grāmatošanas noteikumiem.
Aizdevēja metadatu lauks Tā Stripe metadatu kolonnas nosaukums, kurā norādīts, kam nauda tika novirzīta. Tiek izveidots partneris ar šo vērtību (vai izmantots esošs, ja tāds jau pastāv) un iestatīts abos iepriekšminētajos ierakstos. Ja lauks tiek atstāts tukšs vai ja rindā nav vērtības, tiek parādīts brīdinājums "lender not identified" un ieraksts tiek izveidots bez partnera.

Ja abi operācijas veida lauki ir tukši, pārskaitījumu vai komisijas maksas ieraksti netiek veikti vispār, neatkarīgi no citiem iestatījumiem.

7. Izmaksas uz jūsu banku

Maksājumu eksportā nav izmaksu rindu, tāpēc nauda, ko Stripe nosūta uz jūsu reālo banku, tiek grāmatota no izmaksu pārskata. Stripe informācijas panelī atveriet Reports → Payouts → Payout reconciliation, itemized, lejupielādējiet to un importējiet sadaļā Bank → Settlements savā reālajā bankas kontā, pēc tam iegrāmatojiet katru izmaksu.

Katrai izmaksas rindai, kuras maksājumu, komisijas maksu vai atmaksu šis imports jau ir ievietojis Stripe bankas kontā, iegrāmatošana pārvieto rindas neto summu no Stripe bankas konta uz reālo bankas kontu. Komisijas maksas un rēķinu maksājumi netiek grāmatoti otrreiz. Rindas, ko Stripe izmaksāja, bet kuras šis imports nekad neredzēja, tiek grāmatotas tā, kā aprakstīts sadaļā Bankas un maksājumu importēšana.

Katra izmaksa uzrāda rādītāju Difference to imported payments (Atšķirība no importētajiem maksājumiem): izmaksas pārvietotā summa, no kuras atskaitīta Stripe bankas kontā esošā summa par tiem pašiem maksājumiem un atmaksām. Nulles vērtība nozīmē, ka izmaksa pilnībā nosedz Stripe kontu. Rinda ar atšķirību vai ar kustību Stripe kontā, kas joprojām nav iegrāmatota, tiek ieskaitīta sadaļā Lines to check (Pārbaudāmās rindas). Maksājumu eksportā tiek saglabāta tikai kopējā atmaksātā summa vienam maksājumam, tāpēc visas viena maksājuma atmaksas rindas tiek salīdzinātas kopā pret šo kopsummu.

Ja izmaksa tika iegrāmatota pirms maksājumu faila importēšanas, imports izlaiž šīs izmaksas maksājumus, komisijas maksas un atmaksas, un norāda to brīdinājumos.

8. Kur meklēt informāciju pēc tam

  • Bank → Transactions – visas importētās kustības; saskaņotās saistās ar rēķinu vai grāmatojumu.
  • Invoices – izveidotie rēķini un kredītrēķini ar pasūtījuma numuru piezīmēs.
  • Partners – izveidotie klienti.
  • Ledger → Journal – komisijas maksu, maksājumu un rēķinu grāmatojumi.

Norēķini

Faili līdz 10 MB un 50 000 kustībām. Katras 10 importētās kustības skaitās kā viens API pieprasījums.