Nordlet

← Bunúsanna / SDKanna

Iompórtáil bhainc agus íocaíochtaí

Ráitis camt.053, CSV ó Stripe, réiteach socruithe PSP agus fothaí saincheaptha JSON.

Titeann gach iompórtáil isteach mar idirbheairt bhainc ar chuntas bainc (bank/accounts/create). Bíonn externalId ag gach idirbheairt; tá sé sábháilte an comhad céanna a iompórtáil arís – scipeáiltear rónna a bhfuil a n-aimsiú (bankAccountId, externalId) ann cheana féin agus tuairiscítear iad sa áiritheoir skipped. Tosaíonn idirbheairtí iompórtáilte leis an stádas new agus ní phostáiltear chuig an leabhar mór iad ach nuair a dhéantar iad a mheaitseáil (bank/transactions/match, agus úsáidtear bank/transactions/suggest-matches do na hiarrthóirí).

Nochtann an aip ghréasáin na hiompórtálacha céanna faoi Banc → Iompórtáil comhad (uaslódáil comhaid, roghnóir teimpléid).

Déantar neamhshuim de mheaitseáil mhícheart le bank/transactions/unmatch (Díchur meaitseála faoi Banc → Idirbheairtí). Ní chuirtear in eagar ná ní scriostar iontrálacha postáilte choíche: faigheann íocaíocht a mheaitseáiltear le sonrasc, nó líne a phostáil teimpléad iompórtála chuig aontas, idirbheairt irise fritháirithe le gach iontráil ar an taobh eile, agus an dáta socraithe mar date (réamhshocrú: inniu, agus gan a bheith níos luaithe ná an postáil bhunaidh). Téann méid íoctha an tsonraisc agus an stádas íocaíochta ar ais de réir mhéid na líne bainc sin. Ní dhéantar ach an nasc a dhíchur i gcás líne a nascվում le socrutas soláthraí íocaíochta, toisc gurb leis an mbaisc an postáil socruithe. Filleann an líne ar an stádas new agus is féidir í a mheaitseáil arís. Caithfidh dáta an fhritháirithe a bheith laistigh de thréimhse chuntasaíochta oscailte.

Teimpléid iompórtála

