Select Page

Enterprise Fax APIs für Unternehmen, die mehr wollen als nur eine Schnittstelle

Fax senden und empfangen mit Ihrer Applikation.
Und mit Enterprise-Anspruch.

Ob mobile Anwendung oder Web-Applikation – mit Retarus Enterprise Fax APIs finden Sie die passende Schnittstelle zu Ihrer Entwicklungs-Umgebung. Und vor allem das, worauf es beim erfolgreichen Einsatz von Fax wirklich ankommt: Leistungsfähige Infrastruktur. Internationale Verfügbarkeit. Und zahlreiche Optionen für die individuelle Anpassung an Ihren Geschäftsprozess.

Entwicklerfreundlich und intuitiv

Versenden Sie Faxe direkt aus Ihrer Anwendung. Einfach. Schnell. Und professionell.
Via REST API, SOAP API oder alternativ per FTP oder SMTP. Ein paar Zeilen Code und los geht’s:

curl -i 
  -H "Authorization: Basic [InsertYourCredentialsHere]" 
  -H "Content-Type: application/json" 
	-X POST 
	-d '{
  "recipients": [
    {
      "number": "+49891234567890"
    }
  ],
  "documents": [
    {
      "name": "example.txt",
      "data": "SGVsbG8sIHRoaXMgaXMgYSB0ZXN0aW5nIGRvY3VtZW50IGJvZHk="
    }
  ],
  "renderingOptions": {
    "paperFormat": "A4"
  },
  "statusReportOptions": {
    "reportPurgeTs": "2018-08-07T13:34:37.098+02:00"
  }
}' 
https://faxws.retarus.com/rest/v1/XXXXX/fax
echo '
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://retarus.com/fax4ba/faxws/3/0">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:JobRequest>
         <username>myusername</username>
         <password>mypassword</password>
         <faxRecipient>
            <number>+49891234567890</number>
         </faxRecipient>
         <document>
            <name>example.txt</name>
            <charset>UTF-8</charset>
            <data>VGhpcyBpcyBhIHRlc3QgZmF4IHVzaW5nIFNPQVA=</data>
         </document>
      </ns:JobRequest>
   </soapenv:Body>
</soapenv:Envelope>
' > request.xml
curl -i 
  -H 'Content-Type: text/xml;charset=UTF-8' 
  -H 'SOAPAction: ""' 
  --data @request.xml 
https://faxws.retarus.com/Faxolution/v3.0

Reports can be sent via email or through an http web service. For additional sending options you can refer to the following WSDL:
https://faxws.retarus.com/Faxolution/v3.0?wsdl

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE jobs SYSTEM "job.dtd">
<jobs>
    <fax>
        <fax-file-list>
            <fax-file>
                <file-name>minimal.pdf</file-name>
            </fax-file>
        </fax-file-list>
        <distribution-list>
            <fax-address>
                <fax-number>+49891234567890</fax-number>
            </fax-address>
        </distribution-list>
    </fax>
</jobs>

To send a fax using FTP you just need to load on the Retarus FTP server the fax document (e.g. minimal.pdf) and an XML file in the format. The XML file supports most of the options available in other APIs for personalizing each sending. Reports can be retrieved through the same FTP interface.

Through Retarus Mail2Fax it is possible to send faxes manually through any email client, or in batch by connecting your application through SMTP to the Retarus infrastructure.

[faxnumber]@[us.]rfax.net

Alternatively, a distribution list can be defined as a text file and the message will be sent to all recipients in the list. In this case the destination email address is:

list@[us.]rfax.net

A report will be returned to the sending email address. Further options can be specified by inserting tags in the subject line, for example:

<code>[PRIO:URGENT]</code>: requires an express transmission
<code>[ATTONLY:ON]</code>: only the attachments, not the body of the email, will be sent as fax
<code>[RES:HIGH]</code>: The fax will be sent in high resolution.
Aufruf Fax-Versand „All Options“:
curl -i 
   -H "Authorization: Basic [InsertYourTokenHere]" 
   -H "Content-Type: application/json" 
   -X POST 
   -d ' {"reference":{"customerDefinedId":"myCustomerDefinedId","billingCode":"myBillingCode","billingInfo":"myBillingInfo"},"recipients":[{"number":"004989312000000000","alternativeNumbers":["004989312000000000123"],"properties":[{"key":"key123","value":"value123"}]},{"number":"0049893120000000002","alternativeNumbers":["004989312000000000123"],"properties":[{"key":"key123","value":"value123"}]}],"documents":[{"name":"document.suffix","charset":"UTF-8","reference":null,"data":"SGVsbG8sIHRoaXMgaXMgYSB0ZXN0aW5nIGRvY3VtZW50IGJvZHkgY3JlYXRlZCBmb3IgOTk5OTlURQ=="}],"transportOptions":{"csid":"csid-inserthere","isExpress":true,"isBlacklistEnabled":false},"renderingOptions":{"paperFormat":"A4","resolution":"HIGH","coverpageTemplate":"coverpage-default.ftl.html","overlay":{"name":"retarus1p","mode":"ALL_PAGES"},"header":"%tz=CEST Testfax: CSID: %C Receiver Number: %# Date: %d.%m.%Y %H:%M %z"},"statusReportOptions":{"reportPurgeTs":"2018-08-07T13:34:37.098+02:00","reportMail":{"successAddress":"my.email.address@mycompany.com","failureAddress":"my.email.address@mycompany.com"},"httpStatusPush":{"targetUrl":"http://mycompany.com/fax-example-push-destinations/insert.here.your.document.name.suffix","principal":"examplePrincipal","credentials":"examplePassword","authMethod":"HTTP_BASIC"}},"meta":{"customerReference":"XXXXXXX","jobValid":{"start":"2016-08-14T14:02:01.497+02:00","end":"2016-08-14T15:02:01.497+02:00"}}} ' 
https://faxws.retarus.com/rest/v1/XXXXXXX/fax
Aufruf Fax-Empfang:
curl -X POST -u T1: https://faxws.retarus.com/faxin/rest/v1/topics/X
Retarus Entwickler-Portal

Interessiert an weiteren APIs und Details?

In unserem Developer-Portal finden Sie eine Sammlung von API-Referenzdokumentationen, Anleitungen zur Integration der Retarus Services in Ihr Unternehmen sowie SDKs für beliebte Websprachen, Code-Snippets, Tutorials und Beispiel-Apps für häufige Anwendungsfälle.

Besuchen Sie das Retarus Developer-Portal.

Graphic: Developer Portal for SMS, Email and Fax API

Entdecken Sie die Vorteile der Retarus Enterprise Fax APIs.

N

Optimale Zustellung

Senken Sie die Fehlerrate beim Fax-Versand um bis zu 10% und reduzieren Sie den Aufwand für die manuelle Nachbearbeitung Ihrer Aussendungen. Die Retarus NeverBusy-Technology stellt sicher, dass niemals mehrere Faxe gleichzeitig an einen Empfänger versendet werden. Eingehende Faxe werden dank der Retarus NeverBusy-Technology auch bei großen Volumina sofort, also ohne besetzte Leitungen oder Kapazitätsengpässe zugestellt.

N

Intelligentes Routing

Erzielen Sie mit Online Fax Services einen bis zu 30% höheren Durchsatz. Das Active Carrier Management in der Retarus Enterprise Cloud sorgt dafür, dass Ihre Faxe automatisch über die Routen bzw. die Carrier versendet werden, deren Leitungsqualität und Verfügbarkeit am besten zu Ihrem Versandauftrag passen. Mit Retarus als Fax Provider versenden Sie Ihre Faxe auch online stets zuverlässig.

N

Skalierbar und flexibel

Eliminieren Sie Über- und Unterkapazitäten. Egal, ob Sie heute 1.000 Fax-Dokumente am Tag versenden und morgen eine Million – mit der Enterprise Cloud von Retarus steht Ihnen zu jedem Zeitpunkt genau die Bandbreite zur Verfügung, die Sie gerade benötigen.

N

Hochverfügbar und global

Verlassen Sie sich auf weltweit zuverlässige Zustellung. Die auf Hochverfügbarkeit und Hochlastfähigkeit ausgelegte Retarus Enterprise Cloud mit selbst betriebenen Rechenzentren in Europa, Asien und in den USA sorgt für maximale Verfügbarkeit und Zustellsicherheit. In jeder Minute an jedem Tag im Jahr.

N

OCR und Barcode-Erkennung

