# Adicionar documento extra via Plantilla

## Adicionar documento extra via plantilla

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

Este endpoint te permite agregar documentos extra a un sobre, creandolo a partir de una plantilla dinamica. Puedes añadir hasta 14 documentos adicionales (uno a la vez, es decir, una solicitud por cada archivo adjunto). Esto significa que, sumando el documento original, tu firmante podrá firmar hasta 15 documentos al mismo tiempo.

Al igual que con el documento principal, deberás enviar todos los datos de reemplazo en formato JSON, y recibirás la respuesta también en formato JSON.

{% hint style="info" %}
Antes de iniciar debes crear la Plantilla con el endpoint [Crear plantilla DOCX](https://docs.zapsign.com.br/espanol/plantillas/create-template-docx) o crearla en la plataforma web de ZapSign en la sección de Plantillas y seleccionar la opción DOCX (**no esta disponible para plantillas PDF**). [Ver tutorial](https://www.youtube.com/watch?v=4RbglTOK23E) para crear una plantilla dinámica
{% endhint %}

#### 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="154">Nombre</th><th width="152">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>template_id<mark style="color:red;">*</mark></td><td>string</td><td><p>El identificador/token de la plantilla dinámica.</p><p>Ejemplo: https://app.zapsign.co/conta/modelos/{TEMPLATE_ID}</p><p>Para acceder a tu lista de plantillas, <a href="https://app.zapsign.co/conta/modelos">haz clic aquí.</a></p></td></tr><tr><td>data[]['de']</td><td>string</td><td><p>La variable a reemplazar.</p><p>Ej: "{{Nombre completo}}"</p></td></tr><tr><td>data[]['para']</td><td>string</td><td>El valor con el que reemplazar la variable. Ej: "John Doe"</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: OK Extra document successfully added." %}

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

{% endtab %}

{% tab title="400: Bad Request Required fields are not present in the payload" %}

{% endtab %}

{% tab title="400: Bad Request Parent doc has already been signed, or is in itself an extra document" %}

{% endtab %}

{% tab title="402: Payment Required Current company doesn't have an API plan" %}

{% endtab %}

{% tab title="403: Forbidden Template has been deleted, is inactive or belongs to another company" %}

{% endtab %}

{% tab title="404: Not Found Specified document or template have not been found " %}

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Obs:** dont mistake the extra document with [the batch sign via API](https://docs.zapsign.com.br/espanol/firmantes/assinar-em-lote-via-api), because this one is made to sign multiple documents at the same time not to create attachments. They have different use cases.
{% endhint %}

### Request

{% embed url="<https://www.postman.com/zapsign/workspace/zapsign-workspace/request/27495556-750bab98-f46d-4a69-99d8-4d3f230ff77f>" %}

### 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 %}

```javascript
{
    "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.