Nordlet

← Bunúsanna / SDKanna

Ar aistriú ó chóras eile

Tabhair leat leabhair chuideachta i dtogra amháin - cairt cuntas, comhpháirtithe, iarmhéideanna oscailte nó stair iomlán, sonrasc oscailte, sócmhainní seasta agus stoc.

Nuair a aistríonn cuideachta go Nordlet ó chlár cuntasaíochta eile, ní thosaíonn a cuid leabhar ó nialas. Glacann an t-allmhaireoir leabhar stairiúla gach rud a fhágann an seanchóras agat agus scríobhann sé i dtogra amháin, idirbheart bunachar sonraí amháin é: má theipeann ar shraith amháin seiceáil, ní stóráiltear aon rud. Is féidir an pacáiste céanna a rith trí fhoirceann seiceála amháin ar dtús, a dhéanann gach bailíochtú agus a rollann ar ais.

POST /v1/migration/books/validate   # seiceálann gach rud, ní scríobhann sé aon rud
POST /v1/migration/books/import     # scríobhann sé gach rud nó gan aon rud

Tá an dá chnaipe chéanna ag an aip ghréasáin faoi Account → Migration (greamaigh an JSON nó uaslódáil comhad). Teastaíonn ledger:write ón eochair API mar aon le scóip scríbhneoireachta gach rannáin a chuireann tú san áireamh (partners:write, catalog:write, sales:write, purchases:write, assets:write, inventory:write). Glacann an dá fhoirceann le comhlacht suas le 32 MB.

Dáta an athraithe

Roghnaigh dáta an athraithe (cut-over date): an chéad lá a ritheann an chuideachta i Nordlet. Fanann gach rud roimhe sin sa seanchóras (nó tagann sé anonn mar stair, féach thíos); cuirtear gach rud ón lá sin ar aghaidh isteach i Nordlet tríd na foircinn ghnáthaimh. Is é an méid atá i ngach méid sa phacáiste ná "amhail an lá roimh an athrú": an t-iarmhéid trialach deiridh, na sonrasc atá fós gan íoc, an stoc atá fós ar an tseilf, na sócmhainní atá fós ar an chlár.

Muthaigh na nithe seo a leanas in Nordlet mus a n-allmhaireoidh tú:

  1. Cruthaigh an chuideachta agus cuir i bhfeidhm an teimpléad cairte cuntas (ledger/accounts/apply-template) - nó liostaigh na cuntais a theastaíonn uait i rannán accounts an phacáiste.
  2. Cruthaigh stóras amháin ar a laghad (inventory/warehouses/create) má allmhaireoidh tú stoc.
  3. Rith an pacáiste trí migration/books/validate go dtí nach dtuairisceoidh sé aon earráidí agus go nglacfaidh tú lena rabhaidh.

An pacáiste

Tá gach rannán roghnach; cuir san áireamh na cinn atá agat. Is le cód (cód cuntais, cód comhpháirtí, cód míre, cód ghrúpa sócmhainní, cód stórais) gach tagairt idir rannáin, agus féadann cód tagairt a thabhairt do taifead atá ann cheana i Nordlet nó do cheann a cruthaíodh le rannán níos luaithe den phacáiste céanna.

{
  "cutoverDate": "2026-01-01",
  "source": "Rivilė GAMA",
  "accounts": [
    { "code": "6210", "name": "Advertising expenses", "type": "expense", "parentCode": "6" }
  ],
  "partners": [
    { "code": "301111222", "name": "UAB Klientas", "vatCode": "LT100001112223", "isCustomer": true },
    { "code": "302222333", "name": "UAB Tiekėjas", "isCustomer": false, "isSupplier": true }
  ],
  "items": [
    { "code": "SKU-1", "name": "Widget", "type": "product", "unit": "vnt", "vatRatePercent": "21" }
  ],
  "assetGroups": [
    { "code": "TRANSP", "name": "Vehicles", "assetAccountCode": "1230", "depreciationAccountCode": "1239",
      "defaultUsefulLifeMonths": 60 }
  ],
  "openingBalances": {
    "balancingAccountCode": "3410",
    "entries": [
      { "accountCode": "2710", "debit": "5000.00" },
      { "accountCode": "2410", "debit": "1500.00" },
      { "accountCode": "2040", "debit": "300.00" },
      { "accountCode": "1230", "debit": "12000.00" },
      { "accountCode": "1239", "credit": "2400.00" },
      { "accountCode": "4430", "credit": "700.00" },
      { "accountCode": "3010", "credit": "10000.00" }
    ]
  },
  "openReceivables": [
    { "partnerCode": "301111222", "number": "SF-1050", "issueDate": "2025-12-10", "dueDate": "2026-01-09",
      "grossTotal": "1210.00", "vatTotal": "210.00" },
    { "partnerCode": "301111222", "number": "SF-1049", "issueDate": "2025-11-20",
      "grossTotal": "500.00", "outstanding": "290.00" }
  ],
  "openPayables": [
    { "partnerCode": "302222333", "documentNumber": "T-77", "documentDate": "2025-12-15", "grossTotal": "700.00" }
  ],
  "fixedAssets": [
    { "groupCode": "TRANSP", "code": "CAR-1", "name": "Delivery van", "acquisitionDate": "2025-01-01",
      "acquisitionCost": "12000.00", "accumulatedDepreciation": "2400.00", "depreciatedMonths": 12 }
  ],
  "stock": [
    { "itemCode": "SKU-1", "quantity": "30", "unitCost": "10" }
  ]
}

Is teaghráin dheachúlacha iad na méideanna, mar atá gach áit san API. Is lipéad saor é source a chríochnaíonn i gcur síos an idirbhirt iarmhéid oscailte agus i nótaí na sonrasc a allmhairíodh.

accounts

Sraitheanna cairte cuntas: code, name, type (asset, liability, equity, income, expense), roghnach parentCode agus isPostable. Fágtar na cóid atá ann cheana gan teagmháil agus comhairítear iad mar existing. Úsáid é seo nuair a bhíonn cairt an tseanchórais difriúil ón teimpléad, or scipeáil é agus cuir an teimpléad i bhfeidhm ar dtús.

partners agus items

Custaiméirí, soláthraithe agus míreanna catalóige, arna n-eochrú ag code. Sa Liotuáin is é cód na cuideachta de ghnáth cód cláraithe na cuideachta; do dhaoine príobháideacha úsáid aon cód atá uathúil laistigh den chuideachta. Scipeáiltear cóid atá ann cheana, ní nuashonraítear iad. Glacann míreanna le type (product nó service), unit, barcode, vatRatePercent, salePriceExclVat, purchasePriceExclVat.

openingBalances

Iarmhéid trialach deiridh an tseanchórais, sraith amháin in aghaidh an chuntais: accountCode le debit nó credit. Postáiltear na sraitheanna mar idirbheart dialainne amháin a bhfuil an dáta openingBalances.date air (is é an réamhshocrú ná dáta an athraithe) agus an cineál doiciméid migration_opening. Ní mór do shraitheanna tagairt a thabhairt do chuntais inphostáilte.

Ní mór don idirbheart cothromú. Mura ndéanann iarmhéid trialach an tseanchórais é sin - slánú, brabús nach druideadh riamh le cothromas, cuntas ar iarraidh - tabhair balancingAccountCode (de ghnáth tuilleamh coinnithe, 3410 sa teimpléad Liotuánach) agus postáiltear an difríocht ansin; tuairiscíonn an freagra an méid mar balancingAmount.

Ní fhéadfaidh ach idirbheart iarmhéid oscailte amháin a bheith ann in aghaidh na cuideachta. Diúltaítear d'allmhairiú dara uair le openingBalances (409). Is idirbhirt dialainne lámhle agusúla iad ceartúcháin i ndiaidh an tirim (ledger/journal/transactions/create); tá idirbhirt phostáilte do-athraithe, mar sin fanann an buncheann mar a allmhairíodh é.

journal - stair iomlán in ionad iarmhéideanna, nó mar bhreis orthu

Más mian leat idirbhirt an tseanchórais i Nordlet (chun go n-oibreoidh tuarascálacha do thréimhsí roimhe seo), seol anseo iad: aon oibiacht in aghaidh an idirbhirt le date, description agus reference roghnach, agus entries de accountCode + debit/credit. Ní mór do gach idirbheart cothromú a dhéanamh ar a son féin. Postáiltear iad le cineál doiciméid migration.

