Assinaturas alternativas

Para o uso de formas alternativas de assinatura é necessario que o dossie de arquivos de comprovação sejá compactado em um arquivo .zip e enviado através do endpoint /upload QI TECH, assim o document_key retornado pode ser ultilizado neste endpoint como forma de assinatura de contrato.

Exemplos de assinaturas alternativas:

• Ligação gravada;

• Analise de crédito;

Request

ENDPOINT

/debt/DEBT-KEY/signed

MÉTODO

POST

Request Body

{
    "type": "data-signature",
    "signatures": [
        {
            "signed_object": {
                "raw_text": "Lorem ipsum dolor sit amet, consectetur a....",
                "document_key": "79003de0-2590-455d-9b73-426b8ca284eb",
                "document_md5": "7521bd5621d97af26b2c1721fc4023a8"
            },
            "authenticity": {
                "timestamp": "1970-01-01 00:00:01",
                "document_key": "79003de0-2590-455d-9b73-426b8ca284eb",
                "document_md5": "79003de0-2590-455d-9b73-426b8ca284eb"
            },
            "signer": {
                "name": "IVANILDO DE SENA LIMA",
                "email": "ivanlima2604@gmail.com",
                "phone": {
                    "country_code": "055",
                    "area_code": "11",
                    "number": "999999999"
                },
                "document_number": "61766976204"
            },
            "authentication_type": "zip"
        }
    ]
}

Path Params

Campo	Tipo	Descrição	Caracteres
debt_key *	string	Chave da divida devolvida no momento da criação da operação de crédito.	-

Body Params

Campo	Tipo	Descrição	Caracteres
type *	string	Tipo de assinatura que será enviada.	-
signatures *	array of objects	Lista contendo objetos de comprovação de assinatura - deve ser enviado no caso de assinatura "type": "data-signature".	Objetos signatures
path-pdf-signed *	string	URL com o PDF assinado - deve ser enviado no caso de assinatura "type": "pdf-signature".	-

Objeto signatures

Campo	Tipo	Descrição	Caracteres
signed_object	object	Objeto contendo o documento que esta sendo assinado.	Objetos signed_object
authenticity	object	objeto com dados de autenticação.	Objetos authenticity
signer	object	Objeto com os dados do signatário.	Objeto signer
authentication_type *	string	Tipo de assinatura.	-

Objeto signed_object

Campo	Tipo	Descrição	Caracteres
raw_text	string	Texto corrido com os dados do contrato que será assinado (Obrigatório para autenticação tipo opt-in).	-
document_key	string	DOCUMENT_KEY do arquivo assinado enviado a partir da API 1.1 (obrigatório apenas caso o campo "raw_text" não seja enviado).	-
document_md5	string	DOCUMENT_MD% do arquivo assinado enviado a partir da API 1.1 (obrigatório apenas caso o campo "raw_text" não seja enviado).	-

Objeto authenticity

Campo	Tipo	Descrição	Caracteres
timestamp *	string	Data da assinatura.	-
document_key *	string	DOCUMET_KEY retornado pela API 1.1 após o envio do arquivo com as evidencias de assinatura.	-
document_md5 *	string	DOCUMET_MD5 retornado pela API 1.1 após o envio do arquivo com as evidencias de assinatura.	-

Objeto signer

Campo	Tipo	Descrição	Caracteres
name *	string	Nome do signatário.	-
email *	string	E-mail do signatário.	-
phone	string	Objeto de telefone do signatário.	Objeto phone
document_number *	string	Numero de documento do signatário.	-

Objeto phone

Campo	Tipo	Descrição	Caracteres
country_code *	string	Código DDI do telefone (https://ddi.guiamais.com.br/)	3
area_code *	string	Código DDD do telefone (https://ddd.guiamais.com.br/)	2
number *	string	Número de telefone (apenas números)	10

Response

STATUS

200

Response Body

{
  "data": {},
  "event_datetime": "2022-11-07 15:24:47",
  "key": "\<DEBT-KEY\>",
  "status": "signature_received",
  "webhook_type": "debt"
}

STATUS

400

Response Body

{
  "data": "{\"title\": \"Bad Request\", \"description\": \"Invalid request body.\", \"translation\": \"Corpo da requisição inválido.\", \"extra_fields\": {}, \"code\": \"LEG000069\"}"
}