Importavimas iš Stripe

Šiame vadove aprašomas Stripe mokėjimų failo importavimas naudojant importavimo šabloną: ką eksportuoti, kaip nustatyti šabloną ir ką šis importavimas sukuria. API išsamią informaciją rasite skyriuje Banko ir mokėjimų importavimas.

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

Stripe valdymo pulte atidarykite Payments → Export, pasirinkite datų rėžį, palikite All columns ir įtraukite naudojamus metaduomenų stulpelius (Stripe kiekvieną metaduomenų raktą eksportuoja kaip stulpelį, pavadintą <key> (metadata), pavyzdžiui, orderNo (metadata)). Atsisiųskite CSV failą. Veikia ir realios aplinkos (live), ir testavimo režimo eksportas.

Eilutės, kuriose nebuvo pinigų judėjimo, importuojant yra praleidžiamos: mokėjimų bandymai, kurie nepavyko, buvo atšaukti arba vis dar reikalauja mokėjimo būdo, ir nuskaitymai (charges), kurie niekada nebuvo patvirtinti (captured).

2. Sukurkite banko sąskaitą Stripe sistemai

Kiekvienas importas patenka į banko sąskaitą. Sukurkite ją skiltyje Bankas ir pavadinkite, pavyzdžiui, „Stripe“, ta valiuta, kuria vykdote nuskaitymus. Stripe likutis veikia kaip banko sąskaita: nuskaitymai patenka į ją, komisiniai mokesčiai (fees) nuskaičiuojami, o išmokėjimai (payouts) perkelia likutį į jūsų tikrąjį banką.

3. Sukurkite importavimo šabloną

Skiltyje Bankas → Importavimo šablonai paspauskite Naujas importavimo šablonas, pasirinkite tipą Stripe ir suteikite jam pavadinimą.

Laukai. Kiekvienas Stripe eksporto stulpelis yra eilutė. Laukas Būtina faile reiškia, kad stulpelis turi būti įkeltame faile; failas, kuriame trūksta būtino stulpelio, yra atmetamas ir parodomi trūkstami pavadinimai. Pagal numatytuosius nustatymus 19 Card … stulpelių yra nepažymėti, nes kai kurioms paskyroms Stripe juos praleidžia.

Didžiosios knygos sąskaita. Eilutės, kuriose nurodyti pinigai — Amount, Fee, Amount Refunded — gali būti priskirtos didžiosios knygos sąskaitai (ledger account): jau esamai arba naujai, sukurtai iš tos pačios eilutės. Kiekvienas judėjimas, sukurtas iš priskirto lauko, yra užregistruojamas (posted) importavimo metu: gaunami pinigai debetuoja Stripe banko sąskaitą ir kredituoja priskirtą sąskaitą, o išleidžiami pinigai daro atvirkščiai, ir banko operacija (transaction) pažymima kaip susieta (matched) su tuo dvejybiniu įrašu (journal entry). Įprasta sąranka yra tokia:

Laukas	Sąskaita	Poveikis
Fee	mokėjimų paslaugų teikėjo (PSP) komisinių sąnaudų sąskaita (6800 standartiniame sąskaitų plane)	Kiekvienas Stripe komisinis mokestis užregistruojamas kaip sąnaudos
Amount	palikite „Neregistruota“	Nuskaitymai lieka atviri susiejimui su sąskaita faktūra (žr. 5 veiksmą)
Amount Refunded	palikite „Neregistruota“	Grąžinimai (refunds) apdorojami naudojant kreditines sąskaitas faktūras (žr. 5 veiksmą)

Sukurti trūkstamus pirkėjus. Pažymėkite tai eilutėje Customer Email. Kiekvienam faile esančiam el. pašto adresui, kurio dar neturi joks partneris, sukuriamas pirkėjas: pavadinimas imamas iš Customer Description (jei tuščia, naudojamas el. paštas), adresas — iš Card Address … stulpelių, jei jie yra. Esami partneriai atpažįstami pagal el. pašto adresą neatsižvelgiant į raidžių registrą, todėl niekas nesukuriama du kartus.

Sukurti partnerį Stripe. Pažymėkite tai eilutėje Fee. Importavimo metu vieną kartą sukuriamas tiekėjas-partneris pavadinimu Stripe (jei partneris tokiu pavadinimu jau yra, jis panaudojamas iš naujo), ir kiekvienas komisinio mokesčio įrašas užregistruojamas nurodant Stripe kaip partnerį, todėl mokesčių įrašuose matosi, kam buvo sumokėta.

