API de automação para assinatura digital da plataforma CLICKSIGN

Overview

API PARA ASSINATURA DIGITAL COM PHP

API de automação para assinatura digital da plataforma CLICKSIGN usando PHP API básica, para mais funcionalidades deve acessar a documentação oficial para implementações adicionais API com endpoints direcionado ao SANDBOX, plataforma de testes da clicksign Para usar a API em produção deverá apontar a url do endpoint para: https://app.clicksign.com/ Para usar a API em produção deverá apontar a url do endpoint para: https://sandbox.clicksign.com/

Documentação oficial: https://developers.clicksign.com/docs

Passos para utilização da API

1º Passo: Acessar a plataforma da clicksign e criar uma conta.

2º Passo: Ir ate as configurações, acessar a aba "API" e gerar seu token para uso da API, no botão "Gerar Acess Token".

3º Passo: após o token gerado poderá testar o mesmo usando o postman, insonia ou outra plataforma da sua preferência com a URL: https://sandbox.clicksign.com/api/v1/accounts?access_token={{access_token}} substituindo {{access_token}} pelo seu access_token.

4º Passo: Para gerar um documento através de um modelo, você deverá realizar o upload de um modelo de sua preferência na plataforma da clicksign, o qual deve conter as variáveis de sua necessidade, a declaração de variavel e feita da seguinte forma, exemplo: Eu {{ NOME }} solicito a assinatura de {{ NOME_CLIENTE }}, essas variaveis irão receber os valores através de um JSON eviado pelo seu sistema.

Criando Signtário

Endpoint: https://sandbox.clicksign.com/api/v1/signers?access_token={{access_token}}

Dados: Exemplo de dados que deverão ser enviados para requisação fazer a criação do signatário. para mais informações acessar a documentação https://developers.clicksign.com/docs/criar-signatario

{ 
    "signer": { 
	    "email":  "[email protected]", 
	    "phone_number":  "11999999999", 
	    "auths":  [ "email"  ], 
	    "name":  "Marcos Zumba", 
	    "documentation":  "123.321.123-40", 
	    "birthday":  "1983-03-31", 
	    "has_documentation":  true, 
	    "selfie_enabled":  false, 
	    "handwritten_enabled":  false, 
	    "official_document_enabled":  false, 
	    "liveness_enabled":  false, 
	    "facial_biometrics_enabled":  false  
    }
 }

Criando Documento via modelo

Endpoint: https://sandbox.clicksign.com/api/v1/templates/:key/documents?access_token={{access_token}}

Dados: Exemplo de dados que deverão ser enviados para requisação fazer a criação do documento. para mais informações acessar a documentação https://developers.clicksign.com/docs/criar-documento-via-modelos

Os campos dentro de data deverão ser os mesmos campos que foi adicionado as variaveis dentro do documento upado nos modelos da clicksign.

{ 
    "document":  { 
	    "path":  "/Modelos/Teste-123.docx", 
	    "template":  { 
		    "data":  { 
			    "Company Name":  
			    "Clicksign Gestão de Documentos S.A.", 
			    "Address":  "R. Teodoro Sampaio 2767, 10° andar", 
			    "Phone":  "(11) 3145-2570", 
			    "Website":  "https://www.clicksign.com"  
		    } 
	    } 
    } 
}

Adicionando o signatário ao documento

Endpoint: https://sandbox.clicksign.com/api/v1/lists?access_token={{access_token}}

Dados: Dentro de list deverá ser adicionado o document_key que se encontra localizado dentro da plataforma da clicksign, aonde foi colocado o modelo do documento, basta pegar a CHAVE que se encontra no modelo criado.

A signer_key será gerada após a criação do signatário, o qual conterá a mesma.

Para mais exemplos: https://developers.clicksign.com/docs/adicionar-signatario-a-documento

{ 
    "list":  { 
	    "document_key":  "27b02527-a576-46ee-b01c-bb4e694036c4", 
	    "signer_key":  "79301388-9567-4320-90ce-9e6f60e70d28", 
	    "sign_as":  "sign", 
	    "refusable":  true, 
	    "group":  1, 
	    "message":  "Prezado João,\nPor favor assine o documento.\n\nQualquer dúvida estou à 					  disposição.\n\nAtenciosamente,\nGuilherme Alvez"  
    } 
}

Enviando a documentação ao cliente

Endpoint: https://sandbox.clicksign.com/api/v1/notifications?access_token={{access_token}}

Dados: Este passo juntará informações de todos os passos anteriores, e enviará ao cliente um email com link para assinatura do documento.

Para mais exemplos: https://developers.clicksign.com/docs/solicitar-assinatura-por-email

request_signature_key: será gerada após o signatário ser adicionado ao documento mensagem: será definida de acordo o solicitado url: será gerada após o signatário ser adicionado ao documento

{ 
    "request_signature_key":  "0d5a9615-2bb8-3a23-6584-33ff436bb990", 
    "message":  "Prezado João,\nPor favor assine o documento.\n\nQualquer dúvida estou à disposição.\n\nAtenciosamente,\nGuilherme Alvez", 
    "url":  "https://www.example.com/abc" 
}
You might also like...
API REST para CRUD de usuários

Crud de Usuários QUAL A FUNÇÃO DA API? Esta API tem como objetivo cadastrar usuários e seus respectivos endereços por meio de requests e também fazer

