Nordlet

← Skjöl / Leiðbeiningar

Banka- og greiðsluinnflutningur

camt.053 yfirlit, Stripe CSV, uppgjör greiðslumiðla og sérsniðnir JSON straumar.

Allur innflutningur skilar sér sem bankafærslur á bankareikning (bank/accounts/create). Færslur bera externalIdkenni; það er öruggt að flytja sömu skrá inn aftur, en línum þar sem (bankAccountId, externalId) er þegar til er sleppt og þær eru skráðar í skipped telurann. Innfluttar færslur byrja í stöðunni new og eru bókaðar í fjárhagsbókina eingöngu þegar þær eru pörunarhæfar (bank/transactions/match, eða með bank/transactions/suggest-matches fyrir möguleg samsvörun).

Vefkerfið birtir sömu innflutningsleiðir undir Banki → Flytja inn skrá (skráarhlaða, sniðmátsval).

Rangri pörun er eytt út með bank/transactions/unmatch (Afturkalla pörun undir Banki → Færslur). Bókaðar færslur eru aldrei breyttar eða eitt út: greiðslu sem pöruð hefur verið við reikning, eða línu sem innflutningssniðmát bókaði á reikning, er skipt út fyrir endurgreiðslufærslu í dagbók með öllum færslum á gagnstæðari hlið, dagsettri á date (sjálfgefið: í dag, og aldrei á undan upprunalegu bókuninni). Greidd upphæð reikningsins og greiðslustaða fara til baka um upphæð þessrar bankalínu. Línu sem tengist uppgjöri greiðslumiðils er aðeins aftengd, þar sem uppgjörsbókunin tilheyrir lotunni. Línan fer aftur í stöðuna new og hægt er að para hana aftur. Afturköllunardagsetningin verður að vera innan opins bókhaldstímabils.

Innflutningssniðmát

Innflutningssniðmát tilgreinir gagnaheimild, telur upp þá reiti sem heimildin skilar og tengir reiti sem bera peninga við reikninga í fjárhagsbók. Sniðmát eru stjórnuð undir Banki → Innflutningssniðmát og í gegnum bank/import-templates/create|update|delete|get|list.

