# 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](/espanol/documentos/detalhar-documento.md) 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="/files/A3S6udhlxb8hQZ0lH3YS" 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="/files/KK8H3HIoUGwfNfx2Fulv" 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](/espanol/documentos/opcional-posicionar-assinaturas.md), 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zapsign.com.br/espanol/documentos/adicionar-anexo-documento-extra.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.