Abrechnung & Preise

{
  "batch_name": "Q4 Belege",
  "processing": {
    "phases": ["conversion"],  // Nur Konvertierung
    // "phases": ["analysis"],  // Nur Analyse
    // "phases": ["conversion", "analysis"]  // Standard: Beide
  }
}

{
  "batch_id": "b_abc123",
  "status": "queued",

  "partner_code": {
    "code": "PARTNER2024",
    "discount_percent": 15.00,
    "provision_percent": 15.00,
    "snapshot_id": "pcs_xyz789"  // Unveränderlicher Snapshot
  },

  "estimated_cost": {
    "conversion_eur": "1.00",      // 50 Seiten × 0,02 €
    "analysis_eur": "1.50",        // 50 Seiten × 0,03 €
    "subtotal_eur": "2.50",        // Summe vor Rabatt
    "discount_eur": "0.38",        // 15% Rabatt
    "total_eur": "2.12"            // Endpreis
  }
}

POST /v1/batches

Response 202 Accepted:
{
  "batch_id": "b_abc123",
  "status": "queued",

  "estimated_cost": {
    "conversion_eur": "0.48",      // 24 Seiten × 0,02 €
    "analysis_eur": "0.72",        // 24 Seiten × 0,03 €
    "subtotal_eur": "1.20",
    "discount_eur": "0.18",        // 15% Rabatt
    "total_eur": "1.02"            // Geschätzter Endpreis
  },

  "estimated_duration_seconds": 180,
  "created_at": "2025-10-06T10:00:00Z"
}

// Eigene Kalkulation
const pages = 50;
const pricePerPage = 0.05;  // Konvertierung (0,02 €) + Analyse (0,03 €)
const subtotal = pages * pricePerPage;

// Mit Partner-Rabatt
const discountPercent = 15;  // Von Projekt/Partner-Code
const discount = subtotal * (discountPercent / 100);
const total = subtotal - discount;

console.log(`Geschätzte Kosten: ${total.toFixed(2)} €`);
// Output: Geschätzte Kosten: 2.12 €

{
  "batch_id": "b_abc123",
  "status": "completed",

  "result": {
    "download_url": "https://files.partner.example/presigned/result.zip",
    "file_size_bytes": 5242880,
    "sha256": "a3b5c7d9..."
  },

  "usage": {
    "pages_processed": 38,              // Tatsächliche Seitenzahl
    "documents_processed": 12,
    "conversion_duration_seconds": 150,
    "analysis_duration_seconds": 95,
    "total_duration_seconds": 245
  },

  "billing": {
    "partner_code": "PARTNER2024",
    "snapshot_id": "pcs_xyz789",

    // Finale Abrechnung
    "conversion_cost_eur": "0.76",     // 38 Seiten × 0,02 €
    "analysis_cost_eur": "1.14",       // 38 Seiten × 0,03 €
    "subtotal_eur": "1.90",
    "discount_eur": "0.29",             // 15% Rabatt
    "total_cost_eur": "1.61"           // Endpreis
  }
}

GET /v1/batches?from=2025-10-01&to=2025-10-31

Response:
{
  "batches": [
    {
      "batch_id": "b_abc123",
      "batch_name": "Q4 2024",
      "status": "completed",
      "created_at": "2025-10-06T10:00:00Z",
      "billing": {
        "total_cost_eur": "1.61"
      }
    },
    {
      "batch_id": "b_def456",
      "status": "completed",
      "billing": {
        "total_cost_eur": "1.02"
      }
    }
  ],
  "summary": {
    "total_batches": 2,
    "total_pages": 62,
    "total_cost_eur": "2.63"
  }
}

interface BatchBilling {
  batchId: string;
  customerId: string;
  pages: number;
  totalCost: number;
  partnerCode: string | null;
  snapshotId: string | null;
  processedAt: Date;
}

async function saveBillingData(batchId: string) {
  // Batch-Ergebnis von SteuerMappePro API abrufen
  const response = await fetch(
    `https://api.steuermappe-pro.de/v1/batches/${batchId}/result`,
    {
      headers: {
        'Authorization': `Bearer ${accessToken}`
      }
    }
  );

  const data = await response.json();

  // In eigener Datenbank speichern
  await db.billing.create({
    batchId: data.batch_id,
    customerId: getCurrentCustomerId(),
    pages: data.usage.pages_processed,
    totalCost: parseFloat(data.billing.total_cost_eur),
    partnerCode: data.billing.partner_code,
    snapshotId: data.billing.snapshot_id,
    processedAt: new Date(data.completed_at)
  });

  // Eigene Kundenrechnung erstellen
  await generateCustomerInvoice(data);
}