Consultar estatus de firma por firmante en documento
Para poder acceder a todas las propiedades de un documento, así como su lista de versiones y firmantes es necesario obtenerlo mediante su id
, realizando un GET
a /documents/:document_id
, dentro de las propiedades del documento, existe un arreglo llamado signers
donde se podrá ver el estatus por cada firmante, se manejan dos para el documento signer y unsigner.
curl --location --request POST 'https://sandbox.api.cincel.digital/v1/documents'\ --header 'x-api-key: my_secret_key' \ --header 'Content-Type: application/json' \ --data-raw '{ "ok":true, "payload":{ "id":6767, "with_nom151":false, "owner_id":3, "owner_type":"User", "folder_id":null, "name":"inv2", "description":"a", "last_version":"1626762342", "creator_id":3, "advanced_signature_version":"cincel_v1", "autograph_signature_version":"cincel_v1", "created_at":"2021-07-20T01:25:37.031-05:00", "updated_at":"2021-08-04T23:40:56.612-05:00", "status":"partially_signed", "active":true, "validate_signers_3id":false, "blockchain_certs_enabled":false, "signing_stage":1, "organization":null, "files":[ { "id":6425, "document_id":6767, "name":null, "signed_ended_at":"2021-08-04T23:40:56.603-05:00", "status":"signed", "sha256":null, "adv_id":null, "adv_moment":null, "adv_str_end":null, "adv_str_now":null, "adv_str_constance":null, "version":"1626762342", "created_at":"2021-07-20T01:25:42.609-05:00", "updated_at":"2021-08-04T23:40:56.604-05:00", "xml_btc_cert":null, "xml_eth_cert":null, "blockchain_certs_status":"not_requested", "sha256_signed_file":null, "url":"https://s3.amazonaws.com/staging.docs.cincel.digital/Bx6M89eWyCH...", "signed_file_url":"https://s3.amazonaws.com/staging.docs.cincel.digital/frVYqn9SEdiigcyWWfNPMBHa...", "evidence_doc_url":"https://s3.amazonaws.com/staging.docs.cincel.digital/zv4Nq9NR9fGjgyJSmejAGQS.....", "comments":[ ], "signers":[ { "id":7562, "file_id":6425, "signature_type":"autograph", "created_at":"2021-07-20T01:25:55.589-05:00", "updated_at":"2021-07-20T04:00:51.657-05:00", "status":"signed", "email":"hector@example.com", "hash_to_sign":null, "user":{ "user_id":null }, "user_id":null }, { "id":7563, "file_id":6425, "signature_type":"autograph", "created_at":"2021-07-20T01:25:55.616-05:00", "updated_at":"2021-08-04T23:40:55.292-05:00", "status":"unsigned", "email":"pruebas@cincel.digital", "hash_to_sign":null, "user":{ "email":"pruebas@cincel.digital", "name":"Maria", "user_id":3 }, "user_id":3 } ] } ], "invitations":[ { "id":7568, "invite_name":"a", "invite_email":"hector@example.com", "document_id":6767, "status":"accepted", "created_at":"2021-07-20T01:25:55.574-05:00", "updated_at":"2021-07-20T04:00:51.677-05:00", "stage":1, "customer_id_3id":null, "validation_status_3id":"pending", "allowed_signature_types":"all", "requested_documents_status":"pending", "requested_documents_required":false, "validate_kyc":false, "requested_documents":[ ] }, { "id":7569, "invite_name":"maria", "invite_email":"pruebas@cincel.digital", "document_id":6767, "status":"accepted", "created_at":"2021-07-20T01:25:55.598-05:00", "updated_at":"2021-07-20T01:25:55.598-05:00", "stage":1, "customer_id_3id":null, "validation_status_3id":"pending", "allowed_signature_types":"all", "requested_documents_status":"pending", "requested_documents_required":false, "validate_kyc":false, "requested_documents":[ ] } ] }}'