Criar documento via Modelo

post
Criar documento via Modelo

https://api.zapsign.com.br/api/v1/models/create-doc/?api_token={{seu_token_de_acesso}}
Esse endpoint permite que você crie um documento a partir de um Modelo dinâmico (isto é, um .docx com variáveis que você sobe na ZapSign, que terá suas variáveis automaticamente substituídas e convertido para .pdf). Você deverá enviar os dados em JSON, bem como receberá eles nesse mesmo formato.
Request
Response
Request
Body Parameters
sandbox
optional
boolean
Default: false. Defina como true caso se trate de um documento de teste (sem cobrança de créditos e sem validade jurídica).
template_id
required
string
ID do template (modelo dinâmico)
signer_name
required
string
Nome do signatário do documento. Se houver mais de um signatário no documento, você poderá adicioná-lo posteriormente via endpoint Adicionar signatário.
data[]['de']
required
string
Nome da variável a ser substituída. Ex: "{{NOME COMPLETO}}"
data[]['para']
required
string
Valor a ser preenchido no lugar da variável. Ex: "João dos Santos"
Response
200: OK

Campos opcionais da requisição

  • Documento - raiz do JSON:

    • lang (string): idioma do documento. Valores possíveis: "pt-bt" (português), "es" (espanhol), "en" (inglês). Default: "pt-br"

    • disable_signer_emails (boolean): para desativar os e-mails enviados aos signatários, envie esse parâmetro como true. Default: false

    • signed_file_only_finished (boolean): para desativar os botões "Baixar original" e "Baixar assinado" da experiência de signatário, ative este flag. Assim, você é quem se encarregará de entregar o signed_file ao signatário. Default: false

    • brand_logo (string): se deseja personalizar a logomarca da experiência de assinatura deste documento específico, envie a URL da imagem (precisa ser um link publicamente acessível). Default: ""

    • brand_primary_color (string): se deseja personalizar a cor primária (do botão) da experiência de assinatura deste documento específico, envie em rgb ou hexadecimal. Ex: "#0011ee". Default: ""

    • external_id (string): ID do documento na sua aplicação. Default: ""

Exemplo de requisição

Os parâmetros devem estar em formato JSON no corpo da requisição

{
"template_id":"ad896ea9-3c69-48d8-893a-3ee10fdb1e8d",
"signer_name":"João dos Santos",
"external_id":"123",
"data":[
{
"de":"{{NOME COMPLETO}}",
"para":"João dos Santos"
},
{
"de":"{{NÚMERO DO CPF}}",
"para":"123.456.789-10"
},
{
"de":"{{ENDEREÇO COMPLETO}}",
"para":"Rua Brigadeiro, n. 10, CEP 05622-001"
}
]
}

Como criar um Modelo dinâmico na ZapSign

Um modelo dinâmico na ZapSign é um .docx (Word) com variáveis, representadas por duplas chaves. Exemplo: {{NOME COMPLETO}}

Baixe aqui um .docx de exemplo: https://app.zapsign.com.br/assets/modelo/Exemplo-Modelo-Dinamico.docx

Exemplo de Modelo dinâmico

Para inserir um modelo dinâmico na ZapSign, entre na sua conta e vá na aba "Modelos".

Observação: é necessário adquirir um plano de API mensal para ter acesso (inclusive para teste) aos Modelos. Cada documento criado via Modelo gastará apenas 1 crédito da API, não há cobrança extra por estar usando os Modelos.

Entre na sua conta, clique em "Modelos", "Novo modelo" e "Modelo dinâmico".

O "template_id" do seu Modelo dinâmico pode ser encontrado aqui:

"template_id" do seu Modelo dinâmico

O que fazer com a resposta

Leia no endpoint "Criar documento via Upload".

Se você precisar de mais de um signatário, utilize o endpoint "Adicionar signatário".