> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# [GUIDE_TITLE]

> [BRIEF_DESCRIPTION - one sentence summary of what the user will learn]

## Understanding \[TOPIC\_NAME]

**\[TOPIC\_NAME]** \[describe what this topic covers and why it matters]. According to the [relevant standard/reference](https://link-to-source), this includes:

* **\[Category 1]**: \[Description]
* **\[Category 2]**: \[Description]
* **\[Category 3]**: \[Description]
* **\[Category 4]**: \[Description]

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           [DIAGRAM_TITLE]                                   │
├─────────────────────┬─────────────────────┬─────────────────────────────────┤
│  [Column 1]         │  [Column 2]         │  [Column 3]                     │
│  [Header]           │  [Header]           │  [Header]                       │
├─────────────────────┼─────────────────────┼─────────────────────────────────┤
│  • [Item 1]         │  • [Item 1]         │  • [Item 1]                     │
│  • [Item 2]         │  • [Item 2]         │  • [Item 2]                     │
│  • [Item 3]         │  • [Item 3]         │  • [Item 3]                     │
│  • [Item 4]         │  • [Item 4]         │  • [Item 4]                     │
└─────────────────────┴─────────────────────┴─────────────────────────────────┘
```

<Note>
  **\[KEY\_CONCEPT\_TITLE]**

  \[Explain the key formula, concept, or methodology]

  **\[FORMULA\_NAME] = \[FORMULA]**

  Where:

  * **\[Variable 1]**: \[Description]
  * **\[Variable 2]**: \[Description]
  * **\[Variable 3]**: \[Description]
</Note>

## Prerequisites

Before starting, ensure you have:

* Dcycle API credentials ([get them here](/docs/quickstart#step-1-get-your-api-key))
* \[Prerequisite 2]
* \[Prerequisite 3]

<Tip>
  **Using the Dcycle App?**

  You can also manage this through our web interface:

  * [Feature 1](https://app.dcycle.io) - \[Description]
  * [Feature 2](https://app.dcycle.io) - \[Description]
  * [Feature 3](https://app.dcycle.io) - \[Description]
</Tip>

## Data Map: \[TOPIC] Requirements Overview

Before diving into the calculations, here's a complete overview of the data you'll need:

```
┌─────────────────────────────────────────────────────────────────────────────────────────┐
│                        [TOPIC] DATA REQUIREMENTS OVERVIEW                               │
├─────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                         │
│  ┌─────────────────────────────────────────────────────────────────────────────────┐   │
│  │ [SECTION 1] (Steps X.1 - X.N)                                                   │   │
│  ├─────────────────────────────────────────────────────────────────────────────────┤   │
│  │                                                                                 │   │
│  │  [Category 1]              [Category 2]          [Category 3]                   │   │
│  │  ─────────────────         ────────────          ─────────────────              │   │
│  │  • [Field 1]               • [Field 1]           • [Field 1]                    │   │
│  │  • [Field 2]               • [Field 2]           • [Field 2]                    │   │
│  │  • [Field 3]               • [Field 3]           • [Field 3]                    │   │
│  │  • [Field 4]               • [Field 4]           • [Field 4]                    │   │
│  │                                                                                 │   │
│  └─────────────────────────────────────────────────────────────────────────────────┘   │
│                                                                                         │
│  ┌─────────────────────────────────────────────────────────────────────────────────┐   │
│  │ [SECTION 2] (Steps X.N+1 - X.M)                                                 │   │
│  ├─────────────────────────────────────────────────────────────────────────────────┤   │
│  │                                                                                 │   │
│  │  [Category 1]              [Category 2]                                         │   │
│  │  ────────────────────      ────────────────                                     │   │
│  │  • [Field 1]               • [Field 1]                                          │   │
│  │  • [Field 2]               • [Field 2]                                          │   │
│  │  • [Field 3]               • [Field 3]                                          │   │
│  │  • [Field 4]               • [Field 4]                                          │   │
│  │                                                                                 │   │
│  └─────────────────────────────────────────────────────────────────────────────────┘   │
│                                                                                         │
└─────────────────────────────────────────────────────────────────────────────────────────┘
```

## \[MAIN\_SECTION\_TITLE]

\[Introduction to this section - what it covers and how Dcycle handles it]

### Emission Sources Covered

| Source Type   | \[Column 2] | Examples    |
| ------------- | ----------- | ----------- |
| **\[Type 1]** | `[value]`   | \[Examples] |
| **\[Type 2]** | `[value]`   | \[Examples] |
| **\[Type 3]** | `[value]`   | \[Examples] |
| **\[Type 4]** | `[value]`   | \[Examples] |

### Calculation Methods by \[CATEGORY]

<Tabs>
  <Tab title="[Option 1 Name]">
    For \[context], Dcycle uses \[methodology] from **\[Source]**.

    ```
    [Flow diagram showing the process]
    [Input] → [Step 1] → [Step 2] → [Output]
          ↓         ↓           ↓           ↓
      [Detail]  [Detail]    [Detail]    [Detail]
    ```

    **Key characteristics:**

    * \[Characteristic 1]
    * \[Characteristic 2]
    * \[Characteristic 3]
    * \[Characteristic 4]

    <Tip>
      Access \[resource name] [here](https://link-to-resource).
    </Tip>

    <AccordionGroup>
      <Accordion title="Emission Factor Sources - [Option 1]">
        For \[context], Dcycle uses emission factors from:

        * **\[Source 1]** (\[Full name])
        * \[Additional details]
        * Source: [Link to official source](https://link)

        Factors are automatically selected based on:

        * \[Selection criteria 1]
        * \[Selection criteria 2]
        * \[Selection criteria 3]
      </Accordion>

      <Accordion title="Calculation Details - [Option 1]">
        \[Explain the calculation methodology]

        **\[Formula Name] = \[Formula]**

        Where:

        * **\[Variable 1]**: \[Description]
        * **\[Variable 2]**: \[Description]
        * **\[Variable 3]**: \[Description]

        **Example (\[specific case]):**

        ```
        [Step-by-step calculation example]
        ```
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="[Option 2 Name]">
    For \[context], Dcycle uses \[methodology] from **\[Source]**.

    ```
    [Flow diagram showing the process]
    ```

    **Key characteristics:**

    * \[Characteristic 1]
    * \[Characteristic 2]
    * \[Characteristic 3]

    <Tip>
      Access \[resource name] [here](https://link-to-resource).
    </Tip>

    <AccordionGroup>
      <Accordion title="Emission Factor Sources - [Option 2]">
        \[Emission factor source details]
      </Accordion>

      <Accordion title="Calculation Details - [Option 2]">
        \[Calculation methodology details]
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

<Note>
  **Automatic \[Feature] Selection**

  You don't need to specify \[what]. Dcycle automatically detects \[criteria] and applies the correct \[settings]:

  * `[condition 1]` → \[result 1]
  * `[condition 2]` → \[result 2]
</Note>

What you'll track:

```
[Stage 1] → [Stage 2] → [Stage 3]
      ↓           ↓            ↓
  [Detail]    [Detail]     [Detail]
```

### Data Flow

<Steps>
  <Step title="[Step 1 Title]">
    \[Step 1 description]
  </Step>

  <Step title="[Step 2 Title]">
    \[Step 2 description]
  </Step>

  <Step title="[Step 3 Title]">
    \[Step 3 description]
  </Step>

  <Step title="[Step 4 Title]">
    \[Step 4 description]
  </Step>

  <Step title="[Step 5 Title]">
    \[Step 5 description]
  </Step>
</Steps>

### Step \[X.1]: \[Step Title]

<Accordion title="📋 Data Map: [Step Name]">
  | Field          | Type   | Required | Description                   | Example           |
  | -------------- | ------ | -------- | ----------------------------- | ----------------- |
  | `[field_name]` | string | ✅        | \[Description]                | `"[example]"`     |
  | `[field_name]` | UUID   | ✅        | \[Description]                | `"abc-123-..."`   |
  | `[field_name]` | number | ✅        | \[Description]                | `5000`            |
  | `[field_name]` | date   | ✅        | \[Description]                | `"2024-01-01"`    |
  | `[field_name]` | UUID   | ❌        | \[Optional field description] | `"optional-uuid"` |

  **Where to get this data:**

  * **\[Field 1]**: \[Source/method to obtain]
  * **\[Field 2]**: \[API endpoint or manual source]
  * **\[Field 3]**: \[Data source description]
</Accordion>

\[Brief introduction to what this step accomplishes]

<CodeGroup>
  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests
  import os

  headers = {
      "Authorization": f"Bearer {os.getenv('DCYCLE_API_KEY')}",
      "Content-Type": "application/json",
      "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
      "x-user-id": os.getenv("DCYCLE_USER_ID"),
  }

  # [Comment explaining what this code does]
  [variable] = "[value]"

  # [Step 1 comment]
  response = requests.get(
      f"https://api.dcycle.io/api/v1/[endpoint]/{[variable]}",
      headers=headers,
  ).json()

  # [Step 2 comment]
  data = {
      "[field_1]": "[value]",
      "[field_2]": [value],
      "[field_3]": "[value]",
  }

  # [Step 3 comment]
  response = requests.post(
      "https://api.dcycle.io/api/v1/[endpoint]",
      headers=headers,
      json=data,
  )

  result = response.json()
  print(f"✅ [Success message]: {result['id']}")
  print(f"   [Additional info]: {result['field']}")
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const axios = require('axios');

  const headers = {
    Authorization: `Bearer ${process.env.DCYCLE_API_KEY}`,
    'Content-Type': 'application/json',
    'x-organization-id': process.env.DCYCLE_ORG_ID,
    'x-user-id': process.env.DCYCLE_USER_ID,
  };

  // [Comment explaining what this code does]
  const variable = 'value';

  // [Step 1 comment]
  const response = await axios.get(
    `https://api.dcycle.io/api/v1/[endpoint]/${variable}`,
    { headers }
  );
  const data = response.data;

  // [Step 2 comment]
  const requestData = {
    field_1: 'value',
    field_2: value,
    field_3: 'value',
  };

  // [Step 3 comment]
  const result = await axios.post(
    'https://api.dcycle.io/api/v1/[endpoint]',
    requestData,
    { headers }
  );

  console.log(`✅ [Success message]: ${result.data.id}`);
  console.log(`   [Additional info]: ${result.data.field}`);
  ```
</CodeGroup>

<Tip>
  **\[Helpful Tip Title]**

  \[Tip content explaining a best practice, shortcut, or recommendation]
</Tip>

### Step \[X.2]: \[Step Title]

<Accordion title="📋 Data Map: [Step Name]">
  | Field          | Type   | Required | Description    | Example         |
  | -------------- | ------ | -------- | -------------- | --------------- |
  | `[field_name]` | string | ✅        | \[Description] | `"[example]"`   |
  | `[field_name]` | UUID   | ✅        | \[Description] | `"abc-123-..."` |
  | `[field_name]` | number | ✅        | \[Description] | `250`           |

  **Where to get this data:**

  * **\[Field 1]**: \[Source/method to obtain]
  * **\[Field 2]**: \[API endpoint or manual source]
</Accordion>

\[Brief description of this step and when to use it]

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
# [Code example for this step]
data = {
    "[field_1]": "[value]",
    "[field_2]": [value],
}

response = requests.post(
    "https://api.dcycle.io/api/v1/[endpoint]",
    headers=headers,
    json=data,
)

print(f"✅ [Success message]: {response.json()['id']}")
```

