ZapSign API
Español
Español
  • Información General
  • Antes de empezar
  • Entornos de ZapSign
  • Solicitudes listas para usar
  • Autenticación
    • Token estático
    • Autenticación JWT
      • Obtener el access token
      • Actualizar access token
  • Tipos de Tokens
  • Versiones de la API
  • Políticas de Rate Limit
  • Alertas de Incidentes
  • Cómo Funciona el Pago
  • Códigos de estado
  • Cuenta
    • Información del Plan
    • Listar usuarios de la cuenta
    • Crear usuarios en la cuenta
    • Eliminar usuario de la cuenta
  • Documentos
    • Crear documento via Upload
    • OneClick - Clickwrap
      • Crear documento (OneClick)
    • Crear documento via Plantilla
    • Adicionar documento (sobre)
    • Adicionar documento extra via Plantilla
    • Detalle del documento
    • Listar documentos
    • Eliminar documento
    • Histórico de eventos
    • Posicionar firma (opcional)
    • Rechazar documentos
  • Firmantes
    • Detalles del firmante
    • Actualizar firmante
    • Adicionar firmante
    • Eliminar firmante
    • Firma en lote via API
    • Rechazar documentos por el usuario
  • Plantillas
    • Crear plantilla DOCX
      • Configurar formulario de plantilla
    • Listar plantillas
    • Actualizar plantilla
    • Eliminar plantilla
  • Aliados / Re-sellers
    • Actualizar estado de pago
    • Crear cuenta
  • Antecedentes
    • Introducción
    • Entendiendo el resultado
  • Crear un consulta (check)
    • Consulta de persona
    • Consulta de empresa
  • Consultar check
  • Detalle del check
  • Webhooks
    • ¿Cómo funcionan los webhooks?
    • Probar webhooks en ZapSign
    • Crear Webhook
    • Registro de Webhooks
    • Eventos
      • De documento
        • Doc creado
        • Doc eliminado
        • Firmante creado
      • De firmantes
        • Solicitud de firma enviada
        • Doc visualizado
        • Confirmación lectura
        • Doc firmado
        • Doc rechazado
        • Email bounce
        • Validación Fallida
      • De antecedentes
        • Consulta completada
    • Reprocesando documentos y webhooks
    • Eliminar Webhook
  • Widget
    • iFrame: ¿cómo funciona?
Powered by GitBook
On this page
  • Adicionar documento a un sobre
  • Request
  • Response
  • Preguntas frecuentes

Was this helpful?

  1. Documentos

Adicionar documento (sobre)

Adicionar documento a un sobre

POST 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

Nombre
Tipo
Descripción

Authorization*

string

API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23

Request Body

Name
Type
Description

name

string

Título del documento máximo 255 caracteres.

url_pdf

string

Define el archivo PDF a firmar. Debe ser una URL pública y el tamaño del documento máximo 10Mb.

base64_pdf

string

Alternativa a url_pdf: Documento convertido a cadena de base64.

Ex:

{

... "base64_pdf":"JVBERi0xLjcNCiWhs8XXDQoxIDA...",

}

{
    "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
},

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

Request

Response

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

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

¿Puedo posicionar firmas en un documento extra?

He agregado un archivo adjunto por error. ¿Puedo eliminarlo?

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.

PreviousCrear documento via PlantillaNextAdicionar documento extra via Plantilla

Last updated 5 months ago

Was this helpful?

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 cada vez que tu usuario necesite una URL válida que caduque en más de 60 minutos.

¡Sí! Puedes posicionar firmas e iniciales en un documento extra. Simplemente envía el token del documento en el endpoint de , y ¡listo!

Detalle del documento
Posicionar firmas
LogoAdd extra doc | ZapSign WorkspacePostman
Example of the web application with 3 PDFs in one envelope.