Binect API: Integrieren Sie den digitalen Versand Ihrer Geschäftspost nahtlos in Ihre bestehende Software per Schnittstelle

  • Ganzheitliche Lösung: Effizientes Output-Management für Ihre Software
  • Wettbewerbsvorteile nutzen: Digitales Versand-Feature für Geschäftsbriefe mit Umsatz-Plus
  • Flexibel: Ihr ERP- oder CRM-System nahtlos anbinden
  • Gedruckte Geschäftsbriefe über digitalen Briefversand einfach anstoßen
Jetzt Beratungstermin buchen!
Diese Softwareunternehmen vertrauen auf Binect

Anmeldung

Melden Sie sich an für Binect API in der Anmeldemaske von Binect Online.

Definition der Schnittstellen

Integrieren Sie die Binect API einfach in Ihre Systeme. In der Datei sind die Schnittstellen definiert.

Code-Beispiele

Finden Sie in der Swagger-UI Beispiele für jede Funktion zur einfachen Integration in Ihre bestehende Umgebung.

Seit Juli 2013 nutzen wir den Service des digitalen Briefkastens von Binect und haben dadurch unseren Geschäftspostversand effizienter, kostengünstiger und einfacher gestalten können als zuvor.

Benjamin Lochmann Geschäftsführer, Homepage-Baukasten.de

Diese Standardworkflows bietet die Binect API

Laden Sie Ihren Einzel- oder Serienbrief in Form von PDF und PS hoch. Beim Hochladen prüfen wir Ihren Brief auf Zustellbarkeit — diese Prüfung umfasst u.a. die korrekte Position der Adresse, das korrekte Adressformat und den freigehaltenen Sperrbereich am linken Seitenrand.

Schlägt eine Prüfung fehl, kann der Brief nicht verarbeitet werden. In diesem Fall wird eine eindeutige Fehlermeldung zurück geliefert.

Formatanforderung beachten:
Eine kompakte Übersicht der wichtigsten Formatanforderung für Ihren Brief.

Download: Adressvorlage

Fügen Sie Ihrem Einzel- oder Serienbrief einen Anhang als PDF hinzu.

Status abfragen
HINWEIS: Bitte beachten Sie, dass es beispielsweise bei Serienbriefen zu kleinen Verzögerungen kommen kann, bis Ihr Anhang hinzugefügt ist.
TIPP: Fragen Sie den Bearbeitungsstatus Ihres Briefs ab.

Hochgeladene Briefe erhalten automatisch die von Ihnen hinterlegten Standardversandeinstellungen, d.h. farbig, schwarz-weiß, einseitig, beidseitig, C4-Umschlag (hier wird der Brief nicht gefaltet).
Sie können die Versandeinstellungen für jeden hochgeladenen Brief anpassen.

Briefvorschau abrufen
EMPFEHLUNG: Überprüfen Sie Ihre Briefe vor dem Versand. Zur Prüfung können Sie von jedem Brief eine Vorschau im Format PDF oder PNG abrufen. 

HINWEIS:
Briefe mit 10 Blättern werden automatisch im C4-Umschlag versendet.

Versenden Sie Ihren Brief über die Binect-API vor 14:30 Uhr, wird der Brief noch am selben Tag der Deutschen Post AG für die Zustellung übergeben.

Versandstatus abfragen

EMPFEHLUNG: Optional können Sie den Versandstatus abfragen, d.h. Sie erhalten Informationen darüber, ob sich Ihr Brief im Druck befindet oder der Zustellung übergeben wurde. Die Versandinformation liegt in der Regel ab 21:00 Uhr vor.

Zur Dokumentation der Binect API nutzen wir das bewährte Open-Source-Framework Swagger UI, das Beispiel-Codes und das Testen direkt im Browser ermöglicht.

Die Binect API bietet Ihnen diese Vorteile

Kalender und Uhr
Schnelligkeit
Hand mit Münzen
Umsatz-Plus durch Wettbewerbsvorteil
drei Personen mit Symbol Herz
Einfache Integration in Software-Lösungen
Person mit einem Headset
Top Kundenservice und Betreuung
Schloss auf einem Schutzschild
Sicherheit durch SSL-Verschlüsselung

