Innflutningur frá Stripe

Þessi leiðarvísir fjallar um skráarinnflutning á Stripe greiðslum með innflutningssniðmáti: hvað á að flytja út, hvernig á að setja sniðmátið upp og hvað innflutningurinn býr til. Nánari upplýsingar um API eru í Bankainnflutningur og greiðslur.

1. Flytja út greiðsluskrána frá Stripe

Í Stripe stjórnborðinu skaltu opna Payments → Export, velja dagsetningabil, hafa kross við All columns og taka með metadata dálkana sem þú notar (Stripe flytur út hvern metadata lykil sem dálk sem heitir <key> (metadata), til dæmis orderNo (metadata)). Sæktu CSV skrána. Hægt er að nota bæði raunumboð (live) og prófunarham (test-mode).

Raðir sem færðu enga peninga eru hunsaðar við innflutning: greiðslutilraunir sem mistökust, var aflýst eða krefjast enn greiðslumáta, og færslur sem voru aldrei gjaldfærðar (captured).

2. Búa til bankareikning fyrir Stripe

Allur innflutningur lendir á bankareikningi. Undir Bank smellirðu á New bank account, velur Type: Stripe (Stripe reikningur er án IBAN), gefur honum nafn eins og „Stripe“, velur gjaldmiðilinn sem þú innheimtir í og tilheyrandi höfuðbókarreikning. Stripe staðan hegðar sér eins og bankareikningur: greiðslur koma inn, þóknanir fara út, og útborganir færa stöðuna yfir á raunverulegan banka þinn.

3. Búa til innflutningssniðmát

Undir Bank → Import templates smellirðu á New import template, velur gerðina Type: Stripe og gefur sniðmátinu nafn.

Reitir (Fields). Hver dálkur í Stripe útflutningnum er röð. Reiturinn Required in file gefur til kynna að dálkurinn verði að vera til staðar í skránni sem hlaðið er upp; skrá sem vantar nauðsynlegan dálk er hafnað og nöfnum þeirra dálka sem vantar er birt. Dálkunum 19 sem byrja á Card … er sjálfkrafa sleppt vegna þess að Stripe sleppir þeim fyrir suma reikninga.

Höfuðbókarreikningur (Ledger account). Raðirnar sem bera fjármuni – Amount, Fee, Amount Refunded – má tengja við höfuðbókarreikning, annaðhvort fyrirliggjandi reikning eða nýjan sem stofnaður er út frá sömu röð. Hver hreyfing sem verður til úr úthlutuðum reit er færð við innflutning: innkomnir peningar skrifast á Stripe bankareikninginn og eignast á úthlutaðan reikning, útkomnir peningar gera hið gagnstæða, og bankafærslan er merkt sem jöruð við þá færslu í dagbók. Venjuleg uppsetning er:

Reitur	Reikningur	Verkun
Fee	þóknunargjaldareikningur PSP (6800 í staðli)	Hver Stripe þóknun er bókuð sem kostnaður
Amount	skildu eftir „Ekki fært“ (Not posted)	Greiðslur eru skildar eftir opnar til jöfnunar við reikninga (sjá skref 5)
Amount Refunded	skildu eftir „Ekki førte“ (Not posted)	Endurgreiðslur eru afgreiddar í gegnum kreditreikninga (sjá skref 5)

Búa til vantar viðskiptavini (Create missing customers). Hakaðu við þetta á röðinni Customer Email. Fyrir hvert tölvupóstfang í skránni sem enginn viðskiptamaður hefur þegar, er stofnaður viðskiptamaður: nafn kemur úr Customer Description (tölvupóstfangið ef tómt), heimilisfang úr Card Address … dálkunum þegar þeir eru til staðar. Fyrirliggjandi viðskiptavinir eru þekktir á tölvupóstfangi, óháð há- og lágstöfum, þannig að ekkert er stofnað tvöfalt.