Sonraíonn teimpléad iompórtála foinse sonraí, liostaíonn sé na réimsí a sholáthraíonn an fhoinse, agus mapálann sé na réimsí a iompraíonn airgead chuig cuntais an leabhair mhóir. Bainistítear teimpléid faoi Banc → Teimpléid iompórtála agus trí 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"]
}
  • Is éard atá in type ná ceann de stripe, iso20022, bank_connection nó revolut.
  • Tá name agus accountCode roghnach ag gach réimse. Ní ghlacann ach na réimsí a iompraíonn airgead le cuntas: Amount, Fee agus Amount Refunded ó Stripe; Ntry/Amt ó camt.053; transaction_amount.amount ó fotha an bhainc. Caithfidh an cuntas a bheith ann sa tsraith cuntas (cruthaigh é le ledger/accounts/create).
  • Féadfar fields a fhágáil ar lár; ansin réamhshocraítear é go dtí an liosta réimsí caighdeánach den chineál: ainmneacha colúin an chomhaid Payments → Export ó Stripe (gan na 19 gcolún Card …, a fhágann an fhoirm gan tic freisin de réir réamhshocraithe), na gnéithe camt.053 a iompraíonn gach ráiteas (Stmt/Id, Stmt/Acct/Id/IBAN, Stmt/Bal/…, Ntry/Amt, Ntry/CdtDbtInd, Ntry/Sts, Ntry/BookgDt), nó na tréithe a thugann fotha bainc PSD2 ar ais in aghaidh an idirbheairt. Cuir isteach nó baint as eintirí chun do chomhad a mheaitseáil: léann an t-iompórtálaí freisin na gnéithe roghnacha camt.053 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 agus TxDtls/AddtlTxInf.
  • Féadfaidh réimse Customer Email ó Stripe "createPartner": true a iompar. Cruthaíonn an t-iompórtáil ansin custaiméir (comhpháirtí den chineál duine, marcáilte mar chustaiméir) do gach ríomhphost sa chomhad nach bhfuil ag aon chomhpháirtí atá ann cheana, ag baint úsáide as Customer Description mar an t-ainm (an ríomhphost nuair a bhíonn sé báite) agus na colúin Card Address … mar an seoladh nuair a bhíonn siad sa chomhad. Déantar comhpháirtithe atá ann cheana a mheaitseáil de réir ríomhphoist, gan aird ar chás litreach. Tuairiscíonn an freagra an líon in customersCreated.
  • Liostaíonn metaFields (Stripe amháin) na eochracha meiteashonraí a iompraíonn do mhuirir. Eicsportálann Stripe gach eochair mar cholún <key> (metadata); is liosta saor-fhoirme é agus is féidir leis a bheith fada.
  • Is mír chatalóige é invoiceItemId (Stripe amháin, roghnach). Nuair a shocraítear é, tagraíonn gach líne sonrasc agus nóta creidmheasa a chruthaíonn an t-iompórtáil don mhír sin (a phostáil agus, nuair a bhíonn invoiceVatRatePercent folamh, a ráta CBL); tagann téacs na líne ón muirear fós.
  • Ainmníonn companyMetaField (Stripe amháin) ceann de na eochracha sin mar an bhratach chuideachta. Nuair a iompraíonn muirear true, 1, yes, company, business nó b2b sa cholún sin, is comhpháirtí den chineál cuideachta seachas duine an custaiméir a cruthaíodh dó.
  • Ainmníonn invoiceMetaField (Stripe amháin) ceann de na eochracha sin, mar shampla uimhir ordaithe, agus invoiceVatRatePercent ráta CBL na sonrasc a chruthófar uaidh. Ar an iompórtáil, déantar gach rón muirir agus aisíocaíochta a ghrúpáil de réir luach na heochrach sin:
    • déantar grúpa a nascadh le sonrasc díolacháin atá ann cheana – ordú díolacháin a bhfuil a externalRef mar luach den sórt sin (ecommerce/orders/create, aon chainéal) nó sonrasc a bhfuil a fullNumber mar luach den sórt sin – a mheaitseálann é;
    • cruthaíonn luach nach bhfuil sonrasc leis ceann: comhpháirtí ó Customer Email (a cruthaíodh nuair a bhíonn sé ar iarraidh, mar atá le createPartner), líne amháin in aghaidh an muirir (Checkout Line Item Summary nó Description mar an téacs, méid an muirir mar phraghas cuimsitheach CBL ag invoiceVatRatePercent), dáta eisiúna = an chéad dáta muirir, cóireáil CBL ón gcuideachta agus tír an chárta. Eisítear agus postáiltear an sonrasc láithreach, agus taifeadtar ordú díolacháin le cainéal stripe agus an luach sin mar externalRef ionas go n-nasctar in ionad cruthú le haghaidh iompórtálacha níos déanaí;
    • déantar gach muirear sa ghrúpa a mheaitseáil leis an sonrasc ansin mar íocaíocht (ag postáil an fháiltithe); cruthaíonn gach aisíocaíocht nóta creidmheasa eisithe i gcoinne an tsonraisc don mhéid aisíoctha agus déantar an aisíocaíocht a mheaitseáil leis. Tagann comhaireamh ar ais mar invoicesCreated, invoicesLinked, creditNotesCreated agus paymentsMatched; liostaítear grúpaí nach bhféadfar a phróiseáil (gan ríomhphost custaiméara, airgeadraí measctha, sonrasc nasctha atá fós ina dhréacht nó ildiolta cheana féin) sna warnings agus fágtear iad mar idirbheairtí bainc new. Ná mapáil Amount freisin chuig cuntas leabhair mhóir sa teimpléad céanna: ní phostáiltear muirear a mheaitseáiltear le sonrasc den dara uair, ach phostálfaí ceann neamhmheaitseáilte.
  • Tá ainmneacha teimpléid uathúil in aghaidh na cuideachta.
  • Iompraíonn teimpléid camt.053 agus ceangail bhainc na roghanna céanna, arna léamh ón ráiteas seachas ó cholúin Stripe:
    • Cruthaigh comhpháirtithe ar iarraidh: cruthaíonn createPartner ar an rón ainm an fhéichiúnaí (TxDtls/RltdPties/Dbtr/Nm, fotha debtor.name) custaiméir do gach íocóir anaithnid d'airgead isteach; ar an rón ainm an chreidiúnaí (TxDtls/RltdPties/Cdtr/Nm, fotha creditor.name) soláthraí do gach faighteoir anaithnid d'airgead amach. Aithnítear comhpháirtithe de réir IBAN (stóráilte i partner_bank_accounts), ansin de réir ainm cruinn; is cuideachta comhpháirtí nua nuair a iompraíonn an t-ainm foirm dhlíthiúil (UAB, MB, SIA, GmbH, Ltd, …), murach sin is duine é. Tagann an comhaireamh ar ais mar customersCreated (iompórtáil comhaid) nó partnersCreated (sioncronú fotha).
    • Nasc sonrasc de réir tagartha: invoiceMetaField socraithe go rón aistrithe nó tagartha (TxDtls/RmtInf/Ustrd, TxDtls/RmtInf/Strd/CdtrRefInf/Ref, TxDtls/Refs/EndToEndId; fotha remittance_information, reference_number) a mheaitseálann gach líne bhainc nua a bhfuil a dtagairt, a aistriú nó a tuairisc ina bhfuil uimhir sonrasc díolacháin eisithe oscailte (airgead isteach) nó sonrasc ceannaigh cláraithe (airgead amach), agus a phostálann an íocaíocht. Nuair a shábháiltear IBAN an fhéichiúnaí ar chomhpháirtí, nó nuair a bhíonn ainm an fhéichiúnaí comhionann le hainm nó cód comhpháirtí, caithfidh an sonrasc baint leis an gcomhpháirtí sin. Ní nasctar íocaíocht ó íocóir anaithnid ach amháin nuair a bhíonn sí comhionann le hiarmhéid fágach an tsonraisc agus nuair a iompraíonn uimhir an tsonraisc a réimír sraithe, ionas nach nglactar le huimhir lom mar mhéid mar thagairt choíche. Ní nasctar íocaíocht atá níos mó ná an t-iarmhéid fágach choíche. Fanann línte a dteipeann ar na seiceálacha seo nua le haghaidh meaitseála láimhe agus liostaítear iad sna rabhaidh. Le advanceInvoices: true, cruthaíonn íocaíocht isteach neamhmheaitseáilte ó chomhpháirtí a bhfuil aithne air sonrasc réamhíocaíochta eisithe (cineál advance) don mhéid ag invoiceVatRatePercent nó ráta invoiceItemId agus déantar an íocaíocht a mheaitseáil leis; caithfidh aithne bheith ar an gcomhpháirtí, mar sin cuir tic sa rón féichiúnaí freisin.
    • Ralacha postála de réir cóid idirbheairt: seachas Ntry/Amt / transaction_amount.amount, tá rónna rialach ag an liosta réimsí Ntry/BkTxCd=CHRG, =INTR, =TAXE, Ntry/CdtDbtInd=DBIT, =CRDT (fotha: bank_transaction_code=…, credit_debit_indicator=…). Postáiltear líne chuig cuntas an chéad rialach a mheaitseálann sí: teaghlach cóid idirbheairt bainc, ansin a threoir, ansin an rón méid lom. Ní dhéantar seiceáil ar rónna rialach i gcoinne an chomhaid.
    • Comhpháirtí muirir bhainc: cruthaíonn createPartner ar an rón rialach …=CHRG soláthraí ainmnithe i ndiaidh an bhainc (ráiteas Stmt/Acct/Svcr/FinInstnId/Nm, nó banc an cheangail, nó ainm chuntas bainc an leabhair mhóir) agus cuirtear gach muirear i leith an chomhpháirtí sin.
    • Roghnaítear teimpléid ceangail bhainc in aghaidh an chuntais fotha le bank/feeds/accounts/configure (Banc → Ceangail san aip), a shocraíonn freisin syncSchedule (manual, daily, weekly, monthly): sioncrónaíonn an API cuntais le sceideal leis féin nuair a imíonn a dtréimhse. Cuirtear teimpléid i bhfeidhm ar gach bank/feeds/sync; tuairiscíonn freagra an tsioncronaithe ansin freisin posted, partnersCreated, invoicesLinked, invoicesCreated, paymentsMatched agus warnings.

