Archivos PDF
Añade PDFs a un borrador, conserva los IDs de cada elemento y descarga la versión correcta.
Cada PDF de un sobre aparece en envelopeItems. Su id es el envelopeItemId usado por campos y descargas. Un sobre con varios PDFs tiene varios IDs de elemento; el ID del sobre no identifica un archivo.
Añade un PDF al borrador
Para añadir un anexo a un sobre existente, envía un formulario con payload y files. Puedes repetir la parte files para varios PDFs.
curl --fail-with-body \
'https://business.digito.do/api/v2/envelope/item/create-many' \
-H "Authorization: $DIGITO_API_TOKEN" \
-F 'payload={
"envelopeId": "envelope_ejemplo"
}' \
-F 'files=@./anexo.pdf;type=application/pdf'El resultado contiene data con los elementos creados. Guarda sus IDs antes de asignar campos. Consulta el sobre nuevamente para verificar su conjunto de archivos y el orden definitivo.
Renombra y ordena los elementos
POST /envelope/item/update-many permite cambiar title y order de elementos identificados por envelopeItemId. Este cuerpo muestra cómo referenciar dos elementos existentes:
{
"envelopeId": "envelope_ejemplo",
"data": [
{
"envelopeItemId": "item_contrato",
"title": "Contrato",
"order": 1
},
{
"envelopeItemId": "item_anexo",
"title": "Anexo",
"order": 2
}
]
}Los IDs y órdenes son valores ilustrativos; conserva los devueltos a tu aplicación y revisa el resultado tras actualizar. Eliminar un elemento es una operación separada. Revisa sus campos y la intención del usuario antes de retirar un PDF.
Descarga una versión
Pide explícitamente la versión que necesitas y comprueba el tipo de contenido antes de guardar bytes:
curl --fail-with-body \
'https://business.digito.do/api/v2/envelope/item/item_ejemplo/download?version=original' \
-H "Authorization: $DIGITO_API_TOKEN" \
--output './original.pdf'version | Cuándo utilizarla |
|---|---|
original | Recuperar el PDF que se cargó. |
pending | Revisar una vista provisional del proceso pendiente. |
signed | Archivar el resultado final tras comprobar COMPLETED; es el valor predeterminado. |
No uses response.json() para una descarga PDF. Tampoco archives un cuerpo de error con extensión .pdf. Una versión pending no representa el documento final firmado.
Sobres con varios PDFs
Descarga cada ID de envelopeItems, no solo el primero. La guía distribuir y descargar consulta el estado y guarda todos los PDFs en un directorio con nombres controlados. Un sobre con varios documentos explica la relación de campos y archivos en la carga inicial.