invoice-processing

name	invoice-processing
description	Extract, validate, and classify invoices from PDF, Factur-X, and UBL formats. Multi-country support with field mapping and anomaly detection.
version	1.0.0
last-updated	2026-04-17
model_tested	claude-sonnet-4-6
category	documents
platforms	["claude-code","codex","gemini-cli","cursor","copilot","windsurf","cline"]
language	en
geo_relevance	["global","fr","eu"]
priority	medium
dependencies	{"mcp":[],"skills":["fr-facturation-electronique"],"apis":[],"data":[]}
update_sources	[{"url":"https://fnfe-mpe.org/factur-x/","check_frequency":"yearly","last_checked":"2026-04-21"}]
license	MIT

Invoice Processing

When to Use

• Extracting data from PDF invoices
• Validating Factur-X or UBL structured invoices
• Classifying invoices by type, vendor, or account
• Detecting anomalies (duplicates, unusual amounts, missing fields)
• Mapping invoice fields to accounting entries

Extraction Pipeline

1. INPUT: PDF / Factur-X / UBL / image
2. DETECT FORMAT: structured XML embedded? → parse directly
   No XML? → OCR + field extraction
3. EXTRACT FIELDS: map to canonical schema
4. VALIDATE: required fields, amounts, VAT consistency
5. CLASSIFY: expense category, accounting account, vendor
6. OUTPUT: structured JSON + confidence scores

Canonical Invoice Schema

{
  "invoice_number": "FA-2026-042",
  "invoice_date": "2026-04-15",
  "due_date": "2026-05-15",
  "supplier": {
    "name": "Fournisseur SAS",
    "tax_id": "FR12345678901",
    "address": "12 rue Example, 75001 Paris"
  },
  "buyer": {
    "name": "Client SARL",
    "tax_id": "FR98765432109"
  },
  "lines": [
    {
      "description": "Prestation conseil",
      "quantity": 5,
      "unit_price": 200.00,
      "vat_rate": 20.0,
      "line_total": 1000.00
    }
  ],
  "subtotal": 1000.00,
  "vat_amount": 200.00,
  "total": 1200.00,
  "currency": "EUR",
  "payment_terms": "30 jours net"
}

Validation Rules

Rule	Check	Severity
Required fields	invoice_number, date, supplier, total	Critical
Math consistency	sum(lines) = subtotal, subtotal + VAT = total	Critical
VAT rate validity	Rate matches country standard rates	Warning
Duplicate detection	Same number + supplier + amount	Critical
Date logic	due_date >= invoice_date	Warning
Currency	Valid ISO 4217 code	Warning

Anomaly Detection

Anomaly	Signal	Action
Duplicate invoice	Same number + supplier + amount +/- 5%	Block, flag for review
Round amount	Total is exact round number (1000, 5000)	Flag (common in fraud)
Weekend/holiday date	Invoice dated on non-business day	Flag
Unusual amount	> 3 standard deviations from vendor average	Flag for review
Missing VAT	Taxable transaction with 0% VAT	Flag, check exemption

What This Skill Does NOT Do

• Does not perform OCR (uses existing OCR output or structured XML)
• Does not approve or pay invoices (validation and extraction only)
• Does not connect to ERP systems (outputs structured data)
• Does not handle tax compliance (see fr-comptabilite)