Cuir templateId chuig bank/statements/import in ionad format: roghnaíonn cineál an teimpléid an parsálaí, agus caithfidh an comhad gach réimse a liostaítear sa teimpléad a bheith ann – diúltaítear do chomhad in easnamh aon cheann díobh le HTTP 422 agus ainmneacha na gcolún nó na ngnéithe atá ar iarraidh. Ní gá go mbeadh réimsí meiteashonraí i láthair. Cur síos atá i dteimpléid ceangail bhainc ar fhotha beo PSD2 agus ní féidir iad a úsáid le haghaidh iompórtáil comhaid.

Léann teimpléad ISO 20022 comhaid MT940 freisin: comhad a thosaíonn le {1: nó :20: (nó a sheoltar le "format": "mt940") déantar é a pharsáil mar MT940 agus cuirtear meaitseáil tagartha agus rialacha postála an teimpléid i bhfeidhm ar a línte. Sciptear an tseiceáil gné do MT940, agus ní bhaineann rialacha Ntry/BkTxCd=… le línte MT940 choíche toisc nach n-iompraíonn MT940 aon chód idirbheairt bainc ISO 20022; úsáid na rialacha Ntry/CdtDbtInd=… ina ionad sin.

Tá airgeadra amháin i gcuntas bainc. Diúltaítear do ráiteas in airgeadra eile le HTTP 422 (i gcomhad camt.053 le ráitis in airgeadraí éagsúla don IBAN céanna, ní iompórtáiltear ach an ráiteas in airgeadra an chuntais), agus mar an gcéanna le líne a sheoltar chuig bank/transactions/import le currency seachas airgeadra an chuntais.

Gach gluaiseacht a tháirgtear ó réimse a bhfuil accountCode aige, postáiltear é tráth an iompórtála mar aon idirbheairt irise amháin: déanann airgead isteach dochar do chuntas leabhair mhóir an chuntais bhainc agus creidiúint don chuntas mapáilte; déanann airgead amach dochar don chuntas mapáilte agus creidiúint do chuntas leabhair mhóir an chuntais bhainc. Déantar méideanna a thiontú go dtí an t-airgeadra bunáite ag dáta na gluaiseachta. Déantar an t-idirbheairt bhainc a matched leis an idirbheairt irise sin ansin (matchedDocumentType = journal_transaction) agus ní thairgtear níos mó í le haghaidh meaitseála sonrasc. Tuairiscíonn an freagra an comhaireamh sa posted. Fanann gluaiseachtaí ó réimsí neamhmapáilte new agus déantar iad a mheaitseáil le sonrasc mar a bhí roimhe – mar shampla mapáil Fee chuig cuntas caiteachais táillí PSP agus fág Amount neamhmapáilte ionas go ndéantar muirir a mheaitseáil le sonrasc díolacháin fós.

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

ISO 20022 camt.053 (XML baincéireachta oscailte)

Ligeann bainc Liotuánacha (Swedbank, SEB, Luminor, Šiaulių bankas, …) duit ráitis cuntais a íoslódáil mar ISO 20022 camt.053 XML ón mbaincéireacht idirlín acu – de ghnáth faoi eispéirt/íoslódáil ráitis, format "ISO XML" nó "camt.053". Tugann APIanna faisnéise cuntais PSD2 an format céanna ar ais.

POST /v1/bank/statements/import
{
  "bankAccountId": "…",
  "format": "camt053",
  "content": "<?xml version=\"1.0\"…>…"
}
  • Féadfaidh comhad roinnt ráiteas a bheith ann; caithfidh IBAN gach ráitis a bheith i gcomhréir le IBAN an chuntais bhainc (glactar le ráitis gan IBAN, nó cuntais gan ceann, mar atá).
  • Is éard a bhíonn in externalId ná tagairtí eintirí (AcctSvcrRef/NtryRef, ag titim siar go dtí hash ábhair).
  • Athfhuaimníonn an freagra meiteashonraí in aghaidh an ráitis: id ráitis, tréimhse, iarmhéid oscailte/dúnta, comhaireamh idirbheairtí.
  • Baintear ainm an chontrapháirtí, IBAN agus aidhm na híocaíochta in aghaidh an eintir le haghaidh meaitseála.

Eispiortáiltear íocaíochtaí sa treo eile mar pain.001 trí bank/payments/export.

CSV Gnó Revolut

Íoslódáil ráiteas idirbheairt chuntas Gnó Revolut mar CSV agus iompórtáil é leis an teimpléad ionsuite Revolut Business (templateId: "builtin-revolut"). Tá an teimpléad seo ag gach cuideachta gan é a chruthú: liostaíonn bank/import-templates/list-builtin é, tugann bank/import-templates/get ar ais é, agus diúltaíonn bank/import-templates/update agus bank/import-templates/delete dó le HTTP 400. San aip liostaítear é ar dtús faoi Banc → Teimpléid iompórtála; nuair a osclaítear é taispeántar a chuid socruithe, agus cruthaíonn sábháil teimpléad cuideachta de chuid féin a thig leat a athrú.

POST /v1/bank/statements/import
{
  "bankAccountId": "…",
  "templateId": "builtin-revolut",
  "content": "Date started (UTC),Date completed (UTC),ID,Type,State,…"
}
  • Ní iompórtáiltear ach rónna a bhfuil State = COMPLETED acu. Fághtar rónna eile (mar shampla PENDING) ar lár agus comhairítear iad sna warnings; iompórtáiltear iad le hiompórtáil níos déanaí de chomhad ina bhfuil siad críochnaithe.
  • Tiocfaidh gach rón ina idirbheairt bhainc leis an dáta ó Date completed (UTC), an méid ó Total amount, an t-airgeadra ó Payment currency, ID mar externalId agus Description mar an tuairisc.
  • Is é kontrapháirtí an airgid amach ná Beneficiary name agus Beneficiary IBAN; i gcás íocaíochta cárta gan benéficiaire, an ceannaí in Description. Is é kontrapháirtí an airgid isteach ná Sender name agus Sender account.
  • Déantar rónna a ghrúpáil de réir cuntais agus airgeadra. Caithfidh International account number a bheith i gcomhréir le IBAN an chuntais bhainc, agus ní iompórtáiltear ach rónna in airgeadra an chuntais bhainc.
  • Maidir le gach rón, seiceálann an t-iompórtálaí go bhfuil iarmhéid an róin roimhe sin móide Total amount comhionann le Balance, agus liostaíonn sé gach rón nach bhfuil i warnings.
  • Caithfidh na colúin Date completed (UTC), ID, Type, State, Description, Payment currency, Total amount, Reference, Sender name agus Beneficiary name a bheith sa chomhad.

Ar gach iompórtáil déanann an teimpléad ionsuite:

  • custaiméir a chruthú do gach seoltóir anaithnid d'airgead isteach, agus soláthraí do gach benéficiaire nó ceannaí cárta anaithnid d'airgead amach, mar a mhínítear faoi Cruthaigh comhpháirtithe ar iarraidh thuas;

  • gach rón a bhfuil a Reference nó Description ina bhfuil uimhir sonrasc díolacháin nó ceannaigh oscailte a mheaitseáil, agus an íocaíocht a phostáil, le seiceálacha Nasc sonrasc de réir tagartha thuas;

  • na rónna nach raibh sonrasc ag meaitseáil leo a phostáil de réir a Type, chuig cuntas rialach postála:

    Type Rialach postála Cuntas réamhshocraithe Sraith Rómánach Postáil
    FEE bank.fees 6800 627 déan dochar do chuntas an rialach, creidiúint do chuntas leabhair mhóir an chuntais bhainc; comhpháirtí: soláthraí ainmnithe i ndiaidh chuntas an bhainc
    CARD_PAYMENT bank.cardPayments 6209 628 déan dochar do chuntas an rialach, creidiúint do chuntas leabhair mhóir an chuntais bhainc, gan CBL
    TOPUP bank.topUps 3010 1012 déan dochar do chuntas leabhair mhóir an chuntais bhainc, creidiúint do chuntas an rialach

    Fanann rónna de chineálacha eile, mar shampla TRANSFER, new le haghaidh meaitseála.

Athraigh na cuntais le ledger/posting-rules/update; úsáideann an teimpléad ionsuite na cuntais nua ón gcéad iompórtáil eile. Ní féidir rialach postála a mhúchadh: chun íocaíochtaí cárta nó top-ups a iompórtáil gan iad a phostáil, cruthaigh teimpléad cuideachta den chineál revolut gan an rón Type=CARD_PAYMENT nó Type=TOPUP agus iompórtáil leis. Ní dhéantar íocaíocht cárta a phostáiltear ar an mbealach seo a mheaitseáil le sonrasc an tsoláthraí nuair a chlárítear an sonrasc sin níos déanaí; postáil ceann den dá cheann, ná postáil an dá cheann.

Úsáideann teimpléad cuideachta den chineál revolut na colúin céanna agus féadann sé rónna a phostáil de réir cineáil leis na rónna rialach Type=FEE, Type=CARD_PAYMENT, Type=TRANSFER agus Type=TOPUP. Iompórtálann iompórtáil le "format": "revolut-csv" agus gan aon teimpléad na rónna gan aon cheann de na céimeanna seo.

CSV ó Stripe

Eispiortáil ó dheais Stripe – oibríonn an dá thuarascáil:

  • Reports → Balance → Itemized balance change from activity (molta): colúin balance_transaction_id, created_utc, currency, gross, fee, net, reporting_category, description.
  • Payments → Export: colúin 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,…"
}

