Finault Documentation

Turn AI invoices into audit-ready journal entries. This documentation covers everything from basic invoice analysis to real-time gateway integration.

Quickstart

1. Upload an Invoice

Go to app.html and drag your AI provider CSV (OpenAI, Anthropic, Azure, or Google) into the upload zone. Or click "Try with Sample Data" to see how it works.

2. Review Allocation

Finault automatically detects your provider, extracts costs, and allocates to cost centers based on project metadata. Review the allocation breakdown and confidence scores.

3. Download Close Pack

Click "Download Complete Close Pack" to get a ZIP containing:

• Executive Summary — CFO-ready overview PDF
• GL Journal Entry — NetSuite/QuickBooks-ready CSV
• Reconciliation Certificate — Audit-ready proof with SHA-256 hash
• Controls Narrative — SOX-compliant documentation

Core Concepts

Cost Centers

Cost centers are organizational units (teams, projects, departments) that consume AI resources. Finault maps invoice line items to cost centers using project metadata and custom rules.

Allocation Rules

Rules define how costs are assigned to GL codes and cost centers. Pattern matching (e.g., proj-platform-* → ENG-001) allows flexible, automated allocation.

Confidence Scores

Each allocation has a confidence score (0-100%) based on the clarity of the metadata match. High confidence (90%+) means strong mapping; lower scores may need manual review.

Data Integrity

Every Close Pack includes a SHA-256 hash of the source data, ensuring the output can be verified against the original invoice. This is critical for audit compliance.

Invoice Analyzer

The Invoice Analyzer accepts CSV exports from major AI providers and automatically detects the format.

Supported Providers

Close Pack

The Close Pack is a finance-ready deliverable containing everything needed to close the books on AI spend.

Components

Unit Economics PRO

Understand the true cost of AI in your business with unit economics calculations.

Metrics

• Cost per Transaction — Total spend ÷ API calls
• Cost per User — Total spend ÷ Active users
• AI % of Revenue — Total spend ÷ AI-attributed revenue × 100
• Revenue per $1 Spent — AI-attributed revenue ÷ Total spend

Gateway Setup BUSINESS

Route all AI API calls through Finault Gateway for real-time cost attribution, budget enforcement, and compliance logging.

Quick Integration

Change one environment variable to start routing through Finault:

# For OpenAI
export OPENAI_BASE_URL="https://gateway.finault.ai/v1"
export FINAULT_API_KEY="fin_live_xxxxxxxxxxxx"

# For Anthropic
export ANTHROPIC_BASE_URL="https://gateway.finault.ai/anthropic"
export FINAULT_API_KEY="fin_live_xxxxxxxxxxxx"

Headers

Add cost attribution headers to your requests:

Gateway Endpoints

Budget Enforcement BUSINESS

Set hard or soft limits on AI spend by team, project, or time period.

Budget Types

• Hard Limit — Requests that would exceed budget return HTTP 402 (Payment Required)
• Soft Limit — Alerts triggered at threshold (e.g., 80%) but requests continue

# Create a budget
curl -X POST https://gateway.finault.ai/v1/budgets \
  -H "Authorization: Bearer fin_live_xxx" \
  -d '{
    "name": "Platform Team Monthly",
    "cost_center": "ENG-001",
    "limit": 50000,
    "period": "monthly",
    "type": "hard",
    "alert_threshold": 0.8
  }'

API Authentication

All API requests require a Finault API key in the Authorization header.

Authorization: Bearer fin_live_xxxxxxxxxxxx

API Key Types

API: Analyze BUSINESS

curl -X POST https://gateway.finault.ai/v1/analyze \
  -H "Authorization: Bearer fin_live_xxx" \
  -F "file=@invoice.csv"

API: Allocate BUSINESS

API: Close Pack BUSINESS

API: Verify

curl "https://gateway.finault.ai/v1/attest/verify?hash=sha256:7f83b1657..."

Data Security

Encryption

• In Transit — TLS 1.3 for all connections
• At Rest — AES-256 encryption for stored data

Data Retention

Compliance

Standards

• SOX 404 — Controls Narrative document provides required documentation
• GAAP/IFRS — Journal entries follow standard accounting practices
• EU AI Act — Audit logging supports Article 12 requirements (Enterprise)
• SOC 2 Type II — In progress (Q2 2026)