Mijn Farmad Apotheek

The Mijn Farmad Apotheek integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you search the product catalog of your pharmacy and order medication for pickup from Home Assistant, using your Mijn Farmad Apotheek account. Mijn Farmad Apotheek is the online service of pharmacies connected to Farmad, a platform used by more than 1000 pharmacies in Flanders.

The integration adds no entities. You use it through its two actions, which run on demand: search the catalog of a pharmacy, and order one product for pickup.

Use cases

• Order medication that runs out on a regular schedule, without opening the app each time.
• Check the price and the stock of a product at your pharmacy before ordering.
• Place a new order when a supply you track in Home Assistant runs low.

Prerequisites

• An account for the Mijn Farmad Apotheek app, registered at a pharmacy connected to Farmad. If you do not have an account yet, create one in the app or on the Farmad website.
• At least one pharmacy linked to your account in the app.

Configuration

To add the Mijn Farmad Apotheek service to your Home Assistant instance, use this My button:

Supported functionality

• The search action finds products in the catalog of a pharmacy by product name or CNK code, and returns up to 25 matches with price and stock.
• The order action places an order for one product at a pharmacy. Orders are paid at pickup.
• The Pharmacy field of both actions takes the APB number of the pharmacy, for example 343602.
• Only users with administrator rights can run the order action.

List of actions

The Mijn Farmad Apotheek integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Order medication (mijn_farmad_apotheek.order_medication) Places an order for one product at a Farmad pharmacy. The product is paid at pickup.

• Search medication (mijn_farmad_apotheek.search_medication) Searches the catalog of a Farmad pharmacy by product name or CNK and returns up to 25 matching products.

For an overview of every action across all integrations, see the actions reference.

Mijn Farmad Apotheek automation examples

Automation: order a product every month

This automation orders a known product on a monthly schedule, with a comment for the pharmacist. Create a calendar first, for example with the Local Calendar integration, and add an event that repeats on the first day of every month at 09:00. To find the CNK code of your product, use the Search medication action.

• Trigger: Calendar event started
  • Calendar: Medication orders (calendar.medication_orders)
• Action: Mijn Farmad Apotheek: Order medication
  • Product: 3093242
  • Quantity: 2
  • Pharmacy: 343602
  • Comment: For monthly pickup

alias: "Order a product every month"
description: "Orders two packages of a known product every month."
triggers:
  - trigger: calendar.event_started
    target:
      entity_id: calendar.medication_orders
actions:
  - action: mijn_farmad_apotheek.order_medication
    data:
      product: "3093242"
      quantity: 2
      apb: "343602"
      comment: "For monthly pickup"

Data updates

The integration fetches nothing on a schedule. Each action contacts Farmad when you run it, so the search results show the current price and stock.

If Farmad rejects the stored session, the actions fail and Home Assistant asks you to sign in again.

Your password is only used to sign in, and it is never stored. The integration keeps only your email address and the tokens Farmad returns, and refreshes the tokens when needed.

Known limitations

Authentication

• The integration supports a single account per Home Assistant instance.

Ordering

• Each order holds one product. To order several products, call the order action once per product.
• Orders are paid at pickup. Paying online is not supported.

Language

• Product names in the search results and order confirmations are in Dutch.

Troubleshooting

If your problem is not listed here, enable debug logging and check the logs:

1. Go to Settings > Devices & services.
2. Select Mijn Farmad Apotheek.
3. In the top right of the page, open the three dots menu, and select Enable debug logging.
4. Run the action that gave you the error, then open the same menu, select Disable debug logging, and download the log file.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
   • Depending on the integration, the entries are listed under one of the following headings:
     • Devices
     • Hubs
     • Services
     • Integration entries
3. To confirm, select Delete.
   • Home Assistant also deletes the devices and entities of the entry.
4. If Home Assistant asks you to restart, restart Home Assistant.
5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
   • If you keep them, Home Assistant uses them automatically when you add the integration again.
   • To delete them later, refer to Deleting application credentials.