[{"data":1,"prerenderedAt":478},["ShallowReactive",2],{"frage-belegschmied-an-das-erp-anbinden":3,"frage-verwandt-belegschmied-an-das-erp-anbinden":109},{"id":4,"title":5,"antwort":6,"body":7,"description":92,"draft":93,"extension":94,"kategorie":95,"meta":96,"navigation":97,"order":98,"path":99,"seo":100,"seoTitle":101,"stem":102,"updated":103,"verwandt":104,"__hash__":108},"fragen\u002Ffragen\u002Fbelegschmied-an-das-erp-anbinden.md","Wie binden wir Belegschmied an unser ERP an?","Über die REST-API, wenn Ihr System einen HTTP-Aufruf absetzen kann, sonst über einen Power-Automate-Flow, der einen Ordner beobachtet, oder per Mail. Alle drei setzen hinter dem Punkt an, an dem die Rechnung fertig ist, im führenden System ändert sich also nichts: kein Change Request, kein Customizing, kein Regressionstest. Die API ist ab dem Business-Tarif enthalten.",{"type":8,"value":9,"toc":84},"minimark",[10,15,19,42,45,49,52,61,65,72],[11,12,14],"h2",{"id":13},"die-entscheidung-hängt-an-einer-frage","Die Entscheidung hängt an einer Frage",[16,17,18],"p",{},"Nicht am ERP-Hersteller, sondern daran, was Ihr System am Ende eines\nRechnungslaufs tun kann:",[20,21,22,30,36],"ul",{},[23,24,25,29],"li",{},[26,27,28],"strong",{},"Es kann einen HTTP-Aufruf absetzen"," oder Sie haben eine Middleware, die das\nübernimmt. Dann ist die REST-API der direkte Weg, mit Statusabfrage und\nRückgabe der erzeugten Dateien in Ihr System.",[23,31,32,35],{},[26,33,34],{},"Es legt die fertige PDF in einem Ordner ab."," Dann beobachtet ein\nPower-Automate-Flow diesen SharePoint- oder Teams-Ordner und liefert jede neue\nDatei ein. Die Vorlage stellen wir bereit. Ohne Premium-Lizenz übernimmt\nderselbe Flow den Weg per Mail.",[23,37,38,41],{},[26,39,40],{},"Es verschickt die Rechnung direkt per Mail."," Dann genügt die Versandadresse\noder ein CC in die bestehende Rechnungsmail.",[16,43,44],{},"Alle drei Wege enden in derselben Verarbeitung. Der Unterschied ist nur, wie viel\nBeteiligung Ihre IT braucht.",[11,46,48],{"id":47},"warum-keine-erp-erweiterung-nötig-ist","Warum keine ERP-Erweiterung nötig ist",[16,50,51],{},"Eine Anbindung, die im ERP ansetzt, muss jeden Geschäftsvorfall kennen, den sie\nabbilden soll. Genau daran scheitert sie bei den Rechnungen, um die es meist\ngeht, nämlich denen, die das System ohnehin nicht abbildet. Eine Schicht hinter\nder fertigen PDF hat dieses Problem nicht: Sie bekommt ein Dokument und gibt ein\nDokument zurück.",[16,53,54,55,60],{},"Details dazu in\n",[56,57,59],"a",{"href":58},"\u002Ffragen\u002Fkonvertierung-ohne-eingriff-ins-erp","Muss unser ERP angefasst werden",".",[11,62,64],{"id":63},"was-sie-beim-anbinden-bekommen","Was Sie beim Anbinden bekommen",[16,66,67,68,60],{},"Über die API nicht nur den Konvertierungsaufruf, sondern auch den lesenden\nZugriff: Ausgangs- und Eingangsrechnungen listen und filtern, XML, PDF und\nValidierungsbericht abrufen, Kunden und Lieferanten lesen, das Protokoll und den\nKontingentstand abfragen. Damit lässt sich der Zustand in Ihrem System spiegeln,\nstatt in zwei Oberflächen nachzusehen. Der Umfang im Einzelnen:\n",[56,69,71],{"href":70},"\u002Ffragen\u002Fwas-kann-die-rest-api-von-belegschmied","Was kann die REST-API",[16,73,74,75,79,80,60],{},"Für alles, was darüber hinausgeht, etwa eine Anbindung an ein bestimmtes\nDokumentenmanagement, arbeiten wir auf Projektbasis. Die Wege im Überblick stehen\nauf ",[56,76,78],{"href":77},"\u002Fintegrationen","Integrationen",", die vollständige Doku unter\n",[56,81,83],{"href":82},"\u002Fentwickler","Entwickler",{"title":85,"searchDepth":86,"depth":86,"links":87},"",3,[88,90,91],{"id":13,"depth":89,"text":14},2,{"id":47,"depth":89,"text":48},{"id":63,"depth":89,"text":64},"Über die REST-API, über einen Ordner-Flow oder per Mail. Die Anbindung setzt hinter der fertigen Rechnung an, im führenden System ändert sich dabei nichts.",false,"md","Anbindung",{},true,530,"\u002Ffragen\u002Fbelegschmied-an-das-erp-anbinden",{"title":5,"description":92},"Belegschmied an ein ERP anbinden","fragen\u002Fbelegschmied-an-das-erp-anbinden","2026-08-31",[105,106,107],"was-kann-die-rest-api-von-belegschmied","konvertierung-ohne-eingriff-ins-erp","rechnungen-automatisch-einliefern-ohne-mehraufwand","X0vCvEjuR2nNF4gtaxi_LyyqodMMMbwd0jMzeb0b3Pg",[110,248,328,404],{"id":111,"title":112,"antwort":113,"body":114,"description":237,"draft":93,"extension":94,"kategorie":95,"meta":238,"navigation":97,"order":239,"path":70,"seo":240,"seoTitle":241,"stem":242,"updated":103,"verwandt":243,"__hash__":247},"fragen\u002Ffragen\u002Fwas-kann-die-rest-api-von-belegschmied.md","Was kann die REST-API von Belegschmied?","Mehr als konvertieren. Die API deckt den gesamten Rechnungsbestand eines Workspace ab: Ausgangsrechnungen anlegen, listen und filtern, XML, PDF und Validierungsbericht abrufen, Eingangsrechnungen verarbeiten und auslesen, dazu Kunden, Lieferanten, das Protokoll und den Kontingentstand. Sie ist ab dem Business-Tarif enthalten.",{"type":8,"value":115,"toc":232},[116,120,126,136,147,153,159,165,169,184,203,217,221],[11,117,119],{"id":118},"die-sechs-bereiche","Die sechs Bereiche",[16,121,122,125],{},[26,123,124],{},"Ausgangsrechnungen."," Eine fertige PDF übergeben und daraus eine geprüfte\nE-Rechnung erzeugen lassen, wahlweise mit direktem Versand. Dazu der lesende\nZugriff: alle Ausgangsrechnungen listen, nach Status und Zeitraum filtern, eine\neinzelne im Detail abrufen.",[16,127,128,131,132,60],{},[26,129,130],{},"Eingangsrechnungen."," Eine empfangene Rechnung zur Verarbeitung einreichen und\ndie extrahierten Daten strukturiert wieder abholen. Der Eingang ist damit\ngenauso automatisierbar wie der Ausgang, siehe\n",[56,133,135],{"href":134},"\u002Ffragen\u002Feingangsrechnungen-per-api-verarbeiten","Eingangsrechnungen per API verarbeiten",[16,137,138,141,142,146],{},[26,139,140],{},"Dateien."," Zu jeder Rechnung die erzeugte XML, die PDF und den\nValidierungsbericht. Die PDF gibt es auch als ",[143,144,145],"code",{},"variant=original",", also das\nDokument, wie es eingeliefert wurde.",[16,148,149,152],{},[26,150,151],{},"Stammdaten."," Kunden und Lieferanten lesen, inklusive der Zuordnungen, die\nbeim Verarbeiten entstanden sind.",[16,154,155,158],{},[26,156,157],{},"Protokoll."," Das Audit-Log, filterbar nach Objektart. Wer nachvollziehen muss,\nwas wann mit welcher Rechnung passiert ist, holt es hier ab, statt es in der\nOberfläche zu suchen.",[16,160,161,164],{},[26,162,163],{},"Workspace und Kontingent."," Plan, Standardwährung, Freigabe-Einstellung und der\nverbrauchte Anteil am Monatskontingent. Damit lässt sich überwachen, bevor eine\nGrenze erreicht wird.",[11,166,168],{"id":167},"wie-sie-sich-anfühlt","Wie sie sich anfühlt",[16,170,171,172,175,176,179,180,183],{},"Basis-URL ist ",[143,173,174],{},"https:\u002F\u002Fbelegschmied.de\u002Fapi\u002Fv1",", authentifiziert wird mit einem\nBearer-Token (",[143,177,178],{},"bs_live_…","), das Sie in der App unter Einstellungen → REST-API\nselbst erzeugen und widerrufen. Alle Antworten sind JSON mit snake_case-Feldern,\nUploads laufen als ",[143,181,182],{},"multipart\u002Fform-data"," bis 15 MB, Downloads kommen als\nBinärdaten.",[16,185,186,187,190,191,194,195,198,199,202],{},"Die Verarbeitung ist ",[26,188,189],{},"asynchron",": Der Upload antwortet sofort mit einer\n",[143,192,193],{},"conversion_id"," und einer ",[143,196,197],{},"status_url",". Sie fragen den Status ab, statt auf eine\nlange Antwort zu warten. Sechs Verarbeitungsstatus und sieben Rechnungsstatus\nsagen jederzeit, woran eine Rechnung gerade hängt, bis hin zu\n",[143,200,201],{},"validation_failed",", wenn die EN-16931-Prüfung sie abgelehnt hat.",[16,204,205,206,209,210,213,214,60],{},"Listen-Endpunkte nehmen einheitlich ",[143,207,208],{},"limit"," (1 bis 100, Default 50) und ",[143,211,212],{},"offset","\nund liefern die Gesamtzahl mit. Datumsfilter erwarten ",[143,215,216],{},"YYYY-MM-DD",[11,218,220],{"id":219},"wo-die-vollständige-dokumentation-steht","Wo die vollständige Dokumentation steht",[16,222,223,224,227,228,60],{},"Alle Endpunkte mit Beispielaufrufen, Feldern, Statuswerten, Fehlercodes und\nRate-Limits stehen offen im Netz, ohne Konto:\n",[56,225,226],{"href":82},"REST-API-Dokumentation",". Wie ein typischer Ablauf aussieht, zeigt\n",[56,229,231],{"href":230},"\u002Fblog\u002Fe-rechnung-per-api-aus-pdf","E-Rechnung per API aus PDF",{"title":85,"searchDepth":86,"depth":86,"links":233},[234,235,236],{"id":118,"depth":89,"text":119},{"id":167,"depth":89,"text":168},{"id":219,"depth":89,"text":220},"Nicht nur konvertieren: Ausgang anlegen und abrufen, Eingangsrechnungen verarbeiten, Dateien und Validierungsberichte holen, Stammdaten, Protokoll und Kontingent.",{},510,{"title":112,"description":237},"Was die REST-API von Belegschmied abdeckt","fragen\u002Fwas-kann-die-rest-api-von-belegschmied",[244,245,246],"eingangsrechnungen-per-api-verarbeiten","belegschmied-an-das-erp-anbinden","api-durchsatz-tausende-rechnungen","cHbLCW9m1PohaCnvdXripDAosGP_c1uCEnMBbSu6TSU",{"id":249,"title":250,"antwort":251,"body":252,"description":317,"draft":93,"extension":94,"kategorie":318,"meta":319,"navigation":97,"order":320,"path":58,"seo":321,"seoTitle":322,"stem":323,"updated":103,"verwandt":324,"__hash__":327},"fragen\u002Ffragen\u002Fkonvertierung-ohne-eingriff-ins-erp.md","Muss unser ERP angefasst werden, wenn eine Konvertierung dahinterkommt?","Nein. Eine Konvertierungsschicht setzt hinter dem Punkt an, an dem die Rechnung fertig ist, also bei der PDF. Im führenden System ändert sich dadurch nichts: kein Change Request, kein Customizing, kein Regressionstest. Wo sich ein Sonderfall über die Jahre zur Regelmenge entwickelt hat, gehört er trotzdem mittelfristig ins ERP.",{"type":8,"value":253,"toc":312},[254,258,261,264,268,271,295,298,302,305],[11,255,257],{"id":256},"warum-das-der-entscheidende-unterschied-ist","Warum das der entscheidende Unterschied ist",[16,259,260],{},"Der Aufwand eines ERP-Projekts steckt nicht im Bauen, sondern im Absichern. Jede\nÄnderung am führenden System zieht Tests, Freigaben und ein Zeitfenster nach\nsich, und bei einem produktiven Fakturaprozess ist das Risiko real. Deshalb\ndauern diese Projekte Quartale, nicht Tage.",[16,262,263],{},"Eine Schicht dahinter berührt diesen Bereich nicht. Sie bekommt ein fertiges\nDokument und gibt ein Dokument zurück. Der Beleg im ERP bleibt derselbe, die\nNummernkreise bleiben, die Buchung bleibt.",[11,265,267],{"id":266},"was-sie-stattdessen-entscheiden-müssen","Was Sie stattdessen entscheiden müssen",[16,269,270],{},"Nicht nichts, aber deutlich weniger:",[20,272,273,279,285],{},[23,274,275,278],{},[26,276,277],{},"Wie die Rechnungen ankommen."," Über REST-API, über einen\nPower-Automate-Flow, der einen SharePoint- oder Teams-Ordner beobachtet (die\nVorlage dafür stellen wir bereit), per Mail an die Versandadresse oder als CC\nin die Rechnungsmail, oder als Upload im Browser.",[23,280,281,284],{},[26,282,283],{},"Wie sie hinausgehen."," Über unsere Infrastruktur, unter Ihrer eigenen Domain\nüber DNS-Einträge, über Ihr Microsoft 365 oder über Ihren eigenen SMTP-Server.",[23,286,287,290,291,60],{},[26,288,289],{},"Was bei Unklarheit passiert."," Freigabe statt stiller Versand, siehe\n",[56,292,294],{"href":293},"\u002Ffragen\u002Fwenn-eine-pdf-rechnung-nicht-konvertierbar-ist","Was passiert, wenn eine PDF nicht sauber konvertierbar ist",[16,296,297],{},"Das sind Festlegungen in Ihrer Umgebung, keine Eingriffe im ERP.",[11,299,301],{"id":300},"der-ehrliche-nachteil","Der ehrliche Nachteil",[16,303,304],{},"Automatisiert wird die Konformität, nicht das Schreiben der Rechnung. Wer sich\ndavon erhofft, dass die Fachabteilung aufhört, in Word zu arbeiten, wird\nenttäuscht. Und ohne Validierung jeder einzelnen Rechnung wäre der Weg\nfahrlässig: Was nicht eindeutig aus dem Dokument hervorgeht, darf nicht geraten\nwerden.",[16,306,307,308,60],{},"Die drei Wege im Vergleich stehen auf der Seite zu den\n",[56,309,311],{"href":310},"\u002Fschattenrechnungen","Schattenrechnungen",{"title":85,"searchDepth":86,"depth":86,"links":313},[314,315,316],{"id":256,"depth":89,"text":257},{"id":266,"depth":89,"text":267},{"id":300,"depth":89,"text":301},"Nein. Eine vorgelagerte Konvertierung setzt an der fertigen PDF an. Im führenden System ändert sich nichts: kein Change Request, kein Customizing.","Systeme",{},240,{"title":250,"description":317},"E-Rechnung ohne Eingriff ins ERP","fragen\u002Fkonvertierung-ohne-eingriff-ins-erp",[325,107,326],"muessen-wir-sap-drc-einfuehren","aus-einer-pdf-rechnung-eine-e-rechnung-machen","TBCHlFHKbf99lfSHxDRPiMvuLBIVkw-muIBuPSlKCXA",{"id":329,"title":330,"antwort":331,"body":332,"description":392,"draft":93,"extension":94,"kategorie":393,"meta":394,"navigation":97,"order":395,"path":396,"seo":397,"seoTitle":398,"stem":399,"updated":103,"verwandt":400,"__hash__":403},"fragen\u002Ffragen\u002Frechnungen-automatisch-einliefern-ohne-mehraufwand.md","Wie kommen die Rechnungen automatisch in die Konvertierung, ohne einen Schritt mehr?","Vollautomatisch über die REST-API oder über einen Power-Automate-Flow, der einen SharePoint- oder Teams-Ordner beobachtet und jede neue PDF einliefert; die Flow-Vorlage stellen wir bereit. Beide Wege laufen ohne Zutun der Fachabteilung. Wer ohne IT-Beteiligung anfangen will, schickt die Rechnung per Mail an die Versandadresse oder setzt sie in CC, einzelne Belege gehen auch per Upload im Browser.",{"type":8,"value":333,"toc":387},[334,338,350,356,362,368,372,375,378,382],[11,335,337],{"id":336},"die-wege-nach-automatisierungsgrad","Die Wege, nach Automatisierungsgrad",[16,339,340,343,344,346,347,349],{},[26,341,342],{},"REST-API."," Der vollautomatische Weg aus dem eigenen System heraus: PDF\nübergeben, Konvertierungs-ID zurückbekommen, Status abfragen, XML, PDF und\nValidierungsbericht abholen. Die Doku samt Schlüsselverwaltung steht offen unter\n",[56,345,83],{"href":82},", der Weg ist ausführlich beschrieben in\n",[56,348,231],{"href":230},". Die API ist ab\ndem Business-Tarif verfügbar.",[16,351,352,355],{},[26,353,354],{},"Power-Automate-Flow auf einen Ordner."," Der Flow beobachtet einen SharePoint-\noder Teams-Ordner und liefert jede neue PDF ein. Die Fachabteilung legt ihre\nRechnung dort ab, wo sie sie ohnehin ablegt, und macht sonst nichts. Die Vorlage\nfür den Flow stellen wir bereit. Ohne Premium-Lizenz übernimmt derselbe Flow den\nWeg per Mail.",[16,357,358,361],{},[26,359,360],{},"Mail an die Versandadresse oder CC in die Rechnungsmail."," Die Fachabteilung\nverschickt ihre Rechnung wie bisher und setzt eine Adresse in CC. Keine\nIT-Beteiligung, keine Umstellung im Ablauf, am selben Tag einsatzbereit.",[16,363,364,367],{},[26,365,366],{},"Upload im Browser."," Für einzelne Belege und für die Übergangszeit, solange der\nautomatische Weg noch nicht steht.",[11,369,371],{"id":370},"welcher-weg-wann-passt","Welcher Weg wann passt",[16,373,374],{},"Die Wahl hängt weniger am Volumen als daran, wo die fertige Rechnung heute\nlandet. Liegt sie ohnehin in einem gemeinsamen Ordner, ist der Flow der\nunauffälligste Weg. Entsteht sie in einem System mit Schnittstelle, ist es die\nAPI. Geht sie direkt aus dem Postfach eines Kollegen hinaus, ist es der CC.",[16,376,377],{},"Sinnvoll ist, klein anzufangen: mit Mail oder CC starten, damit die Strecke steht\nund geprüft ist, und den automatischen Weg danach nachziehen. Die Konvertierung\ndahinter ist in allen Fällen dieselbe.",[11,379,381],{"id":380},"was-die-fachabteilung-davon-merkt","Was die Fachabteilung davon merkt",[16,383,384,385,60],{},"Im Regelfall nichts. Sichtbar wird die Schicht nur dort, wo eine Rechnung\nangehalten wird, weil eine Pflichtangabe fehlt. Genau das ist beabsichtigt:\n",[56,386,294],{"href":293},{"title":85,"searchDepth":86,"depth":86,"links":388},[389,390,391],{"id":336,"depth":89,"text":337},{"id":370,"depth":89,"text":371},{"id":380,"depth":89,"text":381},"Über REST-API oder einen Power-Automate-Flow, der einen Ordner beobachtet. Beides läuft ohne Zutun der Fachabteilung. Daneben stehen Mail, CC und Upload im Browser.","Umsetzung",{},320,"\u002Ffragen\u002Frechnungen-automatisch-einliefern-ohne-mehraufwand",{"title":330,"description":392},"Rechnungen automatisch einliefern","fragen\u002Frechnungen-automatisch-einliefern-ohne-mehraufwand",[106,401,402],"e-rechnung-aus-eigenem-microsoft-365-versenden","muessen-die-fachabteilungen-geschult-werden","HEMysiU2smMGH_Ktyl1m5gBmqaiOJb8qkbV7N0jK4MU",{"id":405,"title":406,"antwort":407,"body":408,"description":470,"draft":93,"extension":94,"kategorie":95,"meta":471,"navigation":97,"order":472,"path":134,"seo":473,"seoTitle":135,"stem":474,"updated":103,"verwandt":475,"__hash__":477},"fragen\u002Ffragen\u002Feingangsrechnungen-per-api-verarbeiten.md","Können wir auch Eingangsrechnungen per API verarbeiten?","Ja. Der Eingang ist genauso automatisierbar wie der Ausgang: Sie reichen eine empfangene Rechnung per API ein und holen die extrahierten Daten strukturiert wieder ab, dazu die Originaldatei und den Validierungsbericht. Damit lässt sich der Rechnungseingang an eine Buchhaltung oder ein Dokumentenmanagement anschließen, ohne dass jemand Belege abtippt.",{"type":8,"value":409,"toc":465},[410,414,417,420,424,427,430,434,454,457],[11,411,413],{"id":412},"warum-das-oft-übersehen-wird","Warum das oft übersehen wird",[16,415,416],{},"E-Rechnung wird meist als Versandthema diskutiert, weil dort die Frist steht.\nEmpfangen können muss aber jedes Unternehmen schon seit dem 1. Januar 2025, und\nder Aufwand liegt danach: Eine XRechnung ist für einen Menschen nicht lesbar, und\neine ZUGFeRD-PDF sieht aus wie immer, trägt ihre Daten aber unsichtbar mit.",[16,418,419],{},"Genau diese Daten holt die API ab. Statt eine Rechnung anzusehen und Beträge in\nein anderes System zu tippen, bekommen Sie sie als Felder.",[11,421,423],{"id":422},"was-zurückkommt","Was zurückkommt",[16,425,426],{},"Zu jeder verarbeiteten Eingangsrechnung stehen die extrahierten Rechnungsdaten\nbereit, dazu die Datei selbst und der Validierungsbericht. Der Bericht ist der\nTeil, der in der Prüfung zählt: Er sagt, ob die Rechnung den Regeln entsprach,\nund er wird mitarchiviert.",[16,428,429],{},"Der Weg dahin ist derselbe wie beim Ausgang: einreichen, Status abfragen, Daten\nabholen. Kein zweites Bedienkonzept.",[11,431,433],{"id":432},"was-das-in-der-praxis-erschließt","Was das in der Praxis erschließt",[20,435,436,442,448],{},[23,437,438,441],{},[26,439,440],{},"Vorkontierung und Buchung."," Die Felder gehen in Ihre Buchhaltung, statt dass\njemand sie abschreibt.",[23,443,444,447],{},[26,445,446],{},"Ablage im Dokumentenmanagement."," Datei und Metadaten zusammen, richtig\nbenannt und verschlagwortet.",[23,449,450,453],{},[26,451,452],{},"Prüfung gegen Bestellung oder Vertrag."," Betrag, Lieferant und Zeitraum\nliegen als Werte vor und lassen sich vergleichen.",[16,455,456],{},"Was darüber hinausgeht, etwa eine feste Anbindung an ein bestimmtes\nDokumentenmanagement, setzen wir auf Projektbasis um. Der Weg über die API ist\nin den meisten Fällen der schnellere, weil er sich an Ihrem System ausrichtet und\nnicht umgekehrt.",[16,458,459,460,462,463,60],{},"Alle Endpunkte und Felder stehen in der\n",[56,461,226],{"href":82},", die Einlieferungs- und Versandwege im\nÜberblick auf ",[56,464,78],{"href":77},{"title":85,"searchDepth":86,"depth":86,"links":466},[467,468,469],{"id":412,"depth":89,"text":413},{"id":422,"depth":89,"text":423},{"id":432,"depth":89,"text":433},"Ja. Eine empfangene Rechnung wird per API eingereicht, die extrahierten Daten kommen strukturiert zurück, inklusive Datei und Validierungsbericht.",{},520,{"title":406,"description":470},"fragen\u002Feingangsrechnungen-per-api-verarbeiten",[105,245,476],"e-rechnungen-aus-word-archivieren-gobd","-aETP-S_G7PrMFeCTZ01CUtqGrRwA_N4-jgwe6fcfcI",1788180268882]