Invoice Created

Emitted when a new invoice has been generated and is ready to be sent to a customer

Event Domain Event

Overview

The InvoiceCreated event signals that a new invoice has been generated and added to the system, creating an accounts receivable record.

Event Schema

Schema Definition

{
  "eventId": "uuid",
  "eventType": "InvoiceCreated",
  "timestamp": "2025-12-11T10:30:00Z",
  "version": "1.0.0",
  "data": {
    "invoiceId": "string",
    "invoiceNumber": "string",
    "customerId": "string",
    "customerName": "string",
    "invoiceDate": "date",
    "dueDate": "date",
    "lineItems": [
      {
        "description": "string",
        "quantity": "number",
        "unitPrice": "number",
        "amount": "number",
        "taxRate": "number"
      }
    ],
    "subtotal": "number",
    "taxAmount": "number",
    "totalAmount": "number",
    "currency": "string",
    "paymentTerms": "string",
    "status": "draft | sent",
    "metadata": {
      "orderId": "string (optional)",
      "contractId": "string (optional)"
    }
  }
}

Example Payload

{
  "eventId": "inv_a1b2c3d4",
  "eventType": "InvoiceCreated",
  "timestamp": "2025-12-11T10:30:00Z",
  "version": "1.0.0",
  "data": {
    "invoiceId": "inv_1234567890",
    "invoiceNumber": "INV-2025-000123",
    "customerId": "cus_johndoe",
    "customerName": "John Doe",
    "invoiceDate": "2025-12-11",
    "dueDate": "2026-01-10",
    "lineItems": [
      {
        "description": "Professional Services - December 2025",
        "quantity": 40,
        "unitPrice": 150.00,
        "amount": 6000.00,
        "taxRate": 0.08
      }
    ],
    "subtotal": 6000.00,
    "taxAmount": 480.00,
    "totalAmount": 6480.00,
    "currency": "USD",
    "paymentTerms": "Net 30",
    "status": "draft",
    "metadata": {
      "contractId": "CON-2025-001"
    }
  }
}

Downstream Actions

  • Ledger Service: Creates AR journal entry (debit AR, credit Revenue)
  • AR Service: Adds to customer’s outstanding balance
  • Analytics Service: Updates revenue forecasts
26 properties
eventIdstring<uuid>
required
eventTypestringconstant: InvoiceCreated
required
timestampstring<date-time>
required
versionstring
required
Match pattern: ^\d+\.\d+\.\d+$
dataobject
required
Edit this page