Fehler beim Löschen der Registerkarten im Umschlag

Question

Ich habe ein Problem, wenn sie delete a tab mit dem REST-API versucht, das unter der folgenden URL fehlschlägt:

https://demo.docusign.net/restapi/2/accounts/ {accountID}/Umschläge/{envelopeID}/Empfänger/1/Tabs

mit Körper DELETE {"checkboxTabs":[{"tabId":"168229c3-d717-436f-b6a9-5f014d1817bb"}]} bekommt:

{ 
    "checkboxTabs": [ 
    { 
     "selected": "false", 
     "requireInitialOnSharedChange": "false", 
     "recipientId": "1", 
     "tabId": "168229c3-d717-436f-b6a9-5f014d1817bb", 
     "errorDetails": { 
     "errorCode": "INVALID_TAB_OPERATION", 
     "message": "The Tab specified is not valid for the requested operation." 
     } 
    } 
    ] 
} 

Es ist unklar, was das Problem ist und ich kann ein gutes Beispiel für die korrekte Verwendung nicht finden. Ist es möglich, dass der Tab nicht gelöscht wurde?

UPDATE

Ich habe auch versucht, einen UPDATE anstelle einer DELETE und ich bekam folgende Antwort Körper (Interessanterweise ist die Antwort zeigt textTabs statt checkboxTabs):

{ 
    "textTabs": [ 
    { 
     "requireAll": "false", 
     "concealValueOnDocument": "false", 
     "disableAutoSize": "false", 
     "documentId": "1", 
     "recipientId": "1", 
     "tabId": "00000000-0000-0000-0000-000000000000", 
     "errorDetails": { 
     "errorCode": "INVALID_TAB_OPERATION", 
     "message": "The Tab specified is not valid for the requested operation. The Tab specified is not valid for the requested operation. Recipient not in state that allows correction." 
     } 
    } 
    ] 
} 

jedoch diesmal die Fehler Die Nachricht enthielt auch "Empfänger nicht im Status, der eine Korrektur zulässt", was bedeutet, dass ich eine ungültige Operation versuche, da der Empfänger bereits unterschrieben hat? Wenn jemand das klären kann, würde das meinem Verständnis helfen.

Es wäre sehr nützlich, wenn die DELETE-Methode auch eine ähnliche Nachricht enthalten würde.

Answer 1

Dieser Fehler sollte erscheinen, wenn die tabID nicht existiert. Ich würde empfehlen, überprüfen Sie die RegisterkarteID durch Ausführen eines GET für die gleiche URL.

Answer 2

Ich glaube, dass Sie diesen Fehler erhalten werden, wenn eine der von Ihnen angegebenen Registerkarteneigenschaften nicht korrekt ist. Zum Beispiel könnten Sie sich auf die korrekte tabId beziehen, aber wenn die fragliche Registerkarte in Dokument 2 ist (zum Beispiel) und Sie in Ihrer Anfrage auf documentId = 1 verweisen, erhalten Sie diesen Fehler.

Ich empfehle Ihnen, bevor Sie die DELETE Anfrage zunächst eine GET auf der Registerkarte und überprüfen Sie dann alle zurückgegebenen Eigenschaften und überprüfen Sie, ob sie alle übereinstimmen, was Sie senden in Ihrer Anfrage löschen.

---

UPDATE

ich nur realisiert, was Sie wahrscheinlich in ausführen. Die EnvelopeTabs: delete API-Anfrage, die Sie versuchen, sagt dies für die Beschreibung

"Löscht eine oder mehrere Registerkarten mit einem Empfänger in einem Entwurf Umschlag zugeordnet."

Ich glaube, das ist nur für DRAFT-Umschläge. Sobald Sie den Umschlag gesendet haben, müssen Sie eine Umschlagskorrektur durchführen, wenn Sie Aspekte dazu ändern möchten. Ihre Fehlermeldung wird auch der auf dieses

„Empfänger nicht in dem Zustand, die Korrektur erlaubt“