Búa til viðskiptamann Stripe (Create partner Stripe). Hakaðu við þetta á röðinni Fee. Innflutningurinn stofnar birgja að nafni Stripe einu sinni (fyrirliggjandi viðskiptamaður með það nafn er endurnotaður) og skráir hverja þóknunarfærslu í dagbókina með Stripe sem viðskiptamann, þannig að þóknunarbókanir sýna hverjum var greitt.

Metadata reitir (Metadata fields). Bættu við einni röð fyrir hvern metadata lykil sem þú vilt að innflutningurinn lesi, til dæmis orderNo. Hægt er að virkja tvö merki á þessum röðum:

• Búa til eða tengja reikninga (Create or link invoices) – merkir lykilinn sem greinir pöntun (skref 5). Aðeins ein röð getur borið þetta merki. VSK hlutfall fyrir stofnaða reikninga birtist við hliðina á því, ásamt valkvæðri Vörulistaeiningu (Catalog item): þegar hún er valin vísar hver reikningslína sem innflutningurinn býr til í þá vöru eða þjónustu, þannig að tekjur fara á reikning vörunnar; línutextinn kemur þó enn úr færslunni.
• Fyrirtækismerki (Company flag) – merkir lykil þar sem gildið gefur til kynna að kaupandinn sé fyrirtæki (true, 1, yes, company, business eða b2b). Viðskiptavinir sem stofnaðir eru út frá slíkum færslum eru viðskiptavinir af gerðinni fyrirtæki; allir aðrir eru einstaklingar.

Vistaðu sniðmátið.

4. Flytja skrána inn

Undir Bank skaltu velja Stripe bankareikninginn, sniðmátið og skrána og smella síðan á Import. Hnappurinn sýnir biðhring þar til innflutningurinn er búinn; stór skrá getur tekið nokkrar mínútur vegna þess að reikningar eru gefnir út einn af öðrum. Niðurstöðulínan greinir frá hversu margar færslur voru fluttar inn, hversu margar voru þegar til staðar, hversu margar hreyfingar voru færðar og hversu margir viðskiptavinir, reikningar og kreditreikningar voru stofnaðir. Viðvaranir telja upp þær pantanir sem ekki var hægt að vinna úr og hvers vegna.

Það er öruggt að flytja sömu skrá inn aftur: færslur eru þekktar á Stripe færslunúmeri (charge id), viðskiptavinir á tölvupósti og pantanir á metadata gildi sínu.

5. Hvað „Búa til eða tengja reikninga“ gerir

Greiðslur og endurgreiðslur eru flokkaðar eftir gildi valda metadata lykilsins (pöntunarnúmerinu).

• Ef sölureikningur fyrir það gildi er þegar til staðar – sölupöntun þar sem ytri tilvísun er það gildi, eða reikningur þar sem númerið er það gildi – eru greiðslurnar jafnaðar við hann sem greiðslur.
• Annars er sölureikningur stofnaður fyrir viðskiptamanninn: ein lína á hverja færslu, með línutexta færslunnar og upphæð færslunnar sem VSK-innifalið verð á VSK-hlutfalli sniðmátsins, dagsettur á fyrstu færslu. Hann er gefinn út og færður tafarlaust, og færslurnar eru jafnaðar við hann þannig að hann birtist sem greiddur. Sölupöntun með rásinni stripe er skráð með pöntunarnúmerinu, þannig að næsti innflutningur tengir í stað þess að stofna nýjan.
• Hver endurgreiðsla í hópnum verður að útgefnum kreditreikningi á móti þeim reikningi fyrir endurgreiddri upphæð, og endurgreiðslufærslan er jöruð við hann.

Hópar án tölvupóstfangs viðskiptamanns, með færslur í mismunandi gjaldmiðlum, eða þar sem fyrirliggjandi reikningur er enn drög eða þegar greiddur, eru hunsaðir og skráðir í viðvörunum. Færslur þeirra verða ójafnaðar undir Bank → Transactions.

Reikningsnúmer koma úr númeraröð yfirstandandi árs jafnvel fyrir færslur sem eru dagsettar á fyrri árum, þannig að sögulegur innflutningur rekst ekki á fyrirliggjandi númer.

