> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/cess/api/juntar-assinatura.md).

# Juntar assinatura

Após a preparação de um documento em [Preparação de documento(s)](/workspace/cess/api/preparacao-de-documento-s.md) e obter externamente a assinatura raw do hash fornecido, é necessário juntar esse hash ao documento preparado. Essa é a finalidade desse serviço.

O processo é feito de forma assíncrona. Ao iniciar-se o processo é gerado outro TCN (Token de controle da transação), o TCN deve ser utilizado para identificar a transação no momento da recuperação do documento assinado.

<mark style="color:green;">`POST`</mark> `http://cess.local/join-signature/<tcn>`

#### Headers

| Name                                            | Type   | Description                                                   |
| ----------------------------------------------- | ------ | ------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | Basic, Bearer ou VCSchema (Veja "Autenticação e Autorização") |
| Content-Type                                    | string | application/json                                              |
| Accept                                          | string | application/json                                              |

#### Request Body

| Name                                           | Type           | Description                                                                                                                                                      |
| ---------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| documents<mark style="color:red;">\*</mark>    | array          | <p>- i<strong>d</strong> ( Identificador do documento na transação )<br>- <strong>raw\_signature</strong> ( Conteúdo da assinatura raw obtido externamente )</p> |
| certificates<mark style="color:red;">\*</mark> | array\[string] | URL encode do PEM da cadeia de certificados. Ex.: \["-----BEGIN%20CERTIFICATE-----%0AMIIHDTCCB...toLNr8DF%0A-----END%20CERTIFICATE-----"]                        |

{% tabs %}
{% tab title="200 " %}

```json
{
    "tcn": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "certificate_alias": "VVVVV..VVVVVV",
    "type": "PDFSignature",
    "hash_algorithm": "SHA256",
    "checksum_algorithm": "SHA1",
    "status": 200,
    "visible_signature": true,
    "tsa": false,
    "eot": true,
    "documents_source": "DATA_URL",
    "documents": [
        {
            "id": "0",
            "original_file_name": "meu-arquivo.pdf",
            "mediatype": "data:application/pdf",
            "status": "SIGNED",
            "result": "http://cess.local/file-transfer/aaa...aa/0",
            "checksum": "cccccc...cccc"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Download do documento assinado

Para fazer o download do documento preparado, basta acessar a url retornada em **result**.

<mark style="color:blue;">`GET`</mark> `http://cess.local/file-transfer/<tcn>/<document id>`

#### Path Parameters

| Name                                           | Type   | Description |
| ---------------------------------------------- | ------ | ----------- |
| tcn<mark style="color:red;">\*</mark>          | string |             |
| document\_id<mark style="color:red;">\*</mark> | String |             |

{% tabs %}
{% tab title="200 " %}

```
bytes do documento assinado
```

{% endtab %}
{% endtabs %}