Case Studies und Blogbeiträge

Outsourcing von Dokumentendruck und -versand

Unser Leitfaden greift die wichtigsten Entscheidungskriterien für das Outsourcing von Dokumentendruck und -versand auf. Jetzt mehr erfahren....

Weiterlesen

Output Management Outsourcing

Das Outsourcing der Ausgangsprozesse von Geschäftspost bietet diese Vorteile. Jetzt mehr erfahren....

Weiterlesen

WorkDesk Web: Der neue Web-Client

Der neue Web-Client WorkDesk Web bietet mehr Komfort beim digitalen Versand Ihrer Geschäftspost. Jetzt mehr erfahren....

Weiterlesen

Jetzt Fördermittel-Check durchführen und Kosten sparen

Nutzen Sie den Fördermittel-Check für staatliche Förderungen für Ihr Digitalisierungsprojekt mit Binect. Jetzt mehr erfahren....

Weiterlesen

Webme versendet Rechnungen elektronisch mit Binect

Mit der digitalen Poststelle von Binect profitiert Webme von hohen Kosteneinsparungen. Diese fließen direkt in den Kundenservice....

Case Study lesen

Die Prozessschritte beim digitalen Postversand

Die GWH Wohnungsgesellschaft Hessen nutzt seit einigen Jahren die Binect-Software für den digitalen Postversand. Kira Schumann, Digital Coach von der...

Weiterlesen

FAQ - Häufige Fragen zur Binect API

Anhänge: Kann ich meinem Brief auch Anhänge hinzufügen?

Sie können Ihrem Brief Anhänge in folgenden Dateiformaten hinzufügen: pdf, rtf, txt, png, jpg, jpeg, bmp, gif, ps. Die maximale Dateigröße beträgt 20 MB.

Standardmäßig ist die Option „Anhang beginnt auf neuem Blatt“ aktiviert. Dadurch wird verhindert, dass bei beidseitigem Druck Anhänge auf der Rückseite des letzten Blattes beginnen.

Beachten Sie, dass Briefen mit ungerader Seitenanzahl eine Leerseite hinzugefügt wird. Diese Leerseite wird mitgezählt, jedoch nicht berechnet. Aus technischen Gründen erscheint die Leerseite erst bei der Briefansicht unter „Beauftragte Briefe“.

Bilder: Darf mein Brief auch Bilder enthalten?

Ihr Brief darf auch Bilder wie Logos und Grafiken enthalten, sofern sich diese außerhalb des Adressfelds und des Sperrbereichs am linken Seitenrand befinden. Siehe auch: Datei- und Formatanforderungen

TIPP: Damit Ihre Bilder wie Firmenlogos im Druck das optimale Ergebnis liefern, empfehlen wir eine Auflösung von mindestens 300 dpi.

Hinweis: Vermeiden Sie großflächige Grafiken mit Transparenzen.

Bezahlung: Wann und wie wird bezahlt?

Als registrierter Nutzer stehen Ihnen folgende Zahlungsmöglichkeiten zur Verfügung:

  • PayPal
  • Kreditkarte
  • Giropay
  • Sofortüberweisung
  • Zahlung auf Rechnung (Bitte wenden Sie sich an kontakt@binect.de für die Umstellung Zahlung auf Rechnung ab einem monatlichen Betrag von 100 Euro.)

Ihre versandfertigen Briefe können Sie direkt im Warenkorb oder über Ihr Guthabenkonto bezahlen, das Sie jederzeit aufladen können. Aus Sicherheitsgründen ist der maximale Betrag pro Aufladung auf 100 Euro begrenzt – sollten Sie einen höheren Aufladungsbetrag wünschen, wenden Sie sich an unseren Kundenservice:

Für technische Fragen: kontakt@binect.de
Für allgemeine Fragen: sales@binect.de
Hotline: 06151 – 90 67 113, werktags 9 Uhr – 17 Uhr

Die Kosten für den Versand Ihres Briefes werden nach dem Versenden verbucht. Das Hochladen und Prüfen von Briefen auf Versendbarkeit ist kostenlos.