Cruthaigh cuntas bainc tiomnaithe do Stripe (m.sh. ainm "Stripe", cuntas GL 2710 nó fo-chuntas féin) – gníomhaíonn iarmhéid Stripe cosúil le cuntas bainc: sreabhann muirir isteach, baintear táillí, aistríonn íocaíochtaí an t-iarmhéid chuig do fhíorbhanc.

Iompraíocht iompórtála:

  • Tiocfaidh gach idirbheairt iarmhéid ina hidirbheairt bhainc amháin don mhéid ollmhéid (externalId = id idirbheairt iarmhéid).
  • Tiocfaidh táille neamh-nialasach ina dara hidirbheairt leis an gcomhartha contrártha (externalId = <id>:fee, kontrapháirtí "Stripe") – ionas gur féidir táillí a mheaitseáil/a phostáil mar chaiteachais ar leith ón ioncam. Tagann táillí a aisítear ar aisíocaíochtaí isteach mar méideanna dearfacha.
  • Iompórtáiltear rónna payout mar aontheorainneacha diúltacha; déan iad a mheaitseáil leis an idirbheairt isteach chomhfhreagrach ar ráiteas do fhíorbhanc.
  • Scipeáiltear rónna méid-nialas; glactar leis an dáta ó created_utc (UTC).
  • Scipeáiltear rónna eispéirt íocaíochta nach ndearna gluaiseacht airgid: Captured = false (údaruithe/gabhálacha moillithe) agus Status Failed/Canceled.
  • Tiocfaidh Amount Refunded neamh-nialasach ina thríú hidirbheairt dhiúltach (externalId = <id>:refund) le dáta Refunded date (UTC) – ionas nach gcailltear páirt-aisíocaíochtaí agus aisíocaíochtaí iomlána atá leabaithe i rónna íocaíochta.

