> ## Documentation Index > Fetch the complete documentation index at: https://docs.business-os.de/llms.txt > Use this file to discover all available pages before exploring further. # Kassenbucheintrag (einfach) > Erstellt einen einfachen Kassenbucheintrag in DATEV Unternehmen Online. **Kosten:** 1 Credit ## OpenAPI ````yaml POST /v2/datev-duo/kassenbuch-einfach openapi: 3.1.0 info: title: Business OS API description: >- API für Business OS – Zugang zu DATEV und Banking Enterprise-Schnittstellen. Alle Endpoints erfordern einen API Key im `x-api-key` Header. Credits werden pro API-Call abgezogen. version: 2.0.0 contact: name: Business OS Support email: impressum@business-os.de url: https://business-os.de/kontakt servers: - url: https://api.business-os.de description: Production security: - ApiKeyAuth: [] tags: - name: DATEV Allgemein description: >- Modulübergreifende DATEV-Endpunkte (z. B. Abo-/Service-Diagnose für Mandanten) - name: DATEV DUO description: DATEV Unternehmen Online — Kassenbuch, Belegbilder und Buchungsvorschläge - name: DATEV ReWe - Write description: 'DATEV Rechnungswesen — Write: Buchungen, Kontakte, Belegtypen, Steuersätze' - name: DATEV ReWe - Read description: >- DATEV Rechnungswesen — Read (Export): Geschäftsjahre und weitere Lesemodule - name: Banking AIS description: >- Account Information Services — Verbindungen, Kontostände und Transaktionen verwalten - name: Banking PIS description: Payment Initiation Services — Zahlungen ausführen und Status abrufen - name: Banking Webhooks description: Webhook-Konfiguration für Echtzeit-Benachrichtigungen paths: /v2/datev-duo/kassenbuch-einfach: post: tags: - DATEV DUO summary: Kassenbucheintrag (einfach) description: |- Erstellt einen einfachen Kassenbucheintrag in DATEV Unternehmen Online. **Kosten:** 1 Credit parameters: - $ref: '#/components/parameters/ConnectionIdParam' - $ref: '#/components/parameters/CreditQuelleParam' requestBody: required: true content: application/json: schema: type: object required: - waehrung - kassenname - belegtext - betrag - transaktionsdatum - belegnummer - steuersatz - bewegung properties: waehrung: type: string description: Währungscode (ISO 4217) example: EUR kassenname: type: string description: >- Name des Kassenbuchs. Kann aus `GET /v2/datev-duo/kassenbuecher` (Feld `bezeichnung`) ausgelesen werden. example: Kasse belegtext: type: string description: Text zur Buchungsbewegung example: Büromaterial betrag: type: number description: >- Absolutbetrag; Vorzeichen der Buchung ergibt sich aus `bewegung`. example: 49.99 transaktionsdatum: type: string format: date-time description: ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339). example: '2025-03-01T00:00:00Z' gegenkonto: type: string description: Sachkonto als Gegenkonto zur Kasse (z. B. Büromaterial). example: '4930' belegnummer: type: string description: >- Eindeutige Transaktions-ID. Erlaubte Zeichen: `a-z A-Z 0-9 $ % & * + - /` (max. 36 Zeichen). pattern: ^[a-zA-Z0-9$%&*+\-/]{0,36}$ example: TX-12345 steuersatz: type: number description: Steuersatz in Prozent example: 19 bewegung: type: string description: Nur exakt `EINNAHME` oder `AUSGABE` (Großschreibung). enum: - EINNAHME - AUSGABE example: AUSGABE belegNummer: type: string description: Kann die Belegnummer enthalten. example: INV-123 belegbilder: type: array description: Optionale Belegbilder (Quittungen) items: type: object required: - content properties: content: type: string description: Base64-kodierter Dateiinhalt dateiname: type: string maxLength: 255 description: Dateiname inkl. Endung example: quittung-buero.pdf responses: '200': description: Kassenbucheintrag erfolgreich erstellt content: application/json: schema: type: object properties: belegnummer: type: string example: TX-12345 kassenname: type: string example: Kasse transaktionsdatum: type: string format: date-time example: '2025-03-01T00:00:00Z' bewegung: type: string example: AUSGABE betrag: type: number example: -49.99 waehrung: type: string example: EUR belegtext: type: string example: Büromaterial gegenkonto: type: string example: '4930' belegNummer: type: string example: INV-123 steuersatz: type: number example: 19 belegbilder: type: array description: >- Metadaten zu hochgeladenen Belegbildern (Form je nach Schnittstelle) items: type: object properties: dateiname: type: string description: Dateiname des Belegbilds example: quittung-buero.pdf additionalProperties: true datevAntwort: description: >- Ergebnis des DATEV-Async-Tasks. `null`, wenn kein Task gepollt wurde. nullable: true allOf: - $ref: '#/components/schemas/DatevAntwortKassenbuch' business-os: type: object properties: neuesGuthaben: type: integer nullable: true example: 499 example: belegnummer: TX-12345 kassenname: Kasse transaktionsdatum: '2025-03-01T00:00:00Z' bewegung: AUSGABE betrag: -49.99 waehrung: EUR belegtext: Büromaterial gegenkonto: '4930' belegNummer: INV-123 steuersatz: 19 belegbilder: - dateiname: quittung-buero.pdf datevAntwort: status: ERFOLGREICH meldungen: - dateiname: quittung-buero.pdf nachricht: Beleg erfolgreich an das Kassenbuch übergeben. zeitstempel: '2023-11-07T05:31:56Z' typ: INFO business-os: neuesGuthaben: 499 '400': description: Fehlende oder ungültige Pflichtfelder im JSON-Body. content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: >- Fehlende Pflichtfelder: waehrung, kassenname, belegtext, betrag, transaktionsdatum, belegnummer, steuersatz, bewegung '401': $ref: '#/components/responses/DatevUnauthorized' '402': $ref: '#/components/responses/DatevPaymentRequired' '404': $ref: '#/components/responses/DatevNoConnection404' '500': $ref: '#/components/responses/DatevInternal500' '502': $ref: '#/components/responses/DatevBadGateway502' '504': $ref: '#/components/responses/DatevAsyncTimeout504' default: $ref: '#/components/responses/DatevServiceError' components: parameters: ConnectionIdParam: name: connectionId in: query required: true schema: type: string format: uuid example: abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145 description: >- UUID der DATEV-Verbindung. Abrufbar über den `/connections`-Endpunkt des jeweiligen Moduls (z. B. `GET /v2/datev-duo/connections`). CreditQuelleParam: name: quelle in: query required: false schema: type: string default: API example: Make description: >- Kennzeichnung der Aufrufquelle für die Nutzungsanalyse. Standard bei Weglassen: `API` (direkter API-Aufruf). Für Automationen aus Make z. B. `Make` angeben. schemas: DatevAntwortKassenbuch: type: object description: >- Ergebnis des asynchronen DATEV-Tasks (Kassenbuch einfach): `meldungen` statt `information`. properties: status: type: string description: Status meldungen: type: array items: $ref: '#/components/schemas/DatevAntwortMeldung' additionalProperties: true DatevError: type: object description: >- JSON-Fehlerantwort. Bei Fehlern der DATEV-Schnittstelle kann zusätzlich `details` gesetzt sein. Bei bekannten Fehlerkategorien ist ein stabiler `code` gesetzt, anhand dessen Automatisierungen reagieren können. required: - error properties: error: type: string description: Fehlermeldung message: type: string description: >- Zusätzliche Erläuterung; wenn der Header `x-api-key` fehlt: Hinweis zur erforderlichen Header-Zeile. code: type: string description: >- Stabiler, maschinenlesbarer Fehlercode für bekannte Fehlerkategorien. Wird nur gesetzt, wenn die Ursache eindeutig erkannt wurde. - `datev_connection_invalid`: Account-Key ist abgelaufen oder widerrufen — Reconnect über das Dashboard nötig. Begleitet von `reconnectUrl`. - `datev_export_service_missing`: Mandant hat keine relevante DATEV-Subscription gebucht (z. B. Belegbilderservice, Rechnungsdatenservice, Datenservice Export Rechnungswesen-Familie). Begleitet von `activeSubscriptions` mit der Liste der tatsächlich aktiven Services. - `datev_endpoint_not_authorized`: Subscription am Mandanten ist vorhanden und der Token gilt, aber das DATEV-RVO-Schreib-/Leserecht für den konkreten Endpoint fehlt für den authentifizierten Nutzer. Reconnect hilft hier nicht — der Steuerberater/Mandant-Inhaber muss in DATEV RVO das entsprechende Teilrecht freischalten. enum: - datev_connection_invalid - datev_export_service_missing - datev_endpoint_not_authorized reconnectUrl: type: string format: uri description: >- URL zum Business OS Dashboard, über die der Nutzer die DATEV-Verbindung erneuern kann. Gesetzt bei `code = datev_connection_invalid`. activeSubscriptions: type: array items: type: string description: >- Liste der aktuell aktiven DATEV-Service-Subscriptions des Mandanten (z. B. Belegbilderservice, Rechnungsdatenservice 1.0). Gesetzt bei `code = datev_export_service_missing`, damit Automationen erkennen, welche Services bereits gebucht sind. details: type: object description: >- Strukturierte Zusatzinformationen bei Antworten der DATEV-Schnittstelle. additionalProperties: true DatevAntwortMeldung: type: object description: Ein Eintrag in der Meldungsliste der DATEV-Antwort (öffentliche Felder). properties: dateiname: type: string description: Dateiname nachricht: type: string description: Nachricht zeitstempel: type: string description: Zeitstempel format: date-time typ: type: string description: Typ (z. B. INFO) additionalProperties: true responses: DatevUnauthorized: description: >- API-Key fehlt, ist ungültig, widerrufen oder abgelaufen. Fehlt der Header `x-api-key`, enthält die Antwort zusätzlich `message`. content: application/json: schema: $ref: '#/components/schemas/DatevError' examples: ungueltigerKey: summary: Ungültiger oder unbekannter Key value: error: Ungültiger API-Key fehlenderHeader: summary: Fehlender x-api-key Header value: error: Fehlende Header message: x-api-key Header ist erforderlich. DatevPaymentRequired: description: Nicht genügend Credits für diesen Aufruf. content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: Nicht genügend Credits DatevNoConnection404: description: >- Es ist keine gespeicherte DATEV-Verbindung für die Organisation vorhanden. Der Text in `error` nennt das gewählte DATEV-Produkt (z. B. DATEV Unternehmen Online). content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: Keine Verbindung gefunden für DATEV Unternehmen Online DatevInternal500: description: >- Unerwarteter Serverfehler oder fehlende Serverkonfiguration für den DATEV-Dienst. content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: API-Dienst nicht konfiguriert. DatevBadGateway502: description: >- Die DATEV-Schnittstelle war kurzzeitig nicht erreichbar (Netzwerk- oder Verbindungsfehler). content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: Die DATEV-Schnittstelle ist vorübergehend nicht erreichbar. DatevAsyncTimeout504: description: >- Der asynchrone DATEV-Task wurde nicht innerhalb des Zeitlimits abgeschlossen (max. ca. 40 Sekunden). content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: 'Async-Task-Timeout: Task wurde nicht rechtzeitig abgeschlossen.' DatevServiceError: description: >- Fehlerantwort der DATEV-Schnittstelle (HTTP-Status entspricht der DATEV-Antwort). Der Body enthält `error` und optional `details` mit Zusatzinformationen. Bei 403 wegen fehlendem DATEV Rechnungswesen-Exportservice ist zusätzlich `code = datev_export_service_missing` und `activeSubscriptions` gesetzt. content: application/json: schema: $ref: '#/components/schemas/DatevError' examples: mitDetails: summary: Beispiel mit details value: error: Validierung fehlgeschlagen details: message: … exportserviceFehlt: summary: 403 – DATEV Rechnungswesen-Exportservice nicht abonniert value: error: >- DATEV Rechnungswesen-Exportservice ist für diesen Mandanten nicht abonniert. Aktive Services: Belegbilderservice, Rechnungsdatenservice 1.0. Bitte den Service über DATEV beim Mandant aktivieren. code: datev_export_service_missing activeSubscriptions: - Belegbilderservice - Rechnungsdatenservice 1.0 details: errors: - message: 'RVO-Recht fehlt: Stammdaten' verbindungUngueltig: summary: 401 – DATEV-Verbindung ungültig (zur Referenz) value: error: >- Die DATEV-Verbindung ist ungültig oder abgelaufen. Bitte im Business OS Dashboard die Verbindung erneuern. code: datev_connection_invalid reconnectUrl: https://app.business-os.de/ securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Dein Business OS API Key. Erstelle einen unter [app.business-os.de](https://app.business-os.de/) → API Keys. ````