> For the complete documentation index, see [llms.txt](https://csv4you-1.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://csv4you-1.gitbook.io/guide/allgemeine-informationen/api.md). # API ## Allgemeine API-Informationen *** ## aktuelle API-Listings abrufen ![Einlesen unter 'Listings'](https://data.csv4you.com/media/image/guide/api/api-zuruecklesen-listings.png) ![Einlesen unter 'Mein Konto->Grundeinstellungen'](https://data.csv4you.com/media/image/guide/api/api-zuruecklesen-meinkonto.png) Um immer einen aktuellen Stand Ihrer Listings zu haben, müssen diese Daten in unser System zurückgelesen werden. Diese Daten dienen nur zum Vergleichen. Es werden immer die API-Listings-ID sowie Preis und Bestand benötigt. Sie können das Zurücklesen manuell durchführen oder mit einem Cronjob erledigen lassen. Ein Zurücklesen auf der Seite `Listings` schreibt nur die Daten für die gerade benutzte Datenquelle. Es werden trotzdem im Hintergrund ALLE Listings zurückgegeben. Das Zurücklesen auf der Seite `Mein Konto->Grundeinstellungen` unter der Auswahl `Cronjob: Daten von [APINAME] einlesen`, schreibt die Daten für ALLE Datenquellen. Sie müssen also nicht für jede Datenquelle das Zurücklesen durchführen. Dieses ist aber nur möglich, wenn Sie einen Cronjob hierfür eingerichtet haben. {% hint style="info" %} Mit dem Zurücklesen wird auch gewährleistet, das bei einem Update nur die Produkte gesendet werden, welche eine Änderung benötigen. Ein Abgleich erfolgt **fast immer** mit der SKU beim Shop/Marktplatz und der Artikelnummer im CSV4YOU. Bei einigen Systemen kann ein Abgleich nur über die zurückgegebene API-ID erfolgen. Sollten Sie Listings direkt auf dem Shop/Marktplatz **gelöscht** haben, empfehlen wir die vorhandenen Zuweisungen in unserem System zu entfernen. Es werden KEINE Daten im Shop/Marktplatz geändert. Danach können Sie erneut zurücklesen. {% endhint %} #### Unterscheidung der Listingstypen im Export * **nur neue Produkte**\ Es werden alle Produkte übertragen, welche noch nicht im externen System gelistet ist. Sollten Produkte bereits vorhanden sein, aber es wurde nicht zurückgelesen, kann es in einigen externen Systemen zu doppelten Listings kommen. * **gelistete Produkte**\ Es werden alle Produkte übertragen, welche bereits im externen System gelistet sind. *** ## Kategoriezuordnung Eine Übersicht der Einstellungen finden Sie [hier](/guide/seiten/export/categories.md). Einige Marktplätze benutzen eigene Kategoriezuordnungen, welche Sie über `Datenpool->Interne Kategorien` oder `Datenpool->Produkte` erreichen. *** ## Preiskalkulation Eine Übersicht der Einstellungen finden Sie [hier](/guide/seiten/export/pricecalculation.md). *** ## Exportprofil Wir empfehlen die nachfolgende Exportprofile einzurichten. Allgemeine Informationen zu den verschiedenen Funktionen der Exportprofile, finden Sie [hier](/guide/seiten/export.md). #### Neuanlage Richten Sie ein Exportprofil zur Neuanlage mit nachfolgenden Einstellungen im Abschnitt [Sonstiges](/guide/seiten/export/interface.md#sonstiges) ein: * **Was möchten Sie zu xxxxx übertragen?** 1. Auswahl 'Produkte' 2. Auswahl 'nur neue Produkte' {% hint style="info" %} Nach dem Export einer Produktneuanlage schauen Sie sich die Ihnen angebotenen Statusberichte an. In diesen finden Sie Informationen, ob die Produkte übertragen und angelegt wurden. Wenn das geschehen ist, sollten Sie aktuelle Daten in unser System zurücklesen. Dies erfolgt im Bereich Listings und der Auswahl des jeweiligen Shops oder Marktplatz. Sie können dafür auch einen Cronjob benutzen, welchen Sie unter den jeweilgen Verbindungseinstellungen Ihres Systems mit [CSV4YOU](https://www.csv4you.com) finden. {% endhint %} #### Bestandsänderung Richten Sie ein weiteres Exportprofil zum Bestandsabgleich mit nachfolgenden Einstellungen ein: * **Was möchten Sie zu xxxxx übertragen?** 1. Auswahl 'Bestand' 2. Auswahl 'Gelistete Produkte' {% hint style="danger" %} Standardmäßig werden nur Artikel übertragen, welche eine Änderung des Bestandes benötigen. {% endhint %} #### Preisänderung Sie können optional ein weiteres Exportprofil für den Preisabgleich mit nachfolgenden Einstellungen einrichten: * **Was möchten Sie zu xxxxx übertragen?** 1. Auswahl 'Preis' 2. Auswahl 'Gelistete Produkte' {% hint style="warning" %} Ein Preisupdate steht nicht bei allen API-Schnittstellen zur Verfügung {% endhint %} {% hint style="danger" %} Standardmäßig werden nur Artikel übertragen, welche eine Änderung des Preises benötigen. {% endhint %} #### Kategorien übertragen Bei einigen Schnittstellen können Sie die vorhandenen, internen Kategorien in Ihr System übertragen. Welche Kategorien gesendet werden, entscheidet die Auswahl im Bereich [Kategoriezuordnung](/guide/seiten/export/categories.md). * **Was möchten Sie zu xxxxx übertragen?** 1. Auswahl 'Kategorie' {% hint style="info" %} Sind keine Kategorien ausgewählt, werden, anders als bei den [Produkten](/guide/seiten/datenpool/product.md), keine [Kategorien](/guide/seiten/datenpool/categories.md) übertragen. {% endhint %} *** ## Produkte für den Export sperren ![Produkte für Marktplätze sperren/freischalten](https://data.csv4you.com/media/image/guide/api/api-product-sperren.png) ![Ansicht gesperrte Artikel](https://data.csv4you.com/media/image/guide/api/api-product-sperren-2.png) Sie können im Abschnitt 'API' der Einstellungen des Produktes angeben, ob ein Produkt für den Export gesperrt werden soll. Diese Produkte werden dann nicht übermittelt. --- # 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://csv4you-1.gitbook.io/guide/allgemeine-informationen/api.md?ask=&goal= ``` `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.