Réiteach socruithe PSP (tuarascálacha íocaíochta Stripe)

Chun íocaíocht chruinn a roinnt ina horduithe bunúsacha, aisíocaíochtaí, táillí agus aiséilimh, úsáid na foircinn shocraithe in ionad iompórtáil shimplí an ráitis. Glactar le dhá eispéirt ó Stripe (a bhraitear go huathoibríoch):

  • Reports → Payouts → Payout reconciliation, itemized (cineálacha tuarascála payout_reconciliation.itemized.* nó payout_reconciliation.by_id.itemized.*) – cruinn, rón amháin in aghaidh an idirbheairt iarmhéid; is fearr ar chuntais bheo.
  • Payments → Export (unified payments) – an t-eispéirt ar leibhéal muirir; oibríonn sé i mód tástála/sandbox har nach bhfuil réiteach socruithe ar fáil. Déantar muirir ghabhálacha a ghrúpáil de réir an id íocaíochta sa cholún Transfer; sciptear rónna neamhghabhálacha/teipthe (skippedNotSettled); tagann Amount Refunded neamh-nialasach ina líne aisíocaíochta shintéiseach i mbaisc íocaíochta an mhuirir – gar-mheastachán, ós rud é gur tharla an aisíocaíocht b'fhéidir in íocaíocht níos déanaí. Tagann tagairtí meaitseála ó id an mhuirir, PaymentIntent ID, Invoice Number, Client Reference ID agus gach colún … (metadata) (m.sh. uimhir ordaithe i meiteashonraí).

