Configure VosFactures
Get your VosFactures API code to connect Order Invoicer
Prerequisites
Before you begin, make sure that:
- You have an active VosFactures account
- You have administrator access to your account
Don't have an account yet? Create a free VosFactures account, then return to this guide.
Get your credentials
Order Invoicer connects to VosFactures with your account subdomain and your API code (authorization token).
Find your subdomain
Your VosFactures account is reachable at an address like mycompany.vosfactures.fr.
The subdomain is the part before .vosfactures.fr — here mycompany.
Retrieve your API code
- Log in to your VosFactures account
- Click Settings in the top-right corner: the Your account page opens
- In the left-hand menu, open the Integration tab
- Copy the API authorization code (API token)
The API code grants access to your VosFactures data. Never share it and keep it in a safe place.
Enter your credentials in Order Invoicer
In the VosFactures connection form:
- VosFactures subdomain: the subdomain only (e.g.
mycompany) - VosFactures API token: the API code you copied in the previous step
Click Test connection to verify your credentials before continuing.
Email invoices to your customers
In your connector's Invoices workflow, turn on Email the invoice to the customer. VosFactures then emails each invoice created, with its PDF attached, to the order's customer email address. The email is sent from your VosFactures account and uses its email templates.
- An order without a customer email address is not sent.
- Each email uses 1 credit (see Credits).
Updating existing customers
With the customer sync (“Customers from your store”), the sync mode sets whether to create the customers missing from VosFactures, update the existing ones, or both. An update brings over your store's name, first and last name, email, phone, address, VAT number and SIRET when they differ; an empty field in your store never clears a value. You can also pick the mode when you start a manual customer sync.
Troubleshooting
"Invalid credentials" error
- Make sure you copied your VosFactures API authorization code (from the Integration tab), not an API key from your online store (Shopify, Wix, etc.). A Wix key starts with
IST.— that is not the right code. - Check that you entered the subdomain only, without
.vosfactures.frorhttps:// - Make sure the API code was copied in full, with no spaces
- Check that the code was not regenerated from your account
Connector paused: "VosFactures rejects the API code"
VosFactures rejects the API code saved in Order Invoicer: it was regenerated, or VosFactures invalidated it for security reasons. No invoice can be created anymore, so the connector is paused and your orders wait.
- In VosFactures, copy the current API authorization code (see Retrieve your API code)
- In Order Invoicer, click Update the API key in the connector banner (or open the VosFactures application), then Update credentials, paste the code and save
- The connector resumes as soon as the code is validated
Generating a new code in VosFactures is not enough: until it is saved in Order Invoicer, Unpause leaves the connector paused.
"Seller name is required" error
If invoices fail with a missing seller name (nom du vendeur), your VosFactures
account has no default seller set. Set one in VosFactures, then the invoice will be
issued on the next attempt:
- Add your first and last name to your user profile, or
- Set a default seller name under Settings > Account settings > Default options > Billing documents
See the VosFactures guide: Nom du vendeur
Support
If you run into difficulties:
- Check the troubleshooting section above
- Contact our support:
contact@orderinvoicer.com