<Warning>
  **\[Warning Title]**

  \[Important warning about potential issues, high-impact items, or common mistakes]

  * **\[Item 1]**: \[Value/impact]
  * **\[Item 2]**: \[Value/impact]
  * **\[Item 3]**: \[Value/impact]

  \[Additional context or recommendation]
</Warning>

<Note>
  **\[Note Title]**

  \[Important information about behavior, distinctions, or clarifications]

  * Use `[option A]` when \[condition A]
  * Use `[option B]` when \[condition B]

  Example: \[Concrete example to illustrate the note]
</Note>

## \[SECONDARY\_SECTION\_TITLE]

\[Introduction to secondary section]

<AccordionGroup>
  <Accordion title="[Accordion 1 Title]">
    \[Content]
  </Accordion>

  <Accordion title="[Accordion 2 Title]">
    \[Content with formula or methodology]

    **\[Formula] = \[Expression]**

    Where:

    * **\[Variable 1]**: \[Description]
    * **\[Variable 2]**: \[Description]
  </Accordion>

  <Accordion title="[Accordion 3 Title]">
    \[Content]
  </Accordion>
</AccordionGroup>

### CSV Format for \[Data Type]

```csv theme={"theme":{"light":"github-light","dark":"github-dark"}}
[column1],[column2],[column3],[column4],[column5]
[example_row_1]
[example_row_2]
[example_row_3]
```

### Query \[Data Type]

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
# [Code example for querying/retrieving data]
response = requests.get(
    f"https://api.dcycle.io/api/v1/[endpoint]/{[id]}",
    headers=headers,
    params={
        "page": 1,
        "size": 50,
        "[filter_1]": "[value]",
        "[filter_2]": "[value]",
    },
).json()

print(f"📊 [Data Type]:")
for item in response["items"]:
    print(f"   {item['field_1']} - {item['field_2']}")
    print(f"   [Label]: {item['field_3']}")
    print()
```

<Tip>
  **Best Practice: \[Practice Title]**

  For complete \[topic] accounting:

  1. **\[Recommendation 1]**: \[Description]
  2. **\[Recommendation 2]**: \[Description]
  3. **\[Recommendation 3]**: \[Description]

  Use the `[field]` field (`[option A]` or `[option B]`) to distinguish.
</Tip>