Importimine Stripe'ist

See juhend käsitleb Stripe'i maksete failiimporti impordimalli kaudu: mida eksportida, kuidas malli seadistada ja mida import loob. API üksikasjad leiate lehelt Panga- ja maksete import.

1. Ekspordige maksete fail Stripe'ist

Avage Stripe'i töölaual Payments → Export, valige kuupäevavahemik, jätke valituks All columns ja kaasake kasutatavad metaandmete veerud (Stripe ekspordib iga metaandmete võtme veeruna nimega <key> (metadata), näiteks orderNo (metadata)). Laadige CSV alla nii reaalajas (live) kui ka testrežiimi ekspordi jaoks.

Read, millega raha ei liigutatud, jäetakse impordil vahele: ebaõnnestunud, tühistatud või makseviisi ootavad maksekatsed ning laekumised, mida pole kunagi kinnitatud (captured).

2. Looge Stripe'i jaoks pangakonto

Iga import laeb pangakontole. Vajutage jaotises Bank nuppu New bank account, valige Type: Stripe (Stripe'i kontol ei ole IBAN-i), nimetage see näiteks "Stripe", valige arveldusvaluuta ja selle pearaamatu konto. Stripe'i saldo käitub nagu pangakonto: laekumised tulevad sisse, tasud lähevad maha, väljamaksed liigutavad saldo teie päris panka.

3. Looge impordimall

Avage Bank → Import templates, vajutage nuppu New import template, valige tüübiks Stripe ja sisestage nimi.

Väljad. Stripe'i ekspordi iga veerg on eraldi rida. Ruut Required in file märgib, et veerg peab üleslaaditud failis olemas olema; puuduva kohustusliku veeruga fail lükatakse tagasi ja puuduvad nimed kuvatakse. 19 veergu Card … on vaikimisi märkimata, kuna Stripe jätab need teatud kontode puhul ära.

Pearaamatu konto. Raha liigutavad read (Amount, Fee, Amount Refunded) saab suunata pearaamatu kontole, kas olemasolevale või samalt realt loodavale uuele kontole. Iga määratud väljalt pärinev liikumine kantakse raamatupidamisse impordi hetkel: sissetulev raha debiteerib Stripe'i pangakontot ja krediteerib määratud kontot, väljaminev raha teeb vastupidiselt ja pangatehing märgitakse selle müügikande vastaspooleks. Tavaline seadistus on:

Väli	Konto	Mõju
Fee	PSP teenustasude kulukonto (standardkontoplaanis 6800)	Iga Stripe'i tasu kajastatakse kuluna
Amount	jätke valikuks "Not posted"	Laekumised jäävad arvete sidumiseks avatuks (vt 5. samm)
Amount Refunded	jätke valikuks "Not posted"	Tagasimakseid käsitletakse kreeditarvete kaudu (vt 5. samm)

Loo puuduvad kliendid (Create missing customers). Märkige see ruut real Customer Email. Iga e-aadressi jaoks failis, millel veel partnerit pole, luuakse klient: nimi võetakse väljalt Customer Description (kui see on tühi, siis e-aadress), aadress veergudest Card Address …, kui need on olemas. Olemasolevad partnerid tuvastatakse e-aadressi järgi tõstutundetult, nii et midagi ei looda topelt.

Loo partner Stripe (Create partner Stripe). Märkige see ruut real Fee. Import loob ühekordselt tarnijapartneri nimega Stripe (olemasolevat sama nimega partnerit taaskasutatakse) ja kajastab iga tasukande kandel partnerina Stripe, nii et tasukannetelt on näha, kellele maksti.

Metaandmete väljad. Lisage üks rida iga metaandmete võtme kohta, mida soovite importida, näiteks orderNo. Nendele ridadele saab määrata kaks lippu:

• Loo või seo arved (Create or link invoices) – tähistab võtit, mis tuvastab tellimuse (5. samm). Seda saab määrata ainult ühele the-le. Loodavate arvete käibemaksumäär ilmub selle kõrval ja valikuline kataloogi üksus (Catalog item): kui see on valitud, viitab iga impordi loodud arverida sellele tootele või teenusele, nii et tulu kantakse toote kontole; rea tekst pärineb endiselt laekumiselt.
• Ettevõtte lipp (Company flag) – tähistab võtit, mille väärtus näitab, et ostja on ettevõte (true, 1, yes, company, business või b2b). Sellistelt laekumistelt loodavad kliendid on ettevõttest partnerid; kõik teised on eraisikud.

Salvestage mall.

4. Importige fail

Valige jaotises Bank Stripe'i pangakonto, mall ja fail ning vajutage nuppu Import. Nupp näitab laadimisanimatsiooni, kuni import on lõppenud; suur fail võib võtta minuteid, kuna arveid esitatakse ükshaaval. Tulemuste rida annab teada, mitu tehingut imporditi, mitu oli juba olemas, mitu liikumist kanti raamatupidamisse ning mitu klienti, arvet ja kreeditarvet loodi. Hoiatused loetlevad tellimused, mida ei saanud töödelda, ja põhjuse.

Sama faili uuesti importimine on ohutu: tehingud tuvastatakse Stripe'i laekumise ID järgi, kliendid e-aadressi järgi ja tellimused nende metaandmete väärtuse järgi.

5. Mida teeb "Loo või seo arved" ("Create or link invoices")

Laekumised ja tagasimaksed rühmitatakse valitud metaandmete võtme (tellimuse numbri) väärtuse järgi.

• Kui selle väärtusega müügiarve on juba olemas – müügitellimus, mille väline viide on see väärtus, või arve, mille number on see väärtus – seotakse laekumised sellega maksetena.
• Vastasel juhul luuakse kliendile müügiarve: üks rida laekumise kohta, laekumise rea tekstiga ja laekumise summana koos käibemaksuga malli käibemaksumäära alusel, esimese laekumise kuupäevaga. See esitatakse ja postitatakse kohe ning laekumised seotakse sellega, nii et see kuvatakse makstuna. Müügitellimus kanaliga stripe salvestatakse tellimuse numbriga, nii et järgmine import seob loomise asemel.
• Iga tagasimakse rühmas muutub selle arve vastu esitatud kreeditarveks tagastatud summa ulatuses ja tagasimaksetehing seotakse sellega.

Rühmad, millel puudub kliendi e-aadress, millel on laekumised erinevates valuutades või mille olemasolev arve on endiselt mustand või juba makstud, jäetakse vahele ja loetletakse hoiatustes. Nende tehingud jäävad jaotises Bank → Transactions sidumata.

Arvenumbrid pärinevad jooksva aasta seeriast isegi varasemate aastate kuupäevadega laekumiste puhul, nii et ajaloolised impordid ei satu vastuollu olemasolevate numbritega.

6. Kuus valikulist välja malli allosas

Enamik ettevõtteid jätab kõik kuus välja tühjaks ja import toimib täpselt samamoodi. Need on olemas kahe kitsa olukorra jaoks: soovite kaardi broneeringuid dokumentidena kajastada või kogute raha, mis kuulub osaliselt kellelegi teisele.

Miks rippmenüüd näivad tühjad

Kolm toimingutüübi rippmenüüd loetlevad toimingutüübid, mille teie ettevõte on loonud jaotises Account → Operation types. Kui te pole ühtegi loonud, on rippmenüü tühi. See ei ole viga; looge esmalt toimingutüüp või jätke väli tühjaks.

Rippmenüü Lender metadata field loetleb metaandmete veergude nimed, mille sisestasite sama vormi ülaosas olevasse loendisse Metadata fields. Lisage seal esmalt metaandmete väli ja see ilmub siin.

Osalise tagasimakse silt ja täieliku tagasimakse silt

Kui import loob tagasimakse jaoks kreeditarve, määravad need sõna, mis trükitakse selle kreeditarve PDF-i ülaossa.

Olukord	Kasutatav sõna	Vaikimisi
Tagasimakse on arve kogusummast väiksem	Osalise tagasimakse silt (Partial refund label)	DEPOZITAS
Tagasimakse võrdub arve kogusummaga	Täieliku tagasimakse silt (Full refund label)	ANULIAVIMAS

Muutke neid ainult siis, kui teie ettevõte trükib sellistele dokumentidele teisi sõnu. Need ei mõjuta numeratsiooni ega raamatupidamist.

Autoriseerimise toimingutüüp (Authorization operation type)

Kaardi autoriseerimine on kliendi kaardil reserveeritud raha, mida te pole veel vastu võtnud. Stripe'i ekspordis on neil ridadel Captured väärtuseks false. Import ignoreerib neid tavaliselt, kuna raha ei liikunud.

Täitke see väli ja igast sellisest reast saab esitatud müügidokument, mis kasutab seda toimingutüüpi ja dokumentide seeriat, millele see toimingutüüp viitab. Jätke see tühjaks ja need read jäetakse vahele ning impordi tulemus kuvab hoiatuse "authorization(s) skipped: template has no authorization operation type".

Kui te juba ei tea, et teie ettevõte peab broneeringuid dokumentidena kajastama, jätke see tühjaks.

Väljamakse toimingutüüp, vahendustasu toimingutüüp ja laenuandja metaandmete väli

Jätke see osa täielikult vahele, välja arvatud juhul, kui teie ettevõte kogub raha, mis kuulub kellelegi teisele – näiteks müüjatele maksev turg (marketplace) või laenuandjatele maksev platvorm. Tavaline pood ei täida neid kunagi.

Stripe edastab selle teabe kahes failis. Maksete (payments) eksport näitab, mida iga klient maksis. Eraldi ülekannete (transfers) eksport näitab, kui suure osa sellest saatsite edasi teisele osapoolele. Import vajab mõlemat, et välja arvestada, mida te endale hoidsite.

Jaotises Bank kuvab impordivorm failivälja Stripe transfers export, kui olemas on vähemalt üks Stripe'i mall; valige seal maksete faili kõrval ülekannete fail. API kaudu on see välja bank/statements/import väli transfersCsv.

Kui mõlemad failid on olemas:

Väli	Mida see teeb
Väljamakse toimingutüüp (Payout operation type)	Iga teisele osapoolele tehtud ülekande kohta kirjutatakse ülekantud summa kohta üks kande kirje. Deebet- ja kreeditkontod pärinevad sellest toimingutüübist. Kui see jäetakse tühjaks, kasutatakse selle asemel müüja-võlgnevuste ja tarnija-võlgnevuste kontode reegleid.
Vahendustasu toimingutüüp (Commission operation type)	Osa, mille endale jätte, arvutatuna laekumise summana miinus Stripe'i tasu miinus välja kantud summa, ja mis kirjutatakse ainult siis, kui see on suurem kui null. Kontod pärinevad sellest toimingutüübist, vastasel juhul müüja-võlgnevuste ja vahendustasutulude kontode reeglitest.
Laenuandja metaandmete väli (Lender metadata field)	Selle Stripe'i metaandmete veeru nimi, mis sisaldab teavet selle kohta, kellele raha läks. Selle väärtusega partner luuakse või taaskasutatakse, kui see on olemas, ja määratakse mõlemale ülaltoodud kandele. Kui see jäetakse tühjaks või real puudub väärtus, antakse hoiatus "lender not identified" ja kanne kirjutatakse ilma partnerita.

Kui mõlemad toimingutüübi väljad on tühjad, ei kirjutata ülekande- ega vahendustasukandeid üldse, olenemata sellest, mis muu on määratud.

7. Väljamaksed teie panka

Maksete ekspordis ei ole väljamakse ridu, seega kajastatakse raha, mille Stripe teie päris panka saadab, hoopis väljamaksete aruande alusel. Avage Stripe'i töölaual Reports → Payouts → Payout reconciliation, itemized, laadige see alla ja importige jaotises Bank → Settlements oma päris pangakontole, seejärel postitage iga väljamakse.

Iga väljamakse rea puhul, mille laekumise, tasu või tagasimakse see import juba Stripe'i pangakontole pani, liigutab postitamine rea netosumma Stripe'i pangakontolt päris pangakontole. Tasusid ja arvemakseid teist korda ei kajastata. Read, mida Stripe maksis välja ja mida see import kunagi ei näinud, kajastatakse nii, nagu on kirjeldatud jaotises Panga- ja maksete import.

Iga väljamakse kuvab välja Difference to imported payments: väljamaksega liigutatud summa miinus summa, mida Stripe'i pangakonto hoiab samade laekumiste ja tagasimaksete eest. Null tähendab, et väljamakse tasandab Stripe'i konto. Erinevusega rida või Stripe'i konto liikumist, mis on endiselt postitamata, arvestatakse jaotises Lines to check. Maksete eksport hoiab ainult tagastatud summat laekumise kohta, nii et ühe laekumise kõik tagasimakse read võrreldakse koos selle kogusummaga.

Kui väljamakse postitati enne maksete faili importimist, jätab import selle väljamakse laekumised, tasud ja tagasimaksed vahele ning nimetab selle hoiatustes.

8. Kust edasi vaadata

• Bank → Transactions – iga imporditud liikumine; seotud kanded viitavad arvele või kandelisti kirjele.
• Invoices – loodud arved ja kreeditarved, tellimuse number märkustes.
• Partners – loodud kliendid.
• Ledger → Journal – tasude, maksete ja arvestuse kanded.

Arveldamine

Failid suurusega kuni 10 MB ja 50 000 liikumist. Iga 10 imporditud liikumist arvestatakse ühe API päringuna.