Metaduomenų laukai. Pridėkite po vieną eilutę kiekvienam metaduomenų raktui, kurį norite, kad importas nuskaitytų, pavyzdžiui, orderNo. Šiose eilutėse galima nustatyti dvi žymas (flags):

• Sukurti arba susieti sąskaitas faktūras — pažymi raktą, identifikuojantį užsakymą (5 veiksmas). Jį gali turėti tik viena eilutė. Šalia jos atsiranda PVM tarifas kuriamoms sąskaitoms faktūroms ir neprivaloma Katalogo prekė: ją pasirinkus, kiekviena importo sukuriama sąskaitos faktūros eilutė nurodys šią prekę ar paslaugą, todėl pajamos bus užregistruotos į prekės sąskaitą; eilutės tekstas vis tiek bus imamas iš nuskaitymo.
• Įmonės žyma — pažymi raktą, kurio reikšmė nurodo, kad pirkėjas yra įmonė (true, 1, yes, company, business arba b2b). Iš tokių nuskaitymų sukurti pirkėjai yra įmonės tipo partneriai; visi kiti yra fiziniai asmenys.

Išsaugokite šabloną.

4. Importuokite failą

Skiltyje Bankas pasirinkite Stripe banko sąskaitą, šabloną bei failą ir paspauskite Importuoti. Mygtuke bus rodomas sukimosi indikatorius (spinner), kol importavimas bus baigtas; didelio failo apdorojimas gali užtrukti kelias minutes, nes sąskaitos faktūros išrašomos po vieną. Rezultatų eilutėje pateikiama ataskaita, kiek operacijų buvo importuota, kiek jau egzistavo, kiek pinigų judėjimų buvo užregistruota ir kiek pirkėjų, sąskaitų faktūrų bei kreditinių sąskaitų faktūrų buvo sukurta. Įspėjimuose išvardijami užsakymai, kurių nepavyko apdoroti, ir nurodomos priežastys.

Importuoti tą patį failą dar kartą yra saugu: operacijos atpažįstamos pagal Stripe nuskaitymo ID, pirkėjai – pagal el. paštą, užsakymai – pagal jų metaduomenų reikšmę.

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

Nuskaitymai ir grąžinimai grupuojami pagal pasirinkto metaduomenų rakto (užsakymo numerio) reikšmę.

• Jei pardavimo sąskaita faktūra su šia reikšme jau egzistuoja — pardavimo užsakymas (sales order), kurio išorinė nuoroda yra ši reikšmė, arba sąskaita faktūra, kurios numeris yra ši reikšmė — nuskaitymai susiejami su ja kaip mokėjimai.
• Priešingu atveju pirkėjui sukuriama pardavimo sąskaita faktūra: po vieną eilutę kiekvienam nuskaitymui, su nuskaitymo eilutės tekstu ir nuskaityta suma kaip kaina su PVM, taikant šablono PVM tarifą, o data nustatoma pagal pirmojo nuskaitymo datą. Ji nedelsiant išrašoma ir užregistruojama, o nuskaitymai susiejami su ja, todėl ji rodoma kaip apmokėta. Pardavimo užsakymas su kanalu stripe įrašomas kartu su užsakymo numeriu, todėl kito importavimo metu sistema ne kuria naują, o susieja su esamu įrašu.
• Kiekvienas grąžinimas grupėje tampa išrašyta kreditine sąskaita faktūra tai pradinei sąskaitai faktūrai su grąžinama suma, o grąžinimo operacija susiejama su ja.

Grupės be pirkėjo el. pašto, su nuskaitymais skirtingomis valiutomis, ar kurių esama sąskaita faktūra vis dar yra juodraštis arba jau apmokėta, yra praleidžiamos ir pateikiamos įspėjimuose. Jų operacijos lieka nesusietos skiltyje Bankas → Operacijos.

Sąskaitų faktūrų numeriai imami iš einamųjų metų serijos net ir ankstesnių metų datų nuskaitymams, todėl istoriniai importai nesusiduria su esamais numeriais.

6. Kur ieškoti vėliau

• Bankas → Operacijos — visi importuoti pinigų judėjimai; susietieji nukreipia į sąskaitą faktūrą arba dvejybinį įrašą.
• Sąskaitos faktūros — sukurtos sąskaitos faktūros ir kreditinės sąskaitos faktūros su užsakymo numeriu pastabose.
• Partneriai — sukurti pirkėjai.
• Didžioji knyga → Žurnalas — komisinių mokesčių, mokėjimų ir sąskaitų faktūrų užregistruoti įrašai.

Atsiskaitymas

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