> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/magento-2-api-connector/magento2_en_us/getting-started/overview-and-data-flow.md).

# Overview & Data Flow

The connector operates directly within **Microsoft Dynamics 365 Business Central**. From here, users start synchronizations, control mappings, and track results. The app communicates with the shop via the Magento REST API.

### Work Areas at a Glance

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>🧭 Setup Wizard</strong></td><td>Guides new shops through connection, initial data, and required mappings.</td></tr><tr><td><strong>🧩 Mapping Hub</strong></td><td>Shows open mappings and leads to focused detail pages.</td></tr><tr><td><strong>⬇️ Download Cockpit</strong></td><td>Bundles reference, catalog, and sales downloads with preflight checks.</td></tr><tr><td><strong>🛒 Sales Order Dashboard</strong></td><td>Links Magento orders with the corresponding BC documents.</td></tr><tr><td><strong>🔎 Logs</strong></td><td>Separate business events, API details, and product download progress.</td></tr></tbody></table>

### Consciously Define Data Ownership

{% columns %}
{% column width="50%" %}
**Magento → Business Central**

* Payment and shipping methods
* Websites and Store Views
* Tax references and attributes
* Categories and products
* Orders and optional credit memos
  {% endcolumn %}

{% column width="50%" %}
**Business Central → Magento**

* Items and product structures
* Categories and assignments
* Images and related items
* Inventory per MSI source
* Shipment, tracking, and invoice
  {% endcolumn %}
  {% endcolumns %}

{% hint style="info" %}
Not every data area is bidirectional. Define a leading system for each area. For example, the **Upload Data** page sends data from BC to Magento, even though some legacy labels read “Import.”
{% endhint %}

### Recommended Operational Workflow

{% stepper %}
{% step %}
**Verify connection and initial data**

Test access and download all required reference data from Magento.
{% endstep %}

{% step %}
**Complete required mappings**

Review payment, shipping, tax, websites, languages, and MSI sources.
{% endstep %}

{% step %}
**Test with individual transactions**

Run one item, one inventory update, and one order through the full cycle.
{% endstep %}

{% step %}
**Verify the result in the target system**

Status fields alone are not sufficient: compare the BC record, log, and Magento result.
{% endstep %}

{% step %}
**Only then automate**

Activate batch sizes and Job Queue Entries step by step.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/magento-2-api-connector/magento2_en_us/getting-started/overview-and-data-flow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