POST /v1/bank/import-templates/create
{
  "name": "Stripe payments export",
  "type": "stripe",
  "fields": [
    { "name": "id" },
    { "name": "Created date (UTC)" },
    { "name": "Amount" },
    { "name": "Fee", "accountCode": "6800" },
    { "name": "Amount Refunded" }
  ],
  "metaFields": ["order_id"]
}
  • type er annaðhvort stripe, iso20022, bank_connection eða revolut.
  • Hver reitur er með name og valfrjálst accountCode. Aðeins þeir reitir sem bera peninga taka við reikningi: Stripe Amount, Fee og Amount Refunded; camt.053 Ntry/Amt; bankastraumur transaction_amount.amount. Reikningurinn verður að vera til í lyklaskránni (búðu til hann með ledger/accounts/create).
  • Hægt er að sleppa fields; þá er sjálfgefið notaður staðlaður reitalisti fyrir tegundina: dálkanöfnin í Stripe Payments → Export skránni (án 19 Card … dálkanna, sem eyðublaðið skilur einnig eftir óvalda sjálfgefið), camt.053 einingarnar sem hvert yfirlit ber (Stmt/Id, Stmt/Acct/Id/IBAN, Stmt/Bal/…, Ntry/Amt, Ntry/CdtDbtInd, Ntry/Sts, Ntry/BookgDt), eða eiginleikana sem PSD2 bankastraumur skilar á hverja færslu. Bættu við eða fjarlægðu færslur til að passa við skrána þína: innflutningstækið les einnig valfrjálsu camt.053 einingarnar Ntry/ValDt, Ntry/NtryRef, Ntry/AcctSvcrRef, Ntry/AddtlNtryInf, TxDtls/Refs/EndToEndId, TxDtls/Refs/TxId, TxDtls/RltdPties/Dbtr/Nm, TxDtls/RltdPties/DbtrAcct/Id/IBAN, TxDtls/RltdPties/Cdtr/Nm, TxDtls/RltdPties/CdtrAcct/Id/IBAN, TxDtls/RmtInf/Ustrd og TxDtls/AddtlTxInf.
  • Stripe Customer Email reitur gæti borið "createPartner": true. Innflutningurinn býr þá til viðskiptavin (viðskiptaaðila af tegund einstaklings, merktan sem viðskiptavin) fyrir hvert netfang í skránni sem enginn fyrirliggjandi viðskiptaaðili er með, með því að nota Customer Description sem nafn (netfangið þegar það er tómt) og Card Address … dálkana sem vistfang þegar skráin inniheldur það. Fyrirliggjandi viðskiptaaðilar eru paraðir eftir netfangi, án tillits til hástafa og lágstafa. Svarið birtir fjöldann í customersCreated.
  • metaFields (aðeins fyrir Stripe) telur upp lýsigagnalyklana sem færslurnar þínar bera. Stripe flytur út hvern lykil sem <key> (metadata) dálk; listinn er frjáls og getur verið langur.
  • invoiceItemId (aðeins fyrir Stripe, valfrjálst) er vörulistarvara. Þegar það er virkt, vísar hver reiknings- og línukeyrsla sem innflutningurinn býr til í þá vöru (bókun hennar og, þegar invoiceVatRatePercent er tómt, virðisaukaskattshlutfall hennar); línutextinn kemur samt frá færslunni.
  • companyMetaField (aðeins fyrir Stripe) nefndir einn af þessum lyklum sem fyrirtækismerki. Þegar færsla ber true, 1, yes, company, business eða b2b í þeim dálki, er viðskiptavinurinn sem búaður er til fyrir hana viðskiptaaðili af tegund fyrirtækis í stað einstaklings.
  • invoiceMetaField (aðeins fyrir Stripe) nefndir einn af þessum lyklum, til dæmis pöntunarnúmer, og invoiceVatRatePercent virðisaukaskattshlutfallið fyrir reikninga sem búnir til eru úr honum. Við innflutning er hver færslu- og endurgreiðslulína flokkuð eftir gildi þessa lykils:
    • gildi sem passar við fyrirliggjandi sölureikning - sölupöntun þar sem externalRef er þetta gildi (ecommerce/orders/create, hvaða rás sem er) eða reikningur þar sem fullNumber er þetta gildi - tengir hópinn við þann reikning;
    • gildi án reiknings býr til einn: viðskiptavinur frá Customer Email (búinn til ef hann vantar, eins og fyrir createPartner), ein lína á hverja færslu (Checkout Line Item Summary eða Description sem texti, færsluupphæðin sem verð innifalinn VSK við invoiceVatRatePercent), útgáfudagur = fyrsti færsludagur, VSK meðferð frá fyrirtækinu og landi kortinu. Reikningurinn er gefinn út og bókaður í einu lagi, og sölupöntun með rásinni stripe og því gildi sem externalRef er skráð þannig að síðari innflutningur tengist í stað þess að búa til;
      • hver færsla í hópnum er síðan páruð við reikninginn sem greiðsla (bókar innborgunina); hver endurgreiðsla býr til útgefna kröfunótu á móti reikningnum fyrir endurgreissu upphæðinni og parar endurgreiðsluna við hann. Fjöldar koma til baka sem invoicesCreated, invoicesLinked, creditNotesCreated og paymentsMatched; hópar sem ekki hægt var að vinna úr (ekkert netfang viðskiptavinar, blandaðar gjaldmiðlar, tengdur reikningur sem er enn drög eða þegar að fullu greiddur) eru skráðir í warnings og skildir eftir sem new bankafærslur. Ekki varpa einnig Amount á reikning í fjárhagsbók í sama sniðmáti: færsla sem pöruð er við reikning er ekki bókuð öðru sinni, en óparuð færsla myndi gera það.
  • Nöfn sniðmáta eru einstök fyrir hvert fyrirtæki.
  • camt.053 og bankatenginga sniðmát bera sömu valkosti, lesnir úr yfirlitinu í stað Stripe dálka:
    • Búa til vantar viðskiptaaðila: createPartner á nafnalínu skuldareiknings (TxDtls/RltdPties/Dbtr/Nm, straumur debtor.name) býr til viðskiptavin fyrir hvern óþekktan greiðanda innkomandi peninga; á nafnalínu lánardrottins (TxDtls/RltdPties/Cdtr/Nm, straumur creditor.name) birgja fyrir hvern óþekktan viðtakanda útkomandi peninga. Viðskiptaaðilar eru þekktir eftir IBAN (vistað í partner_bank_accounts), síðan eftir nákvæmu nafni; nýr viðskiptaaðili er fyrirtæki þegar nafnið ber lagalegt form (UAB, MB, SIA, GmbH, Ltd, …), annars einstaklingur. Fjöldinn kemur til baka sem customersCreated (skráarinnflutningur) eða partnersCreated (straumsamstilling).
    • Tengja reikninga með tilvísun: invoiceMetaField stillt á skeytinga- eða tilvísunarlínu (TxDtls/RmtInf/Ustrd, TxDtls/RmtInf/Strd/CdtrRefInf/Ref, TxDtls/Refs/EndToEndId; straumur remittance_information, reference_number) parar hverja nýja bankalínu þar sem tilvísun, skeyting eða lýsing inniheldur númer opins útgefins sölureiknings (peningar inn) eða skráðs innkaupareiknings (peningar út), og bókar greiðsluna. Þegar IBAN greiðanda er vistað á viðskiptaaðila, eða nafn greiðanda jafngildir nafni eða kóða viðskiptaaðila, verður reikningurinn að tilheyra þeim viðskiptaaðila. Greiðsla frá óþekktum greiðanda er aðeins tengd þegar hún jafngildir eftirstöðvum reikningsins og reikningsnúmerið ber forskeyti sínu, þannig að stakt númer eins og upphæð er aldrei tekið sem tilvísun. Greiðsla sem er hærri en eftirstöðvarnar er aldrei tengd. Línur sem falla á þessum prófunum haldast nýjar fyrir handvirka pörun og eru skráðar í viðvaranirnar. Með advanceInvoices: true býr óparuð innkomandi greiðsla frá þekktum viðskiptaaðila til útgefinn forreikning (tegund advance) fyrir upphæðina á invoiceVatRatePercent eða invoiceItemId hlutfallinu og parar greiðsluna við hann; viðskiptaaðilinn verður að vera þekktur, svo hakaðu líka við skuldaralínuna.
    • Bókunarreglur eftir færslukóða: auk Ntry/Amt / transaction_amount.amount, er reitalistinn með reglulínur Ntry/BkTxCd=CHRG, =INTR, =TAXE, Ntry/CdtDbtInd=DBIT, =CRDT (straumur: bank_transaction_code=…, credit_debit_indicator=…). Lína er bókuð á reikning fyrstu reglunnar sem hún passar við: færslukóðaflokkur hennar, síðan stefna hennar, og að lokum hinu einfalda upphæðarröð. Reglur raða eru ekki athugaðar gagnvart skránni.
    • Bankakostnaður viðskiptaaðili: createPartner á …=CHRG reglulínunni býr til birgja sem heitir eftir bankanum (yfirlit Stmt/Acct/Svcr/FinInstnId/Nm, eða banki tengingarinnar, eða nafn bankareiknings í fjárhagsbók) og færir hverja færslu á þann viðskiptaaðila.
    • Bankatengingasniðmát eru valin fyrir hvern straumreikning með bank/feeds/accounts/configure (Banki → Tengingar í appinu), sem stillir einnig syncSchedule (manual, daily, weekly, monthly): API-ið samstillir reikninga með áætlun sjálfkrafa þegar tímabil þeirra er liðið. Sniðmát eru beitt á hverja bank/feeds/sync; samstillingarsvarið skilar þá einnig posted, partnersCreated, invoicesLinked, invoicesCreated, paymentsMatched og warnings.

