Enviar recordatorios a firmantes
Para obtener el identificador de las invitaciones, hay que obtener las propiedades del documento. Para eso se realiza una petici贸n GET a /documents/:document_id mediante su id.
Ejemplo:
curl --location --request GET 'https://sandbox.api.cincel.digital/v1/documents/0' \ --header 'x-api-key: my_secret_key'Respuesta:
{ "ok": true, "payload": { "id": 21, "owner_id": 2, "owner_type": "User", "folder_id": null, "name": "Contrato 1", "description": "Contrato de adquisici贸n de bienes", "last_version": "1596125425", "created_at": "2020-01-01T00:00:00.000-05:00", "updated_at": "2020-01-01T00:00:00.000-05:00", "status": "signed", "organization": null, "files": [ { "id": 0, "document_id": 0, "name": null, "signed_ended_at": "2020-01-01T00:00:00.000-05:00", "status": "signed", "sha256": "CD4E31AC2288FDAA752E37FAB847E53FC4D0734010F193580C2790C9660D6A90", "version": "1596125425", "created_at": "2020-01-01T00:00:00.000-05:00", "updated_at": "2020-01-01T00:00:00.000-05:00", "url": "URL_DEL_DOCUMENTO_PDF_ORIGINAL", "signed_file_url": "URL_DEL_DOCUMENTO_PDF_FIRMADO", "comments": [ { "title": "Mi comentario", "text": "comentario 1", "created_at": "2020-01-01T00:00:00.000-05:00", "user": { "name": "Juan P茅rez", "email": "example@mail.com" "id": null, } } ], "signers": [ { "id": 0, "file_id": 0, "signature_type": "advanced", "created_at": "2020-01-01T00:00:00.000-05:00", "updated_at": "2020-01-01T00:00:00.000-05:00", "status": "signed", "email": "example@mail.com", "user": { "email": "example2@mail.com", "name": "Pedro P茅rez", "user_id": 0 } } ] } ], "invitations": [ { "id": 71061, "invite_name": "Juan P茅rez", "invite_email": "example@mail.com", "document_id": 0, "status": "accepted", "created_at": "2020-01-01T00:00:00.000-05:00", "updated_at": "2020-01-01T00:00:00.000-05:00", "user": { "user_id": null, "name": "Juan P茅rez", "email": "example@mail.com" }, } ] }}Document['invitations']#
La lista de firmantes que se incluyeron en la creaci贸n del documento esta representada por la propiedad invitations la cual es un arreglo de objetos, con el nombre, correo del firmante invitado y un id de identificador.
Para enviar un recordatorio a un firmante, se manda la siguiente petici贸n POST a https://sandbox.api.cincel.digital/v1/invitations/idInvitation/reminder.
Ejemplo:
curl --location --request GET 'https://sandbox.api.cincel.digital/v1/invitations/71061/reminder' \ --header 'x-api-key: my_secret_key'La respuesta exitosa ser铆a status code 204.