Is féidir le CSV amháin a bheith ann thar go leor íocaíochtaí. Íoslódálann Stripe an tuarascáil mhionsonraithe comhad amháin in aghaidh an rannáin (…_charge_…, …_refund_…, …_fee_…); iompórtáil iad uile – comhtháthaíonn rónna d'íocaíocht a iomportáladh cheana sa bhaisc atá ann cheana (tuairiscಿತar san áiritheoir updated) chomh fada agus nach bhfuil sé postáilte fós, agus déantar iomláin bhaisc a athríomh.

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

Iompraíocht iompórtála:

  • Déantar rónna a ghrúpáil de réir automatic_payout_id i baisceanna socruithe – baisc amháin in aghaidh na híocaíochta, le iomláin ollmhéide/táillí/glanmhéide (suim an róin net = an méid a bhuaileann do bhanc). Scipeáiltear ath-iompórtáil íocaíochta (áiritheoir skipped). Scipeáiltear rónna nach bhfuil sannadh fós d'íocaíocht agus na rónna payout iad féin agus comhairítear iad ar leithligh.
  • Déantar gach rón muirir/aisíocaíochta/díospóide a mheaitseáil go huathoibríoch le sonrasc díolacháin ag baint úsáide as, san ord seo: externalRef ordaithe r-thráchtála (aon luach ó order_id, payment_intent_id, source_id, charge_id nó aon cholún *_metadata[...]), fullNumber sonrasc le feiceáil sna colúin sin, agus – d'aisíocaíochtaí agus aiséilimh – charge_id de mhuirear a mheaitseáladh roimhe seo (an comhad céanna nó iompórtálacha roimhe sin).
  • Déan athbhreithniú le bank/settlements/list / bank/settlements/get; réitigh na hiarsmaí le bank/settlements/match { lineId, invoiceId } (nó invoiceId: null chun meaitseáil a dhíchur).