Sendu templateId til bank/statements/import í stað format: tegund sniðmátsins velur þáttarann, og skráin verður að innihalda hvern einasta reikning sem talinn er upp í sniðmátinu - skrá sem vantar einhvern þeirra er hafnað með HTTP 422 og nöfnum dálka eða eininga sem vantar. Lýsigagnareitir þurfa ekki að vera til staðar. Bankatengingasniðmát lýsa lifandi PSD2 straumi og er ekki hægt að nota til skráarinnflutnings.

ISO 20022 sniðmát les einnig MT940 skrár: skrá sem byrjar á {1: eða :20: (eða er send með "format": "mt940") er þáttuð sem MT940 og tilvísunarpörun og bókunarreglur sniðmátsins eru beittar á línur þess. Einingaprófun er sleppt fyrir MT940, og Ntry/BkTxCd=… reglur eiga aldrei við um MT940 línur vegna þess að MT940 ber engan ISO 20022 bankafærslukóða; notaðu Ntry/CdtDbtInd=… reglurnar í staðinn.

Bankareikningur heldur utan um einn gjaldmiðil. Yfirliti í öðrum gjaldmiðli er hafnað með HTTP 422 (í camt.053 skrá með yfirlitum í nokkrum gjaldmiðlum fyrir sama IBAN, er aðeins yfirlitið í gjaldmiðli reikningsins flutt inn), og hið sama á við um línu sem send er til bank/transactions/import með öðrum currency en gjaldmiðli reikningsins.

Hver hreyfing sem verður til úr reit sem er með accountCode er bókuð við innflutning sem ein dagbókarfærslu: peningar inn skuldfæra bankareikning fjárhagsbókarinnar og kreditfæra tengda reikninginn; peningar út skuldfæra tengda reikninginn og kreditfæra bankareikning fjárhagsbókarinnar. Upphæðir eru umreiknaðar í grunngjaldmiðil á hreyfingardegi. Bankafærslan er því matched við þá dagbókarfærslu (matchedDocumentType = journal_transaction) og er ekki lengur boðin til pörunar við reikninga. Svarið birtir fjöldann í posted. Hreyfingar úr ótengdum reitum haldast new og eru paraðar við reikninga eins og áður - til dæmis að tengja Fee við kostnaðarreikning PSP gjalds og skilja Amount eftir ótengt þannig að færslur séu enn paraðar við sölureikninga.

POST /v1/bank/statements/import
{
  "bankAccountId": "…",
  "templateId": "…",
  "content": "id,Created date (UTC),Amount,…"
}

ISO 20022 camt.053 (opinn bankaþjónusta XML)

Litháískir bankar (Swedbank, SEB, Luminor, Šiaulių bankas, …) leyfa þér að hlaða niður reikningsyfirlitum sem ISO 20022 camt.053 XML úr netbanka þeirra - venjulega undir útflutningi/niðurhali yfirlita, sniðinu "ISO XML" eða "camt.053". Sama sniði skila PSD2 reikningsupplýsinga-API-um.

POST /v1/bank/statements/import
{
  "bankAccountId": "…",
  "format": "camt053",
  "content": "<?xml version=\"1.0\"…>…"
}
  • Skrá getur innihaldið nokkur yfirlit; IBAN hvers yfirlits verður að passa við IBAN bankareikningsins (yfirlit án IBAN, eða reikningar án eins, eru samþykktir eins og þeir eru).
  • Færslutilvísanir (AcctSvcrRef/NtryRef, með fallback í efnishurkunarhash) verða að externalId.
  • Svarið endurómar lýsigögn per yfirlit: auðkenni yfirlits, tímabil, opnunar-/lokastöður, fjölda færslna.
  • Nafn gagnaðila, IBAN og tilgangur greiðslu eru dregnir út per færslu til pörunar.

Greiðslum í hina áttina er flutt út sem pain.001 í gegnum bank/payments/export.

Revolut Business CSV

Hladdu niður færsluyfirliti Revolut Business reiknings sem CSV og flyttu það inn með innbyggða sniðmátinu Revolut Business (templateId: "builtin-revolut"). Hvert fyrirtæki er með þetta sniðmát án þess að þurfa að búa það til: bank/import-templates/list-builtin telur það upp, bank/import-templates/get skilar því, og bank/import-templates/update og bank/import-templates/delete hafna því með HTTP 400. Í appinu er það talið upp fyrst undir Banki → Innflutningssniðmát; að opna það sýnir stillingar þess, og vistun býr til þitt eigið fyrirtækissniðmát sem þú getur breytt.

POST /v1/bank/statements/import
{
  "bankAccountId": "…",
  "templateId": "builtin-revolut",
  "content": "Date started (UTC),Date completed (UTC),ID,Type,State,…"
}
  • Aðeins línur þar sem State = COMPLETED eru fluttar inn. Aðrar línur (til dæmis PENDING) eru skildar eftir og taldar í warnings; þær eru fluttar inn með síðari innflutningi á skrá þar sem þær eru lokið.
  • Hver lína verður að bankafærslu með dagsetningu frá Date completed (UTC), upphæð frá Total amount, gjaldmiðli frá Payment currency, ID sem externalId og Description sem lýsingu.
  • Gagnataki peninga út er Beneficiary name og Beneficiary IBAN; fyrir kortagreiðslu án viðtakanda, söluaðilinn í Description. Gagnataki peninga inn er Sender name og Sender account.
  • Línur eru flokkaðar eftir reikningi og gjaldmiðli. International account number verður að passa við IBAN bankareikningsins, og aðeins línur í gjaldmiðli bankareikningsins eru fluttar inn.
  • Fyrir hverja línu athugar innflutningstækið að staða fyrri línu ásamt Total amount jafngildi Balance, og skráir hverja línu þar sem hún gerir það ekki í warnings.
  • Skráin verður að innihalda dálkana Date completed (UTC), ID, Type, State, Description, Payment currency, Total amount, Reference, Sender name og Beneficiary name.

Við hvern innflutning gerir innbyggða sniðmátið eftirfarandi:

  • býr til viðskiptavin fyrir hvern óþekktan sendanda peninga inn, og birgja fyrir hvern óþekktan viðtakanda eða kortsöluaðila peninga út, eins og Búa til vantar viðskiptaaðila lýsir hér að ofan;

  • parar hverja línu þar sem Reference eða Description inniheldur númer opins sölu- eða innkaupareiknings, og bókar greiðsluna, með prófunum á Tengja reikninga með tilvísun hér að ofan;

  • bókar línurnar sem enginn reikningur passaði við samkvæmt Type þeirra, á reikning bókunarreglu:

    Type Bókunarregla Sjálfgefinn reikningur Rúmensk lyklaskrá Bókun
    FEE bank.fees 6800 627 skuldfæra reikning reglunnar, kreditfæra bankareikning fjárhagsbókarinnar; viðskiptaaðili: birgir sem heitir eftir bankareikningnum
    CARD_PAYMENT bank.cardPayments 6209 628 skuldfæra reikning reglunnar, kreditfæra bankareikning fjárhagsbókarinnar, án VSK
    TOPUP bank.topUps 3010 1012 skuldfæra bankareikning fjárhagsbókarinnar, kreditfæra reikning reglunnar

    Línur af öðrum gerðum, svo sem TRANSFER, haldast new til pörunar.

Breyttu reikningunum með ledger/posting-rules/update; innbyggða sniðmátið notar nýju reikningana frá og með næsta innflutningi. Ekki er hægt að slökkva á bókunarreglu: til að flytja inn kortagreiðslur eða áfyllingar án þess að bóka þær, skaltu búa til fyrirtækissniðmát af tegund revolut án Type=CARD_PAYMENT eða Type=TOPUP lírunnar og flytja inn með því. Kortagreiðsla sem bókuð er á þennan hátt er ekki pöruð við reikning birgjans þegar sá reikningur er skráður síðar; bókaðu annan hvorn þeirra, en ekki báða.

Fyrirtækissniðmát af tegund revolut notar sömu dálka og getur bókað línur eftir tegund með reglulínunum Type=FEE, Type=CARD_PAYMENT, Type=TRANSFER og Type=TOPUP. Innflutningur með "format": "revolut-csv" og engu sniðmáti flytur línurnar inn án nokkurs af þessum skrefum.

Stripe CSV

Útflutningur úr Stripe mælaborðinu - hvort sem er skýrsla virkar:

  • Reports → Balance → Itemized balance change from activity (mælt með): dálkar balance_transaction_id, created_utc, currency, gross, fee, net, reporting_category, description.
  • Payments → Export: dálkar id, Created (UTC), Amount, Fee, Currency, Description, Customer Description.
POST /v1/bank/statements/import
{
  "bankAccountId": "…",
  "format": "stripe-csv",
  "content": "balance_transaction_id,created_utc,currency,gross,fee,net,…"
}

Búðu til sérstakan bankareikning fyrir Stripe (t.d. með nafninu "Stripe", GL reikning 2710 eða sinn eigin undirreikning) - Stripe staðan hegðar sér eins og bankareikningur: færslur flæða inn, gjöld eru dregin frá, útborganir flytja stöðuna yfir á raunverulegan bankareikning þinn.

Hegðun við innflutning:

  • Hver jöfnunarfærsla verður að einni bankafærslu fyrir bruttó upphæðina (externalId = auðkenni jöfnunarfærslu).
  • Non-zero fee (gjald) verður að annarri færslu með gagnstæðu merki (externalId = <id>:fee, gagnataki "Stripe") - þannig að hægt er að para/bóka gjöld sem kostnað aðskilið frá tekjum. Gjöld sem endurgreidd eru á endurgreiðslum koma inn sem jákvæðar upphæðir.
  • Payout línur (útborganir) flytjast inn sem stakar neikvæðar færslur; paraðu þær á móti samsvarandi innkomandi færslu á yfirliti raunverulega bankareiknings þíns.
  • Línum með núllupphæð er sleppt; dagsetningin er tekin úr created_utc (UTC).
  • Útflutningslínur greiðslna sem hreyfðu engum peningum er sleppt: Captured = false (heimildir/seinkaðar tökur) og Status Failed/Canceled.
  • Non-zero Amount Refunded (endurgreidd upphæð) verður að þriðju, neikvæðu færslunni (externalId = <id>:refund) dagsettri á Refunded date (UTC) - þannig að hluta- og algerar endurgreiðslur innfelldar í færslulínum glatast ekki.

Uppgjör greiðslumiðla (Stripe útborgunarskýrslur)

Til að skipta upp heildarútborgun í undirliggjandi pantanir, endurgreiðslur, gjöld og endurgreiðslukröfur, skaltu nota uppgjörsendapunktana í stað hins einfalda yfirlitsinnflutnings. Tveimur Stripe útflutningum er tekið við (greindir sjálfkrafa):

  • Reports → Payouts → Payout reconciliation, itemized (skýrslugerðir payout_reconciliation.itemized.* eða payout_reconciliation.by_id.itemized.*) - nákvæmt, ein lína á hverja jöfnunarfærslu; æskilegt á virkum reikningum.
  • Payments → Export (unified payments) - útflutningur á færslustigi; virkar í prófunar-/sandkassaumhverfi þar sem útborgunaruppgjör er ekki tiltækt. Tæknar færslur eru flokkaðar eftir útborgunarauðkenni í Transfer dálknum; óteknar/fallaðar línur eru skildar eftir (skippedNotSettled); non-zero Amount Refunded verður að tilbúinni endurgreiðslulínu í útborgunarlotu færslunnar - áætlanagerð, þar sem endurgreiðslan gæti í raun hafa verið uppgerð í síðari útborgun. Pörunartilvísanir koma frá færsluauðkenni, PaymentIntent ID, Invoice Number, Client Reference ID og hverjum … (metadata) dálki (t.d. pöntunarnúmeri í lýsigögnum).

Ein CSV skrá getur náð yfir margar útborganir. Stripe hleður niður liðskiptu skýrslunni ein skrá á hvern hluta (…_charge_…, …_refund_…, …_fee_…); flyttu þær allar inn - línur fyrir þegar innflutta útborgun renna saman við fyrirliggjandi lotu (skráð í updated telurann) svo lengi sem hún hefur ekki verið bókuð enn, og heildartölur lotunnar eru endurreiknaðar.

POST /v1/bank/settlements/import
{
  "bankAccountId": "…",
  "provider": "stripe",
  "content": "balance_transaction_id,created_utc,…,reporting_category,…,automatic_payout_id,…"
}

Hegðun við innflutning:

  • Línum er raðað saman eftir automatic_payout_id í uppgjörslotur - ein lota á útborgun, með bruttó-/gjald-/nettó tölum (summa línu net = upphæðin sem kemur inn á bankann þinn). Endurinnflutningur á útborgun er sleppt (skipped teljari). Línum sem ekki hefur enn verið úthlutað á útborgun og payout línunum sjálfum er sleppt og þær taldar sérstaklega.
  • Hver færslu-/endurgreiðslu-/ágreininglíni er sjálfkrafa pöruð við sölureikning með því að nota, í þessari röð: externalRef raftrænnar pöntunar (hvaða gildi sem er úr order_id, payment_intent_id, source_id, charge_id eða hvaða *_metadata[...] dálki sem er), reiknings fullNumber sem birtist í þeim dálkum, og - fyrir endurgreiðslur og ágreining - charge_id á áður paraðri færslu (sömu skrá eða fyrri innflutningi).
  • Farðu yfir með bank/settlements/list / bank/settlements/get; lagaðu afganga með bank/settlements/match { lineId, invoiceId } (eða invoiceId: null til að aftengja pörun).

POST /v1/bank/settlements/post { id, date?, commissionPercent? } bókar alla lotuna sem eina jafnaða dagbókarfærslu og gerir upp pörðu reikningana (paidAmount/paymentStatus, sale_invoice.paid vefslóðir):

  • Skuldfærðu GL bankareikningsins fyrir nettó útborguninni; skuldfærðu PSP gjöld (settlements.fees, sjálfgefið 6800) fyrir afturkölluð gjöld og gjaldalínur.
  • Kreditfærðu viðskiptakröfur per páruð færslu; endurgreiðslur og ágreiningur snúa því við. Notkun er hámarkuð við eftirstöðvar hvers reiknings - allt sem umfram er lendir á biðreikningi með viðvörun.
  • Óparaðar færslur: með commissionPercent stillt er þeim skipt í tekjur af þóknun (settlements.commissionRevenue, sjálfgefið 5001) og seljandaábyrgð (settlements.sellerPayable, sjálfgefið 4499) - markaðstorgsflæðið þar sem innheimtir peningar eiga að mestu leyti við um seljendur. Án þess er þeim lagt í bígerð á settlements.suspense (sjálfgefið 4440, mótteknar fyrirframgreiðslur).
  • platform_earning línur (Stripe Connect umsóknargjöld) bóka á þóknunartekjur; transfer línur (útborganir til tengdra seljenda) minnka seljandaábyrgðina.
  • Hægt er að yfirskrifa alla fjóra reikningana per fyrirtæki í gegnum bókunarreglur (ledger/posting-rules).
  • Lína þar sem færslu, gjaldi eða endurgreiðslu var þegar flutt inn á annan bankareikning úr Stripe greiðsluútflutningi (bank/statements/import) er ekki færð á gjöld, kröfur eða biðreikning. net hennar er í staðinn kreditfært á fjárhagsreikning þess bankareiknings, þannig að Stripe bankareikningurinn gerir upp útborgun eftir útborgun. summary.clearedAmount er heildin sem færð var á þennan hátt; lína þar sem upphæð er frábrugðin því sem sá reikningur heldur um er nefnd í warnings. Ef ekkert er eftir til bókunar er lotunni lokað með journalTransactionId sem null.

bank/settlements/list og /get skila, per lotu, clearedNet, clearingDifference (útborgunarlínur að frádregnum upphæðum sem hinn bankareikningurinn heldur um fyrir þær; núll þegar þær eru sammála) og clearingOpenCount (línur með mismun eða óbókaðri hreyfingu); /get skilar því sama per línu og clearingBankAccountId, clearingBooked, clearingDifference og clearingUnposted. Endurgreiðslulínur einnar færslu eru bornar saman í sameiningu, þar sem greiðsluútflutningurinn heldur aðeins utan um endurgreiddu heildina. Stripe greiðsluútflutningur sem fluttur er inn eftir að útborgun hans var bókuð sleppir hreyfingum þeirrar útborgunar og nefnir hana í warnings.

VSK af þóknuninni sjálfri er reikningslagður sérstaklega (gefðu út þóknunarreikning á seljandann); skiptingin úthlutar aðeins innheimtu reiðufé.

Útborganir í öðrum gjaldmiðli

Dagbókin er alltaf skrifuð í grunngjaldmiðli fyrirtækisins, en útborgun í öðrum gjaldmiðli bókast sjálfkrafa - engin handvirk færsla er nauðsynleg:

  • Lotan umreiknar á gengi fyrir bókunardaginn (date, með fallback á útborgunardaginn, síðan í dag). Gengið er eigin gengi fyrirtækisins fyrir þann gjaldmiðil (reference/exchange-rates/set) þegar það er að minnsta kosti jafn nýlegt og hið opinbera, annars síðasta opinbera gengi á eða fyrir þann dag. Ef ekkert gengi er til staðar á eða fyrir daginn mistakast kallið með 422 og nefnir reference/exchange-rates/sync.
  • Hver reikningur umreiknar á því lotugengi fyrir utanaðkomandi viðskiptakröfur, sem eru léttar á því fxRate sem hver reikningur var gefinn út á. Mismunurinn á milli genganna tveggja bókast á bank.fxGain (sjálfgefið 5803) eða bank.fxLoss (sjálfgefið 6803) sem raunverulegur gengismunur, þannig að dagbókin jafnar sig samt sem áður.
  • Svarið summary skilar fxRate sem notað var og tilheyrandi exchangeDifference, og lotan heldur genginu sem hún var bókuð á. Pöruðum reikningi þar sem eigin gjaldmiðill er frábrugðinn gjaldmiðli lotunnar er ekki lokið: upphæð hans fer á biðreikninginn með viðvörun.
  • Ein innflutningstakmörkun stendur eftir: stakri útborgun þar sem línur blanda saman nokkrum gjaldmiðlum er hafnað með 422, rétt eins og endurinnflutningi þar sem gjaldmiðill er frábrugðinn lotunni sem þegar er vistuð fyrir þá útborgun.

Handvirkir / sérsniðnir straumar

Hvað sem er annað er hægt að senda inn sem einfaldan JSON:

POST /v1/bank/transactions/import
{
  "bankAccountId": "…",
  "transactions": [
    { "date": "2026-07-01", "amount": "-25.00", "currency": "EUR",
      "counterpartyName": "…", "description": "…", "externalId": "unique-ref-1" }
  ]
}

Gefðu upp stöðugt externalId per færslu til að halda endurinnflutningi sjálfsafgreiðandi (idempotent).