{"openapi":"3.0.2","paths":{"/api/v1/documents":{"get":{"summary":"Listar documentos","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"default":1,"type":"number","minimum":1}},{"name":"perPage","in":"query","schema":{"default":10,"type":"number","minimum":1}},{"name":"folderId","in":"query","description":"Filter documents by folder ID. When omitted, returns root documents.","schema":{"type":"string"}}],"operationId":"getDocuments","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"documents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt"]}},"totalPages":{"type":"number"}},"required":["documents","totalPages"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"post":{"summary":"Crear un documento y obtener la URL prefirmada para subir el PDF","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createDocument","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"externalId":{"type":"string","nullable":true},"folderId":{"type":"string","description":"The ID of the folder to create the document in. If not provided, the document will be created in the root folder."},"recipients":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"representacion":{"type":"object","properties":{"cuit":{"type":"string","minLength":11,"maxLength":13,"description":"CUIT de la sociedad representada, con o sin guiones."},"razonSocial":{"type":"string","minLength":3,"maxLength":200,"description":"Razón social. Opcional: si la sociedad no está en el catálogo se crea con el CUIT y la razón social se completa con la documentación que aporte el firmante."}},"required":["cuit"]},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$","description":"Teléfono del firmante en formato E.164 (por ej. `+5491123456789`) para mandarle el link de firma por WhatsApp **además** del email. Sólo se usa si el documento tiene `meta.sendViaWhatsapp: true` y la cuenta tiene saldo del canal; consume 1 crédito por mensaje enviado, de un pool prepago separado del de documentos. Si falta el teléfono o no hay saldo, no se manda nada y el firmante recibe el email igual: el envío del documento nunca falla por esto. Los recordatorios automáticos van siempre por email."},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"idDocumentCountry":{"type":"string","minLength":2,"maxLength":2,"description":"País del documento (ISO-3166 de 2 letras). Por defecto `AR`."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"Número del documento de identidad contra el que se valida la verificación biométrica (si `meta.requireBiometricId` está activo). El documento que presente el firmante tiene que coincidir. Si no lo mandás, el firmante lo carga antes de verificarse."},"idDocumentType":{"type":"string","maxLength":32,"description":"Tipo de documento para la verificación biométrica. Por defecto, DNI."},"requireBiometricId":{"type":"boolean","description":"Por firmante: `false` exime a este firmante de la verificación de identidad aunque `meta.requireBiometricId` esté activo (firma sin DNI + rostro y no consume crédito). Omitido o `true`: sigue al documento. Sin efecto con el toggle del documento apagado."},"firstName":{"type":"string","maxLength":255,"description":"Nombre(s) del firmante, por separado del apellido — así lo valida el proveedor biométrico. Recomendado si activás `meta.requireBiometricId`."},"lastName":{"type":"string","maxLength":255,"description":"Apellido(s) del firmante, por separado del nombre. Recomendado si activás `meta.requireBiometricId`."}},"required":["name","email"]}},"meta":{"default":{},"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"},"timezone":{"default":"Etc/UTC","type":"string","description":"The timezone of the date. Must be one of the options listed in the list below.","enum":["Etc/UTC","Africa/Abidjan","Africa/Accra","Africa/Addis_Ababa","Africa/Algiers","Africa/Asmara","Africa/Bamako","Africa/Bangui","Africa/Banjul","Africa/Bissau","Africa/Blantyre","Africa/Brazzaville","Africa/Bujumbura","Africa/Cairo","Africa/Casablanca","Africa/Ceuta","Africa/Conakry","Africa/Dakar","Africa/Dar_es_Salaam","Africa/Djibouti","Africa/Douala","Africa/El_Aaiun","Africa/Freetown","Africa/Gaborone","Africa/Harare","Africa/Johannesburg","Africa/Juba","Africa/Kampala","Africa/Khartoum","Africa/Kigali","Africa/Kinshasa","Africa/Lagos","Africa/Libreville","Africa/Lome","Africa/Luanda","Africa/Lubumbashi","Africa/Lusaka","Africa/Malabo","Africa/Maputo","Africa/Maseru","Africa/Mbabane","Africa/Mogadishu","Africa/Monrovia","Africa/Nairobi","Africa/Ndjamena","Africa/Niamey","Africa/Nouakchott","Africa/Ouagadougou","Africa/Porto-Novo","Africa/Sao_Tome","Africa/Tripoli","Africa/Tunis","Africa/Windhoek","America/Adak","America/Anchorage","America/Anguilla","America/Antigua","America/Araguaina","America/Argentina/Buenos_Aires","America/Argentina/Catamarca","America/Argentina/Cordoba","America/Argentina/Jujuy","America/Argentina/La_Rioja","America/Argentina/Mendoza","America/Argentina/Rio_Gallegos","America/Argentina/Salta","America/Argentina/San_Juan","America/Argentina/San_Luis","America/Argentina/Tucuman","America/Argentina/Ushuaia","America/Aruba","America/Asuncion","America/Atikokan","America/Bahia","America/Bahia_Banderas","America/Barbados","America/Belem","America/Belize","America/Blanc-Sablon","America/Boa_Vista","America/Bogota","America/Boise","America/Cambridge_Bay","America/Campo_Grande","America/Cancun","America/Caracas","America/Cayenne","America/Cayman","America/Chicago","America/Chihuahua","America/Ciudad_Juarez","America/Costa_Rica","America/Coyhaique","America/Creston","America/Cuiaba","America/Curacao","America/Danmarkshavn","America/Dawson","America/Dawson_Creek","America/Denver","America/Detroit","America/Dominica","America/Edmonton","America/Eirunepe","America/El_Salvador","America/Fort_Nelson","America/Fortaleza","America/Glace_Bay","America/Goose_Bay","America/Grand_Turk","America/Grenada","America/Guadeloupe","America/Guatemala","America/Guayaquil","America/Guyana","America/Halifax","America/Havana","America/Hermosillo","America/Indiana/Indianapolis","America/Indiana/Knox","America/Indiana/Marengo","America/Indiana/Petersburg","America/Indiana/Tell_City","America/Indiana/Vevay","America/Indiana/Vincennes","America/Indiana/Winamac","America/Inuvik","America/Iqaluit","America/Jamaica","America/Juneau","America/Kentucky/Louisville","America/Kentucky/Monticello","America/Kralendijk","America/La_Paz","America/Lima","America/Los_Angeles","America/Lower_Princes","America/Maceio","America/Managua","America/Manaus","America/Marigot","America/Martinique","America/Matamoros","America/Mazatlan","America/Menominee","America/Merida","America/Metlakatla","America/Mexico_City","America/Miquelon","America/Moncton","America/Monterrey","America/Montevideo","America/Montserrat","America/Nassau","America/New_York","America/Nome","America/Noronha","America/North_Dakota/Beulah","America/North_Dakota/Center","America/North_Dakota/New_Salem","America/Nuuk","America/Ojinaga","America/Panama","America/Paramaribo","America/Phoenix","America/Port-au-Prince","America/Port_of_Spain","America/Porto_Velho","America/Puerto_Rico","America/Punta_Arenas","America/Rankin_Inlet","America/Recife","America/Regina","America/Resolute","America/Rio_Branco","America/Santarem","America/Santiago","America/Santo_Domingo","America/Sao_Paulo","America/Scoresbysund","America/Sitka","America/St_Barthelemy","America/St_Johns","America/St_Kitts","America/St_Lucia","America/St_Thomas","America/St_Vincent","America/Swift_Current","America/Tegucigalpa","America/Thule","America/Tijuana","America/Toronto","America/Tortola","America/Vancouver","America/Whitehorse","America/Winnipeg","America/Yakutat","Antarctica/Casey","Antarctica/Davis","Antarctica/DumontDUrville","Antarctica/Macquarie","Antarctica/Mawson","Antarctica/McMurdo","Antarctica/Palmer","Antarctica/Rothera","Antarctica/Syowa","Antarctica/Troll","Antarctica/Vostok","Arctic/Longyearbyen","Asia/Aden","Asia/Almaty","Asia/Amman","Asia/Anadyr","Asia/Aqtau","Asia/Aqtobe","Asia/Ashgabat","Asia/Atyrau","Asia/Baghdad","Asia/Bahrain","Asia/Baku","Asia/Bangkok","Asia/Barnaul","Asia/Beirut","Asia/Bishkek","Asia/Brunei","Asia/Chita","Asia/Colombo","Asia/Damascus","Asia/Dhaka","Asia/Dili","Asia/Dubai","Asia/Dushanbe","Asia/Famagusta","Asia/Gaza","Asia/Hebron","Asia/Ho_Chi_Minh","Asia/Hong_Kong","Asia/Hovd","Asia/Irkutsk","Asia/Jakarta","Asia/Jayapura","Asia/Jerusalem","Asia/Kabul","Asia/Kamchatka","Asia/Karachi","Asia/Kathmandu","Asia/Khandyga","Asia/Kolkata","Asia/Krasnoyarsk","Asia/Kuala_Lumpur","Asia/Kuching","Asia/Kuwait","Asia/Macau","Asia/Magadan","Asia/Makassar","Asia/Manila","Asia/Muscat","Asia/Nicosia","Asia/Novokuznetsk","Asia/Novosibirsk","Asia/Omsk","Asia/Oral","Asia/Phnom_Penh","Asia/Pontianak","Asia/Pyongyang","Asia/Qatar","Asia/Qostanay","Asia/Qyzylorda","Asia/Riyadh","Asia/Sakhalin","Asia/Samarkand","Asia/Seoul","Asia/Shanghai","Asia/Singapore","Asia/Srednekolymsk","Asia/Taipei","Asia/Tashkent","Asia/Tbilisi","Asia/Tehran","Asia/Thimphu","Asia/Tokyo","Asia/Tomsk","Asia/Ulaanbaatar","Asia/Urumqi","Asia/Ust-Nera","Asia/Vientiane","Asia/Vladivostok","Asia/Yakutsk","Asia/Yangon","Asia/Yekaterinburg","Asia/Yerevan","Atlantic/Azores","Atlantic/Bermuda","Atlantic/Canary","Atlantic/Cape_Verde","Atlantic/Faroe","Atlantic/Madeira","Atlantic/Reykjavik","Atlantic/South_Georgia","Atlantic/St_Helena","Atlantic/Stanley","Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Eucla","Australia/Hobart","Australia/Lindeman","Australia/Lord_Howe","Australia/Melbourne","Australia/Perth","Australia/Sydney","Europe/Amsterdam","Europe/Andorra","Europe/Astrakhan","Europe/Athens","Europe/Belgrade","Europe/Berlin","Europe/Bratislava","Europe/Brussels","Europe/Bucharest","Europe/Budapest","Europe/Busingen","Europe/Chisinau","Europe/Copenhagen","Europe/Dublin","Europe/Gibraltar","Europe/Guernsey","Europe/Helsinki","Europe/Isle_of_Man","Europe/Istanbul","Europe/Jersey","Europe/Kaliningrad","Europe/Kirov","Europe/Kyiv","Europe/Lisbon","Europe/Ljubljana","Europe/London","Europe/Luxembourg","Europe/Madrid","Europe/Malta","Europe/Mariehamn","Europe/Minsk","Europe/Monaco","Europe/Moscow","Europe/Oslo","Europe/Paris","Europe/Podgorica","Europe/Prague","Europe/Riga","Europe/Rome","Europe/Samara","Europe/San_Marino","Europe/Sarajevo","Europe/Saratov","Europe/Simferopol","Europe/Skopje","Europe/Sofia","Europe/Stockholm","Europe/Tallinn","Europe/Tirane","Europe/Ulyanovsk","Europe/Vaduz","Europe/Vatican","Europe/Vienna","Europe/Vilnius","Europe/Volgograd","Europe/Warsaw","Europe/Zagreb","Europe/Zurich","Indian/Antananarivo","Indian/Chagos","Indian/Christmas","Indian/Cocos","Indian/Comoro","Indian/Kerguelen","Indian/Mahe","Indian/Maldives","Indian/Mauritius","Indian/Mayotte","Indian/Reunion","Pacific/Apia","Pacific/Auckland","Pacific/Bougainville","Pacific/Chatham","Pacific/Chuuk","Pacific/Easter","Pacific/Efate","Pacific/Fakaofo","Pacific/Fiji","Pacific/Funafuti","Pacific/Galapagos","Pacific/Gambier","Pacific/Guadalcanal","Pacific/Guam","Pacific/Honolulu","Pacific/Kanton","Pacific/Kiritimati","Pacific/Kosrae","Pacific/Kwajalein","Pacific/Majuro","Pacific/Marquesas","Pacific/Midway","Pacific/Nauru","Pacific/Niue","Pacific/Norfolk","Pacific/Noumea","Pacific/Pago_Pago","Pacific/Palau","Pacific/Pitcairn","Pacific/Pohnpei","Pacific/Port_Moresby","Pacific/Rarotonga","Pacific/Saipan","Pacific/Tahiti","Pacific/Tarawa","Pacific/Tongatapu","Pacific/Wake","Pacific/Wallis"]},"dateFormat":{"default":"yyyy-MM-dd hh:mm a","type":"string","description":"The format of the date. Must be one of the options listed in the list below.","enum":["yyyy-MM-dd hh:mm a","yyyy-MM-dd HH:mm","dd/MM/yyyy HH:mm","dd/MM/yyyy hh:mm a","dd-MM-yyyy HH:mm","dd-MM-yyyy hh:mm a","MM/dd/yyyy HH:mm","MM/dd/yyyy hh:mm a","dd.MM.yyyy HH:mm","yy-MM-dd HH:mm","yy-MM-dd hh:mm a","yyyy-MM-dd HH:mm:ss","MMMM dd, yyyy HH:mm","MMMM dd, yyyy hh:mm a","EEEE, MMMM dd, yyyy HH:mm","EEEE, MMMM dd, yyyy hh:mm a","yyyy-MM-dd'T'HH:mm:ss.SSSXXX","yyyy-MM-dd","dd/MM/yyyy","dd-MM-yyyy","MM/dd/yyyy","dd.MM.yyyy","yy-MM-dd","MMMM dd, yyyy","EEEE, MMMM dd, yyyy"]},"redirectUrl":{"type":"string"},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"]},"typedSignatureEnabled":{"default":true,"type":"boolean"},"uploadSignatureEnabled":{"default":true,"type":"boolean"},"drawSignatureEnabled":{"default":true,"type":"boolean"},"requireBiometricId":{"default":false,"type":"boolean","description":"Activa la verificación biométrica de identidad (DNI + prueba de vida facial) para este documento: cada firmante debe aprobarla antes de poder firmar. Mandá `meta: { \"requireBiometricId\": true }`; también se hereda de la plantilla si la dejaste activada en la interfaz. Cada verificación aprobada consume 1 crédito del pool prepago de la cuenta (separado del de documentos); sin créditos, el firmante firma normalmente en lugar de quedar bloqueado. El resto del circuito (signingUrl, webhooks, descarga) no cambia — ver \"Verificación biométrica\" al principio de esta página."},"requireRepresentationCheck":{"type":"boolean","description":"No aplica en esta plataforma: la firma en representación de personas jurídicas se verifica sólo en firma digital. Dejalo en `false`."},"sendViaWhatsapp":{"default":false,"type":"boolean","description":"Activa el aviso por WhatsApp para este documento: cada firmante que tenga `phone` cargado recibe el link de firma por WhatsApp **además** del email. Consume 1 crédito por mensaje enviado, de un pool prepago separado del de documentos. Sin saldo o sin teléfono no se manda nada y el email sale igual — el envío del documento nunca falla por esto. Los recordatorios automáticos van siempre por email."},"sendViaSms":{"default":false,"type":"boolean","description":"Igual que `sendViaWhatsapp` pero por SMS, con su propio pool de créditos. El SMS es el canal de respaldo: cuesta más y llega peor que WhatsApp. Consultá disponibilidad antes de usarlo."},"requireWhatsappOtp":{"default":false,"type":"boolean","description":"Exige a cada firmante un código de un solo uso enviado por WhatsApp antes de completar la firma (firma electrónica avanzada). Requiere `phone` en E.164 en TODOS los firmantes: sin teléfono, `/send` devuelve 400. Consume 1 crédito por firmante de un pool prepago propio, cobrado al primer envío del código; sin saldo el firmante firma normalmente. Ver \"Código por WhatsApp\" al principio de esta página."},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"]},"emailSettings":{"nullable":true}}},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}}]},"globalActionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}]}},"description":"The globalActionAuth property is only available for Enterprise accounts."},"formValues":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"boolean"},{"type":"number"}]}},"attachments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"data":{"type":"string","format":"uri"},"type":{"default":"link","type":"string","enum":["link"]}},"required":["label","data"]}}},"required":["title","recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"uploadUrl":{"type":"string","minLength":1},"documentId":{"type":"number"},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"name":{"type":"string"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"representacion":{"type":"object","properties":{"cuit":{"type":"string"},"razonSocial":{"type":"string"},"status":{"type":"string"},"nivel":{"type":"string","nullable":true},"cargo":{"type":"string","nullable":true},"motivo":{"type":"string","nullable":true}},"required":["cuit","razonSocial","status","nivel","cargo","motivo"],"nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"token":{"type":"string"},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"signingUrl":{"type":"string"}},"required":["recipientId","name","email","token","role","signingUrl"]}}},"required":["uploadUrl","documentId","recipients"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}":{"get":{"summary":"Obtener un documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getDocument","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"recipients":{},"meta":{"type":"object","properties":{"requireRepresentationCheck":{"type":"boolean"},"requireBiometricId":{"type":"boolean"},"requireWhatsappOtp":{"type":"boolean"},"sendViaWhatsapp":{"type":"boolean"},"sendViaSms":{"type":"boolean"},"language":{"type":"string","nullable":true}},"required":["requireBiometricId","requireWhatsappOtp","sendViaWhatsapp","sendViaSms"]},"fields":{}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt","recipients","fields"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"delete":{"summary":"Eliminar un documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteDocument","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/download":{"get":{"summary":"Descargar el documento firmado (requiere almacenamiento S3)","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"downloadOriginalDocument","in":"query","schema":{"default":false,"type":"boolean","nullable":true}}],"operationId":"downloadSignedDocument","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"downloadUrl":{"type":"string"}},"required":["downloadUrl"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"Devuelve JSON con downloadUrl, no bytes PDF. Descargá el archivo desde esa URL firmada; no envíes el API token a la URL de almacenamiento. Para bytes directos usá GET /api/v2/document/{documentId}/download. Verificá status=COMPLETED antes de tratarlo como documento final."}},"/api/v1/templates":{"post":{"summary":"Crear una plantilla y obtener la URL prefirmada para subir el PDF","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createTemplate","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":255,"description":"The title of the document."},"recipients":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1,"maxLength":254},"name":{"type":"string","maxLength":255},"cuil":{"type":"string","maxLength":20,"nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number"},"accessAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"actionAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}},"fields":{"type":"array","items":{"allOf":[{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["SIGNATURE"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["FREE_SIGNATURE"]},"fieldMeta":{}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["INITIALS"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["NAME"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["EMAIL"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["DATE"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["TEXT"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["NUMBER"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["RADIO"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["CHECKBOX"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["DROPDOWN"]},"fieldMeta":{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}},"required":["type"]}]},{"type":"object","properties":{"pageNumber":{"type":"number","minimum":1,"description":"The page number the field will be on."},"pageX":{"type":"number","minimum":0,"description":"The X coordinate of where the field will be placed."},"pageY":{"type":"number","minimum":0,"description":"The Y coordinate of where the field will be placed."},"width":{"type":"number","minimum":1,"description":"The width of the field."},"height":{"type":"number","minimum":1,"description":"The height of the field."}},"required":["pageNumber","pageX","pageY","width","height"]}]}}},"required":["email","name","role"]}},"folderId":{"type":"string"},"externalId":{"type":"string","nullable":true},"visibility":{"type":"string","enum":["EVERYONE","MANAGER_AND_ABOVE","ADMIN"]},"globalAccessAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"globalActionAuth":{"default":[],"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}},"publicTitle":{"type":"string","minLength":1,"maxLength":50,"description":"The title of the template that will be displayed to the public. Only applicable for public templates."},"publicDescription":{"type":"string","minLength":1,"maxLength":256,"description":"The description of the template that will be displayed to the public. Only applicable for public templates."},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"meta":{"type":"object","properties":{"subject":{"type":"string","maxLength":254,"description":"The subject of the email that will be sent to the recipients."},"message":{"type":"string","maxLength":5000,"description":"The message of the email that will be sent to the recipients."},"timezone":{"type":"string","description":"The timezone to use for date fields and signing the document. Example Etc/UTC, Australia/Melbourne"},"dateFormat":{"type":"string","enum":["yyyy-MM-dd hh:mm a","yyyy-MM-dd","dd/MM/yyyy","dd-MM-yyyy","MM/dd/yyyy","yy-MM-dd","MMMM dd, yyyy","EEEE, MMMM dd, yyyy","dd/MM/yyyy hh:mm a","dd/MM/yyyy HH:mm","dd-MM-yyyy hh:mm a","dd-MM-yyyy HH:mm","MM/dd/yyyy hh:mm a","MM/dd/yyyy HH:mm","dd.MM.yyyy","dd.MM.yyyy HH:mm","yyyy-MM-dd HH:mm","yy-MM-dd hh:mm a","yy-MM-dd HH:mm","yyyy-MM-dd HH:mm:ss","MMMM dd, yyyy hh:mm a","MMMM dd, yyyy HH:mm","EEEE, MMMM dd, yyyy hh:mm a","EEEE, MMMM dd, yyyy HH:mm","yyyy-MM-dd'T'HH:mm:ss.SSSXXX"],"description":"The date format to use for date fields and signing the document."},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"],"description":"The distribution method to use when sending the document to the recipients."},"emailId":{"type":"string","nullable":true},"emailReplyTo":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","nullable":true},"emailSettings":{"nullable":true},"redirectUrl":{"type":"string","description":"The URL to which the recipient should be redirected after signing the document."},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"],"description":"The language to use for email communications with recipients."},"typedSignatureEnabled":{"type":"boolean","description":"Whether to allow recipients to sign using a typed signature."},"uploadSignatureEnabled":{"type":"boolean","description":"Whether to allow recipients to sign using an uploaded signature."},"drawSignatureEnabled":{"type":"boolean","description":"Whether to allow recipients to sign using a draw signature."},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"}}},"attachments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"data":{"type":"string","format":"uri"},"type":{"default":"link","type":"string","enum":["link"]}},"required":["label","data"]}}},"required":["title"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"template":{"type":"object","properties":{"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"visibility":{"type":"string","enum":["EVERYONE","MANAGER_AND_ABOVE","ADMIN"]},"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number"},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"globalActionAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}},"required":["globalAccessAuth","globalActionAuth"],"nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":true},"publicTitle":{"type":"string"},"publicDescription":{"type":"string"},"folderId":{"type":"string","nullable":true},"envelopeId":{"type":"string"},"templateDocumentDataId":{"default":"","type":"string"},"templateDocumentData":{"type":"object","properties":{"type":{"type":"string","enum":["S3_PATH","BYTES","BYTES_64"]},"id":{"type":"string"},"data":{"type":"string"},"initialData":{"type":"string"},"envelopeItemId":{"type":"string"}},"required":["type","id","data","initialData","envelopeItemId"]},"templateMeta":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","nullable":true},"message":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"dateFormat":{"type":"string","nullable":true},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"typedSignatureEnabled":{"type":"boolean"},"uploadSignatureEnabled":{"type":"boolean"},"drawSignatureEnabled":{"type":"boolean"},"allowDictateNextSigner":{"type":"boolean"},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"]},"redirectUrl":{"type":"string","nullable":true},"language":{"type":"string"},"emailSettings":{"nullable":true},"emailId":{"type":"string","nullable":true},"emailReplyTo":{"type":"string","nullable":true},"templateId":{"type":"number","nullable":true}},"required":["id","subject","message","timezone","dateFormat","signingOrder","typedSignatureEnabled","uploadSignatureEnabled","drawSignatureEnabled","allowDictateNextSigner","distributionMethod","redirectUrl","language","emailId","emailReplyTo","templateId"]},"directLink":{"type":"object","properties":{"id":{"type":"string"},"envelopeId":{"type":"string"},"token":{"type":"string"},"createdAt":{"type":"string","format":"date-time","nullable":true},"enabled":{"type":"boolean"},"directTemplateRecipientId":{"type":"number"},"templateId":{"type":"number"}},"required":["id","envelopeId","token","createdAt","enabled","directTemplateRecipientId","templateId"],"nullable":true},"user":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string","nullable":true},"email":{"type":"string"}},"required":["id","name","email"]},"recipients":{"type":"array","items":{"type":"object","properties":{"envelopeId":{"type":"string"},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"id":{"type":"number"},"email":{"type":"string"},"name":{"type":"string"},"token":{"type":"string"},"documentDeletedAt":{"type":"string","format":"date-time","nullable":true},"expired":{"type":"string","format":"date-time","nullable":true},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"authOptions":{"type":"object","properties":{"accessAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}},"actionAuth":{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}}},"required":["accessAuth","actionAuth"],"nullable":true},"signingOrder":{"type":"number","description":"The order in which the recipient should sign the document. Only works if the document is set to sequential signing.","nullable":true},"rejectionReason":{"type":"string","nullable":true},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true}},"required":["envelopeId","role","readStatus","signingStatus","sendStatus","id","email","name","token","documentDeletedAt","expired","expiresAt","expirationNotifiedAt","signedAt","signingOrder","rejectionReason"]}},"fields":{"type":"array","items":{"type":"object","properties":{"envelopeId":{"type":"string"},"envelopeItemId":{"type":"string"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"id":{"type":"number"},"secondaryId":{"type":"string"},"recipientId":{"type":"number"},"page":{"type":"number","description":"The page number of the field on the document. Starts from 1."},"positionX":{"nullable":true},"positionY":{"nullable":true},"width":{"nullable":true},"height":{"nullable":true},"customText":{"type":"string"},"inserted":{"type":"boolean"},"fieldMeta":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}],"nullable":true},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true}},"required":["envelopeId","envelopeItemId","type","id","secondaryId","recipientId","page","positionX","positionY","width","height","customText","inserted","fieldMeta"]}},"folder":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["DOCUMENT","TEMPLATE"]},"visibility":{"type":"string","enum":["EVERYONE","MANAGER_AND_ABOVE","ADMIN"]},"userId":{"type":"number"},"teamId":{"type":"number"},"pinned":{"type":"boolean"},"parentId":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time","nullable":true},"updatedAt":{"type":"string","format":"date-time","nullable":true}},"required":["id","name","type","visibility","userId","teamId","pinned","parentId","createdAt","updatedAt"],"nullable":true},"envelopeItems":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"envelopeId":{"type":"string"}},"required":["id","envelopeId"]}}},"required":["type","visibility","id","externalId","title","userId","teamId","createdAt","updatedAt","publicTitle","publicDescription","folderId","envelopeId","templateDocumentData","templateMeta","directLink","user","recipients","fields","folder","envelopeItems"]},"uploadUrl":{"type":"string","minLength":1}},"required":["template","uploadUrl"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."},"get":{"summary":"Listar plantillas","tags":[],"parameters":[{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"default":1,"type":"number","minimum":1}},{"name":"perPage","in":"query","schema":{"default":10,"type":"number","minimum":1}}],"operationId":"getTemplates","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"directLink":{"type":"object","properties":{"token":{"type":"string"},"enabled":{"type":"boolean"}},"required":["token","enabled"],"nullable":true},"Field":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"page":{"type":"number"},"positionX":{"nullable":true},"positionY":{"nullable":true},"width":{"nullable":true},"height":{"nullable":true},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}],"nullable":true}},"required":["id","recipientId","type","page","customText"]}},"Recipient":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"signingOrder":{"type":"number","nullable":true},"authOptions":{"nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]}},"required":["id","email","name","role"]}}},"required":["id","type","title","userId","createdAt","updatedAt","directLink","Field","Recipient"]}},"totalPages":{"type":"number"}},"required":["templates","totalPages"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."}},"/api/v1/templates/{id}":{"delete":{"summary":"Eliminar una plantilla","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteTemplate","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","type","title","userId","createdAt","updatedAt"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."},"get":{"summary":"Obtener una plantilla","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getTemplate","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"type":{"type":"string","enum":["PUBLIC","PRIVATE","ORGANISATION"]},"title":{"type":"string"},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"templateMeta":{"type":"object","properties":{"id":{"type":"string"},"subject":{"type":"string","nullable":true},"message":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"dateFormat":{"type":"string","nullable":true},"templateId":{"type":"number"},"redirectUrl":{"type":"string","nullable":true},"signingOrder":{"default":"PARALLEL","type":"string","enum":["PARALLEL","SEQUENTIAL"],"nullable":true}},"required":["id","templateId"],"nullable":true},"directLink":{"type":"object","properties":{"token":{"type":"string"},"enabled":{"type":"boolean"}},"required":["token","enabled"],"nullable":true},"templateDocumentData":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["S3_PATH","BYTES","BYTES_64"]},"data":{"type":"string"}},"required":["id","type","data"]},"Field":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number","nullable":true},"templateId":{"type":"number","nullable":true},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"page":{"type":"number"},"positionX":{"nullable":true},"positionY":{"nullable":true},"width":{"nullable":true},"height":{"nullable":true},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}],"nullable":true}},"required":["id","recipientId","type","page","customText"]}},"Recipient":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"signingOrder":{"type":"number","nullable":true},"authOptions":{"nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]}},"required":["id","email","name","role"]}}},"required":["id","type","title","userId","createdAt","updatedAt","directLink","templateDocumentData","Field","Recipient"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}},"description":"### Crear documentos desde una plantilla\n\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`)."}},"/api/v1/templates/{templateId}/create-document":{"post":{"description":"If you must use the V1 API, use \"/api/v1/templates/:templateId/generate-document\" instead.\n\n### Crear documentos desde una plantilla\n\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`).","summary":"Crear un documento a partir de una plantilla","tags":[],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createDocumentFromTemplate","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"representacion":{"type":"object","properties":{"cuit":{"type":"string","minLength":11,"maxLength":13,"description":"CUIT de la sociedad representada, con o sin guiones."},"razonSocial":{"type":"string","minLength":3,"maxLength":200,"description":"Razón social. Opcional: si la sociedad no está en el catálogo se crea con el CUIT y la razón social se completa con la documentación que aporte el firmante."}},"required":["cuit"]},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$","description":"Teléfono del firmante en formato E.164 (por ej. `+5491123456789`) para mandarle el link de firma por WhatsApp **además** del email. Sólo se usa si el documento tiene `meta.sendViaWhatsapp: true` y la cuenta tiene saldo del canal; consume 1 crédito por mensaje enviado, de un pool prepago separado del de documentos. Si falta el teléfono o no hay saldo, no se manda nada y el firmante recibe el email igual: el envío del documento nunca falla por esto. Los recordatorios automáticos van siempre por email."},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"idDocumentCountry":{"type":"string","minLength":2,"maxLength":2,"description":"País del documento (ISO-3166 de 2 letras). Por defecto `AR`."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"Número del documento de identidad contra el que se valida la verificación biométrica (si `meta.requireBiometricId` está activo). El documento que presente el firmante tiene que coincidir. Si no lo mandás, el firmante lo carga antes de verificarse."},"idDocumentType":{"type":"string","maxLength":32,"description":"Tipo de documento para la verificación biométrica. Por defecto, DNI."},"requireBiometricId":{"type":"boolean","description":"Por firmante: `false` exime a este firmante de la verificación de identidad aunque `meta.requireBiometricId` esté activo (firma sin DNI + rostro y no consume crédito). Omitido o `true`: sigue al documento. Sin efecto con el toggle del documento apagado."},"firstName":{"type":"string","maxLength":255,"description":"Nombre(s) del firmante, por separado del apellido — así lo valida el proveedor biométrico. Recomendado si activás `meta.requireBiometricId`."},"lastName":{"type":"string","maxLength":255,"description":"Apellido(s) del firmante, por separado del nombre. Recomendado si activás `meta.requireBiometricId`."}},"required":["name","email"]}},"meta":{"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"},"timezone":{"type":"string"},"dateFormat":{"type":"string"},"redirectUrl":{"type":"string"},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"]},"requireRepresentationCheck":{"type":"boolean","description":"No aplica en esta plataforma: la firma en representación de personas jurídicas se verifica sólo en firma digital. Dejalo en `false`."}}},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}}]},"globalActionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}]}}},"formValues":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"boolean"},{"type":"number"}]}},"attachments":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1},"data":{"type":"string","format":"uri"},"type":{"default":"link","type":"string","enum":["link"]}},"required":["label","data"]}}},"required":["title","recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"documentId":{"type":"number"},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"name":{"type":"string"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"representacion":{"type":"object","properties":{"cuit":{"type":"string"},"razonSocial":{"type":"string"},"status":{"type":"string"},"nivel":{"type":"string","nullable":true},"cargo":{"type":"string","nullable":true},"motivo":{"type":"string","nullable":true}},"required":["cuit","razonSocial","status","nivel","cargo","motivo"],"nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"token":{"type":"string"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"signingUrl":{"type":"string"}},"required":["recipientId","name","email","token","signingUrl"]}}},"required":["documentId","recipients"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/templates/{templateId}/generate-document":{"post":{"description":"Create a new document from an existing template. Passing in values for title and meta will override the original values defined in the template. If you do not pass in values for recipients, it will use the values defined in the template.\n\n### Crear documentos desde una plantilla\n\nPodés preparar la plantilla en la interfaz web o crearla con `POST /api/v1/templates`, incluyendo destinatarios y campos en el payload y subiendo luego el PDF a la uploadUrl devuelta. Para usarla desde la API:\n\n1. `GET /api/v1/templates` — lista tus plantillas y sus `id`.\n2. `GET /api/v1/templates/{id}` — devuelve los **firmantes de la plantilla con su `id`** (y los campos). Ese `id` es el que tenés que mandar en el paso 3.\n3. `POST /api/v1/templates/{templateId}/generate-document` — crea el documento. En `recipients[]` mandás **el `id` del firmante de la plantilla** junto con el email/nombre reales de esta vez. `title` y `meta` (asunto, mensaje, idioma…) sobrescriben lo definido en la plantilla; si no mandás `recipients`, se usan los de la plantilla.\n   Respuesta: `documentId` y, por cada firmante, su `signingUrl`.\n4. `POST /api/v1/documents/{id}/send` — envía los emails de firma. **Sin este paso el documento queda en borrador.**\n\nLos destinatarios y campos pueden incluirse al crear la plantilla por API. Para modificar una plantilla existente, usá la interfaz o las operaciones correspondientes de v2; v1 permite editar destinatarios y campos de documentos ya creados (`/documents/{id}/recipients` y `/documents/{id}/fields`).","summary":"Crear un documento a partir de una plantilla (con valores)","tags":[],"parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"generateDocumentFromTemplate","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"externalId":{"type":"string"},"folderId":{"type":"string","description":"The ID of the folder to create the document in. If not provided, the document will be created in the root folder."},"recipients":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$"},"name":{"type":"string"},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"representacion":{"type":"object","properties":{"cuit":{"type":"string","minLength":11,"maxLength":13,"description":"CUIT de la sociedad representada, con o sin guiones."}},"required":["cuit"]},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$","description":"Teléfono del firmante en formato E.164 (por ej. `+5491123456789`) para mandarle el link de firma por WhatsApp **además** del email. Sólo se usa si el documento tiene `meta.sendViaWhatsapp: true` y la cuenta tiene saldo del canal; consume 1 crédito por mensaje enviado, de un pool prepago separado del de documentos. Si falta el teléfono o no hay saldo, no se manda nada y el firmante recibe el email igual: el envío del documento nunca falla por esto. Los recordatorios automáticos van siempre por email."},"idDocumentCountry":{"type":"string","minLength":2,"maxLength":2,"description":"País del documento (ISO-3166 de 2 letras). Por defecto `AR`."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"Número del documento de identidad contra el que se valida la verificación biométrica (si `meta.requireBiometricId` está activo). El documento que presente el firmante tiene que coincidir. Si no lo mandás, el firmante lo carga antes de verificarse."},"idDocumentType":{"type":"string","maxLength":32,"description":"Tipo de documento para la verificación biométrica. Por defecto, DNI."},"requireBiometricId":{"type":"boolean","description":"Por firmante: `false` exime a este firmante de la verificación de identidad aunque `meta.requireBiometricId` esté activo (firma sin DNI + rostro y no consume crédito). Omitido o `true`: sigue al documento. Sin efecto con el toggle del documento apagado."},"firstName":{"type":"string","maxLength":255,"description":"Nombre(s) del firmante, por separado del apellido — así lo valida el proveedor biométrico. Recomendado si activás `meta.requireBiometricId`."},"lastName":{"type":"string","maxLength":255,"description":"Apellido(s) del firmante, por separado del nombre. Recomendado si activás `meta.requireBiometricId`."},"signingOrder":{"type":"number"}},"required":["id","email"]}},"meta":{"type":"object","properties":{"subject":{"type":"string"},"message":{"type":"string"},"timezone":{"type":"string"},"dateFormat":{"type":"string"},"redirectUrl":{"type":"string"},"signingOrder":{"type":"string","enum":["PARALLEL","SEQUENTIAL"]},"allowDictateNextSigner":{"type":"boolean"},"language":{"type":"string","enum":["de","en","fr","es","it","nl","pl","pt-BR","ja","ko","zh"]},"distributionMethod":{"type":"string","enum":["EMAIL","NONE"]},"typedSignatureEnabled":{"type":"boolean"},"uploadSignatureEnabled":{"type":"boolean"},"drawSignatureEnabled":{"type":"boolean"},"emailSettings":{"nullable":true},"requireBiometricId":{"type":"boolean","description":"Activa la verificación biométrica de identidad (DNI + prueba de vida facial) para este documento: cada firmante debe aprobarla antes de poder firmar. Mandá `meta: { \"requireBiometricId\": true }`; también se hereda de la plantilla si la dejaste activada en la interfaz. Cada verificación aprobada consume 1 crédito del pool prepago de la cuenta (separado del de documentos); sin créditos, el firmante firma normalmente en lugar de quedar bloqueado. El resto del circuito (signingUrl, webhooks, descarga) no cambia — ver \"Verificación biométrica\" al principio de esta página."},"sendViaWhatsapp":{"type":"boolean","description":"Activa el aviso por WhatsApp para este documento: cada firmante que tenga `phone` cargado recibe el link de firma por WhatsApp **además** del email. Consume 1 crédito por mensaje enviado, de un pool prepago separado del de documentos. Sin saldo o sin teléfono no se manda nada y el email sale igual — el envío del documento nunca falla por esto. Los recordatorios automáticos van siempre por email."},"sendViaSms":{"type":"boolean","description":"Igual que `sendViaWhatsapp` pero por SMS, con su propio pool de créditos. El SMS es el canal de respaldo: cuesta más y llega peor que WhatsApp. Consultá disponibilidad antes de usarlo."},"requireWhatsappOtp":{"type":"boolean","description":"Exige a cada firmante un código de un solo uso enviado por WhatsApp antes de completar la firma (firma electrónica avanzada). Requiere `phone` en E.164 en TODOS los firmantes: sin teléfono, `/send` devuelve 400. Consume 1 crédito por firmante de un pool prepago propio, cobrado al primer envío del código; sin saldo el firmante firma normalmente. Ver \"Código por WhatsApp\" al principio de esta página."},"requireRepresentationCheck":{"type":"boolean","description":"No aplica en esta plataforma: la firma en representación de personas jurídicas se verifica sólo en firma digital. Dejalo en `false`."}}},"authOptions":{"type":"object","properties":{"globalAccessAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","TWO_FACTOR_AUTH"],"description":"The type of authentication required for the recipient to access the document."}}]},"globalActionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD"],"description":"The type of authentication required for the recipient to sign the document. This field is restricted to Enterprise plan users only."}}]}}},"formValues":{"type":"object","additionalProperties":{"oneOf":[{"type":"string"},{"type":"boolean"},{"type":"number"}]}},"prefillFields":{"type":"array","items":{"allOf":[{"type":"object","properties":{"id":{"type":"number"}},"required":["id"]},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["text"]},"label":{"type":"string"},"placeholder":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["number"]},"label":{"type":"string"},"placeholder":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["radio"]},"label":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["checkbox"]},"label":{"type":"string"},"value":{"type":"array","items":{"type":"string"}}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["dropdown"]},"label":{"type":"string"},"value":{"type":"string"}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","enum":["date"]},"value":{"type":"string"}},"required":["type"]}]}]}}},"required":["recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"documentId":{"type":"number"},"externalId":{"type":"string","nullable":true},"recipients":{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"name":{"type":"string"},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"representacion":{"type":"object","properties":{"cuit":{"type":"string"},"razonSocial":{"type":"string"},"status":{"type":"string"},"nivel":{"type":"string","nullable":true},"cargo":{"type":"string","nullable":true},"motivo":{"type":"string","nullable":true}},"required":["cuit","razonSocial","status","nivel","cargo","motivo"],"nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"token":{"type":"string"},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"signingUrl":{"type":"string"}},"required":["recipientId","name","email","token","role","signingUrl"]}}},"required":["documentId","recipients"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/send":{"post":{"description":"Notes\n\nsendEmail - Whether to send an email to the recipients asking them to action the document. If you disable this, you will need to manually distribute the document to the recipients using the generated signing links. Defaults to true","summary":"Enviar un documento a firmar","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"sendDocument","requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"sendEmail":{"default":true,"type":"boolean","description":"Whether to send an email to the recipients asking them to action the document. If you disable this, you will need to manually distribute the document to the recipients using the generated signing links."},"sendCompletionEmails":{"type":"boolean","description":"Whether to send completion emails when the document is fully signed. This will override the document email settings."}}},{"nullable":true}],"nullable":true}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]},{"type":"object","properties":{"id":{"type":"number"},"externalId":{"type":"string","nullable":true},"userId":{"type":"number"},"teamId":{"type":"number","nullable":true},"folderId":{"type":"string","nullable":true},"title":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time","nullable":true},"recipients":{},"meta":{"type":"object","properties":{"requireRepresentationCheck":{"type":"boolean"},"requireBiometricId":{"type":"boolean"},"requireWhatsappOtp":{"type":"boolean"},"sendViaWhatsapp":{"type":"boolean"},"sendViaSms":{"type":"boolean"},"language":{"type":"string","nullable":true}},"required":["requireBiometricId","requireWhatsappOtp","sendViaWhatsapp","sendViaSms"]}},"required":["id","userId","title","status","createdAt","updatedAt","completedAt","recipients"]}]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/resend":{"post":{"summary":"Reenviar la invitación a firmar","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"resendDocument","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"number"}}},"required":["recipients"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/recipients":{"post":{"summary":"Agregar un destinatario al documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createRecipient","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"authOptions":{"type":"object","properties":{"actionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}}]}},"description":"The authOptions property is only available for Enterprise accounts."}},"required":["name","email"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"default":-1,"type":"number","nullable":true},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"representacion":{"type":"object","properties":{"cuit":{"type":"string"},"razonSocial":{"type":"string"},"status":{"type":"string"},"nivel":{"type":"string","nullable":true},"cargo":{"type":"string","nullable":true},"motivo":{"type":"string","nullable":true}},"required":["cuit","razonSocial","status","nivel","cargo","motivo"],"nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"token":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"signingUrl":{"type":"string"}},"required":["id","email","name","role","token","signedAt","readStatus","signingStatus","sendStatus","signingUrl"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/recipients/{recipientId}":{"patch":{"summary":"Actualizar un destinatario del documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"updateRecipient","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"cuil":{"type":"string","maxLength":20,"nullable":true,"description":"CUIL argentino del firmante, 11 dígitos, requerido para firma digital con Digilogix; opcional para firma electrónica"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"},"role":{"default":"SIGNER","type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"authOptions":{"type":"object","properties":{"actionAuth":{"default":[],"oneOf":[{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."},{"type":"array","items":{"type":"string","enum":["ACCOUNT","PASSKEY","TWO_FACTOR_AUTH","PASSWORD","EXPLICIT_NONE"],"description":"The type of authentication required for the recipient to sign the document."}}]}},"description":"The authOptions property is only available for Enterprise accounts."}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"default":-1,"type":"number","nullable":true},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"representacion":{"type":"object","properties":{"cuit":{"type":"string"},"razonSocial":{"type":"string"},"status":{"type":"string"},"nivel":{"type":"string","nullable":true},"cargo":{"type":"string","nullable":true},"motivo":{"type":"string","nullable":true}},"required":["cuit","razonSocial","status","nivel","cargo","motivo"],"nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"token":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"signingUrl":{"type":"string"}},"required":["id","email","name","role","token","signedAt","readStatus","signingStatus","sendStatus","signingUrl"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"delete":{"summary":"Quitar un destinatario del documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteRecipient","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"default":-1,"type":"number","nullable":true},"email":{"type":"string","pattern":"^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~\\u{0080}-\\u{FFFF}-]+@[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?(?:\\.[a-zA-Z0-9\\u{0080}-\\u{FFFF}](?:[a-zA-Z0-9\\u{0080}-\\u{FFFF}-]{0,61}[a-zA-Z0-9\\u{0080}-\\u{FFFF}])?)*$","minLength":1},"name":{"type":"string"},"cuil":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"representacion":{"type":"object","properties":{"cuit":{"type":"string"},"razonSocial":{"type":"string"},"status":{"type":"string"},"nivel":{"type":"string","nullable":true},"cargo":{"type":"string","nullable":true},"motivo":{"type":"string","nullable":true}},"required":["cuit","razonSocial","status","nivel","cargo","motivo"],"nullable":true},"idDocumentCountry":{"type":"string","nullable":true},"idDocumentNumber":{"type":"string","nullable":true},"idDocumentType":{"type":"string","nullable":true},"requireBiometricId":{"type":"boolean","nullable":true},"firstName":{"type":"string","nullable":true},"lastName":{"type":"string","nullable":true},"role":{"type":"string","enum":["CC","SIGNER","VIEWER","APPROVER","ASSISTANT"]},"signingOrder":{"type":"number","nullable":true},"token":{"type":"string"},"expiresAt":{"type":"string","format":"date-time","nullable":true},"expirationNotifiedAt":{"type":"string","format":"date-time","nullable":true},"signedAt":{"type":"string","format":"date-time","nullable":true},"readStatus":{"type":"string","enum":["NOT_OPENED","OPENED"]},"signingStatus":{"type":"string","enum":["NOT_SIGNED","SIGNED","REJECTED"]},"sendStatus":{"type":"string","enum":["NOT_SENT","SENT"]},"signingUrl":{"type":"string"}},"required":["id","email","name","role","token","signedAt","readStatus","signingStatus","sendStatus","signingUrl"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/fields":{"post":{"summary":"Agregar un campo al documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"createField","requestBody":{"description":"Body","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]}},"required":["recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight"]},{"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]}},"required":["recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight"]},"minItems":1}]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"oneOf":[{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]},{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]}}]},"documentId":{"type":"number"}},"required":["fields","documentId"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v1/documents/{id}/fields/{fieldId}":{"patch":{"summary":"Actualizar un campo del documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"updateField","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]}}}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"delete":{"summary":"Quitar un campo del documento","tags":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"deleteField","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"number"},"documentId":{"type":"number"},"recipientId":{"type":"number"},"type":{"type":"string","enum":["SIGNATURE","FREE_SIGNATURE","INITIALS","NAME","EMAIL","DATE","TEXT","NUMBER","RADIO","CHECKBOX","DROPDOWN"]},"pageNumber":{"type":"number"},"pageX":{"type":"number"},"pageY":{"type":"number"},"pageWidth":{"type":"number"},"pageHeight":{"type":"number"},"customText":{"type":"string"},"fieldMeta":{"oneOf":[{"type":"object","properties":{},"additionalProperties":false},{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["signature"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["initials"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["name"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["email"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"default":"auto","type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["date"]},"textAlign":{"type":"string","enum":["left","center","right"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["text"]},"text":{"type":"string"},"characterLimit":{"type":"number","minimum":0,"nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true},"validationPreset":{"type":"string","enum":["none","cuil","dni","cuit"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["number"]},"numberFormat":{"type":"string","nullable":true},"value":{"type":"string"},"minValue":{"type":"number","nullable":true},"maxValue":{"type":"number","nullable":true},"textAlign":{"type":"string","enum":["left","center","right"]},"lineHeight":{"type":"number","minimum":1,"maximum":10,"description":"The line height of the text","nullable":true},"letterSpacing":{"type":"number","minimum":0,"maximum":100,"description":"The spacing between each character","nullable":true},"verticalAlign":{"type":"string","enum":["top","middle","bottom"],"description":"The vertical alignment of the text","nullable":true}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["radio"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["checkbox"]},"values":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"checked":{"type":"boolean"},"value":{"type":"string"}},"required":["id","checked","value"]}},"validationRule":{"type":"string"},"validationLength":{"type":"number"},"direction":{"default":"vertical","type":"string","enum":["vertical","horizontal"]}},"required":["type"]},{"type":"object","properties":{"label":{"type":"string"},"placeholder":{"type":"string"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"fontSize":{"default":12,"type":"number","minimum":8,"maximum":96},"overflow":{"type":"string","enum":["auto","horizontal","vertical","crop"]},"type":{"type":"string","enum":["dropdown"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}},"defaultValue":{"type":"string"}},"required":["type"]}]}]},"inserted":{"type":"boolean"}},"required":["id","documentId","recipientId","type","pageNumber","pageX","pageY","pageWidth","pageHeight","customText","inserted"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}}},"/api/v2/envelope/{envelopeId}/audit-log":{"get":{"summary":"Traza de auditoría del documento (v2)","operationId":"getEnvelopeAuditLogV2","description":"Devuelve la traza de auditoría completa en JSON: creación, envío, apertura, firma de cada campo, rechazo y finalización, con fecha, IP y dispositivo.\n\nSirve para archivar la evidencia de forma estructurada, además del PDF.\n\n⚠️ **Este endpoint acepta ÚNICAMENTE el `envelopeId`** (formato `envelope_...`), **no** el `id` numérico de v1 — mandarle el número devuelve `400 Invalid envelope ID`. Ver \"Los dos identificadores de un documento\" al principio de esta página.","parameters":[{"name":"envelopeId","in":"path","required":true,"description":"El `envelopeId` (`envelope_...`). Lo obtenés de `fields[].envelopeId` en `GET /api/v1/documents/{id}`.","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"number"}},{"name":"perPage","in":"query","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"La traza de auditoría, paginada.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"count":{"type":"number"},"currentPage":{"type":"number"},"perPage":{"type":"number"},"totalPages":{"type":"number"}}}}}},"400":{"description":"El `envelopeId` es inválido (por ejemplo, si mandaste el `id` numérico)."},"401":{"description":"Token ausente o inválido."}}}},"/api/v2/document/{documentId}/download":{"get":{"summary":"Descargar el PDF (v2, bytes directos)","operationId":"downloadDocumentV2","description":"Devuelve directamente los bytes del PDF (`application/pdf`), a diferencia de `GET /api/v1/documents/{id}/download`, que devuelve una URL de descarga firmada.\n\nAcepta **tanto el `id` numérico** del documento (el mismo de v1) **como su `envelopeId`** (`envelope_...`) — usá el que tengas a mano.\n\nSi el archivo ya no está disponible, la ruta devuelve 404. Archivá el PDF al completar; no dependas de 410 para detectar el fin del resguardo.","parameters":[{"name":"documentId","in":"path","required":true,"description":"El `id` numérico del documento (el mismo que devuelve v1) o su `envelopeId` (`envelope_...`); se aceptan ambos.","schema":{"oneOf":[{"type":"number"},{"type":"string","pattern":"^envelope_"}]}},{"name":"version","in":"query","required":false,"description":"`signed` (por defecto) devuelve el archivo vigente, sin garantizar que todos hayan firmado. Verificá status=COMPLETED antes de tratarlo como final; `original` devuelve el PDF tal como se subió.","schema":{"type":"string","enum":["original","signed"]}}],"responses":{"200":{"description":"El PDF.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Token ausente o inválido."},"410":{"description":"Código histórico documentado; la ruta vigente responde 404 si no encuentra el archivo. No dependas de 410 para detectar el fin del resguardo."}}}},"/api/v2/document/{documentId}/certificate":{"get":{"summary":"Descargar la constancia de firma (v2, PDF aparte)","operationId":"downloadDocumentCertificateV2","description":"Devuelve la **constancia de firma** como un PDF independiente (`application/pdf`, bytes directos): quién firmó, cuándo, IP, dispositivo, sellos de tiempo y el hash SHA-256 del PDF firmado.\n\nEn esta plataforma la constancia ya va incorporada al final del PDF firmado; este endpoint es para quien además la quiere como archivo separado.\n\nSe genera desde la evidencia guardada en el momento de la llamada, con el mismo generador que el botón «Descargar constancia» de la interfaz y que el adjunto del correo.\n\nAcepta **tanto el `id` numérico** del documento **como su `envelopeId`** (`envelope_...`). Disponible con `COMPLETED` o `REJECTED`; en un rechazo acredita ese resultado, no firmas completas. `DRAFT` y `PENDING` responden `409`.","parameters":[{"name":"documentId","in":"path","required":true,"description":"El `id` numérico del documento (el mismo que devuelve v1) o su `envelopeId` (`envelope_...`); se aceptan ambos.","schema":{"oneOf":[{"type":"number"},{"type":"string","pattern":"^envelope_"}]}}],"responses":{"200":{"description":"La constancia de firma en PDF (`Content-Disposition: attachment`).","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Token ausente o inválido."},"404":{"description":"El documento no existe o no pertenece a tu equipo."},"409":{"description":"El documento sigue DRAFT/PENDING (`code: DOCUMENT_NOT_COMPLETE`). COMPLETED y REJECTED permiten constancia; un rechazo no acredita firmas completas."}}}},"/api/v2/document/{documentId}/identity-evidence":{"get":{"summary":"Descargar la verificación de identidad (v2, PDF aparte, sólo quien envió el documento)","operationId":"downloadDocumentIdentityEvidenceV2","description":"Devuelve la **verificación de identidad** como PDF independiente (`application/pdf`, bytes directos): una página por firmante verificado con el frente y el dorso del documento, el rostro, el proveedor, la fecha y los identificadores de la operación, con el mismo diseño que la constancia.\n\nSólo existe en la plataforma **electrónica** (la única con verificación biométrica) y **sólo para quien envió el documento**: el token de API tiene que ser del mismo usuario que lo creó. Otro miembro del equipo recibe `403 IDENTITY_EVIDENCE_OWNER_ONLY`. Estas páginas **no van dentro del PDF firmado ni en ningún correo**: son datos personales de cada firmante (Ley 25.326); los demás firmantes ya tienen la constancia como prueba.\n\nVa **sellado con el sello electrónico de Identik** y lleva impreso el hash SHA-256 del PDF firmado; se genera y sella una vez al completarse el documento. Acepta el `id` numérico o el `envelopeId`. Requiere `COMPLETED` (`409 DOCUMENT_NOT_COMPLETE` antes). Sin fotos (documento sin biometría, proveedor sin fotos o ya purgadas por la retención) responde `404 IDENTITY_EVIDENCE_UNAVAILABLE`.","parameters":[{"name":"documentId","in":"path","required":true,"description":"El `id` numérico del documento (el mismo que devuelve v1) o su `envelopeId` (`envelope_...`); se aceptan ambos.","schema":{"oneOf":[{"type":"number"},{"type":"string","pattern":"^envelope_"}]}}],"responses":{"200":{"description":"La verificación de identidad en PDF (`Content-Disposition: attachment`).","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Token ausente o inválido."},"403":{"description":"El token no es de quien envió el documento (`code: IDENTITY_EVIDENCE_OWNER_ONLY`)."},"404":{"description":"El documento no existe o no pertenece a tu equipo, o no hay fotos guardadas (`code: IDENTITY_EVIDENCE_UNAVAILABLE`)."},"409":{"description":"El documento sigue DRAFT/PENDING (`code: DOCUMENT_NOT_COMPLETE`)."}}}}},"info":{"title":"Identik API","version":"1.0.0","description":"API de Identik para integraciones de clientes: creá documentos, subí el PDF, definí firmantes y campos, envialos a firmar y descargá el PDF firmado.\n\n**Autenticación:** toda solicitud lleva el encabezado `Authorization: Bearer api_...` con el token de API que te entrega Identik.\n\n### ⚠️ Los dos identificadores de un documento\n\nUn documento tiene **dos** identificadores distintos. Confundirlos es el error de integración más común:\n\n| Identificador | Formato | Dónde se usa |\n|---|---|---|\n| `id` numérico | `49` | **Todos** los endpoints `v1` (`/api/v1/documents/{id}/...`) |\n| `envelopeId` | `envelope_a1b2c3...` | La traza de auditoría `v2` (`/api/v2/envelope/{envelopeId}/audit-log`) |\n\nLa descarga `v2` (`GET /api/v2/document/{documentId}/download`) acepta **cualquiera de los dos**.\n\nLa traza de auditoría `v2` acepta **solo** el `envelopeId`: mandarle el numérico devuelve `400 Invalid envelope ID`. El `envelopeId` lo conseguís en la respuesta de `GET /api/v1/documents/{id}`, dentro de `fields[].envelopeId` (si el documento no tiene campos todavía, ese arreglo viene vacío).\n\n### Notificaciones automáticas (webhooks)\n\nIdentik te avisa por HTTP `POST` cuando cambia el estado de un documento, así no tenés que consultar en bucle.\n\nSe configuran **desde la interfaz web**, en Configuración → Webhooks (no por API): indicás la URL de destino, los eventos que querés y un secreto compartido. Cada entrega llega con el encabezado `X-Identik-Secret`, cuyo valor es ese secreto — comparalo antes de procesar el cuerpo. Toda entrega queda registrada y se puede reenviar a mano desde el panel si tu endpoint estuvo caído.\n\nEventos disponibles: `DOCUMENT_CREATED`, `DOCUMENT_SENT`, `DOCUMENT_OPENED`, `DOCUMENT_SIGNED`, `DOCUMENT_RECIPIENT_COMPLETED`, `DOCUMENT_COMPLETED`, `DOCUMENT_REJECTED`, `DOCUMENT_CANCELLED`, `RECIPIENT_EXPIRED`, `DOCUMENT_REMINDER_SENT`, más los de plantillas (`TEMPLATE_CREATED`, `TEMPLATE_UPDATED`, `TEMPLATE_DELETED`, `TEMPLATE_USED`).\n\nCuerpo de la entrega: `{ event, payload, createdAt, webhookEndpoint }`. En `payload` viaja el documento (incluido `status`) y sus firmantes con `signingStatus`, `readStatus`, `signedAt`, `expiresAt` y `rejectionReason`.\n\n**Cuidado con el vencimiento:** emitimos `RECIPIENT_EXPIRED` por cada firmante cuya ventana se cerró, pero **no existe** un evento de vencimiento a nivel documento, y el `status` del documento **no** cambia a vencido (se queda en `PENDING`). Si en tu modelo el vencimiento es un estado propio, consultá `GET /api/v1/documents/{id}` y mirá `recipients[].expiresAt` y `recipients[].expirationNotifiedAt`.\n\n### Evidencia de la firma (constancia)\n\nLa constancia de firma —quién firmó, cuándo, IP, dispositivo y hash del documento— va **incorporada como páginas del propio PDF firmado**. Descargás el documento y la evidencia en un solo archivo; no hay que pedirla aparte. Si igual la querés como PDF separado, `GET /api/v2/document/{documentId}/certificate` la devuelve (con el documento COMPLETED o REJECTED; un rechazo genera evidencia de ese resultado).\n\nAdemás, `GET /api/v2/envelope/{envelopeId}/audit-log` devuelve la traza de auditoría en JSON, por si la querés almacenar estructurada.\n\n### Plazos: ventana de firma y resguardo\n\nLa **ventana de firma** por defecto es de 1 mes, con un tope máximo de 31 días. Vencida, el enlace deja de funcionar (el documento no se borra y su `status` sigue en `PENDING` — ver la advertencia de arriba). Esta ventana no se configura por esta API.\n\nEl **resguardo** conserva el documento y su evidencia **15 días desde que el documento se cierra** (firmado, rechazado, o vencido sin firmar). Cumplido el plazo, el archivo puede eliminarse de nuestro almacenamiento y dejar de estar disponible para descarga; no dependas de un código HTTP único para detectar el fin del resguardo. La recomendación es descargar el PDF al recibir `DOCUMENT_COMPLETED` y archivarlo de tu lado. Hay resguardo extendido opcional, de hasta 10 años, configurable por cuenta.\n\n### Límites de uso (rate limits)\n\nCada dirección IP puede hacer hasta **100 solicitudes por minuto** contra esta API. Las respuestas que pasan por el limitador de aplicación incluyen los encabezados `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` (época Unix, en segundos); superado el límite, la API responde `429` con el encabezado `Retry-After` indicando cuántos segundos esperar. Una capa de acceso puede rechazar antes y sin esos headers. Para lotes grandes, procesá en serie y respetá `Retry-After` antes de reintentar.\n\n### Créditos\n\nEl crédito de un documento se consume cuando el documento **se envía a firmar** (`POST /api/v1/documents/{id}/send`). Los borradores no consumen: podés crear un documento y eliminarlo antes de enviarlo sin costo. Un documento ya enviado consume su crédito aunque después venza, se rechace o se elimine.\n\nLos extras opcionales tienen **pools de crédito propios**, separados del de documentos, que también carga Identik al comprar un paquete:\n\n| Pool | Se consume | Si se agota |\n|---|---|---|\n| Documentos | al enviar a firmar | no se pueden crear más documentos |\n| Verificación de identidad | por cada verificación **aprobada** | el firmante firma normalmente, sin verificarse |\n| WhatsApp | por cada aviso **enviado** y por cada firmante al que se le manda un **código de un solo uso** (una sola bolsa) | no se manda el WhatsApp ni el código; el email sale igual y el firmante firma normal |\n| SMS | por cada mensaje **enviado** | no se manda el SMS; el email sale igual |\n\nNinguno de los pools de extras vence. Los saldos se consultan con la herramienta `estado_cuenta` del servidor MCP.\n\n### Aviso por WhatsApp\n\nOpcional y **por documento**: además del email, cada firmante que tenga teléfono cargado recibe su link de firma por WhatsApp, desde el número de Identik y con una plantilla que aclara de parte de quién va.\n\nRequiere las **dos** cosas:\n\n1. Activarlo en el documento con `meta: { \"sendViaWhatsapp\": true }` — en `POST /api/v1/documents`, en `POST /api/v1/templates/{templateId}/generate-document` o dejándolo activado en la plantilla desde la interfaz web (los documentos generados lo heredan).\n2. Mandar `phone` en el elemento de `recipients[]` correspondiente, en formato **E.164** (por ejemplo `+5491123456789`). El teléfono es por firmante: en un mismo documento puede haber unos con teléfono y otros sin.\n\nEl aviso es adicional al email cuando ese email está habilitado. Si no hay teléfono o saldo del canal, no se manda el aviso por WhatsApp. Un teléfono con formato inválido puede rechazarse con 400 al crear/actualizar; y si activás el código por WhatsApp, todos los firmantes deben tener teléfono válido antes de enviar.\n\nSe consume **1 crédito por mensaje enviado**. Sólo el **primer** envío usa el canal: los recordatorios automáticos y `POST /api/v1/documents/{id}/resend` van siempre por email, para que el consumo sea predecible.\n\nPodés confirmar que el teléfono quedó guardado porque las respuestas de creación lo devuelven en `recipients[].phone`.\n\n`meta: { \"sendViaSms\": true }` hace lo mismo por SMS, con su propio pool. Es el canal de respaldo: cuesta más y llega peor que WhatsApp — consultá disponibilidad antes de usarlo.\n\n### Agentes de IA (servidor MCP)\n\nEsta plataforma expone un **servidor MCP** (Model Context Protocol) para agentes de IA en `https://electronica.identik.me/api/mcp` — transporte Streamable HTTP, sin estado, autenticado con el mismo token de API (`Authorization: Bearer api_...`).\n\nConfiguración en Claude Code:\n\n```\nclaude mcp add identik --transport http https://electronica.identik.me/api/mcp --header \"Authorization: Bearer api_...\"\n```\n\nHerramientas: `listar_plantillas`, `listar_documentos`, `obtener_documento`, `crear_documento_desde_plantilla`, `enviar_documento`, `reenviar_invitacion`, `descargar_documento_firmado`, `descargar_constancia`, `traza_auditoria`, `validar_pdf`, `estado_cuenta`. `crear_documento_desde_plantilla` acepta `telefono` por firmante y `avisar_por_whatsapp` a nivel documento, y `estado_cuenta` informa los saldos de los cuatro pools. Funciona igual con el Agents SDK de OpenAI, Gemini CLI, Cursor y cualquier cliente MCP. Manifiesto en `/.well-known/mcp.json`; guía para agentes en `/llms.txt`.\n\n### Verificación biométrica (DNI + prueba de vida)\n\nVerificación reforzada de identidad, opcional y **por documento**: antes de poder firmar, el firmante fotografía su DNI y realiza una prueba de vida facial desde su teléfono. Se activa mandando `meta: { \"requireBiometricId\": true }` en:\n\n- `POST /api/v1/documents` — documentos creados desde cero;\n- `POST /api/v1/templates/{templateId}/generate-document` — documentos generados desde plantilla. También podés dejarla activada en la plantilla desde la interfaz web y los documentos generados la heredan; el `meta` de la llamada siempre puede sobrescribirla en ambos sentidos.\n\nConsume **créditos de verificación** prepagos — un pool a nivel de cuenta, separado del de documentos, que carga Identik cuando comprás un paquete. Cada verificación descuenta 1 crédito. Si la cuenta se queda sin créditos, el firmante firma normalmente (nunca queda bloqueado).\n\n**Fijá la identidad esperada desde la API** (recomendado): en cada elemento de `recipients[]` podés mandar `idDocumentNumber` (y opcionalmente `idDocumentType` + `idDocumentCountry`, por defecto DNI argentino) junto con `firstName` y `lastName` — el nombre y apellido **por separado**, que es como los valida el proveedor. La verificación se hace **contra esos datos**: el documento que presente el firmante tiene que coincidir. Si no los mandás, el firmante los carga él mismo antes de la verificación.\n\nEl circuito de integración no cambia: mismo `signingUrl`, mismos webhooks, misma descarga. La evidencia de la verificación (fecha y hora, tipo y número de documento, y la referencia del proveedor) queda asentada en la constancia de firma del documento.\n\n### Código por WhatsApp (firma electrónica avanzada)\n\nSegundo factor opcional y **por documento**, más simple que la biometría: antes de completar la firma, cada firmante recibe un **código de un solo uso por WhatsApp** al teléfono que vos declarás y tiene que ingresarlo. Se activa con `meta: { \"requireWhatsappOtp\": true }` en `POST /api/v1/documents` y en `POST /api/v1/templates/{templateId}/generate-document` (también se hereda de la plantilla).\n\n- **El teléfono es obligatorio**: con esta opción activa, `POST /documents/{id}/send` rechaza (400) si algún firmante no tiene `phone` en E.164 (`+5491123456789`). El número lo declara quien envía — el firmante nunca elige el suyo; eso es lo que hace «avanzada» a la validación.\n- Es el mismo campo `phone` que usa el aviso por WhatsApp: si activás las dos opciones, el teléfono se carga una sola vez.\n- Consume **1 crédito de WhatsApp por firmante** — la misma bolsa que el aviso con el link (`whatsapp` en `estado_cuenta` del MCP) —, cobrado cuando sale el primer código; los reenvíos no cobran. Sin saldo, el firmante firma normalmente (nunca queda bloqueado).\n- No es compatible con `allowDictateNextSigner`.\n\nEn la constancia de firma, el firmante que validó el código figura con autenticación **«Firma electrónica avanzada»** (fecha y hora de la validación y teléfono enmascarado). El resto del circuito no cambia.\n\nMás información: https://identik.me"},"servers":[{"url":"https://electronica.identik.me"}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","in":"header","name":"Authorization"}}},"security":[{"authorization":[]}]}