> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/integration/de/generic-integration-topics/migration-guide-from-soap-to-rest-or-json.md).

# Migrationsleitfaden von SOAP zu REST oder JSON

Mit FactFinder NG wird die SOAP/Webservice-API nicht mehr unterstützt. Um den Wechsel von SOAP zu erleichtern, finden Sie hier eine Liste der vorhandenen SOAP-Methoden und ihrer Ersatzlösungen in den REST- und JSON-APIs. Sie können einen Client mithilfe der Swagger-Dokumentation für die REST-API oder der JSON-Schema-Definitionen generieren.

| SOAP-Methode                               | REST-API (HTTP-Methode URL)                                                                                                                                                                                                                                                                                                                                                                                                                        | JSON-API                                                          |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Campaign.getProductCampaigns(...)          | GET ../rest/{apiversion}/campaign/{channel}/product                                                                                                                                                                                                                                                                                                                                                                                                | ../ProductCampaign.ff?do=getProductCampaigns\&format=json&..      |
| Campaign.getShoppingCartCampaigns(...)     | GET ../rest/{apiversion}/campaign/{channel}/shoppingcart                                                                                                                                                                                                                                                                                                                                                                                           | ../ProductCampaign.ff?do=getShoppingCartCampaigns\&format=json&.. |
| Campaign.getPageCampaigns(...)             | GET ../rest/{apiversion}/campaign/{channel}/page                                                                                                                                                                                                                                                                                                                                                                                                   | ../ProductCampaign.ff?do=getPageCampaigns\&format=json&..         |
| ChannelManagement.createChannel(...)       | Wir haben keine Aufzeichnungen darüber, dass diese Methoden verwendet werden, daher können sie ohne Ersatz gelöscht werden. Wenn Sie tatsächlich eine davon verwenden, kontaktieren Sie bitte den Support, um weitere Schritte zu koordinieren. Diese Aktionen können in der Regel über die Benutzeroberfläche durchgeführt werden.                                                                                                                |                                                                   |
| ChannelManagement.applyLocaleDefaults(...) |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| ChannelManagement.applyInitTemplate(...)   |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| ChannelManagement.deleteChannel(...)       |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| ChannelManagement.getAllChannels(...)      |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| Import.deleteRecord(...)                   | DELETE ../rest/{apiversion}/records/{channel}?recordId=x                                                                                                                                                                                                                                                                                                                                                                                           | ../Delete.ff                                                      |
| Import.deleteRecords(...)                  | DELETE ../rest/{apiversion}/records/{channel}?recordId=x\&recordId=y                                                                                                                                                                                                                                                                                                                                                                               | Leider gibt es für diese Methode keinen Ersatz in der JSON-API.   |
| Import.insertRecord(...)                   | POST ../rest/{apiversion}/records/{channel}                                                                                                                                                                                                                                                                                                                                                                                                        | ../Insert.ff                                                      |
| Import.insertRecords(...)                  | POST ../rest/{apiversion}/records/{channel}                                                                                                                                                                                                                                                                                                                                                                                                        | Leider gibt es für diese Methode keinen Ersatz in der JSON-API.   |
| Import.downloadProductExport(...)          | Wir haben keine Aufzeichnung darüber, dass diese Methode verwendet wird, daher kann sie ohne Ersatz gelöscht werden. Wenn Sie sie tatsächlich verwenden, kontaktieren Sie bitte den Support, um weitere Schritte zu koordinieren. Diese Aktionen können in der Regel über die Benutzeroberfläche durchgeführt werden.                                                                                                                              |                                                                   |
| Import.startImport(...)                    | POST ../rest/{apiversion}/import/search?channel=de                                                                                                                                                                                                                                                                                                                                                                                                 | ../Import.ff?format=json\&channel=A                               |
| Import.startImports(...)                   | POST ../rest/{apiversion}/import/search?channel=de\&channel=at                                                                                                                                                                                                                                                                                                                                                                                     | Leider gibt es für diese Methode keinen Ersatz in der JSON-API.   |
| Import.startSuggestImport(...)             | POST ../rest/{apiversion}/import/suggest?channel=de                                                                                                                                                                                                                                                                                                                                                                                                | ../Import.ff?format=json\&type=suggest\&channel=A                 |
| Import.updateRecord(...)                   | PUT ../rest/{apiversion}/records/{channel}                                                                                                                                                                                                                                                                                                                                                                                                         | ../Update.ff                                                      |
| Import.getErrors(...)                      | Fehlermeldungen während des Imports sind Teil der jeweiligen Rückgabe. Zusätzlich können Sie Importfehler in festgelegten Intervallen per E-Mail erhalten oder sie über die Oberfläche überprüfen, daher gibt es keinen Ersatz für diese Methode. Wenn Sie sie tatsächlich verwenden, kontaktieren Sie bitte den Support, um weitere Schritte zu koordinieren. Diese Aktionen können in der Regel über die Benutzeroberfläche durchgeführt werden. |                                                                   |
| ProductComparison.compareRecords(...)      | GET ../rest/{apiversion}/compareproducts/{channel}                                                                                                                                                                                                                                                                                                                                                                                                 | ../Compare.ff?format=json&..                                      |
| Recommender.importData(...)                | POST ../rest/{apiversion}/import/recommendation?channel=de                                                                                                                                                                                                                                                                                                                                                                                         | ../Recommender.ff?do=importData\&format=json&..                   |
| Recommender.getRecommendation(...)         | GET ../rest/{apiversion}/recommendation/{channel}                                                                                                                                                                                                                                                                                                                                                                                                  | ../Recommender.ff?do=getRecommendation\&format=json&..            |
| Search.getSuggestions(...)                 | GET ../rest/{apiversion}/suggest/{channel}                                                                                                                                                                                                                                                                                                                                                                                                         | ../Suggest.ff?format=json&..                                      |
| SimilarProducts.getSimilarProducts(...)    | GET ../rest/{apiversion}/similarproducts/{channel}                                                                                                                                                                                                                                                                                                                                                                                                 | ../SimilarRecords.ff?format=json&..                               |
| TagCloud.getTagCloudEntries(...)           | GET ../rest/{apiversion}/tagcloud/{channel}                                                                                                                                                                                                                                                                                                                                                                                                        | ../TagCloud.ff?do=getTagCloud\&format=json&..                     |
| Tracking.logInformation(...)               | POST ../rest/{apiversion}/track/{channel}/{\[cart, checkout, click, feedback, log, login, recommendationClick]}                                                                                                                                                                                                                                                                                                                                    | ../Tracking.ff?..                                                 |
| Tracking.logMultipleInformation(...)       | POST ../rest/{apiversion}/track/{channel}/{\[cart, checkout, click, feedback, log, login, recommendationClick]}                                                                                                                                                                                                                                                                                                                                    | ../Tracking.ff?..                                                 |
| UserManagement.createGroup(...)            | Wir haben keine Aufzeichnungen darüber, dass diese Methoden verwendet werden, daher können sie ohne Ersatz gelöscht werden. Wenn Sie tatsächlich eine davon verwenden, kontaktieren Sie bitte den Support, um weitere Schritte zu koordinieren. Diese Aktionen können in der Regel über die Benutzeroberfläche durchgeführt werden.                                                                                                                |                                                                   |
| UserManagement.deleteGroup(...)            |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.deleteUser(...)             |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.getAllUsers(...)            |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.getAllGroups(...)           |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.getAllRoles(...)            |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.getGroup(...)               |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.getUser(...)                |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.isAdmin(...)                |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.updateGroup(...)            |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.updateUser(...)             |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |
| UserManagement.createUser(...)             |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                   |


---

# 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.fact-finder.com/integration/de/generic-integration-topics/migration-guide-from-soap-to-rest-or-json.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.
