[Vineyard & Winery Elf EN](https://help.vineyardelf.com/index.md) / [VineyardElf](https://help.vineyardelf.com/vineyardelf.md)

# [Recipes (Bills of Materials) - InvoiceOcean integration](https://help.vineyardelf.com/recipes-bills-of-materials-invoiceocean-integration.md)

## What are recipes?

Recipes are the "recipes" for your finished products (for example, a bottle of wine): a list of components and their quantities. In WineryElf, recipes are pulled from the ERP module of the InvoiceOcean invoicing system.

## What are they for?

Recipes let you:

- 📦 Know exactly what a product is made of (wine, bottle, cork, label)
- 💰 Calculate the unit cost of a bottle
- 📊 Plan production and purchasing
- 📋 Document the production process

## How it works

### 1. Setting up the connection

WineryElf menu → **⚙️ Settings** → **InvoiceOcean**

Provide:
- **Subdomain** - e.g. `mycompany` (from the address mycompany.invoiceocean.com)
- **API token** - you will find it in InvoiceOcean → Settings → Integration → API authorization code

### 2. Synchronization

WineryElf menu → **📋 Recipes** → **Synchronize**

The system will fetch all recipes from your InvoiceOcean account.

### 3. Browsing

Each recipe shows:

| Field | Description |
|------|------|
| Name | Recipe name (e.g. "Riesling Bottle 2024") |
| Finished product | What the recipe produces |
| Components | List of components with quantities |
| Cost | Total value of the components |

## Example recipe

**Riesling Bottle 2024**

| Component | Quantity | Price | Value |
|----------|-------|------|--------|
| Riesling wine | 0.75 L | 10.67 / L | 8.00 |
| Bottle 0.75L | 1 pc | 1.80 | 1.80 |
| Natural cork | 1 pc | 2.50 | 2.50 |
| Label | 1 pc | 0.30 | 0.30 |
| Capsule | 1 pc | 0.15 | 0.15 |
| **TOTAL** | | | **12.75** |

## Where do you create recipes?

Recipes are created in the **InvoiceOcean** system:

1. Log in to InvoiceOcean
2. Go to: Warehouse → ERP → Recipes
3. Click "Add recipe"
4. Choose the finished product
5. Add components from your warehouse
6. Save

After saving, click "Synchronize" in WineryElf.

## Limitations

- Recipes are **read-only** in WineryElf
- Editing is possible only in InvoiceOcean
- Synchronization is manual (the "Synchronize" button)

## Requirements

- An active InvoiceOcean account with the ERP module
- An API token with read permissions
- Products and warehouse configured in InvoiceOcean