Sie erhalten eine Rechnung am Anfang jeden Monats für die in Anspruch genommenen Leistungen aus dem Vormonat.
Unter „Mein Konto“ > „Rechnung“ können Sie sich die Rechnung als PDF-Datei herunterladen.

Datei- und Formatanforderungen: Welche Anforderungen gelten für meinen Brief?

Um eine einwandfreie Verarbeitung zu gewährleisten, nutzen Sie gern unsere Vorlagen für Word und OpenOffice.

  • Seitenformat: DIN A4 Hochformat, Breite: 21 cm, Höhe: 29,70 cm
  • Sperrbereich: Halten Sie bündig am linken Seitenrand einen Bereich frei, in den die Sendungs-ID sowie der DataMatrix-Code (DMC) für die automatisierte Verarbeitung aufgetragen werden.

Dieser Bereich hat

    • eine Breite von 16 mm (DMC) bzw. 6 mm (Sendungs-ID)
    • eine Gesamthöhe von 40 mm (DMC: 17 mm + Sendungs-ID: 25 mm)
    • einen Abstand von 35 mm zum unteren Seitenrand

Adressvorlage downloaden

Text- und Bildelemente, die sich in diesem Bereich befinden, werden von unserer Fehlerkorrektur automatisch geweißt.

  • DV-Sperrbereich: Seit dem 27.09.2022 bietet Binect Online eine DV-Validierungsoption an, der als neuer Standard für Plattformen gilt.
    Die alten Sperrbereiche und Adressbereiche sind weiterhin gültig.
    Um Ihr Dokument DV-Kompatibel zu machen, halten Sie folgende Sperrbereiche zusätzlich zu unseren anderen Sperrbereichen in Ihrem Dokument ein.

    • Abstand von 20 mm zum linken Seitenrand
    • Abstand von 51 mm vom oberen Seitenrand
    • Breite von 85 mm
    • Höhe von 17,5 mm
  • Absender-Adressfeld: Die Absenderadresse muss korrekt positioniert sein, damit sie im Sichtfeld eines DIN-lang-Umschlags vollständig sichtbar ist. Dieses Feld hat
    • Breite von 85 mm
    • Höhe von 5,5 mm
    • Abstand von 20 mm zum linken Seitenrand
    • Abstand von 45 mm zum oberen Seitenrand
  • Empfänger-Adressfeld: Die Empfängeradresse muss korrekt positioniert sein, damit sie im Sichtfeld eines DIN-lang-Umschlags vollständig sichtbar ist. Dieses Feld hat
    • Breite von 85 mm
    • Höhe von 21 mm
    • Abstand von 20 mm zum linken Seitenrand
    • Abstand von 69 mm zum oberen Seitenrand

Adressvorlage downloaden

  • Adressformat:
    • Die Empfängeradresse besteht aus mindestens zwei Zeilen und maximal sieben Zeilen.
    • Benutzen Sie keine Leerzeilen, verwenden Sie eine einheitliche Schriftart und -größe. Vermeiden Sie Effekte wie Unterstreichung, Schattierung, Hervorhebung und Umrandung.
    • Die letzte Adresszeile enthält bei Inlandsbriefen eine gültige 5-stellige Postleitzahl. Verwenden Sie bei Inlandsbriefen keine Länderkennung.
    • Bei Auslandsbriefen: Die letzte Adresszeile enthält eine gültige Länderbezeichnung. Diese besteht aus dem Ländernamen in Großbuchstaben und in den zulässigen Sprachen Deutsch, Englisch und Französisch (z. B. SCHWEIZ, SWITZERLAND, SUISSE). Verwenden Sie keine ISO-Codes wie IT oder FR.
    • Passen Sie die Schriftgröße der Absenderadresse so an, dass diese oberhalb der Empfängeradresse vollständig im Bereich des Sichtfensters positioniert ist.
  • Dateiformat und -größe:
    • Ihr Brief lässt sich in folgenden Dateiformaten hochladen: pdf, ps.
    • Ein Brief darf maximal 20 Megabyte (MB) groß sein. Größere Dateien werden nicht angenommen.
    • Auf der Weboberfläche können Sie maximal 1000 Briefe hochladen.
    • Ein Brief darf bis zu 384 Seiten (192 Blatt) enthalten.

