Pular para as operações

Compliance

ZapSign em um fluxo de decisão.

5 ZapSign operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Compliance
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Somente host de produção

Quem são

Serviço brasileiro de assinatura eletrônica voltado a pequenas empresas.

A ZapSign coleta assinaturas eletrônicas com validade jurídica em documentos feitos a partir de um upload ou de um modelo guardado, e registra como cada signatário foi autenticado. Compete com as incumbentes no preço e em quão pouca configuração a primeira integração exige. A API é pequena o bastante para se aprender numa tarde, e boa parte do apelo está aí.

O que um fluxo pode chamar

5 operações, cada uma um passo que você coloca no editor.

  1. POST/api/v1/docs/

    Criar um documento para assinar

    Sobe um PDF por URL e o abre para assinatura.

  2. POST/api/v1/models/create-doc/

    Criar um documento a partir de um modelo

    Preenche um modelo já guardado na ZapSign e o abre para assinatura.

  3. GET/api/v1/docs/$data.zapsign_doc_token/

    Conferir se já foi assinado

    O estado atual de um documento e de cada signatário.

  4. POST/api/v1/docs/$data.zapsign_doc_token/add-signer/

    Adicionar um signatário a um documento

    Adiciona uma parte depois que o documento já existe — um avalista que a decisão só pediu depois que o score voltou, por exemplo.

  5. GET/api/v1/signers/$data.zapsign_signer_token/

    Read one signer's status

    One signer's state, including the authentication they passed and when.

Onde isso entra na decisão

Compliance calls have a natural place in a flow.

A triagem responde às partes da decisão sobre as quais um regulador vai perguntar, então o que importa não é só o veredito, mas o registro dele. A correspondência parcial é o caso interessante: raramente uma recusa por si só, e normalmente o ponto em que o fluxo abre um caso para um revisor com a evidência anexada.

Whatever ZapSign returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add ZapSign as a connection authenticating with an API key.
  • 02A ZapSign tem um host só para os dois ambientes, então proteja as execuções de teste com credenciais e limites seus.
  • 03Coloque um nó de Conexão e escolha uma operação — “Criar um documento para assinar” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a ZapSign em um fluxo.

Como conecto a ZapSign a um fluxo de decisão?

Adicione a ZapSign como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a ZapSign em uma decisão sem nunca ver o segredo.

Dá para testar a ZapSign sem tocar em produção?

A ZapSign expõe um host só para os dois ambientes, então não existe um sandbox separado para apontar. As execuções de teste continuam rodando no Sandbox e ficam registradas à parte no histórico de decisões, mas a chamada vai para o mesmo lugar que a de produção — então proteja isso com credenciais de teste, limites de taxa ou dados seus.

O que um fluxo pode chamar na ZapSign?

5 operações, incluindo “Criar um documento para assinar”, “Criar um documento a partir de um modelo”, “Conferir se já foi assinado”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Criar um documento para assinar”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a ZapSign deve ser chamada?

A triagem responde às partes da decisão sobre as quais um regulador vai perguntar, então o que importa não é só o veredito, mas o registro dele. A correspondência parcial é o caso interessante: raramente uma recusa por si só, e normalmente o ponto em que o fluxo abre um caso para um revisor com a evidência anexada.

Quando você quiser

Wire ZapSign into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação