---
id: object/codeunit/5469
type: object
title: Codeunit 5469 "Library API - General Journal"
summary: Codeunit 5469 "Library API - General Journal" in Base Application (Microsoft.Finance.GeneralLedger.Journal). 3 public procedures. Present since at least BC23, still in BC30.
tier: official
language: en
tags:
  - codeunit
  - base application
versions:
  introduced: null
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: cf149ec828456ad1c7c04b61955a8578ae8d617ca8b93f053f5bb0e62708cf60
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/GeneralLedger/Journal/LibraryAPIGeneralJournal.Codeunit.al
    title: src/Layers/W1/BaseApp/Finance/GeneralLedger/Journal/LibraryAPIGeneralJournal.Codeunit.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: codeunit
object_id: 5469
name: Library API - General Journal
namespace: Microsoft.Finance.GeneralLedger.Journal
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 0
  procedures: 6
  events: 0
  subscribers: 0
relations:
  out: 0
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 2
  called_by: 5
  implements: 0
---

# Codeunit 5469 "Library API - General Journal"

> Codeunit 5469 "Library API - General Journal" in Base Application (Microsoft.Finance.GeneralLedger.Journal). 3 public procedures. Present since at least BC23, still in BC30.

Base Application · Microsoft.Finance.GeneralLedger.Journal · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Finance/GeneralLedger/Journal/LibraryAPIGeneralJournal.Codeunit.al) · facts from BC29

## Procedures

- `InitializeLine(var GenJournalLine: Record "Gen. Journal Line"; LineNo: Integer; DocumentNo: Code[20]; ExternalDocumentNo: Code[35])`: Initializes a general journal line with proper line number, document numbers, and default values based on existing lines. Replicates journal page behavior for API-driven journal line creation with appropriate field inheritance.
- `EnsureGenJnlBatchExists(TemplateNameTxt: Text[10]; BatchNameTxt: Text[10])`: Ensures that a general journal batch exists for the specified template and batch names, creating it if necessary. Provides batch creation with default configuration for API scenarios requiring guaranteed batch availability.
- `GetBatchNameFromId(JournalBatchId: Guid): Code[10]`: Retrieves journal batch name from the specified system ID for API lookup scenarios. Provides system ID to batch name resolution for API integration requirements.

Plus 3 local procedures.

## Triggers

OnRun

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 230 "GenJnlManagement"](../codeunit/230.md) (1 call: `SetUpNewLine → CalcBalance`)
- [Codeunit 308 "No. Series - Batch"](../codeunit/308.md) (1 call: `AlterDocNoBasedOnExternalDocNo → SimulateGetNextNo`)

## Called by

- [Page 20049 "APIV1 - JournalLines"](../page/20049.md) (2 calls: `OnInsertRecord → GetBatchNameFromId`, `OnInsertRecord → InitializeLine`)
- [Page 20058 "APIV1 - Customer Payments"](../page/20058.md) (2 calls: `OnInsertRecord → GetBatchNameFromId`, `OnInsertRecord → InitializeLine`)
- [Page 30055 "APIV2 - Customer Payments"](../page/30055.md) (2 calls: `OnInsertRecord → GetBatchNameFromId`, `OnInsertRecord → InitializeLine`)
- [Page 30060 "APIV2 - Vendor Payments"](../page/30060.md) (2 calls: `OnInsertRecord → GetBatchNameFromId`, `OnInsertRecord → InitializeLine`)
- [Page 30049 "APIV2 - JournalLines"](../page/30049.md) (1 call: `OnInsertRecord → InitializeLine`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: none

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "codeunit", object_name: "Library API - General Journal")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.