causa-prima-ai/scribo-skill

Was macht scribo-skill?

Scribo Claude/Codex Skill – Erstelle EN 16931-konforme E-Rechnungen (XRechnung, ZUGFeRD, Factur-X, Peppol BIS UBL, Facturae) über die öffentliche Scribo HTTP-API.

Beschreibung

Dieses Skill ermöglicht es AI-Agenten, automatisch elektronische Rechnungen zu generieren, die den europäischen Standard EN 16931 erfüllen. Es unterstützt eine Vielzahl von nationalen und internationalen Formaten.

Unterstützte Formate

• XRechnung (Deutschland)
• ZUGFeRD (Deutschland)
• Factur-X (Frankreich)
• Peppol BIS UBL (International)
• Facturae (Spanien)

Verwendung

Das Skill interagiert mit der öffentlichen Scribo-API. Du benötigst einen API-Schlüssel, den du unter Scribo Dashboard erhalten kannst.

Beispielaufruf

import requests

url = "https://api.scribo.dev/v1/invoices"
headers = {
    "Authorization": "Bearer DEIN_API_SCHLUESSEL",
    "Content-Type": "application/json"
}
payload = {
    "format": "xrechnung",
    "invoice": {
        "seller": {
            "name": "Firma GmbH",
            "vatId": "DE123456789",
            "address": {
                "street": "Musterstraße 1",
                "city": "Berlin",
                "zip": "10115",
                "country": "DE"
            }
        },
        "buyer": {
            "name": "Kunde AG",
            "vatId": "DE987654321",
            "address": {
                "street": "Kundenweg 5",
                "city": "München",
                "zip": "80331",
                "country": "DE"
            }
        },
        "items": [
            {
                "description": "Beratungsleistungen",
                "quantity": 10,
                "unitPrice": 100.00,
                "vatRate": 19.0
            }
        ]
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Antwort

Die API gibt eine JSON-Antwort mit der generierten Rechnung im angeforderten Format zurück. Das Ergebnis kann als Datei gespeichert oder direkt an den Benutzer ausgegeben werden.

{
    "status": "success",
    "data": {
        "filename": "INV-2025-001.xml",
        "content": "<xml>...</xml>",
        "format": "xrechnung"
    }
}

Konfiguration

Um das Skill zu verwenden, müssen folgende Umgebungsvariablen gesetzt sein:

• SCRIBO_API_KEY – Dein persönlicher API-Schlüssel für die Scribo-API.

Fehlerbehandlung

Bei Fehlern gibt die API entsprechende HTTP-Statuscodes und Fehlermeldungen zurück. Häufige Fehler sind:

• 400 Bad Request – Ungültige Rechnungsdaten
• 401 Unauthorized – Fehlender oder ungültiger API-Schlüssel
• 500 Internal Server Error – Interner Serverfehler

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Weitere Informationen findest du in der Datei LICENSE.