Postálann POST /v1/bank/settlements/post { id, date?, commissionPercent? } an bhaisc iomlán mar aon idirbheairt irise chothromaithe agus socraíonn sé na sonrasc meaitseáilte (paidAmount/paymentStatus, rabhcháin sale_invoice.paid):

  • Déan dochar do GL an chuntais bhainc don ghlan-íocaíocht; déan dochar do tháillí PSP (settlements.fees, réamhshocrú 6800) do tháillí coinnithe agus rónna táillí.
  • Déan creidiúint do chuntais fhaighte in aghaidh an mhuirir mheaitseáilte; déanann aisíocaíochtaí agus aiséilimh é sin a fhritháireamh. Cuirtear teorainn leis an iarratas ag iarmhéid gach sonrasc – titeann aon bhreis ar an gcuntas fionraí le rabhadh.
  • Muirir neamhmheaitseáilte: le commissionPercent socraithe déantar iad a roinnt ina ioncam coimisiúin (settlements.commissionRevenue, réamhshocrú 5001) agus dliteanas díoltóra (settlements.sellerPayable, réamhshocrú 4499) – an tsreabhadh margaíochta ina mbaineann an t-airgead bailithe go príomha le díoltóirí. Gan é, páirceáiltear iad ar settlements.suspense (réamhshocrú 4440, réamhíocaíochtaí faighte).
  • Postálann rónna platform_earning (táillí iarratais Stripe Connect) chuig ioncam coimisiúin; laghdaíonn rónna transfer (íocaíochtaí chuig díoltóirí ceangailte) dliteanas an díoltóra.
  • Is féidir gach ceann den cheithre chuntas a shárú in aghaidh na cuideachta trí rialacha postála (ledger/posting-rules).
  • Líne ar a ndearnadh muirear, táille nó aisíocaíocht a iompórtáil cheana ar chuntas bainc eile ón eispéirt íocaíochta Stripe (bank/statements/import), ní chuirtear le táillí, cuntais fhaighte nó fionraí é. Déantar a net a chreidiúint do chuntas leabhair mhóir an chuntais bhainc sin ina áit, ionas go nglanann cuntas bainc Stripe íocaíocht ar íocaíocht. Is é summary.clearedAmount an t-iomlán a aistríodh ar an mbealach seo; ainmnítear líne a bhfuil a méid difriúil ó mhéid atá ag an gcuntas sin sna warnings. Mura bhfuil aon rud fágtha le postáil, postáltear an bhaisc le journalTransactionId mar null.

