# Adicionar documento (sobre)

## Adicionar documento a un sobre

<mark style="color:green;">`POST`</mark> `https://api.zapsign.com.br/api/v1/docs/{{original_doc_token}}/upload-extra-doc/`

Este endpoint te permite adicionar documentos a un sobre para que el firmante sólo deba firmar una vez X documentos. Es posible adicionar hasta 14 documentos en un sobre, y por cada documento se debe hacer una solicitud diferente a este endpoint.

#### Encabezado

<table><thead><tr><th width="175">Nombre</th><th width="103">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</td></tr></tbody></table>

#### Request Body

<table><thead><tr><th width="152">Name</th><th width="151">Type</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>string</td><td>Título del documento máximo 255 caracteres.</td></tr><tr><td>url_pdf</td><td>string</td><td>Define el archivo PDF a firmar. Debe ser una URL pública y el tamaño del documento máximo 10Mb.</td></tr><tr><td>base64_pdf</td><td>string</td><td><p>Alternativa a url_pdf: Documento convertido a cadena de base64.</p><p>Ex:</p><p>{</p><p>... 	"base64_pdf":"JVBERi0xLjcNCiWhs8XXDQoxIDA...",</p><p>}</p></td></tr><tr><td>signature_placement</td><td>string</td><td>Permite posicionar la firma en el documento usando un texto ancla (sin necesidad de coordenadas x, y). Configure signature_placement: "&#x3C;&#x3C;{identificador_de_firma}>>" y la firma será posicionada donde encuentre ese texto. Si el texto aparece más de una vez, la firma será posicionada en todas las ubicaciones. Nota: el uso de &#x3C;&#x3C; >> es altamente recomendado para evitar conflictos con el texto, pero no es obligatorio. Ej: "&#x3C;>". Default: ""</td></tr><tr><td>rubrica_placement</td><td>string</td><td>Permite posicionar la rúbrica en el documento usando un texto ancla (sin necesidad de coordenadas x, y). Configure rubrica_placement: "&#x3C;&#x3C;{identificador_de_rubrica}>>" y la rúbrica será posicionada donde encuentre ese texto. Si el texto aparece más de una vez, la rúbrica será posicionada en todas las ubicaciones. Nota: el uso de &#x3C;&#x3C; >> es altamente recomendado para evitar conflictos con el texto, pero no es obligatorio. Ej: "&#x3C;>". Default: ""</td></tr></tbody></table>

{% tabs %}
{% tab title="200 Extra document successfully added." %}

```json
{
    "open_id": 17,
    "token": "50c7d90e-ead6-46b5-99d6-33d2d3b9a31f", 
    "name": "Anexo al contrato de trabajo",
    "original_file": "https://zapsign.s3.amazonaws.com/aaa/48025712-b429-4216-8a33-d90c575d0b7f/0e2d0a87-a0f6-4a49-a05f-7a439fd7308e.pdf",
    "signed_file": null
},
```

{% endtab %}
{% endtabs %}

No es necesario enviar ningún otro parámetro, porque toma las configuraciones del documento y firmantes del documento principal.&#x20;

### Request

{% embed url="<https://www.postman.com/zapsign/workspace/zapsign-workspace/request/27495556-b41b0068-b7e4-47aa-a828-e65084fcdb4b?ctx=documentation>" %}

### Response

{% hint style="warning" %}
**Advertencia**: los enlaces original\_file y signed\_file son temporales y caducan en 60 minutos. Si tu sistema necesita guardar esos enlaces, se recomienda almacenarlos en tu propio CDN o llamar al endpoint de[ Detalle del documento](https://docs.zapsign.com.br/espanol/documentos/detalhar-documento) cada vez que tu usuario necesite una URL válida que caduque en más de 60 minutos.
{% endhint %}

```json
{
    "open_id": 17,
    // use this token in case you want to place signatures in this attachment
    "token": "50c7d90e-ead6-46b5-99d6-33d2d3b9a31f", 
    "name": "Anexo ao Contrato de Admissão João",
    "original_file": "https://zapsign.s3.amazonaws.com/aaa/48025712-b429-4216-8a33-d90c575d0b7f/0e2d0a87-a0f6-4a49-a05f-7a439fd7308e.pdf",
    "signed_file": null
},
```

### Preguntas frecuentes

#### ¿Qué es un documento extra en un sobre?

Si has creado documentos en la plataforma web, sabrás que es posible enviar varios documentos en un sobre al firmante. Esto permite que el firmante reciba un único link de firma por correo, WhatsApp o cualquier otro medio y firme todos los documentos al mismo tiempo.&#x20;

<figure><img src="https://1265384129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FrVBe47d9qwlLisqx07%2Fuploads%2FMFRTxkzbx19G38ym13Yf%2FCaptura%20de%20pantalla%202024-11-29%20a%20la(s)%208.42.42%E2%80%AFp.m..png?alt=media&#x26;token=7cf96472-f846-4337-a71e-594b75e4a7e5" alt=""><figcaption><p>Example of the web application with 3 PDFs in one envelope.</p></figcaption></figure>

En el proceso de firma el firmante verá todos los documentos a firmar y realizará una única firma.

<figure><img src="https://1265384129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FrVBe47d9qwlLisqx07%2Fuploads%2F8SIAR2pkBZ1UUnL2RLoh%2FCaptura%20de%20pantalla%202024-11-29%20a%20la(s)%208.45.19%E2%80%AFp.m..png?alt=media&#x26;token=39249d71-a281-4c2b-8897-f23a9dff3295" alt="" width="341"><figcaption></figcaption></figure>

**¿Puedo posicionar firmas en un documento extra?**

¡Sí! Puedes posicionar firmas e iniciales en un documento extra. Simplemente envía el token del documento  en el endpoint de [Posicionar firmas](https://docs.zapsign.com.br/espanol/documentos/opcional-posicionar-assinaturas), y ¡listo!

**He agregado un archivo adjunto por error. ¿Puedo eliminarlo?**&#x20;

Lamentablemente, actualmente no es posible eliminar documentos extra  una vez que han sido añadidos. Sin embargo, puedes eliminar todo el documento y volver a crearlo para solucionar este inconveniente.