{"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":"No aplica en esta plataforma."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"No aplica en esta plataforma (verificación biométrica sólo en firma electrónica)."},"idDocumentType":{"type":"string","maxLength":32,"description":"No aplica en esta plataforma."},"requireBiometricId":{"type":"boolean","description":"No aplica en esta plataforma."},"firstName":{"type":"string","maxLength":255,"description":"No aplica en esta plataforma."},"lastName":{"type":"string","maxLength":255,"description":"No aplica en esta plataforma."}},"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":"No aplica en esta plataforma: la identidad del firmante ya está acreditada por su certificado de firma digital. Dejalo en `false`."},"requireRepresentationCheck":{"type":"boolean","description":"Firma en representación (sólo firma digital): los firmantes que traen `representacion` deben acreditar su personería para poder firmar. El emisor indica la sociedad (CUIT); el propio firmante sube desde su link la documentación societaria que lo habilita, Identik la analiza y compara su DNI y nombre con la nómina, y recién acreditado presta la declaración jurada y firma. `/send` no se bloquea; la barrera es al firmar. La constancia deja asentada la verificación."},"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":"No aplica en esta plataforma: la identidad del firmante ya está acreditada por su certificado de firma digital. Dejalo en `false`."},"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":"No aplica en esta plataforma."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"No aplica en esta plataforma (verificación biométrica sólo en firma electrónica)."},"idDocumentType":{"type":"string","maxLength":32,"description":"No aplica en esta plataforma."},"requireBiometricId":{"type":"boolean","description":"No aplica en esta plataforma."},"firstName":{"type":"string","maxLength":255,"description":"No aplica en esta plataforma."},"lastName":{"type":"string","maxLength":255,"description":"No aplica en esta plataforma."}},"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":"Firma en representación (sólo firma digital): los firmantes que traen `representacion` deben acreditar su personería para poder firmar. El emisor indica la sociedad (CUIT); el propio firmante sube desde su link la documentación societaria que lo habilita, Identik la analiza y compara su DNI y nombre con la nómina, y recién acreditado presta la declaración jurada y firma. `/send` no se bloquea; la barrera es al firmar. La constancia deja asentada la verificación."}}},"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":"No aplica en esta plataforma."},"idDocumentNumber":{"type":"string","maxLength":32,"description":"No aplica en esta plataforma (verificación biométrica sólo en firma electrónica)."},"idDocumentType":{"type":"string","maxLength":32,"description":"No aplica en esta plataforma."},"requireBiometricId":{"type":"boolean","description":"No aplica en esta plataforma."},"firstName":{"type":"string","maxLength":255,"description":"No aplica en esta plataforma."},"lastName":{"type":"string","maxLength":255,"description":"No aplica en esta plataforma."},"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":"No aplica en esta plataforma: la identidad del firmante ya está acreditada por su certificado de firma digital. Dejalo en `false`."},"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":"No aplica en esta plataforma: la identidad del firmante ya está acreditada por su certificado de firma digital. Dejalo en `false`."},"requireRepresentationCheck":{"type":"boolean","description":"Firma en representación (sólo firma digital): los firmantes que traen `representacion` deben acreditar su personería para poder firmar. El emisor indica la sociedad (CUIT); el propio firmante sube desde su link la documentación societaria que lo habilita, Identik la analiza y compara su DNI y nombre con la nómina, y recién acreditado presta la declaración jurada y firma. `/send` no se bloquea; la barrera es al firmar. La constancia deja asentada la verificación."}}},"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 **no puede ir dentro del PDF firmado** (agregarle páginas invalidaría la firma digital cualificada): también se adjunta al correo de finalización cuando está habilitado. Este endpoint es la forma de obtenerla desde una integración — guardala junto con el PDF firmado.\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."}}}}},"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### CUIL del firmante (obligatorio en esta plataforma)\n\nEn esta plataforma cada firmante firma con su **certificado de firma digital**, emitido a su CUIL por un certificador licenciado. Mandá `cuil` en cada elemento de `recipients[]` (por ejemplo `\"20-33111349-3\"`) al crear el documento o al generarlo desde plantilla. Si el titular todavía no tiene certificado, la plataforma lo guía para emitirlo (trámite 100% remoto) antes de firmar.\n\n### Firma en representación de una sociedad (verificación de personería)\n\nCuando un firmante firma **en nombre de una persona jurídica** (una póliza, un contrato, una propuesta), podés pedirle a Identik que verifique que está facultado: mandá `meta: { \"requireRepresentationCheck\": true }` y, en ese firmante, `representacion: { \"cuit\": \"30-XXXXXXXX-X\" }` con el CUIT de la sociedad (y opcionalmente `razonSocial`). Si la sociedad no está en el catálogo de la organización (**Ajustes → Sociedades**) se crea con ese CUIT. **La documentación la aporta el propio firmante** desde su link de firma (acta de designación, poder, estatuto, constancia del registro): Identik verifica que sea un instrumento admisible y genuino (formalidades: libro y folio, inscripción, escribano, código de verificación; metadatos del PDF; cruce con el Boletín Oficial), extrae la nómina de autoridades y apoderados y compara el DNI del firmante —embebido en su CUIL— y su nombre con esa nómina; recién acreditado, el firmante presta una declaración jurada y puede firmar. Un instrumento dudoso queda en `NEEDS_REVIEW` hasta que el emisor lo confirma. El resultado vuelve en `recipients[].representacion` (`status`: `VERIFIED`, `VERIFIED_BY_NAME`, `NEEDS_REVIEW`, `FAILED`, `PENDING`; `cargo`; `motivo`); al crear el documento suele ser `FAILED`/`PENDING` porque el firmante todavía no subió nada, y pasa a `VERIFIED` cuando lo hace (consultalo con `GET /documents/{id}` o esperá el webhook de firma). `/send` no se bloquea por eso: la barrera está al firmar. La constancia deja asentada la verificación (sociedad, cargo, documento, páginas, quién aportó la documentación). Requiere el módulo habilitado para la organización; los firmantes sin `representacion` firman por sí como siempre, y nada cambia para quien no manda estos campos. Es una verificación de correspondencia contra la documentación aportada: no certifica la autenticidad de los instrumentos ni sustituye la verificación registral o notarial.\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 **no va dentro del PDF firmado**: agregarle páginas invalidaría la firma digital cualificada. Viaja como archivo **adjunto separado** en el correo de finalización (`Constancia de firma.pdf`) y, para integraciones, se descarga con `GET /api/v2/document/{documentId}/certificate` (bytes `application/pdf`, mismo token; acepta el `id` numérico o el `envelopeId`). Se genera desde la evidencia guardada e incluye el hash SHA-256 del PDF firmado, así que podés archivar los dos archivos juntos al recibir `DOCUMENT_COMPLETED`. DRAFT/PENDING responde `409`; REJECTED permite constancia de rechazo y no representa firmas completas.\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 **30 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| 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://firma-dev.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://firma-dev.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\nMás información: https://identik.me"},"servers":[{"url":"https://firma-dev.identik.me"}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","in":"header","name":"Authorization"}}},"security":[{"authorization":[]}]}