# Journal Entry Created

Fired when a new journal entry is created.

Use Cases:
- Real-time GL integration
- Audit trail synchronization
- External accounting system updates

Security: Payload is signed with HMAC-SHA256. 
Verify using the X-NPS-Signature header.

Endpoint: POST ledgerJournalEntryCreated
Version: 1.0.0

## Request fields (application/json):

  - `id` (string)
    Unique event ID (use for idempotency)

  - `type` (string)
    Enum: "ledger.journal_entry.created"

  - `occurredAt` (string)

  - `data` (object)

  - `data.id` (string, required)

  - `data.entityId` (string, required)

  - `data.entryDate` (string, required)

  - `data.currency` (string, required)
    ISO 4217 currency code

  - `data.source` (string, required)
    Source of journal entry
    Enum: "INVOICE", "PAYMENT", "REFUND", "ADJUSTMENT", "REMITTANCE"

  - `data.sourceReference` (string)
    Reference to source document (e.g., invoice ID)

  - `data.references` (object)
    Nested map of invoice IDs to charge IDs for tracing.
Structure: { "invoiceId": ["chargeId1", "chargeId2"], ... }
Enables tracking when a payment applies to multiple invoices.

  - `data.adjustmentType` (string)
    Type of adjustment for manual entries
    Enum: "STANDARD", "DISCOUNT_CORRECTION", "FEE_CORRECTION", "CREDIT_MEMO", "DEBIT_MEMO", "WRITE_OFF"

  - `data.reason` (string)
    Reason for adjustment (if applicable)

  - `data.adminUserId` (string)
    Admin user who created the entry (for adjustments)

  - `data.relatedSourceRef` (string)
    Reference to related entries

  - `data.totalAmount` (integer, required)
    Total amount of the entry in cents

  - `data.isBalanced` (boolean, required)
    Whether debits equal credits

  - `data.lines` (array, required)

  - `data.lines.accountCode` (string, required)
    Chart of accounts code
    Enum: "REVENUE", "AR", "CONTRA_REVENUE", "CLEARING", "BANK", "FEE_EXPENSE", "REFUND_EXPENSE"

  - `data.lines.externalAccountCode` (string)
    External GL account code for export

  - `data.lines.direction` (string, required)
    Direction of journal line
    Enum: "DEBIT", "CREDIT"

  - `data.lines.amount` (integer, required)
    Amount in cents (always positive)

  - `data.lines.description` (string)

  - `data.lines.billableEntityId` (string)

  - `data.lines.accountId` (string)

  - `data.lines.invoiceId` (string)

  - `data.lines.dimensions` (object)
    Reporting dimensions

  - `data.lines.tags` (object)

  - `data.createdAt` (string, required)


## Response 200 fields