Kosten: Was kostet der Versand?

Mit dem Preiskalkulator berechnen Sie die Versandkosten für Ihre Briefe ganz einfach nach Umfang, Versandart und Versandoption.

Die Preise werden Ihnen netto und brutto angezeigt. Inbegriffen sind Druck, Kuvertierung, Frankierung und Versand.

HINWEIS: Die Preisermittlung erfolgt direkt beim Hochladen des Schreibens.

Mehrere Nutzer: Ist es möglich, dass mehrere Nutzer auf einem Guthabenkonto arbeiten?

Als registrierter Nutzer können Sie bis zu zehn Mitarbeiter Ihres Unternehmens auf Ihrem Konto anmelden und das gebuchte Guthaben nutzen.
Diese Option finden Sie unter „Mein Konto“ > „Mitarbeiter anmelden“.

Papier: Welches Papier wird verwendet?

Ihr Brief wird auf DIN A4 Hochleistungspapier vom Typ 80g/qm ultraweiß gedruckt.

Serienbrief: Wie kann ich einen Serienbrief hochladen?

Sie können ein Dokument hochladen, das mehrere Einzelbriefe enthält und anhand eines Merkmals, wie der Seitenanzahl oder eines einmalig auf jeder ersten Briefseite vorkommenden Textmusters (z. B. „Musterstadt, den“ aus der Datumszeile) für den Druck aufgetrennt werden kann.

Dies können Sie unter „Briefe hochladen“ > „Serienbriefe im Format PDF oder PS per Klick oder Drag & Drop hochladen“ vornehmen.

Wenn Sie einen mit dem Serienbrief-Assistenten von Microsoft Word fertiggestellten Serienbrief hochladen möchten, stellen Sie sicher, dass dieser im Format PDF vorliegt.

Hinweis: Vermeiden Sie Serienbriefe mit mehr als 500 Empfänger in einer Datei, um eine schnelle Verarbeitung durch unsere Systeme zu gewährleisten.

Sicherheit: Wie sicher ist die Übertragung meiner Daten an Binect?

Sämtliche Daten wie Briefe oder Stammdaten werden über eine sichere verschlüsselte Verbindung an unseren Dienst übertragen. Durch Verwendung des Verschlüsselungsprotokolls SSL/TLS 1.2 und einer Verschlüsselungsstärke von mindestens 128 Bits gewährleisten wir, wie beim Online-Banking, damit den höchstmöglichen Sicherheitsstandard, um Ihre Daten zu schützen.

Dass Ihre Daten stets verschlüsselt übertragen werden, erkennen Sie in der Adressleiste Ihres Browsers an dem verriegelten Schloss-Symbol und der Bezeichnung „https“ statt „http“.

Damit Sie jederzeit sichergehen können, dass Sie mit dem tatsächlichen Briefportal von Binect verbunden sind, werden unsere Webseiten immer mit einem digitalen Ausweis, einem sogenannten Zertifikat, versendet. Ihr Browser kann dieses Zertifikat prüfen und warnt Sie, wenn das Zertifikat von unbekannter Seite ausgestellt wurde. Dies kann insbesondere bei älteren Browsern auftreten. In diesem Fall ist Ihre Bestätigung notwendig, dass Sie dem Inhaber des Zertifikats dennoch vertrauen.

Stornierung: Kann ich meinen Brief stornieren?

In Auftrag gegebene Briefe können Sie von Montag bis Freitag bis 14:30 Uhr nach Bestellaufgabe stornieren.
Nach 14:30 Uhr kann die Bestellung nicht mehr storniert werden.

Bei erfolgreicher Stornierung wird Ihnen der Rechnungsbetrag auf Ihrem Konto gutgeschrieben.

Upload fehlgeschlagen: Warum können meine Briefe nicht hochgeladen werden?

Beim Hochladen Ihres Briefes prüfen wir ihn auf Zustellbarkeit.
Das bedeutet, es wird geprüft,

  • ob sich die Adresse an der richtigen Position befindet, d.h. ob sie im Adressfenster des Umschlags sichtbar ist.
  • ob die Adresse plausibel ist
  • ob die Postleitzahl bei Inlandsbriefen fünfstellig ist
  • ob der Brief im DIN A4 Format vorliegt

