Perguntas[docusignapi](coding)

Tenho um modelo que estou passando com sucesso TextTabs e CheckboxTabs; no entanto, meus NumberTabs não estão sendo exibidos. Estou lendo sobre Tabulações Numéricas vs. Tabulações Numéricas. Verifiquei novamente e parece que o modelo está configurado com Number. Consigo ver o valor antes de enviar para o DocuSign. Mas quando o envelope é aberto, ele não está lá.

Devo usar Numérico? Alguma outra ideia do que está faltando?

Atualização: Testei Numérico e funcionou. Nova pergunta: Como posso saber se era Numérico no modelo?

   Number n = new Number
   {
        TabLabel = kvp.Key,// name of DS field, e.g. amount
        Value = kvp.Value //e.g. 25.53
   };

   List<Number>? numTabs = [];
   numTabs.Add(n);

   tabs ??= new Tabs();
   tabs.NumberTabs = numTabs ;

   //continue to populate envelope/signer information in envelope definition

Esta é a definição do meu campo de modelo DocuSign, por exemplo, valor:

Desenvolvendo um aplicativo interno da organização para enviar envelopes/ter assinatura incorporada usando os SDKs C# do DocuSign. Seguindo os exemplos do Quickstart, consigo fazer essas ações. Como ele usa os ambientes de demonstração/teste do DocuSign, quando esse aplicativo for implantado, o código precisará fazer chamadas para o ambiente de produção do DocuSign.

Como os funcionários da organização usarão este aplicativo, não os clientes, o código usa Concessões de Código de Autorização, não Tokens JWT.

1. Então, com a obtenção do token de acesso, o código deve chamar SetOAuthBasePath de sua instância de DocuSignClient? O SDK diz "Use este método para definir o caminho base OAuth personalizado". Mas como o DocuSign saberá o contrário?

2. Eu assumo que a chamada de endpoint UserInfo para o BaseUri do usuário já terá o ambiente correto (já que eles foram autenticados), e o BaseUri estaria então 'apontando' para o ambiente apropriado. Verdade?

Vejo que o C# SDK tem constantes que podemos referenciar. Devo usá-las para definir quando estou no meu ambiente de produção:

public class DocuSignClient
{
    public const string Production_REST_BasePath = "https://www.docusign.net/restapi";

    public const string Demo_REST_BasePath = "https://demo.docusign.net/restapi";
...
}

public class OAuth
{
...
    public static string Demo_OAuth_BasePath = "account-d.docusign.com";

    public static string Production_OAuth_BasePath = "account.docusign.com";
}

Exemplo de código em vez de DocuSignClient docuSignClient = new DocuSignClient():

protected DocuSignClient GetDocuSignClient(bool isForAuth, bool useProd, string? userBaseUri = null)
{
    DocuSignClient rtn = new DocuSignClient();

    //DocuSignClient defaults to demo environment
    if (isForAuth && useProd)
    {
        rtn.SetOAuthBasePath(OAuth.Production_OAuth_BasePath);
    }
    
    if (!isForAuth && !string.IsNullOrEmpty(userBaseUri))
    {
        //we should have a User BaseUri, which will be based on the environment authenticated 
        rtn.SetBasePath(userBaseUri);
    }
    return rtn;
}

Implementei o DocuSign no meu aplicativo Laravel e atualmente estou usando o JWT Grant Authentication para enviar documentos para clientes assinarem. A integração está funcionando bem, mas encontrei um problema: quando envio envelopes com documentos para clientes assinarem, inicialmente, tenho que fornecer consentimento manualmente por meio da página de consentimento do DocuSign.

Como meu aplicativo foi projetado para funcionar como um microsserviço de backend que envia documentos automaticamente por meio de gatilhos, esse processo de consentimento manual interrompe o fluxo. Gostaria de perguntar se há uma maneira de automatizar esse processo de consentimento, para que os documentos possam ser enviados sem a necessidade de intervenção manual.

Existe alguma configuração ou recurso de API que permita consentimento automático ou pré-autorização para o aplicativo, ou alguma prática recomendada sobre isso ao usar o DocuSign em tal serviço de backend?

