options to complete a package that requires review from package owner

eslClient.getPackageService().markComplete(packageId);

String token = eslClient.getAuthenticationTokensService().createUserAuthenticationToken();

String target = "https://sandbox.esignlive.com/a/transaction/{packageId}";

System.out.println("https://sandbox.esignlive.com/auth?authenticationToken=" + token + "&target=" + target);

We also have an integrated workflow that deals with required attachments where a package is put in the Ready to Review status once documents are signed.  We are using the Callbacks as our primary source of event updates from OneSpan so when the TRANSACTION_READY_FOR_COMPLETION callback is received we will facilitate the package review in our system before completing it.  In addition to utilizing the callbacks, we have also implemented a polling service that can run to pick up any package updates in the event the callbacks fail because as you know there is no recovery option for failed/missed callbacks.  The question I have is how can we tell from the package data, that it is ready to review?   From what we can see when we check the package status is still in the Sent status.  We are using the .Net SDK (not REST apis) to integrate with OneSpan.  Is there any flag or other field we can go off of in order to indicate it is ready to review or do we need to inspect the package details to infer this.  For example on Sent packages do we also need to check for an Autocomplete flag equal to false and then check to see if all Documents are signed, or if all signers have signed?  Looking for some guidance.  Thanks!

Hi Tricia,

I don't think there's a direct flag indicating if a package is waiting for mark complete. And as you mentioned, you need to calculate the result based on:
(1)package is in SENT status

(2 optional)correct package sender - package listing API also returns packages that the API Key holder received as a signer

(3)package is not auto complete

(4)there's no incomplete signature left

A sample code below could give a brief idea:

        public readonly PackageId packageId = new PackageId("pMgYlmQTFSjIe94SkojFMxSZXrM=");
        public readonly string senderEmail = "your_sender_email";

            Boolean isSent = false;
            Boolean isOwner = false;
            Boolean autoComplete = false;
            Boolean hasIncompleteApproval = false;
            DocumentPackage pkg = eslClient.GetPackage(packageId);
            isSent = pkg.Status == DocumentPackageStatus.SENT;
            isOwner = pkg.SenderInfo.Email == senderEmail;
            autoComplete = pkg.Autocomplete;

            foreach (var document in pkg.Documents)
            {
                foreach (var signature in document.Signatures)
                {
                    if (signature.Accepted == null) {
                        hasIncompleteApproval = true;
                    }
                }
            }

            Boolean canMarkComplete = isSent && isOwner && !autoComplete && !hasIncompleteApproval;

Duo