Schlägt eine dieser Prüfungen fehl, wird der Brief abgelehnt und kann nicht versendet werden. Sie erhalten in dem Fall eine entsprechende Fehlermeldung. Außerdem stellen wir Ihnen Vorlagen für Word und OpenOffice zur Verfügung, die Sie für Ihre Briefe verwenden können.

Vertraulichkeit: Wie vertraulich werden meine Briefe behandelt?

Vertraulichkeit ist die Basis unseres Selbstverständnisses als verlässlicher und erfahrener Partner rund um das digitale Briefmanagement. Ihre Briefe unterliegen unseren strengen Richtlinien zum Datenschutz und werden absolut vertraulich behandelt. Auf dieser Grundlage stellen wir sicher, dass Ihre Briefe keiner inhaltlichen Analyse zur Gewinnung von Daten zu Marketingzwecken unterzogen und zu keinem Zeitpunkt an Dritte weitergegeben werden.

Wir nehmen von Ihren Briefen ausschließlich zum Zweck der Qualitätsprüfung Kenntnis, soweit dies für die ordnungsgemäße Verarbeitung und die erfolgreiche Zustellung notwendig ist.

Nach dem erfolgreichen Versand können Sie auf Ihre Briefe 10 Tage lang zugreifen, danach werden sie automatisch gelöscht.

Zustellzeit: Bis wann muss ich einen Brief versenden, damit dieser noch am selben Tag verschickt wird?

Sie „versenden“ Ihren Brief bis 14 Uhr zwischen Montag bis Freitag über unseren Dienst: Dieser wird  in der Regel noch am gleichen Werktag gedruckt und an ein Briefzentrum der Deutschen Post AG zum weiteren Versand und zur Zustellung übergeben.
Briefe, die Sie am Wochenende zur Versendung bereitstellen, werden mit der am Montag startenden Produktion der Deutschen Post übergeben.

 

Basisfunktionen der Binect API

  • Einzel- und Serienbriefe hochladen
  • Druck- und Versandoptionen setzen
  • Briefkontrolle und -vorschau abrufen
  • Kontodaten verwalten
  • Briefübersicht abrufen
  • Versandstatus abrufen
  • Transparenz über die Sendungskosten
  • Fehlerkorrekturen

Aufbau und Ressourcen der Binect API

Die Binect API basiert auf der REST-Technologie (Representational State Transfer), die sich durch einen einfachen und klaren Aufbau auszeichnet. Gemäß der REST-Grundprinzipien besteht die Binect-API aus Ressourcen, die über HTTP-Anfragen adressiert werden. 

documents: enthält alle Ressourcen rund um versandbereite Briefe

sendings: enthält alle Ressourcen rund um den Briefversand

attachments: enthält alle Ressourcen rund um Anhänge

accounts: enthält alle Ressourcen rund um Kontoinformationen

invoices: enthält alle Ressourcen rund um Rechnungen

HTTP-Anfragen

Sprechen Sie mithilfe der HTTP-Anfragen die Ressourcen einfach unter Verwendung folgender Methoden an:

Ruft eine bestimmte Ressource ab. Es handelt sich um einen Lesezugriff ohne aktive Auswirkung auf den Server.

Beispiel: Standardversandoptionen abrufen
GET /accounts/options

Bearbeitet eine bestimmte Ressource
Beispiel: Versandoptionen für einen bestimmten Brief setzen
PUT /documents/{documentID}/options

Legt eine bestimmte (Sub-)Ressource an bzw. fügt einer Ressource etwas hinzu
Beispiel: Einen Brief hochladen
POST /documents

Löscht die angegebene Ressource
Beispiel: Einen bestimmten Brief löschen
DELETE /documents/{documentID}

Ergänzt um eine Zusatzinformation.

Beispiel: Einem Brief einen Anhang hinzufügen
PATCH /documents/{documentID}/attachment

Die interaktive Preisliste berechnet Ihnen den Preis für Ihre geplanten Briefe über die Binect API.

Ansprechpartner

Unser Experte