0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
A gem to interact with onlinebrief24.de (send PDFs as physical letters/snail mail)
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 2.0
 Project Readme

Onlinebrief24

Gem Version Build Status

This gem is interesting for users of the German letter outbound service Onlinebrief24.de. This gem wraps the required workflow to upload a PDF to Onlinebrief24's servers. Onlinebrief24 then prints and mails the letters via snail mail. As this service is only available to German customers, the following documentation is available in German language only.

Voraussetzung

Ruby 1.9.2 oder neuer.

Installation

Über Bundler im Gemfile hinzufügen:

gem 'onlinebrief24'

…dann auf der Shell Bundler das Gem installieren lassen:

$ bundle

…oder global mit:

$ gem install onlinebrief24

Beispiele

require 'onlinebrief24'

c = Onlinebrief24::Client.new :login => 'email@example.com', :password => '123456'

c.upload! '/tmp/filename1.pdf', :duplex     => true,       :color        => false
c.upload! '/tmp/filename2.pdf', :registered => :insertion, :envelope     => :c4
c.upload! '/tmp/filename3.pdf', :registered => :standard,  :distribution => :international

c.disconnect

Block

require 'onlinebrief24'

Onlinebrief24::Client.new(:login => 'email@example.com', :password => '123456') do |client|
  client.upload! '/tmp/filename1.pdf', :duplex     => true,       :color        => false
  client.upload! '/tmp/filename2.pdf', :registered => :insertion, :envelope     => :c4
  client.upload! '/tmp/filename3.pdf', :registered => :standard,  :distribution => :international
end

Optionen für Brief

Option Werte Vorbelegung Beschreibung
:color
  • true
  • false
false Farbdruck ja/nein
:duplex
  • true
  • false
false Duplexdruck ja/nein
:envelope
  • :din_lang
  • :c4
:din_lang Umschlagformat. DIN lang oder C4.
:distribution
  • :auto
  • :national
  • :international
:auto Versandzone. Automatisch, National, International
:registered
  • :none
  • :insertion
  • :standard
  • :personal
:none Einschreiben: Nein, Einwurf-Einschreiben, Standard-Einschreiben, Einschreiben eigenhändig

Hinweis

Ausprobieren / Keine Funktionsgarantie!

Onlinebrief24 räumt aktuell (Stand Januar 2013) jedem Neukunden ein Guthaben von 5 EUR ein. Es wird empfohlen die Benutzung dieses rubygems damit zu testen. Die vorhandenen Tests (RSpec) im spec-Verzeichnis können dies nicht ersetzen!

Fehler? Probleme? Patches?

Bitte Fehler, Probeme und Patches über Github Issues bzw Pull-Requests einreichen.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Hinweis

Dies ist ein unabhängiges OpenSource-Projekt und kein offizielles Produkt von Onlinebrief24.de.

Copyright

Licensed under the MIT license.

Copyright © 2013 Roland Moriz, Moriz GmbH

LinkedIn Twitter