Tugann bank/settlements/list agus /get ar ais, in aghaidh na baisce, clearedNet, clearingDifference (línte íocaíochta lúide na méideanna atá ag an gcuntas bainc eile dóibh; nialas nuair a aontaíonn siad) agus clearingOpenCount (línte le difríocht nó gluaiseacht neamhphostáilte); tugann /get an rud céanna ar ais in aghaidh na líne mar clearingBankAccountId, clearingBooked, clearingDifference agus clearingUnposted. Déantar línte aisíocaíochta de mhuirear amháin a chur i gcomparáid le chéile, toisc nach bhfuil ach an t-iomlán aisíoctha ag an eispéirt íocaíochta. Eispéirt íocaíochta Stripe a iompórtáiltear tar éis a íocaíocht a phostáil, sciptear gluaiseachtaí na híocaíochta sin agus ainmnítear í sna warnings.

Eispiortáiltear CBL ar an gcoimisiún féin ar leithligh (eisigh sonrasc coimisiúin chuig an díoltóir); ní dhéanann an roinnt ach an t-airgead tirim bailithe a leithdháileadh.

Íocaíochtaí in airgeadra eile

Scríobhtar an iris i gcónaí in airgeadra bunáite na cuideachta, ach postálann íocaíocht in airgeadra eile go huathoibríoch – ní gá aon iontráil láimhe:

  • Déanann an bhaisc tiontú ag an ráta do dháta an phostála (date, ag titim siar go dtí dáta na híocaíochta, ansin inniu). Is é an ráta ráta féin na cuideachta don airgeadra sin (reference/exchange-rates/set) nuair a bhíonn sé chomh déanach ar a laghad leis an ráta oifigiúil, murach sin an ráta oifigiúil is déanaí ar an dáta sin nó roimhe. Gan aon ráta ar an dáta nó roimhe teipeann ar an nglao le 422 agus ainmnítear reference/exchange-rates/sync.
  • Déanann gach cuntas tiontú ag ráta na baisce sin ach amháin cuntais fhaighte, a scaoiltear ag an fxRate ar eiseadh gach sonrasc ann. Postálann an iarmhar idir an dá ráta chuig bank.fxGain (réamhshocrú 5803) nó bank.fxLoss (réamhshocrú 6803) mar dhifríocht malairte réalaithe, ionas go gcothromaíonn an iris fós.
  • Tugann an freagra summary an fxRate a úsáideadh agus an exchangeDifference a eascraíonn as ar ais, agus coinníonn an bhaisc an ráta ar postáladh í. Sonrasc meaitseáilte nach ionann a airgeadra féin agus airgeadra na baisce, ní shocraítear é: téann a mhéid chuig an gcuntas fionraí le rabhadh.
  • Fanann teorainn iompórtála amháin: íocaíocht aonair a mheascann a rónna roinnt airgeadraí diúltaítear di le 422, mar a dhéantar le h-ath-iompórtáil a bhfuil a airgeadra difriúil ón mbaisc atá stóráilte cheana don íocaíocht sin.

Fothaí láimhe / saincheaptha

Is féidir rud ar bith eile a bhrú mar JSON lán-so-léite:

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

Soláthraigh externalId cobhsaí in aghaidh an idirbheairt chun hath-iompórtálacha a choinneáil indempotent.