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 seria status code 204