Dank Fax as a Service integrieren Sie Fax optimal und einfach in Ihre Workflows. Etwa indem Sie Informationen oder Barcodes eingehender Dokumente mit der Retarus OCR und Barcode-Erkennung auslesen und über individuelle Smart-Routing-Optionen regelbasierend vorsortieren, ablegen oder automatisiert weiterverarbeiten. Oder Sie versehen vollautomatisch ausgehende Fax-Aufträge mit Barcodes, um nachgelagerte Prozesse zu automatisieren.

N

Perfekte Integration

Ob ERP, CRM- oder Legacy-System, Microsoft 365 oder Google Workspace - dank offener Standards lassen sich Retarus Fax Services an Business-Applikationen oder Cloud-Anwendungen nahezu aller Hersteller anbinden. Zum Beispiel per Webservice via RESTful-API oder über Standard-Schnittstellen und Protokolle wie SMTP, SFTP und HTTPS.

Was außerdem für die Fax-Schnittstellen von Retarus spricht …

N

Monitoring und Analyse

Kontrollieren Sie den Status Ihrer Fax-Kommunikation zu jeder Zeit über Dashboards und detaillierte Reports im webbasierenden Retarus Enterprise Administration Services Portal. In Echtzeit oder nach frei definierbaren Zeiträumen. Sowohl für ausgehende, als auch für eingehende Faxe.

N

Absolute Kostentransparenz

Senken Sie Ihre Investitions- und Prozesskosten. Mit Fax as a Service lassen sich die Aufwände für Telefon- und Fax-Infrastrukturen, Fax-Server, Software, Updates, Administration und Wartung massiv reduzieren oder ganz eliminieren. Die Retarus Abrechnungs-Modelle setzen ausschließlich auf nutzungsbasierte Seiten- bzw. Paketpreise (Pay-per-use).

N

Sicherheit und Compliance

Vertrauen Sie auf maximale Sicherheit. Die Retarus Enterprise Cloud mit seinen weltweit verteilten Rechenzentren erfüllt die strengsten landes- und branchenspezifischen Vorgaben hinsichtlich Datenschutz und Datensicherheit. Zum Beispiel BDSG, DSGVO, PCI-DSS oder HIPAA.

N

PGP und X.509 Verschlüsselung

Sichern Sie Ihre Fax-Kommunikation optimal ab. Die Anbindung an die Retarus Enterprise Cloud erfolgt ausschließlich über verschlüsselte Verbindungen (TLS, VPN). Auf Wunsch signiert und verschlüsselt Retarus auch eingehende Fax-Dokumente für Sie – abhängig vom Dateityp per AES 256-bit, PGP oder X.509.

N

Langzeit-Archivierung

Halten Sie branchenspezifische oder gesetzliche Vorgaben konsequent ein. Mit der Retarus Langzeitarchivierung erfüllt Ihre Fax-Kommunikation höchste Anforderungen an Datensicherung und Datenintegrität.

N

Enterprise Level SLAs

Wählen Sie ein Service Level Agreement, das den individuellen Anforderungen Ihres Unternehmens an Qualität und Geschwindigkeit entspricht. Retarus Fax APIs eignen sich für Startups ebenso wie für den Mittelstand oder internationale Konzerne.
N

Exklusiver Rufnummern-Service

Empfangen Sie Faxe überall auf der Welt mit lokalen Nummern. Retarus stellt auf allen Kontinenten Service- und Rufnummern für Sie bereit, die sich über das EAS-Portal bequem verwalten und zuweisen lassen. Auch die Portierung bestehender Fax-Eingangsnummern ist jederzeit möglich.

N

Service und Support

Erleben Sie erstklassigen Support. Bei weiterführenden Fragen und individuellen Anpassungen unterstützt Sie das Team von Retarus Enterprise Fax APIs gerne.

Testen Sie die Retarus Enterprise Fax APIs!

Die Retarus Enterprise Cloud ist eine weltweit einzigartige Infrastruktur für zuverlässige Übertragung von Informationen per Fax, E-Mail, SMS und EDI. Seit 1992 steht Retarus für technisch anspruchsvolle Faxkommunikation auf Unternehmensebene. Bauen Sie diese Expertise bei der Faxanbindung jetzt in Ihre Software ein. Einfach. Schnell. Und zuverlässig.