einvoicing-connect — Platform connectors for Ruby e-invoicing
Companion gem to einvoicing. Submit Factur-X invoices to Chorus Pro / PPF and look up SIRET numbers via the French government API.
What is einvoicing-connect?
🔌 Chorus Pro / PPF
Submit invoices to the French public platform (PPF / Chorus Pro) using OAuth2 client credentials. Handles Factur-X PDF upload and invoice status polling.
🔍 SIRET lookup
Look up SIRET numbers from SIREN via the French government Sirene API. No authentication required. Enriches party objects directly.
Current features
Chorus Pro / PPF client
OAuth2 (client_credentials), deposit_flux for Factur-X PDF upload, invoice status polling
SIRET lookup via French government API
`EinvoicingConnect::FR::SiretLookup.find(siren)` and `enrich!(party)` — no auth, stdlib only
Quick start
# Gemfile
gem "einvoicing"
gem "einvoicing-connect"
# Submit a Factur-X invoice to Chorus Pro
client = EinvoicingConnect::PPF::Client.new(
client_id: ENV["PPF_CLIENT_ID"],
client_secret: ENV["PPF_CLIENT_SECRET"]
)
client.deposit_flux(pdf_path: "invoice.pdf")
# Look up a SIRET from SIREN
party = EinvoicingConnect::FR::SiretLookup.enrich!(party)
Used in production
These SXN Labs applications use einvoicing-connect to submit invoices to Chorus Pro.
Want to integrate this in your app?
Need help submitting e-invoices to Chorus Pro from your Ruby on Rails application? Get in touch.
Contact us