Atualizar modelo

Ao usar este endpoint com o token do modelo, você pode atualizar os dados como nome e idioma do modelo. Também é possível alternar seu estado entre ativado e desativado. Redefinir os e-mails dos contatos que serão notificados sobre o modelo. E por fim, editar campos de configuração do primeiro signatário definido no modelo.

Atualizar modelo

PUThttps://api.zapsign.com.br/api/v1/templates/{{template_token}}/

Headers

Name
Type
Description

Authorization*

string

Api token a frente do texto "Bearer".

Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23

Request Body

Name
Type
Description

name

string

Título do documento. String de até 255 caracteres

lang

string

Idioma do documento. Valores possíveis: "pt-br" (português), "es" (espanhol), "en" (inglês). Default: "pt-br"

active

boolean

Este campo é utilizado para controlar o status de visibilidade e utilização do documento na aplicação.

observers

array<string>

Representa os observadores do documento (limite de 20), ou seja, endereços de e-mails que serão notificados após a conclusão do fluxo de assinatura. É um array de strings.

first_signer

Object

Configuração do signatário do documento.

folder_token

string

Opcional, se preenchido, este campo terá prioridade sobre folder_path. Ele define o diretório com base no token da pasta, que pode ser obtido acessando o seguinte endereço:

https://zapsign.com.br/conta/modelos?pasta=<token_da_pasta>

Se você ainda não souber o token, navegue até a pasta desejada a partir de:

https://zapsign.com.br/conta/modelos

e copie o valor do parâmetro pasta na URL após acessar a pasta.

folder_path

string

Opcional, caminho da pasta dentro da ZapSign em que o modelo será colocado. Se as pastas não existirem, serão criadas automaticamente. Requisitos: folder_path pode ter até 255 caracteres Cada pasta pode ter até 50 caracteres Há um limite de 5 níveis de pasta Exemplo: /api/ ou /pasta1/pasta2/pasta3/ Valor padrão: / (sem pasta)

Configurando o Signatário

Esses campos permitem ajustar a experiência de assinatura, como o método de autenticação.

Request

{
    "name": "Nome do modelo",
    "lang": "pt-br",
    "active": "true",
    "observers": [
        "[email protected]"
    ],
    "first_signer": {
        "blank_email": false,
        "blank_phone": false,
        "auth_mode": "assinaturaTela",
        "require_selfie_photo": false,
        "require_document_photo": false,
        "selfie_validation_type": "",
        "qualification": "Aprovador"
    }
}

Response

{
	"token": "152f8416-xxxx-xxxx-xxxx-1aaf785dd335",
	"template_type": "docx",
	"name": "Nome do modelo",
	"active": true,
	"template_file": "https://zapsign.s3.amazonaws.com/2022/1/docs/xxxxx-d66b-495f-9b51-xxxx.docx",
	"created_at": "2022-01-05T12:59:42.563218Z",
	"last_update_at": "2022-01-05T13:03:22.242003Z",
	"redirect_link": "",
	"folder_path": "",
	"lang": "pt-br"
	"signers": [
		{
			"name": "{{NOME COMPLETO}}",
			"auth_mode": "assinaturaTela",
			"email": "",
			"phone_country": "",
			"phone_number": "",
			"lock_name": true,
			"lock_phone": false,
			"lock_email": false,
			"hide_phone": false,
			"blank_phone": false,
			"hide_email": false,
			"blank_email": false,
			"require_selfie_photo": false,
			"require_document_photo": false,
			"selfie_validation_type": "none",
			"qualification": "Aprovador"
		}
	],
	"inputs": [
		{
			"variable": "{{NOME COMPLETO}}",
			"input_type": "input",
			"label": "NOME COMPLETO",
			"help_text": "",
			"options": "",
			"required": false,
			"order": 1
		},
		{
			"variable": "{{CNPJ}}",
			"input_type": "input",
			"label": "CNPJ",
			"help_text": "",
			"options": "",
			"required": false,
			"order": 2
		},
		{
			"variable": "{{CPF}}",
			"input_type": "input",
			"label": "CRO",
			"help_text": "",
			"options": "",
			"required": false,
			"order": 3
		}
	],
    "extra_templates": [],
    "notify_extra_emails": "[email protected]",
    "custom_intro": "",
    "youtube_video_code": ""
}

Last updated

Was this helpful?