Importavimas iš Stripe

Šiame vadove aprašomas Stripe mokėjimų failų importavimas naudojant importavimo šabloną: ką eksportuoti, kaip nustatyti šabloną ir ką sukuria importavimas. API detalės pateiktos skyriuje Banko ir mokėjimų importas.

1. Eksportuokite mokėjimų failą iš Stripe

Stripe valdymo skydelyje atidarykite Payments → Export, pasirinkite laikotarpį, palikite pasirinkimą All columns ir įtraukite reikiamus metaduomenų stulpelius (Stripe eksportuoja kiekvieną metaduomenų raktą kaip stulpelį, pavadintą <key> (metadata), pavyzdžiui, orderNo (metadata)). Atsisiųskite CSV failą. Veikia tiek realaus (live), tiek bandomojo (test) režimo eksportas.

Eilutės, kuriose nebuvo perkeltų pinigų, importuojant praleidžiamos: nesėkmingi, atšaukti arba mokėjimo būdo vis dar reikalaujantys mokėjimo bandymai, taip pat neįvykdyti nurašymai (charges).

2. Sukurkite banko sąskaitą Stripe

Kiekvienas importas patenka į banko sąskaitą. Skiltyje Bank paspauskite New bank account, pasirinkite Type: Stripe (Stripe sąskaita neturi IBAN), pavadinkite ją, pavyzdžiui, „Stripe“, pasirinkite valiutą, kuria priimate mokėjimus, ir jos didžiosios knygos (ledger) sąskaitą. Stripe likutis veikia kaip banko sąskaita: lėšos atskaito, mokesčiai išskaitomi, o išmokos (payouts) perkelia likutį į jūsų tikrąjį banką.

3. Sukurkite importavimo šabloną

Skiltyje Bank → Import templates paspauskite New import template, pasirinkite tipą Stripe ir suteikite jam pavadinimą.

Laukai. Kiekvienas Stripe eksporto stulpelis yra eilutė. Laukas Required in file nurodo, kad stulpelis privalo būti įkeltame faile; failas, kuriame trūksta privalomo stulpelio, yra atmetamas, o trūkstami pavadinimai parodomi. 19 Card … stulpelių pagal nutylėjimą yra nepažymėti, nes Stripe jų kai kurioms paskyroms nepateikia.

Didžiosios knygos sąskaita. Eilutėms, kurios perkelia pinigus – Amount, Fee, Amount Refunded – galima priskirti didžiosios knygos sąskaitą (esamą arba naują, sukurtą iš tų pačių duomenų eilutės). Kiekvienas iš priskirto lauko sukurtas judėjimas užregistruojamas importavimo metu: įplaukos debetuoja Stripe banko sąskaitą ir kredituoja priskirtą sąskaitą, išmokos veikia priešingai, o banko operacija pažymėta kaip suderinta su tuo žurnalo įrašu. Įprasta sąranka yra tokia:

Laukas	Sąskaita	Poveikis
Fee	PSP mokesčių sąnaudų sąskaita (6800 standartiniame sąskaitų plane)	Kiekvienas Stripe mokestis apskaitomas kaip sąnaudos
Amount	palikite „Not posted“	Mokėjimai lieka atviri sąskaitų suderinimui (žr. 5 žingsnį)
Amount Refunded	palikite „Not posted`	Grąžinimai tvarkomi per kreditines sąskaitas faktūras (žr. 5 žingsnį)

Sukurti trūkstamus klientus (Create missing customers). Pažymėkite šį lauką eilutėje Customer Email. Kiekvienam faile esančiam el. paštui, kurio dar neturi joks partneris, sukuriamas klientas: vardas paimamas iš Customer Description (el. paštas, jei laukas tuščias), o adresas – iš Card Address … stulpelių, jei jie pateikti. Esami partneriai atpažįstami pagal el. paštą, neskiriant didžiųjų ir mažųjų raštų, todėl nieko nesukuriama du kartus.

Sukurti partnerį Stripe (Create partner Stripe). Pažymėkite šį lauką eilutėje Fee. Importavimo metu tiekėjo partneris, pavadintas Stripe, sukuriamas vieną kartą (esamas tokio paties pavadinimo partneris naudojamas pakartotinai), o kiekvienas mokesčio įrašas žurnale įrašomas nurodant Stripe kaip partnerį, kad mokesčių apskaita rodytų, kam buvo sumokėta.

Metaduomenų laukai. Pridėkite po vieną eilutę kiekvienam metaduomenų raktai, kurį norite, kad importas perskaitytų, pavyzdžiui, orderNo. Šioms eilutėms galima nustatyti du požymius:

• Sukurti arba susieti sąskaitas faktūras (Create or link invoices) – pažymi raktą, kuris identifikuoja užsakymą (5 žingsnis). Šį požymį gali turėti tik viena eilutė. Šalia jo rodomas PVM tarifas sukurtoms sąskaitoms faktūroms bei pasirenkama Katalogo prekė (Catalog item): kai ji pasirinkta, kiekviena importo sukurta sąskaitos faktūros eilutė nurodo tą produktą arba paslaugą, todėl pajamos įregistruojamos į prekės sąskaitą; pačios eilutės tekstas vis tiek imamas iš nurašymo (charge).
• Įmonės požymis (Company flag) – pažymi raktą, kurio reikšmė nurodo, kad pirkėjas yra įmonė (true, 1, yes, company, business arba b2b). Klientai, sukurti iš tokių apmokėjimų, yra įmonės tipo partneriai; visi kiti yra fiziniai asmenys.

Išsaugokite šabloną.

4. Importuokite failą

Skiltyje Bank pasirinkite Stripe banko sąskaitą, šabloną ir failą, tuomet paspauskite Import. Mygtukas rodo sukinį (spinner), kol importavimas baigiasi; didelis failas gali užtrukti kelias minutes, nes sąskaitos faktūros išrašomos po vieną. Rezultatų eilutėje pateikiama, kiek operacijų buvo importuota, kiek jau egzistavo, kiek judėjimų buvo užregistruota ir kiek klientų, sąskaitų faktūrų bei kreditinių sąskaitų faktūrų buvo sukurta. Įspėjimuose pateikiami užsakymai, kurių nepavyko apdoroti, ir nurodymo priežastis.

Tą patį failą importuoti pakartotinai yra saugu: operacijos atpažįstamos pagal Stripe apmokėjimo ID, klientai – pagal el. paštą, užsakymai – pagal jų metaduomenų reikšmę.

5. Ką daro funkcija „Sukurti arba susieti sąskaitas faktūras“

Mokėjimai ir grąžinimai sugrupuojami pagal pasirinkto metaduomenų rakto reikšmę (užsakymo numerį).

• Jei pardavimo sąskaita faktūra šiai reikšmei jau egzistuoja (pardavimo užsakymas, kurio išorinė nuoroda yra ta reikšmė, arba sąskaita faktūra, kurios numeris yra ta reikšmė), mokėjimai suderinami su ja kaip įmokos.
• Priešingu atveju klientui sukurta pardavimo sąskaita faktūra: po vieną eilutę už kiekvieną mokėjimą, su mokesčio eilutės tekstu ir mokesčio suma kaip PVM įskaitančia kaina pagal šablono PVM tarifą, su pirmojo mokesčio data. Ji išrašoma ir užregistruojama nedelsiant, o mokėjimai suderinami su ja, todėl ji rodoma kaip apmokėta. Pardavimo užsakymas su kanalu stripe užregistruojamas su užsakymo numeriu, todėl kitas importas susies, o nesukurs naujo.
• Kiekvienas grupės grąžinimas tampa išrašyta kreditine sąskaita faktūra tai sąskaitai faktūrai grąžintai sumai, o grąžinimo operacija suderinama su ja.

Grupės be kliento el. pašto, su mokėjimais skirtingomis valiutomis arba kurių esama sąskaita faktūra vis dar yra juodraštis arba jau apmokėta, praleidžiamos ir įtraukiamos į įspėjimų sąrašą. Jų operacijos lieka nesuderintos skiltyje Bank → Transactions.

Sąskaitų faktūrų numeriai imami iš einamųjų metų serijos net tiems mokėjimams, kurių data yra ankstesniais metais, todėl istorinis importas nesusiduria su esamais numeriais.

6. Šablono apačioje esantys šeši pasirinktiniai laukai

Dauguma įmonių palieka visus šešis laukus tuščius, ir importavimas veikia lygiai taip pat. Jie egzistuoja tik dviem specifinėms situacijoms: norite kortelių rezervacijas apskaityti kaip dokumentus arba surenkate pinigus, kurie iš dalies priklauso kažkam kitam.

Kodėl išskleidžiamieji meniu atrodo tušti

Trys „operacijos tipo“ išskleidžiamieji meniu rodo operacijų tipus, kuriuos jūsų įmonė sukūrė skiltyje Account → Operation types. Jei nesukūrėte jokių, meniu bus tuščias. Tai nėra klaida; pirmiausia sukurkite operacijos tipą arba palikite lauką tuščią.

Išskleidžiamasis meniu Lender metadata field rodo metaduomenų stulpelių pavadinimus, kuriuos įvedėte aukščiau šioje pačioje formoje esančiame sąraše Metadata fields. Pirmiausia ten įtraukite metaduomenų lauką, ir jis pasirodys čia.

Dalinio grąžinimo etiketė ir Viso grąžinimo etiketė

Kai importuojant sukuriama kreditinė sąskaita faktūra grąžinimui, šie laukai nurodo žodį, spausdinamą tos kreditinės sąskaitos faktūros PDF viršuje.

Situacija	Naudojamas žodis	Numatytasis (default)
Grąžinimas yra mažesnis nei sąskaitos faktūros suma	Dalinio grąžinimo etiketė	DEPOZITAS
Grąžinimas lygus sąskaitos faktūros sumai	Viso grąžinimo etiketė	ANULIAVIMAS

Pakeiskite juos tik tuo atveju, jei jūsų įmonė ant tokių dokumentų spausdina kitus žodžius. Jie neturi įtakos numeracijai ir apskaitai.

Autorizavimo operacijos tipas

Kortelės autorizavimas – tai lėšos, rezervuotos klientų kortelėje, kurių dar neatsiėmėte. Stripe eksporte šios eilutės turi nustatytą lauką Captured reikšme false. Importavimas paprastai jas ignoruoja, nes pinigai nejudėjo.

Užpildykite šį lauką, ir kiekviena tokia eilutė taps išrašytu pardavimo dokumentu, naudojant šį operacijos tipą ir dokumentų seriją, į kurią tas operacijos tipas nurodo. Palikite jį tuščią, ir šios eilutės bus praleistos, o importavimo rezultatas rodys įspėjimą „authorization(s) skipped: template has no authorization operation type“.

Jei iš anksto nežinote, kad jūsų verslas privalo rodyti rezervacijas kaip dokumentus, palikite lauką tuščią.

Išmokėjimo operacijos tipas, Komisijos operacijos tipas ir Paskolos devizų metaduomenų laukas (Lender metadata field)

Visiškai praleiskite šią dalį, nebent jūsų verslas surenka pinigus, priklausančius kažkam kitam – prekyvietė (marketplace), mokanti pardavėjams, arba platforma, mokanti skolintojams. Įprasta parduotuvė šių laukų niekada neužpildo.

Stripe šią istoriją pateikia dviejuose failuose. Mokėjimų eksportas nurodo, ką sumokėjo kiekvienas klientas. Atskiras pervedimų eksportas nurodo, kiek iš to persiuntėte kitai šaliai. Importui reikia abu failus, kad būtų galima nustatyti, ką pasilikote.

Skiltyje Bank importavimo forma rodo failo lauką Stripe transfers export, kai egzistuoja bent vienas Stripe šablonas; ten šalia mokėjimų failo pasirinkite pervedimų failą. Per API tai yra laukas transfersCsv taške bank/statements/import.

Kai pateikiami abu failai:

Laukas	Ką jis daro
Payout operation type	Kiekvienam pervedimui kitai šaliai sukuriamas vienas didžiosios knygos įrašas pervestai sumai. Debeto ir kredito sąskaitos gaunamos iš šio operacijos tipo. Jei paliekama tuščia, įrašas naudoja pardavėjo kreditorių (seller-payable) ir tiekėjo kreditorių registravimo taisykles.
Commission operation type	Dalis, kurią pasiliekate, apskaičiuojama kaip mokesčio suma minus Stripe mokestis minus pervesta suma, ir įrašoma tik tada, kai ši reikšmė yra didesnė už nulį. Sąskaitos gaunamos iš šio operacijos tipo, priešingu atveju – iš pardavėjo kreditorių ir komisinių pajamų registravimo taisyklių.
Lender metadata field	Stripe metaduomenų stulpelio, kuriame nurodyta, kam atiteko pinigai, pavadinimas. Sukuriamas partneris su šia reikšme arba pakartotinai naudojamas esamas, ir jis priskiriamas abiems aukščiau nurodytiems įrašams. Jei paliekama tuščia arba eilutė neturi reikšmės, pateikiamas įspėjimas „lender not identified“, o įrašas sukuriamas be partnerio.

Jei abu operacijos tipo laukai yra tušti, pervedimo arba komisinių įrašai iš viso neįrašomi, nepaisant jokių kitų nustatymų.

7. Išmokos į jūsų banką

Mokėjimų eksportas neturi išmokų eilučių, todėl pinigai, kuriuos Stripe siunčia į jūsų tikrąjį banką, apskaitomi iš išmokų ataskaitos. Stripe valdymo skydelyje atidarykite Reports → Payouts → Payout reconciliation, itemized, atsisiųskite ją ir importuokite skiltyje Bank → Settlements į savo tikrąją banko sąskaitą, tuomet užregistruokite kiekvieną išmoką.

Kiekvienai išmokos eilutei, kurios mokestį, komisinį mokestį ar grąžinimą šis importavimas jau įkėlė į Stripe banko sąskaitą, registravimas perkelia eilutės grynąją sumą iš Stripe banko sąskaitos į tikrąją banko sąskaitą. Mokesčiai ir sąskaitų faktūrų apmokėjimai nėra apskaitomi antrą kartą. Eilutės, kurias Stripe išmokėjo, bet kurių šis importas niekada nematė, apskaitomos taip, kaip aprašyta skyriuje Banko ir mokėjimų importas.

Kiekviena išmokėta suma rodo Skirtumą nuo importuotų mokėjimų (Difference to imported payments): tai, ką išmoka perkelė, minus tai, ką Stripe banko sąskaita laikpo tiems pačiam mokėjimams ir grąžinimams. Nulis reiškia, kad išmoka išvalo Stripe sąskaitą. Eilutė su skirtumu arba su judėjimu Stripe sąskaitoje, kuri vis dar neužregistruota, įskaičiuojama į Tikrintinas eilutes (Lines to check). Mokėjimų eksportas saugo tik bendrą vieno mokėjimo grąžinimo sumą, todėl visos vieno mokėjimo grąžinimo eilutės lyginamos kartu su šia bendra suma.

Jei išmoka buvo užregistruota prieš importuojant mokėjimų failą, importavimas praleidžia tos išmokos mokėjimus, mokesčius ir grąžinimus bei nurodo ją įspėjimuose.

8. Kur ieškoti vėliau

• Bank → Transactions – kiekvienas importuotas judėjimas; suderinti judėjimai susiejami su sąskaita faktūra arba žurnalo įrašu.
• Invoices – sukurtos sąskaitos faktūros ir kreditinės sąskaitos faktūros, nurodant užsakymo numerį pastabose.
• Partners – sukurti klientai.
• Ledger → Journal – mokesčių, mokėjimų ir sąskaitų faktūrų įrašai.

Atsiskaitymas

Failai iki 10 MB ir 50 000 judėjimų. Kas 10 importuotų judėjimų skaičiuojami kaip viena API užklausa.