API für den Briefversand via Österreichische Post

Mit der skalierbaren Post API von Pingen wird deine Software im Handumdrehen um automatischen Briefversand via Österreichische Post und DHL erweitert. Die Integration ist dank unseren SDKs ein Kinderspiel.

Post API für Briefversand über Österreichische Post und DHL
Vorteile für Entwickler

Automatischer Postversand für deine Software

Mit der Post API von Pingen wird deine Software ganz einfach um den automatisierten Briefversand via Österreichische Post und DHL erweitert.

Österreichische Post API
Kostenlose API Schnittstelle

Wir wollen helfen, Prozesse zu automatisieren. Daher stellen wir unsere API allen Kunden kostenlos zur Verfügung.

Umfangreiche SDKs
Umfangreiche SDKs (demnächst)

Die Integration vom Briefversand ist dank unseren SDKs für PHP, Java, C# und .Net in kürzester Zeit realisiert.

Überweisungsträger
Unterstützte Überweisungsträger

SEPA (Österreich), SEPA (Deutschland) sowie ESR, ESR+, rote Einzahlungsscheine und QR-Rechnung (Schweiz).

Post API von Entwicklern für Entwickler
Von Entwicklern für Entwickler

Alle Funktionen von Pingen sind auch über die Post API verfügbar und in unserer Dokumentation detailliert beschrieben.

Österreichische Post Track & Trace
Track & Trace

Für jeden übermittelten Brief bietet Pingen via API ausführliche Status Informationen, um den Verlauf zu verfolgen.

Einnahmen generieren
Einnahmen generieren

Der Weiterverkauf vom Briefversand bietet Integratoren spannende Möglichkeiten zum Generieren zusätzlicher Einnahmen.

API Highlights

Online Briefversand API

Über die Pingen Post API ist der Versand von einem Brief so einfach wie der Versand von einem E-Mail bei deinem Mailprovider. Digital und beliebig skalierbar.

Österreichische Post API Highlights für den digitalen Briefversand
Vom PDF in den Briefkasten

Via unserer Post API den Briefinhalt als PDF übermitteln und Pingen übernimmt den Rest. In der API stehen dir alle Funktionen von Pingen zur Verfügung. So lassen sich alle Prozesse vollständig automatisieren und auch dein Konto über die API administrieren.

Automatische Validierung von Dokumenten

Alle übermittelten PDF werden von Pingen automatisch auf die Anforderungen beim Briefversand geprüft. Sofern gewisse Anforderungen nicht eingehalten sind, bietet Pingen Optionen, diese direkt via API zu beheben.

Digitale Retouren Verarbeitung

Sofern bei Briefen die Zustellung durch die Österreichische Post fehlschlägt, werden diese anhand vom Pingen-DMC automatisch erfasst, kontrolliert, vernichtet und via Webhooks gemeldet. So werden auch diese immer digital verarbeitet.

Sandbox /Testumgebung

Um Integrationen ausgiebig zu testen, bietet Pingen mit der Staging-Umgebung eine Sandbox. In dieser stehen alle Funktionen zur Verfügung, ohne dass jedoch Briefe effektiv versendet werden.

Detaillierter Preiskalkulator

Über den Preiskalkulator-Endpoint lassen sich sämtliche Preise von Pingen im Voraus berechnen. So sieht man bereits vor dem Versand, welche Kosten ein Brief verursachen wird.

Zur API Dokumentation

So einfach funktioniert unsere API

Die Brief API von Pingen ist so flexibel und einfach wie möglich gehalten, damit sich Integrationen im Handumdrehen realisieren lassen. Neben der verständlichen Dokumentation bieten wir auch Code-Beispiele, um den Einstieg weiter zu erleichtern.

curl \
       -X GET "https://api.v2.pingen.com/file-upload" \
       -H "Authorization: Bearer INSERT_YOUR_ACCESS_TOKEN_HERE"

# Extract data.attributes.url and data.attributes.url_signature from response

curl -X PUT -T path_to_your_file.pdf "INSERT_URL_FROM_INITIAL_CURL_REQUEST"

curl \
       -X POST "https://api.v2.pingen.com/organisations/YOUR_ORGANISATION_UUID/letters" \
       -H "Content-Type: application/vnd.api+json" \
       -H "Authorization: Bearer INSERT_YOUR_ACCESS_TOKEN_HERE" \
       --data-binary @- << EOF
       {
           "data": { \
               "type": "letters", \
               "attributes": { \
                   "file_original_name": "your_filename.pdf", \
                   "file_url": "INSERT_URL_FROM_INITIAL_CURL_REQUEST", \
                   "file_url_signature": "INSERT_URL_SIGNATURE_FROM_INITIAL_CURL_REQUEST", \
                   "address_position": "left", \
                   "auto_send": false, \
                   "delivery_product": "fast", \
                   "print_mode": "simplex", \
                   "print_spectrum": "color" \
               } \
       } \
   }
EOF

require __DIR__ . '/vendor/autoload.php';

$provider = new \Pingen\Provider\Pingen(
   array(
   'clientId' => 'YOUR_OAUTH2_CLIENT_ID',
   'clientSecret' => 'YOUR_OAUTH2_CLIENT_SECRET'
)
);

$access_token = $provider->getAccessToken('client_credentials');

$lettersEndpoint = (new \Pingen\Endpoints\LettersEndpoint($access_token))
    ->setOrganisationId('INSERT_YOUR_ORGANISATION_UUID_HERE');

$lettersEndpoint->uploadAndCreate(
   (new \Pingen\Endpoints\DataTransferObjects\Letter\LetterCreateAttributes())
       ->setFileOriginalName('your_original_pdf_name.pdf')
       ->setAddressPosition('left')
       ->setAutoSend(false),
   fopen('path_to_your_original_pdf_name.pdf', 'r')
);

Vollständige API Dokumentation
Pingen PHP Library

Noch einfacher mit der Pingen PHP Library

In der Pingen PHP Library ist alles für den Briefversand via Österreichische Post vorbereitet. Für alle PHP-Entwickler hat Pingen sozusagen die Arbeit bereits gemacht, für alle anderen Entwickler folgen bald unsere SDKs. 🚀

Mehr als nur eine Lettershop API

Unsere Post API bietet deutlich mehr als eine klassische API von einem Lettershop oder Briefdienstleister. Bei Pingen erhältst du Zugriff auf einen schnell wachsenden internationalen Service, dass dir den weltweiten Briefversand zu den besten Konditionen ermöglicht.

Lokaler Briefdienstleister via Österreichische Post

Lokaler Briefdienstleister

Bereits heute werden Briefe lokal in Österreich, Deutschland, den Niederlanden, Indien und der Schweiz gedruckt und versendet.

Briefe online versenden - Internationaler Versand

Weltweiter Postversand

Durch die Partnerschaft mit DHL kann Pingen auch in alle anderen Länder schnellste Zustellung via Luftfracht garantieren.

Skalierbare und ausfallsichere API

Skallierbar und Ausfallsicher

Durch unsere Cloud-Infrastruktur sowie den Briefdruck an mehreren Standorten skaliert Pingen problemlos und ist ausfallsicher.

Starte jetzt mit der Entwicklung

Wirf einen Blick in die Dokumentation unserer API und sehe, wie einfach sich Briefe in deine Lösung integrieren und digital versenden lassen!