Documentos
Crie documentos para assinatura eletrônica, atribua signatários a eles e gerencie seu ciclo de vida. Base: /api/documents. Todas as rotas exigem Bearer.
O objeto Firmante
Cada documento leva um array endorsementInput com um ou mais signatários:
| Campo | Tipo | Obrig. | Descrição |
|---|---|---|---|
firstName | string | ✔ | Nomes do signatário. |
lastName | string | ✔ | Sobrenomes. |
identification | string | ✔ | Número do documento de identidade. |
identificationKind | string | ✔ | Tipo de documento (ex. CC, CE, PAS). |
kindPerson | enum | ✔ | "Persona Natural" ou "Persona Juridica". |
email | string | ✔ | E-mail do signatário (canal de notificação). |
cellphone | string | ✔ | Celular com código de país (ex. +57...). |
country | string | ✔ | ObjectId do país (ver Catálogos). |
city | string | — | ObjectId da cidade. |
principalSigner | boolean | ✔ | true para o signatário principal. |
iteration | number | ✔ | Ordem de assinatura (1, 2, 3… para assinatura sequencial). |
typeSign | string | — | Papel do signatário ("Firmante" por padrão). |
biometricValid | boolean | — | Validação biométrica avançada. Add-on pago. |
basicIdentityValid | boolean | — | Validação de documento contra o rosto. Add-on pago. |
consultRegistry | boolean | — | Consulta na Registraduría. Add-on pago. |
reqDocument | boolean | — | Exige anexar documento de identidade. |
businessName | string | — | Razão social (pessoa jurídica). |
biometricValid, basicIdentityValid e consultRegistry são funcionalidades adicionais que são cobradas separadamente e devem ser habilitadas para a sua organização. Para ativá-las, escreva para nós em app.docublock.co/organizacion ou no WhatsApp +57 311 806 8275. Se não estiverem habilitadas, são ignoradas.Criar documento a partir de PDF
/api/documents/create-pdf-base64BearerCampos do corpo:
| Campo | Tipo | Obrig. | Descrição |
|---|---|---|---|
name | string | ✔ | Nome do documento. |
baseFile | string | ✔ | Conteúdo do PDF em base64. |
filename | string | — | Nome do arquivo (ex. contrato.pdf). |
endorsementInput | Firmante[] | ✔ | Lista de signatários. |
signatureMode | enum | — | "single" ou "independent". |
template | string | — | ObjectId do modelo associado. |
directory | string | — | ObjectId do diretório de destino. |
relatedInfo | object | — | Metadados livres para a sua integração. |
{
"name": "Contrato de arrendamiento #1024",
"baseFile": "JVBERi0xLjcKJ...==",
"filename": "contrato-1024.pdf",
"signatureMode": "single",
"endorsementInput": [
{
"firstName": "María",
"lastName": "Ríos",
"identification": "1019234567",
"identificationKind": "CC",
"kindPerson": "Persona Natural",
"email": "maria@ejemplo.com",
"cellphone": "+573001112233",
"country": "661a1fb2a0e9e20423fe6cc8",
"principalSigner": true,
"iteration": 1,
"biometricValid": true
}
]
}Resposta 201: o documento criado (com _id, code, path, signatários e estado inicial). A Docublock dispara automaticamente a solicitação de assinatura para cada signatário.
400 com a mensagem correspondente.Criar documento a partir de Word
/api/documents/create-word-base64BearerIgual ao anterior, mas baseFile é um .docx/.doc em base64; a Docublock o converte em PDF antes de assinar.
Criar um bloco
/api/documents/create-blocks-base64BearerAgrupa vários documentos sob um mesmo fluxo de assinatura. Requer o array filesBlocks (cada elemento: { name, baseFile, fileType, filename }). Resposta: { blockId, documents: [{ id, name, code, path }] }.
Criação em massa
/api/documents/create-massive-pdf-base64Bearer/api/documents/create-massive-word-base64Bearer/api/documents/create-massive-blocks-base64BearerCorpo: { "documents": [ ... ] } (ou { "blocks": [ ... ] }). Resposta: { total, created, failed, results, errors }.
Listar documentos
/api/documents/get-allBearerCorpo: filtros opcionais + limit, page, order. A organização é aplicada automaticamente. Resposta: { total, totalPages, documents: [...] }.
Obter um documento
/api/documents/:idBearerRetorna o documento completo: estado de assinatura, signatários, modelo, versões, certificado e trilha de auditoria. 404 se não existir.
Atualizar e versionar
/api/documents/:idBearer/api/documents/add-versions/:idBearerReenviar solicitação de assinatura
/api/documents/resend-endorsement-documentBearerCorpo: { "idDocument": "<ObjectId>", "idSigner": "<ObjectId>" }. Reenvia a notificação de assinatura ao signatário indicado.
