migration accept/decline

README.md

@@ -118,62 +118,6 @@ Werden geänderte Lizenzdaten, übermittelt erfolgt automatisch eine Verlängeru
      `organisation_id`
      `first_issue_date` Ausnahme: Das Erstausstellungsdatum kann bei Bestandsdaten über "Bearbeiten" und "Korrigieren" geändert werden.
 
-## Umzugsanfrage stellen  ##
-
-Umzugsanfrage stellen, um eine Lizenz in einen anderen Zielverband zu verschieben. 
-Hinweis: Die Lizenz wird bei ausreichender Berechtigung direkt umgezogen.
-(Nur möglich unter dem selben Dachverband)
-
- **URL**
-
-  /migration_request
-
- **Method:**
-
-  `POST`
-  
-  **URL Params**
-
-   keine
-   
-
- **Data Params für vorhandene Lizenzen**
-
-   **Required:** `license_numbers_dosb`, `organisation_id`
-   
-  `license_numbers_dosb` = DOSB Lizenznummern
-  
-  `organisation_id`  = ID des Zielverbandes
-    
-## Umzugsanfragen abholen ##
-
-Umzugsanfragen für einen Verband abholen. 
-
- **URL**
-
-  /migration_get
-
- **Method:**
-
-  `POST`
-  
-  **URL Params**
-
- `organisation_id` 
- 
- 
- **Data Params für vorhandene Lizenzen**
-
-**Required:**
-   keine
-
-**Optional:**
-  `offset` , `limit` 
-
-  `offset` = Startwert der Abfrage  (default: 0)
-
-  `limit` = Anzahl der Umzugsanfragen für die Abfrage (default: 100)
-
 
 ### Wertetabelle ###
 
@@ -502,6 +446,121 @@ Bitte beachten Sie, dass die Felder vom Typ "Date" als Unixzeit, also dem POSIX-
    **Code:** 404 NOT FOUND <br />
     **Content:** `["License not found" ]`
 
+
+## Umzugsanfrage stellen  ##
+
+Umzugsanfrage stellen, um eine Lizenz in einen anderen Zielverband zu verschieben. 
+Hinweis: Die Lizenz wird bei ausreichender Berechtigung direkt umgezogen.
+(Nur möglich unter dem selben Dachverband)
+
+ **URL**
+
+  /migration_request
+
+ **Method:**
+
+  `POST`
+  
+  **URL Params**
+
+   keine
+   
+
+ **Data Params für vorhandene Lizenzen**
+
+   **Required:** `license_numbers_dosb`, `organisation_id`
+   
+  `license_numbers_dosb` = DOSB Lizenznummern
+  
+  `organisation_id`  = ID des Zielverbandes
+    
+## Umzugsanfragen abholen ##
+
+Umzugsanfragen für einen Verband abholen. 
+
+ **URL**
+
+  /migration_get
+
+ **Method:**
+
+  `POST`
+  
+  **URL Params**
+
+ `organisation_id` 
+ 
+ 
+ **Data Params für vorhandene Lizenzen**
+
+**Required:**
+   keine
+
+**Optional:**
+  `offset` , `limit` 
+
+  `offset` = Startwert der Abfrage  (default: 0)
+
+  `limit` = Anzahl der Umzugsanfragen für die Abfrage (default: 100)
+
+## Umzugsanfrage ablehnen  ##
+
+Umzugsanfrage ablehnen, um den Umzug einer Lizenz zu widersprechen. 
+
+ **URL**
+
+  /migration_decline
+
+ **Method:**
+
+  `POST`
+  
+  **URL Params**
+
+  `migration_id` (Lizenz-Id)
+  
+**Success Response:**
+
+Bei Erfolg wird eine entsprechende Message (migration_status) zurückgegeben: 
+"Migrate request has been deleted."
+
+## Umzugsanfrage annehmen  ##
+
+Umzugsanfrage annehmen, um eine Lizenz in einen Zielverband zu verschieben. 
+
+ **URL**
+
+  /migration_accept
+
+ **Method:**
+
+  `POST`
+  
+  **URL Params**
+
+  `migration_id` (Lizenz-Id)
+  
+**Success Response:**
+
+Bei Erfolg wird eine entsprechende Message (migration_status) zurückgegeben: 
+"Die Lizenz wurde umgezogen.""
+
+**Code:** 200
+ **Content-Type:** application/json
+ **Content:** migration_status
+
+**Error Response:**
+
+**Code:** 401 UNAUTHORIZED
+   **Content:** [ Invalid login credentials ]
+
+**Code:** 403 ACCESS DENIED
+   **Content:** [Access has been denied. ]
+
+**Code:** 404 NOT FOUND 
+   **Content:** [Migrate request not found! ]
+   
+
 ## FAQ
 
 1. Frage: Wenn die Daten per Schnittstelle übertragen werden, wie gelangen dann die erstellten Lizenz-pdf-Dateien wieder zum absendenden Verband zurück (Mail, welche Mailadresse)?