User guide
Everything you need to use the app, step by step.
Contents
1Install the app
Installation takes a minute and changes neither your store nor your orders.
- On the Shopify App Store, open the app page and click “Install”.
- Accept access to your orders: the app reads them to create invoices and only stores one thing on them, the invoice link. It changes nothing else.
- The app opens in your Shopify admin, under Apps › Hoshi Factures. Your store name, address and email are already filled in.
- On the Home tab, follow the “Getting started” list: it disappears once the three steps are done.
2Add your business details
These details appear on every invoice. They are required for a valid invoice.
- Open the Settings tab, “Your business” card.
- Quickest way (French companies): in “Auto-fill”, type your SIRET (or company name and city), click “Search” then “Use”. Company name, head office address, SIRET, legal form and VAT number are taken from the official register. You can also click “Use Shopify details”.
- Check the company name and email: customers reply to this address and you receive invoice copies there.
- Enter the address on several lines, with the postcode and city on the same line (e.g. “69002 Lyon”), then choose the country.
- Enter your company registration number (SIRET in France) and VAT number.
- VAT-exempt small business: tick the VAT exemption option. VAT disappears from invoices and the legal notice is added.
- Open “More business details” for the legal form and share capital, trade register, phone, website and what you sell (goods, services or both).
- Click “Save” in the bar that appears at the bottom of the screen.
3Customise and check the invoice
Give your invoices your brand’s look, then check the result before the first order.
- In Shopify, open Content › Files, upload your logo (PNG or JPEG) and copy its link.
- In Settings › Appearance, paste the link into “Logo URL” and choose the main color.
- If needed, edit the legal notice and thank-you message. Left empty, they are translated automatically into the customer’s language.
- Click “Preview PDF”: a sample invoice is downloaded with your settings, even unsaved ones.
- Save when you’re happy with the result.
4Choose when and how invoices are sent
By default, the invoice is created when the order is paid and emailed to the customer right away.
- In Settings › How it works, choose when to create the invoice: when the order is paid (recommended) or as soon as it is placed.
- Under “How your customers get their invoice”, choose: an email with the PDF attached (recommended, no setup); a single email with a “Download invoice” button on the order page (no code: 3 clicks to turn it on); or a single email with the link right in the Shopify confirmation (paste a code once). The settings guide you step by step.
- Tick “Send me a copy of every invoice” to receive each invoice and build your archive.
- To customise the email, open “Email to the customer”: subject and message accept the variables {{first_name}}, {{name}}, {{invoice_number}}, {{order}} and {{shop}}.
5Add the invoice link to the Shopify order confirmation (optional)
Your customers can also get their invoice from your store’s usual confirmation email.
- In Settings, open “Link in the Shopify order confirmation email” and click “Copy code”.
- In Shopify, go to Settings › Notifications › Customer notifications › Order confirmation, then “Edit code”.
- Paste the code where the button should appear, for example right after the order summary.
- Click “Preview” to check, then “Save”.
6Track your invoices day to day
The Home tab lists the latest invoices with their sending status.
- Each row shows the number, order, customer, date, total and email status.
- “Sent”: the customer received the invoice. “Not sent”: automatic sending is off. “Failed”: hover over the status to see why.
- Click “PDF” to download an invoice, or “Resend” to send it to the customer again.
- The Factur-X badge means the invoice also contains the data for e-invoicing.
7Numbering and languages
Numbers follow each other with no gaps, as the law requires, and each customer gets the invoice in their language.
- In Settings › Numbering and language, choose the number prefix (default “F-”, i.e. F-2026-00001).
- If you already issued invoices with another tool, set the next number: it can be increased but never decreased.
- Choose the invoice language: the customer’s (French, English, German, Spanish, Italian, Dutch, Brazilian Portuguese, Czech, Danish, Finnish, Norwegian Bokmål, Polish, European Portuguese, Swedish, Turkish and Malay) or a single language.
- With “Customer’s language”, also choose the fallback language used when the customer’s language is not available.
8Factur-X: e-invoicing
With Factur-X, the PDF also contains the invoice data, readable by accounting software and e-invoicing platforms, which become mandatory between businesses in France from 2026–2027.
- Open Settings › Factur-X: the option is on by default.
- If “Factur-X paused” is shown, fill in the missing detail (often the address, country or VAT number) and save.
- When the indicator turns to ✓, all following invoices are Factur-X, with no change for your customers.
9Manage your plan
Free plan: 10 invoices per month. Essential: 200 invoices for US$7.90 per month. Unlimited: US$12.90 per month. 7-day free trial on paid plans.
- The Plan tab (and Home) shows how many invoices you used this month. The counter resets on the 1st of every month.
- To change plan, click “Choose” then approve on the Shopify page: the amount is added to your Shopify bill.
- If the limit is reached, new orders are put on hold and you are notified by email. After upgrading, click “Generate their invoices” on Home.
- To go back to the Free plan, click “Cancel”.
10Good practices
A few habits to keep your accounting stress-free.
- Place a test order after setup (using Shopify Payments test mode) and check the invoice you receive.
- Keep your invoices for 10 years: keep the email copy or download them every month. They are deleted from the app 48 hours after uninstalling.
- An issued invoice cannot be changed: in case of a mistake or refund, issue a credit note with your accounting tool.
- A question? Check the FAQ in the Help tab.