Esta é minha classe de serviço cuidando da preparação e do envio dos envelopes.

 public function getToken(ApiClient $apiClient): string
    {
        try {
            $privateKey = file_get_contents(storage_path(env('DS_KEY_PATH')), true);
            $response = $apiClient->requestJWTUserToken(
                env('DS_CLIENT_ID'),
                env('DS_IMPERSONATED_USER_ID'),
                $privateKey,
                env('DS_JWT_SCOPE')
            );
            $token = $response[0];
            return $token->getAccessToken();
        } catch (\Throwable $th) {
            if (strpos($th->getMessage(), 'consent_required') !== false) {
                throw new \Exception('consent_required');
            }
            throw $th;
        }
    }

    /**
     * Build and return the consent URL
     *
     * @return string
     */
    public function getConsentUrl(): string
    {
        return "https://account-d.docusign.com/oauth/auth?response_type=code&scope=signature%20impersonation&client_id="
            . env('DS_CLIENT_ID')
            . "&redirect_uri=" . urlencode(env('DS_REDIRECT_URI'));
    }

    /**
     * Build the envelope definition from the request
     *
     * @param Request $request
     * @return EnvelopeDefinition
     */
    public function buildEnvelope(Request $request): EnvelopeDefinition
    {
        $fileContent = $request->file('formFile')->get();
        $fileName = $request->file('formFile')->getClientOriginalName();
        $fileExtension = $request->file('formFile')->getClientOriginalExtension();
        $recipientEmail = $request['email'];
        $recipientName = $request['name'];

        $document = new Document([
            'document_id' => "1",
            'document_base64' => base64_encode($fileContent),
            'file_extension' => $fileExtension,
            'name' => $fileName
        ]);

        $sign_here_tab = new SignHere([
            'anchor_string' => "FIRMA CLIENTE",
            'page_number' => "1",
            'anchor_units' => "pixels",
            'anchor_x_offset' => "40",
            'anchor_y_offset' => "40"
        ]);

        $tabs = new Tabs([
            'sign_here_tabs' => [$sign_here_tab]
        ]);

        $signer = new Signer([
            'email' => $recipientEmail,
            'name' => $recipientName,
            'recipient_id' => "1",
            'tabs' => $tabs
        ]);

        $recipients = new Recipients([
            'signers' => [$signer]
        ]);

        $inlineTemplate = new InlineTemplate([
            'recipients' => $recipients,
            'sequence' => "1"
        ]);

        $compositeTemplate = new CompositeTemplate([
            'composite_template_id' => "1",
            'document' => $document,
            'inline_templates' => [$inlineTemplate]
        ]);

        return new EnvelopeDefinition([
            'composite_templates' => [$compositeTemplate],
            'email_subject' => "Please sign",
            'status' => "sent"
        ]);
    }

    /**
     * Send the envelope using the DocuSign API
     *
     * @param ApiClient $apiClient
     * @param string $accountId
     * @param EnvelopeDefinition $envelopeDefinition
     * @return object
     */
    public function sendEnvelope(ApiClient $apiClient, string $accountId, EnvelopeDefinition $envelopeDefinition): object
    {
        $envelopeApi = new EnvelopesApi($apiClient);
        return $envelopeApi->createEnvelope($accountId, $envelopeDefinition);
    }

Estive olhando as páginas da API Docusign e queria saber se a tag 'pageNumber' de qualquer filho 'tabs' (por exemplo, signHereTabs, inicialHereTabs, textTabs etc.) era obrigatória?

Se eu tiver as seguintes informações para usar com a API Docusign, o valor 'anchorString' '[POS_Xn]' será pesquisado em todo o documento de várias páginas OU terei que especificar em qual página o valor existe (no meu caso, página 4 de 7) adicionando a tag 'pageNumber' na declaração 'signHereTabs'?

Para ficar claro, o valor '[POS_Xn]' (do 'anchorString') só está presente uma vez no documento para assinar.

{
    "emailSubject": "Please sign attached doc",
    "emailBlurb": "Info to be signed",
    "documents": [
        {
            "documentId": "1",
            "documentBase64": "Base64 string",
            "name": "Testfile1.pdf"
        }
    ],
    "recipients": {
        "signers": [
            {
                "email": "[email protected]",
                "name": "John Doe",
                "recipientId": "1",
                "routingOrder": "1",
                "tabs": {
                    "signHereTabs": [{
                        "anchorString": "[POS_Xn]",
                        "documentId": "1"
                    }]
                }
             }
        ]
    },
    "status": "sent"
}

Como alterar o endereço de e-mail registrado no DocuSign Eu pressiono Meu perfil->Endereço de e-mail->ATUALIZAR

Quando eu insiro o novo e-mail, ele precisa ser verificado. Depois de preencher o código de verificação, ainda não consigo alterá-lo.

Estou usando o DocuSign por meio da API em Java como desenvolvimento com ordem de assinatura. O primeiro destinatário recebe um e-mail e assina e tudo funciona bem. Agora o segundo destinatário deve receber um e-mail, mas infelizmente não. Mesmo quando o status do segundo destinatário mudou de criado para enviado (via API e no DocuSing-Profile).

Também vejo as alterações no perfil de gerenciamento, o status funciona bem e mudou de criado para enviado, mas o destinatário não recebe nenhum e-mail.

Parece que o docusign não envia nenhum e-mail após o primeiro destinatário ao usar o pedido de assinatura. Alguém já experimentou esse bug? qualquer ideia?

PS: Eu também tentei o seguinte:

• nenhum pedido de assinatura -> todos os destinatários recebem o e-mail (incluindo o e-mail do segundo destinatário).
• alterando a ordem: o segundo destinatário passa a ser o primeiro e vice-versa -> o primeiro recebe o e-mail normalmente, o segundo não -> significa que os e-mails recebem sem problemas.