CRUD API em Laravel para registrar produtos.
CRUD API em Laravel para registrar produtos.

CRUD API feito em laravel manipulando dados/registros de produtos. Criar um banco de dados chamado laravel_api utf8mb4_unicode_ci. Baixe o composer. P

Herramienta para limpiar Comprobantes Fiscales Digitales v3.3

phpcfdi/cfdi-cleaner Herramienta para limpiar Comprobantes Fiscales Digitales por Internet mexicanos. 🇺🇸 The documentation of this project is in spa

Projeto utilizado para prática de TDD usando PHP com a equipe de desenvolvimento.

🚀 TDD com PHP 📄 Detalhamento do projeto Projeto desenvolvido durante um DOJO que organizei com os colegas de equipe da GAM Distribuidora. A proposta

Imagem de Laravel com Docker para projetos futuros
Imagem de Laravel com Docker para projetos futuros

LaraDocker Este projeto foi criado com a intensão de facilitar o desenvolvimento de novos projetos que podem a ser desenvolvidos por mim, ou por outra

Capitalize uma frase para o padrão brasileiro de capitalização.

php-capitalize-pt-br Esta biblioteca basicamente está resumida em uma única função. Ela capitaliza uma frase para o padrão brasileiro de capitalização

Um container colaborativo de inteligência artificial para análise de ativos da b3

B3 Analyser Um container colaborativo de inteligência artificial para análise de ativos da b3 Como colaborar? Faça um FORK do projeto, isto é, copiar

Plugins para Adianti Framework
Plugins para Adianti Framework

Adianti-Plugins Plugins para Adianti Framework Componentes disponíveis Componente Fonte de abstração VanillaDBTree https://github.com/finom/vanillatre

Projeto de TCC. Sistema para melhoria de gestão e administração de bibliotecas.

TCC PROJETO ATHENA. (BIBLIOTECA ATHENA). Projeto criado por mim e integrantes do meu grupo de TCC na ETEC Juscelino Kubitschek de Oliveira. INTEGRANTE

Owner
Curso Sistemas de Informação Apaixonado por desenvolvimento web
null
Plataforma GPS Tracker para dispositivos Sinotrack ST-90x creada con Laravel 9 + PHP 8.1 y MySQL 8.

GPS Tracker (Laravel 9 + PHP 8.1 + MySQL 8) Plataforma de gestión de dispositivos Sinotrack ST-90x creada con Laravel 9 + PHP 8.1 y MySQL 8. Instalaci

Lito 17 Dec 28, 2022
Video_Sharing_Platform - Fala Devs! Estou trazendo aqui uma plataforma de compartilhamento de vídeo (como um YouTube)

Video Sharing Platform Sobre o Projeto Fala Devs! Estou trazendo aqui uma plataforma de compartilhamento de vídeo (como um YouTube). A aplicação possu

Raissadev 3 Jan 19, 2022
A PHP library to read and validate EU Digital COVID Certificates

CovPassCheck PHP A PHP library to read and validate EU Digital COVID Certificates. Install composer require stwon/covpasscheck-php Usage Currently, th

Studentenwerk OstNiedersachsen 6 Feb 7, 2022
Xero - a digital currency that allows instant payments to anyone, anywhere

Xeros is a digital currency that allows instant payments to anyone, anywhere. Xeros has been written completely in PHP and mostly follows the technical design of Bitcoin. Xeros uses P2P technology to operate with no central server.

Kladskull 79 Dec 26, 2022
Open Source Data & Experience Management Platform (PIM, MDM, CDP, DAM, DXP/CMS & Digital Commerce)

Pimcore - Open Source Data & Experience Management Platform: PIM, MDM, CDP, DAM, DXP/CMS & Digital Commerce

Pimcore 2.7k Jan 4, 2023
Este es un sitema bibliotecario para registro de adquisiciones y prestamos para INATEC Siuna

About Laravel Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experie

James Reyes 3 Mar 26, 2022
Plugin de Wordpress para criar um Hacker News-like para o ManualdoUsuario.net

?? Órbita Plugin de Wordpress para criar um painel de debates baseado em links, similar ao Hacker News, para o Manual do Usuário. Rodar o projeto Requ

Gabriel Nunes 7 Nov 14, 2022
Uma solucão simples para integrar sua aplicação Laravel a API PIX do Banco Central do Brasil

Uma solução simples para integrar a sua aplicação Laravel com a API PIX do Banco Central do Brasil Instalação Publicando os assets Publicando o arquiv

Mateus Junges 74 Dec 19, 2022
Biblioteca para busca (on-line) de estados e os seus respectivos municípios via API disponibilizada pelo IBGE.

LocalidadeX Biblioteca para busca (on-line) e listagem de estados e seus respectivos municípios, efetua a consulta via API do IBGE, disponibilizando o

Estênio Mariano 3 Feb 12, 2022
Projeto pessoal, cuja finalidade principal é apresentar uma sugestão de APi para procedimentos de transferências financeiras simplificada entre usuários. Projeto em Laravel.

Desafio Autor: Fábio Sousa de Sant'Ana Projeto pessoal, cuja finalidade principal é apresentar uma sugestão de APi para procedimentos de transferência

Fábio Santana 1 Dec 5, 2021