Ní mór do dhátaí a bheith roimh dháta an athraithe. Nuair a iompraíonn an pacáiste openingBalances freisin, ní mór dáta a bheith ar an stair ar nó tar éis openingBalances.date - is é an patrún gnách ná iarmhéideanna ag tús na bliana airgeadais roimhe sin móide idirbhirt na bliana sin, agus an t-athrú ar an chéad lá den bhliain kas reatha. Ná seol iarmhéideanna agus stair don tréimhse chéanna: déanfaí iarmhéideanna a chomhaireamh faoi dhó.

Ní mór do gach mí a mbaineann na iarmhéideanna oscailte nó an stair léi a bheith ina tréimhse cuntasaíochta oscailte (409 murach sin).

openReceivables agus openPayables

Sonrasc a bhí fós gan íoc (go páirteach nó go hiomlán) ag an athrú. Cruthaítear iad mar shonrasc díolacháin eisithe agus sonrasc ceannaigh cláraithe le paidAmount = grossTotal − outstanding, ionas go n-oibreoidh comhoiriúnú bainc (bank/transactions/match, bank/transactions/suggest-matches), an tuarascáil dul in aois fiach agus greasáin íocaíochta orthu mar aon sonrasc eile.

  • Is é grossTotal réamhshocrú outstanding; is é 0 réamhshocrú vatTotal (díorthaítear an glanmhéid).
  • Is é dáta an doiciméid réamhshocrú dueDate.
  • Is é airgeadra sonrasc na cuideachta réamhshocrú currency. I gcás aon airgeadra seachas bunairgeadra na cuideachta, teastaíonn fxRate - aonaid den airgeadra sin in aghaidh 1 aonad den bhunairgeadra, an coinbhinsiún céanna leis an gcuid eile den API - agus stóráiltear é ar an tsonrasc ionas go ríomhann íocaíochtaí níos déanaí an difríocht ráta malairte réadaithe i gceart.
  • Is é number sonrasc díolacháin línimhir iomlán an tseanchórais agus caithfidh sé a bheith uathúil sa chuideachta. Tá sonrasc ceannaigh uathúil in aghaidh an chomhpháirtí agus documentNumber.
  • Ní phostáiltear na sonrasc arís: tá a iarmhéid receivables/payables cheana féin mar chuid de na iarmhéideanna oscailte. Nascotar leis an idirbheart iarmhéid oscailte é, agus sin an fáth a n-éilíonn openPayables openingBalances sa phacáiste céanna.
  • Ní allmhairítear línte sonrasc; ní iompraíonn an tsonrasc ach iomláin. Fanann an seanchóras mar fhoinse do mionsonraí línte agus do chláir CBL do thréimhsí roimh an athrú.

Má rianaigh an seanchóras iarmhéideanna custaiméara gan míreanna oscailte, cruthaigh sonrasc amháin in aghaidh an chomhpháirtí don iarmhéid (mar shampla uimhir OB-301111222) ionas gur féidir é a shocrú.

Leanann an uimhriú ar aghaidh. Nuair a bhíonn an fhoirm PREFIX-N ar uimhir sonrasc díolacháin allmhairithe agus go dtagann a dáta eisiúna i mbliain an athraithe, leagtar sraith uimhreacha an réimhse sin agus na bliana sin go N + 1 (ní ísítear riamh é). Liostaíonn an freagra an numberSeries a eascraíonn as; do chásanna eile leag an tsraith duit féin le reference/series/create ({ documentType: "sale_invoice", prefix, year, startAt }).

assetGroups agus fixedAssets

Tagann sócmhainní seasta anonn lena n-ímfhálú go dtí an dáta: acquisitionCost, salvageValue, accumulatedDepreciation, depreciatedMonths agus usefulLifeMonths (nó réamhshocrú an ghrúpa). Leanann an rith líneach díreach (assets/depreciation/post) ón luach atá fágtha thar na míonna atá fágtha. Cruthaítear sócmhainní a bhfuil a n-ímfhálú carntha cothrom cheana féin leis an luach in-ímfhálaithe mar fully_depreciated. Ní phostáiltear aon rud - tá an costas agus an t-ímfhálú carntha mar chuid de na iarmhéideanna oscailte.

Is arna n-eochrú ag code atá grúpaí agus teastaíonn assetAccountCode agus depreciationAccountCode uathu (cuntas caiteachais réamhshocraithe 6206).

stock

Stoc ar láimh in aghaidh na míre: itemCode, quantity, unitCost (costas in aghaidh an aonaid in EUR) agus go roghnach warehouseCode (réamhshocrú: an stóras réamhshocraithe), lotNumber agus expiryDate do mhíreanna a riánaítear le baisc nó sraithuimhir. Tiontaítear gach sraith ina ghluaiseacht stoic isteach ar a bhfuil dáta an athraithe le cineál doiciméid migration agus tosaíonn sí sraith FIFO ar an gcostas sin. Ní phostáiltear aon rud - tá luach an stoic mar chuid de na iarmhéideanna oscailte.

Seiceálacha agus rabhaidh

Teipeann ar an fhoirceann bailíochtaithe (422) ar cuntais ar iarraidh, cuntais nach bhfuil inphostáilte, idirbhirt mhíchothromaithe, cóid chomhpháirtí/mhíre/ghrúpa/stórais anaithnida, cóid nó uimhreacha dúblacha laistigh den phacáiste, méideanna gan íoc os cionn an chomhlána, ímfhálú carntha os cionn an luacha in-ímfhálaithe, agus rátaí malairte ar iarraidh. Tugann uimhreacha nó cóid atá ann cheana i Nordlet 422.

In aice leis sin, déanann an dá fhoirceann comparáid idir na fo-leabhair agus na hidirbhirt leabhair sa phacáiste céanna agus tugann siad na difríochtaí ar ais mar warnings seachas earráidí:

  • iomlán gan íoc de openReceivables vs an t-iarmhéid ar an cuntas receivables (riail phostála sales.receivable, 2410 de réir réamhshocraithe);
  • iomlán gan íoc de openPayables vs an cuntas payables (purchases.payables, 4430);
  • costas iomlán stock vs an cuntas stoic (inventory.stock, 2040);
  • in aghaidh an ghrúpa sócmhainní, costas na sócmhainní vs cuntas sócmhainní an ghrúpa agus a n-ímfhálú carntha vs an cuntas ímfhálaithe.

Ciallaíonn rabhadh nach n-aontaíonn fo-leabhar an tseanchórais agus an leabhar mór. Ceartaigh an pacáiste (nó glac leis an difríocht go feasach) mus a n-allmhaireoidh tú.

An freagra

{
  "dryRun": false,
  "cutoverDate": "2026-01-01",
  "accounts": { "created": 1, "existing": 0 },
  "partners": { "created": 2, "existing": 0 },
  "items": { "created": 1, "existing": 0 },
  "assetGroups": { "created": 1, "existing": 0 },
  "openingBalances": { "journalTransactionId": "…", "date": "2026-01-01", "entries": 8,
                        "debitTotal": "18800.00", "creditTotal": "18800.00", "balancingAmount": "5700.00" },
  "journal": { "transactions": 0, "entries": 0 },
  "openReceivables": { "created": 2, "outstandingTotal": "1500.00" },
  "openPayables": { "created": 1, "outstandingTotal": "700.00" },
  "fixedAssets": { "created": 1, "costTotal": "12000.00", "accumulatedDepreciationTotal": "2400.00" },
  "stock": { "movements": 1, "costTotal": "300.00" },
  "numberSeries": [],
  "warnings": []
}

Marcálann dryRun: true rith seiceála; an sin is null é journalTransactionId. Taifeadtar allmhairiú sa loga iniúchta mar migration.imported leis an achoimre céanna.

Tar éis an allmhairithe

  • Glasáil na tréimhsí roimh an athrú (ledger/periods/lock) ionas nach dtarlaíonn postáil ar bith isteach sa stair a allmhairíodh de thaisme.
  • Seiceáil an t-iarmhéid trialach agus an clár chothromaíochta amhail dáta an athraithe in aghaidh tuarascálacha deiridh an tseanchórais.
  • Lean ar aghaidh leis an ngnáthsreabhadh: eisigh sonrasc, allmhairigh ráitis bhainc, comhoiriúnaigh íocaíochtaí - socraítear na sonrasc oscailte a allmhairíodh cosúil le haon sonrasc eile.

An rud nach gcismus an t-allmhaireoir: línte sonrasc agus cláir CBL de thréimhsí caite (coinnigh sa tseanchóras nó ina chartlann iad), stair párolla, agus doiciméid seachas sonrasc (orduithe, nótaí seachadta, conarthaí).