Skip to navigation
iOSHow-to guides

How to cache an existing unsigned envelope to use offline

View as Markdown

This topic demonstrates how to cache (download) an unsigned envelope to use offline. An envelope can only be downloaded on your mobile device if it has a status of sent or delivered, and the account used for authentication has been either:

Note: Any previously cached version of an envelope with the same envelope ID will be removed, and any progress for completed signers will be lost.

Required data

Running the code in this how-to requires this data:

Data elementDescription
{ENVELOPE_ID}A GUID value that identifies a Docusign envelope. This value is automatically generated by Docusign when the envelope is created.

Step 1. Log in to Docusign

To make the API call shown in this how-to, you must be logged in to Docusign.

See How to log in to Docusign from your app for details.

Step 2. Cache an envelope

Use the method shown to cache an envelope. Make sure to substitute {ENVELOPE_ID} with the envelope ID of an unsigned envelope that has tabs associated with your account.

[[[DSMEnvelopesManager alloc] init] downloadEnvelopeWithId:@"{ENVELOPE_ID}"
    downloadConfiguration:nil
    completion:^(NSString *envelopeId, NSError *error) {
    if(error) {
        NSLog(@"%@", error.localizedDescription);
    } else {
        NSLog(@"Successfully cached envelope ID: %@", envelopeId);
    }
}];

Expected response

You should receive a DSMEnvelopeCachedNotification.

Next steps