[Skip to main content](#vessel-content)

#  Billbee plugin

Details    Written by: Administrator    Category: [Pther extensions](/support/documentation/hikashop/other-extensions)     Published: 20 November 2026     Hits: 7

The Billbee plugin connects your shop to **Billbee** as a custom webshop: Billbee calls your site to fetch the new orders, and tells it when an order is paid, shipped or canceled in Billbee. Everything is set on the **Billbee** page of the HikaShop backend (System menu).

## Installation

1. Download the plugin from our website via the download link given after the purchase, and install it with the extension manager of Joomla, or in HikaShop &gt; Plugins on WordPress. Enable it.
2. Open HikaShop &gt; System &gt; **Billbee**. Click **Generate a new key**: the page now shows the **Address for Billbee** and the **Key**, each with a Copy button.

![The Connection to Billbee block of the plugin page: the address for Billbee, the key and the Basic Auth fields](/images/doc/plugins/billbee/billbee_connection.png)
3. In Billbee, open **Einstellungen** (Settings), then **Kanäle** (Channels), and click **Shop hinzufügen** (Add shop). In the list, under "Sonstige Shops", choose **Eigener Webshop (Billbee API)** (type "Eigener" in the search field to find it).

![Billbee, Shop hinzufügen: the search finds Eigener Webshop (Billbee API)](/images/doc/plugins/billbee/billbee_add_shop.png)
4. Fill in the form: **Name**, any name for your shop; **URL**, the address for Billbee; **Schlüssel** (key), the key. Leave the two Basic Auth fields empty, unless you set a user name and password on the plugin's page too. Click **Speichern** (Save). Billbee calls your site at once to check the connection, so your site must be reachable from the internet.

![The Billbee form of a custom webshop: Name, URL, Schlüssel and the two Basic Auth fields](/images/doc/plugins/billbee/billbee_shop_form.png)
5. A new shop connection starts paused in Billbee: open it in Einstellungen &gt; Kanäle and click **Aktivieren** (Activate) under "Abruf neuer Bestellungen". Billbee imports the orders placed from that moment on; the refresh button of its Bestellungen (orders) page starts an import at once.

## Configuration

### Connection to Billbee

- **Address for Billbee**: the URL to enter in Billbee's shop connection.
- **Key**: shared with Billbee, which signs every call with it. Generate one, or paste the key already entered in Billbee. Generating a new key stops the connection until you enter it in Billbee too.
- **Basic Auth user name** and **password**: optional. When set, Billbee must send the same ones (the Basic Auth fields of its shop connection).
- **Orders fetched by Billbee**: how many orders Billbee has imported, and when it last did.

### Orders sent to Billbee

- **Order statuses**: Billbee only sees the orders in these statuses, by default confirmed and shipped. Add "created" to have the unpaid bank transfer orders in Billbee too.
- **Orders created from**: older orders are never sent, so Billbee does not import the past orders of your shop. It is set to the day you first save the page.
- **Billbee state of each status**: the state the order has in Billbee when it is imported (by default: created and pending as ordered, confirmed as paid, shipped as shipped, cancelled and refunded as canceled).
- **Payment methods**: the Billbee payment type of each payment method of your shop. The plugin guesses it from the payment plugin (PayPal, Stripe, bank transfer...) until you choose another one.
- **Send the item custom fields**: the values the customer entered on each product line (item custom fields) become options of the line in Billbee, beside the characteristics of the variant.
- **Send the order language**: the language of the order (for example de-DE) goes in the order's comment and history in Billbee. Billbee chooses the language of its invoices and emails from the customer's language, which a Billbee automation rule can set.

### Changes made in Billbee

- **HikaShop status for each Billbee state**: when the order reaches this state in Billbee (paid, packed, shipped, closed, canceled), the order of your shop gets this status. An order never goes back: paid after shipped leaves it shipped. Canceled always applies. Each change, with the comment Billbee sends, is written in the history of the order.
- **Notify the customer**: sends the usual status change email of HikaShop when Billbee changes the status. The tracking number, carrier and tracking link Billbee sends with a shipment are written in the order history.
- **Stock from Billbee**: lets Billbee set the stock of your products. Leave it off when the shop keeps the stock. In Billbee, tick **Abgleich aktiv** (and **Abgleich bei neuen Artikeln aktiv**) on the Bestandsabgleich tab of the shop connection; an article Billbee already had keeps its stock sync off until you untick **Bestandsabgleich deaktivieren** on its Quellen tab.
- **Debug log**: writes each call of Billbee in the HikaShop log.

The order page of your backend shows when Billbee imported the order and its last state in Billbee:

![The order page of the backend: the Billbee row with the import date and the Billbee state](/images/doc/plugins/billbee/billbee_order_page.png)

## Troubleshooting

- **Billbee refuses to save the shop connection**: Billbee calls your site when you save. Check that your site is reachable from the internet (not a local or password-protected test site), that the address is complete, and that the key in Billbee is the one shown by the plugin, without spaces.
- **An order is not in Billbee**: check that its status is one of the order statuses of the plugin, and that it was created after the "Orders created from" date. Billbee imports at its own pace; its manual import button fetches the orders at once.
- **Paid or shipped in Billbee does not change the order**: check the HikaShop status chosen for that Billbee state. An order already further along is left as it is, by design.
- **Invoices and emails in the wrong language**: Billbee uses the language of the customer in Billbee. Create a Billbee automation rule for imported orders that sets it, for instance from the delivery country.