6. Sex valfrjálsu reitirnir neðst á sniðmátinu

Flest fyrirtæki skilja alla sex eftir tvo og innflutningurinn virkar nákvæmlega eins. Þeir eru til staðar vegna nokkurra afmarkaðra aðstæðna: þú vilt að kortafyrirvarar séu skráðir sem skjöl, eða þú innheimtir peninga sem hluta til heyra einhverjum öðrum.

Af hverju felligluggarnir líta út fyrir að vera tómir

Þrír felligluggar fyrir „aðgerðartegund“ (operation type) sýna þær aðgerðartegundir sem fyrirtækið þitt hefur stofnað undir Account → Operation types. Ef þú hefur engar stofnað hefur felliglugginn ekkert að geyma. Það er ekki villa; stofnaðu aðgerðartegund fyrst eða skildu reitinn eftir tómann.

Felliglugginn Lender metadata field sýnir heiti metadata dálka sem þú skrifaðir í listann Metadata fieldsar ofar í þessu sama eyðublaði. Bættu við metadata reit þar fyrst og hann birtist hér.

Skýring texta fyrir hlutaendurgreiðslu og fulla endurgreiðslu (Partial refund label and Full refund label)

Þegar innflutningurinn býr til kreditreikning vegna endurgreiðslu sýna þessir reitir orðið sem prentað er efst á PDF skjal þess kreditreiknings.

Aðstæður	Notað orð	Sjálfgefið
Endurgreiðslan er minni en heildarupphæð reiknings	Skýring texta fyrir hlutaendurgreiðslu	DEPOZITAS
Endurgreiðslan jafngildir heildarupphæð reiknings	Skýring texta fyrir fulla endurgreiðslu	ANULIAVIMAS

Breyttu þessu aðeins ef fyrirtækið þitt prentar önnur orð á slík skjöl. Þetta hefur áhrif á hvorki númeraröð né bókhald.

Aðgerðartegund heimildar (Authorization operation type)

Kortafyrirvari (authorization) eru peningar fráteknir á korti viðskiptamanns sem þú hefur ekki tekið enn. Í Stripe útflutningi hafa þessar raðir Captured stillt á false. Innflutningurinn hunsar þær venjulega vegna þess að engir peningar færðust til.

Fylltu út þennan reit og hver slík röð verður útgefið söluskjal, þar sem notuð er þessi aðgerðartegund og skjalaröðin sem sú aðgerðartegund vísar á. Skildu hann eftir tómum og þeim röðum er sleppt, og niðurstaða innflutnings sýnir viðvörunina „authorization(s) skipped: template has no authorization operation type“.

Ef þú veist ekki þegar að fyrirtæki þitt þurfi að sýna fyrirvara sem skjöl skaltu skilja þetta eftir autt.

Aðgerðartegund útborgana, aðgerðartegund þóknana og lánveitanda metadata reitur (Payout operation type, Commission operation type and Lender metadata field)

Sleptu þessum hluta alveg nema fyrirtækið þitt innheimti peninga sem tilheyra einhverjum öðrum – markaðstorg (marketplace) sem greiðir seljendum, eða vettvangur (platform) sem greiðir lánveitendum. Venjuleg verslun fyllir þetta aldrei út.

Stripe segir þessa sögu í tveimur skrám. Greiðsluútflutningurinn (payments) segir hvað hver viðskiptamaður greiddi. Sérstakur millifærsluútflutningur (transfers) segir hversu mikið þú sendir áfram til hins aðilans. Innflutningurinn þarf hvort tveggja til að reikna út hvað þú áttir eftir.

Undir Bank sýnir innflutningsformið reit fyrir skrá af gerðinni Stripe transfers export þegar að minnsta kosti eitt Stripe sniðmát er til staðar; veldu millifærsluskrána þar við hliðina á greiðsluskránni. Gegnum API er þetta transfersCsv reiturinn í bank/statements/import.

Þegar báðar skrárnar eru til staðar:

Reitur	Hvað hann gerir
Aðgerðartegund útborgana (Payout operation type)	Fyrir hverja millifærslu til hins aðilans er skrifuð ein höfuðbókarfærsla fyrir millifærðu upphæðina. Debet- og kreditreikningar koma frá þessari aðgerðartegund. Ef skilinn eftir tómur notar færsla bókunarreglur fyrir viðskiptakröfur seljanda og viðskiptaskuldir birgja í staðinn.
Aðgerðartegund þóknana (Commission operation type)	Hlutanum sem þú átt eftir, reiknaður sem upphæð færslu að frádreginni Stripe þóknun að frádreginni millifærðri upphæð út, og aðeins skrifaður þegar það er meira en núll. Reikningar koma frá þessari aðgerðartegund, annars frá bókunarreglum fyrir viðskiptakröfur seljanda og þóknunartekjur.
Lánveitanda metadata reitur (Lender metadata field)	Heiti Stripe metadata dálksins sem geymir hvert peningarnir fóru. Viðskiptamaður með það gildi er stofnaður, eða endurnotaður ef hann er til staðar, og settur á báðar færslurnar hér að ofan. Ef skilinn eftir tómur, eða röð án gildis, gefur hann viðvörunina „lender not identified“ og færsla er skrifuð án viðskiptamanns.

Ef báðir reitir aðgerðartegunda eru tómir eru engar færslur um millifærslur eða þóknanir skrifaðar yfir höfuð, sama hvað annað er stilt.

7. Útborganir á bankareikninginn þinn

Greiðsluútflutningurinn hefur engar útborganirðanir raðir, þannig að peningarnir sem Stripe sendir á raunverulegan banka þinn eru bókaðir út frá útborgunarskýrslunni í staðinn. Í Stripe stjórnborðinu skaltu opna Reports → Payouts → Payout reconciliation, itemized, sækja hana og flytja hana inn undir Bank → Settlements á raunverulegan bankareikning þinn, og bóka síðan hverja útborgun.

Fyrir hverja útborgunarlínu þar sem fært, þóknun eða endurgreiðsla er þegar komin á Stripe bankareikninginn með þessum innflutningi, færir bókun hreinni upphæð línunnar úr Stripe bankareikningnum yfir á raunverulegan bankareikning. Þóknanir og reikningsgreiðslur eru ekki bókaðar aftur. Línur sem Stripe greiddi út en þessi innflutningur sá aldrei eru bókaðar eins og lýst er í Bankainnflutningur og greiðslur.

Hver útborgun sýnir Mismunur á fluttum greiðslum (Difference to imported payments): það sem útborgunin færði að frádregnu því sem Stripe bankareikningurinn geymir fyrir sömu færslur og endurgreiðslur. Núll þýðir að útborgunin jafnar Stripe reikninginn. Lína með mismun, eða með hreyfingu á Stripe reikningi sem er enn óbókuð, er talin með í Línur til athugunar (Lines to check). Greiðsluútflutningurinn geymir aðeins heildarendurgreiðslu á hverja færslu, þannig að allar endurgreiðslulínur einnar færslu eru bornar saman samanlagt við þá heildarupphæð.

Ef útborgun var bókuð áður en greiðsluskráin var flutt inn sleppir innflutningurinn færslum, þóknunum og endurgreiðslum þeirrar útborganir og nefnir hana í viðvörunum.

8. Hvar á að leita eftir á

• Bank → Transactions – hver innflutt hreyfing; jafnaðar hreyfingar vísa á reikninginn eða dagbókarfærsluna.
• Invoices – stofnaðir reikningar og kreditreikningar, með pöntunarnúmer í athugasemdum.
• Partners – stofnaðir viðskiptavinir.
• Ledger → Journal – færslur fyrir þóknanir, greiðslur og reikninga.

Reikningsfærsla

Skrár allt að 10 MB og 50.000 hreyfingar. Hverjar 10 innfluttar hreyfingar gilda sem ein API beiðni.