> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtsign/documentos/criar-documento-e-signatarios.md).

# Criar documento e Signatários

Nesta página, você irá aprender como criar documentos e Signatários. O processo é bem simples.

**Passo a passo**

Cria um novo documento com status `WAITING_APPROVAL_TO_VALIDATE`, e os signatários (opcional).

{% hint style="info" %}
Esse processo não dispara e-mails de notificações para os signatários. Para ativar, é necessário alterar o status do documento para `VALID`. Esse processo pode ser realizado na chamada de **Alterar documento para Pronto para Assinar.**
{% endhint %}

A API permite dois canais de notificação para os signatários. São eles:

* EMAIL: Notificações serão enviadas para o endereço de e-mail do signatário
* WHATSAPP: Notificações serão enviadas para o número de WhatsApp do signatário

O canal escolhido determina qual campo de contato é obrigatório:

* Para EMAIL: campo email é obrigatório
* Para WHATSAPP: campo phone é obrigatório (formato E.164, exemplo: +5511912345678)

## POST /documents

> Cria um novo documento e signatários

```json
{"openapi":"3.0.0","info":{"title":"GTSign API","version":"1.0.0"},"servers":[{"url":"https://app.staging.gtsign.giro.tech/api","description":"Ambiente de Staging"},{"url":"https://api.gtsign.giro.tech","description":"Ambiente de Produção"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token fornecido pelo administrador"}}},"paths":{"/documents":{"post":{"summary":"Cria um novo documento e signatários","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"object","required":["name","originalDocument"],"properties":{"name":{"type":"string"},"originalDocument":{"type":"object","properties":{"file":{"type":"string","description":"Arquivo codificado em base64"}}},"externalIdentification":{"type":"string","description":"Identificação externa única"},"notificationType":{"type":"string","enum":["DONT_NOTIFY","NOTIFY"],"default":"NOTIFY"},"deadline":{"type":"string","format":"date","description":"Data limite para assinatura (obrigatório se setReadyToSign = true)"},"notificationPeriodDelivery":{"type":"integer","enum":[3,6,9,12],"description":"Intervalo, em dias, para lembretes de assinatura (obrigatório se setReadyToSign = true)"},"signatureMethods":{"type":"array","items":{"type":"string","enum":["TOKEN","SIGNATURE","SELFIE"],"description":"Métodos de assinatura (obrigatório se setReadyToSign = true)"}},"setReadyToSign":{"type":"boolean","default":false,"description":"Define se o documento deve ser disponibilizado para assinatura"},"minimumSignatureRequirements":{"type":"array","items":{"type":"object","properties":{"signatureType":{"type":"string","enum":["PART","WITNESS","CONTRACTOR","HIRED","ADMINISTRATOR","SIGN_TO_ACKNOWLEDGE_RECEIPT","SIGN_TO_APPROVE","SIGN_TO_RATIFY","GUARANTOR","TRANSFEROR","TRANSFEREE","JOINT_DEBTOR","ISSUER","ENDORSER","ENDORSEE","WARRANTOR","MANAGER","INTERVENING_PARTY","LESSOR","LESSEE","PURCHASER","SELLER","ATTORNEY","LEGAL_REPRESENTATIVE","JOINTLY_LIABLE","VALIDATOR"]},"minimumSignatureNumber":{"type":"integer","description":"Quantidade mínima de assinaturas"}}}}}},"signatures":{"type":"array","items":{"type":"object","required":["signatureType","notificationChannel","name","person"],"properties":{"email":{"type":"string","description":"E-mail do signatário (Obrigatório caso notificationChannel seja EMAIL)"},"phone":{"type":"string","description":"Número de telefone brasileiro no formato E.164. (Obrigatório caso notificationChannel seja WHATSAPP)"},"signatureType":{"type":"string","enum":["PART","WITNESS","CONTRACTOR","HIRED","ADMINISTRATOR","SIGN_TO_ACKNOWLEDGE_RECEIPT","SIGN_TO_APPROVE","SIGN_TO_RATIFY","GUARANTOR","TRANSFEROR","TRANSFEREE","JOINT_DEBTOR","ISSUER","ENDORSER","ENDORSEE","WARRANTOR","MANAGER","INTERVENING_PARTY","LESSOR","LESSEE","PURCHASER","SELLER","ATTORNEY","LEGAL_REPRESENTATIVE","JOINTLY_LIABLE","VALIDATOR"]},"notificationChannel":{"type":"string","enum":["EMAIL","WHATSAPP","WEBHOOK"]},"name":{"type":"string"},"person":{"type":"object","required":["cpf"],"properties":{"cpf":{"type":"string"}}}}}}}}}}},"responses":{"201":{"description":"Documento e signatários criados com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"object","properties":{"uuid":{"type":"string"}}},"signatures":{"type":"array","items":{"type":"object","properties":{"uuid":{"type":"string"},"email":{"type":"string"},"person":{"type":"object","properties":{"cpf":{"type":"string"}}}}}}}}}}},"400":{"description":"Erro na criação do documento ou signatários"}}}}}}
```

<figure><img src="https://978140111-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF6l1W0qI0y7eF7f0QRDC%2Fuploads%2Fgit-blob-f5d2064d02c970341ca52b2c083eb1f585bc436a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
