> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plumaa.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentos

> Aprende sobre cómo Plumaa ID gestiona documentos

Los documentos son la base de la plataforma. Debido a que la legislación hace referencia a *mensajes de datos*, utilizamos el término *documento* para referirnos a cualquier tipo de mensaje de datos que pueda ser firmado electrónicamente.

<Check>
  Todos los documentos de la plataforma obtienen certificados de conservación en la blockchain de forma gratuita a través del [testigo del sistema de información](/advanced/technical/information-system/witness).
</Check>

## Tipos de documentos

La plataforma soporta 4 tipos de mensajes de datos:

* **Textos**: Textos simples, ideal para aceptación de términos y condiciones o consultas a instituciones de información crediticia.
* **PDFs**: Documentos de formato libre en PDF, pueden ser cualquier cosa que el equipo legal de la empresa requiera.
* **Pagarés**: Títulos de crédito especializados en deuda, incluyen una representación en texto del derecho de pago y son tokenizados en automático.
* **JSON**: Mensajes de datos estructurados en formato JSON, ideal para integraciones con sistemas de información.

## Conservación de mensajes de datos

De acuerdo con la [NOM-151](/advanced/technical/electronic-signature/trust-service-providers#certificados-de-nom-151), los requisitos que se deben de observar para la conservación de mensajes de datos pueden ser cumplidos a través de las siguientes opciones:

* **Conservación en blockchain**: Los mensajes de datos son conservados en la blockchain de forma inmutable y con un *timestamp* gracias al [testigo del sistema de información](/advanced/technical/information-system/witness).
* **Conservación en NOM-151 agrupada**: Los mensajes de datos son agrupados en un [árbol de Merkle](/advanced/technical/electronic-signature/data-message-conservation#merkle-tree) para reducir los costos de certificación. El conjunto recibe un *timestamp* de un proveedor de servicios de certificación.
* **Conservación en NOM-151 individual**: Los mensajes de datos son certificados de forma individual por un [proveedor de servicios de certificación](/advanced/technical/electronic-signature/trust-service-providers).

El certificado en Blockchain está incluido de forma gratuita en todos los documentos, mientras que las certificaciones del PSC son limitadas por [créditos en la plataforma](/advanced/organizations#cuotas-de-documentos).

Los usuarios pueden revisar su disponibilidad de cuotas para certificados NOM-151 en la sección de configuración en su [organización](/advanced/organizations) en la aplicación web.

<Frame>
  <img src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/quotas.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=97c4287c5b2b20722fb9f203c72c5b2a" alt="Cuotas de documentos" width="2544" height="1156" data-path="images/advanced/documents/quotas.png" />
</Frame>

<Note>Cada organización cuenta con 5 documentos con certificado NOM-151 de cortesía, y 25 documentos con certificación en blockchain.</Note>

## Ciclo de vida de un documento

El firmado electrónico en Plumaa ID se gestiona a través de un ciclo de vida estandarizado. Este ciclo de vida permite que el documento obtenga diversas fuentes de confianza desde su creación hasta su potencial tokenización.

<Frame>
  ```mermaid theme={null}
  stateDiagram-v2
      D: Draft
      W: Esperando firmas
      S: Firmado
      T: Tokenizado

      [*] --> D: Crear
      [*] --> W: Crear y enviar invitaciones
      D --> W: Enviar invitaciones
      W --> W: Firma/Rechazo (0 < n - 1)
      W --> S: Firma/Rechazo (n)
      S --> T: Tokenizar
      T --> T: Endoso
      T --> [*]: Destrucción
  ```
</Frame>

### Estados

* **Draft (D)**: Documento creado pero no enviado.
* **Esperando firmas (W)**: Documento enviado y esperando firmas.
* **Firmado (S)**: Documento firmado por todas las partes.
* **Tokenizado (T)**: Documento tokenizado y listo para ser endosado.

## Creación de documentos

Los documentos en Plumaa ID pueden ser creados desde la interfaz web o a través de la API. El documento puede ser creado como un draft, lo que evitará que los invitados reciban notificaciones hasta que el documento esté listo para ser firmado.

<Steps>
  <Step title="Crear documento">
    En la sección de documentos de tu organización, haz clic en el botón “Crear documento”.

    <Frame>
      <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/create-document.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=c12c64ab8fea45d6b9c14e8c3acfe7ea" data-path="images/advanced/documents/create-document.png" />
    </Frame>
  </Step>

  <Step title="Campos a rellenar">
    Al elaborar un documento, es esencial llenar los campos necesarios, los cuales pueden variar según el tipo de documento o su propósito.

    * **Nombre del documento**: es indispensable que le asignes un nombre a tu documento, para que puedas tener un mejor control al buscarlo en el futuro.
    * **Organización**: Si tienes más de una organización, puedes seleccionar desde cuál se emitirá el documento.
    * **Firmantes**: Selecciona a los firmantes de forma simultánea, pero también tienes la opción de agregarlos más adelante.
    * **Draft**: Si lo deseas, activa la opción de borrador para que otros miembros de tu organización puedan revisarlo.
    * **Selección de documento**: Recuerda que depende del tipo de documento que hayas elegido te pedirá:

    <Tabs>
      <Tab title="PDF">
        Adjuntar el archivo seleccionado.

        <Frame>
          <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/pdf.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=66cc7ab98c6a3d0bd62de80a95198d20" data-path="images/advanced/documents/pdf.png" />
        </Frame>
      </Tab>

      <Tab title="Textos">
        Introduce el texto que deseas redactar.

        <Frame>
          <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/texts.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=36b36d5e6702c885f1834a06ace0fe72" data-path="images/advanced/documents/texts.png" />
        </Frame>
      </Tab>

      <Tab title="Pagarés">
        Al crear un pagaré, deberás completar los siguientes elementos:

        * Moneda: selecciona entre MXN o USD.
        * Cantidad: ingresa el monto.
        * Selecciona al "Deudor".
        * Selecciona al "Acreedor".
        * Muestra tu geolocalización.

        <Frame>
          <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/ious.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=7675231af67997f0e68c93cea575bfc5" data-path="images/advanced/documents/ious.png" />
        </Frame>
      </Tab>

      <Tab title="JSONs">
        Integra el mensaje de datos.

        <Frame>
          <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/json.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=482f3be10bf92baea668758135f7d573" data-path="images/advanced/documents/json.png" />
        </Frame>
      </Tab>
    </Tabs>
  </Step>
</Steps>

### Invitaciones

Los documentos podrán añadir nuevos invitados en cualquier momento. Los invitados recibirán una notificación y verán la invitación disponible en la aplicación móvil hasta que el documento esté listo para ser firmado.

### Invitaciones de firmado

Las invitaciones son vínculos entre el usuario y el documento. Los usuarios pueden firmar el documento a través de la aplicación móvil. Además, son una pieza fundamental en el [ciclo de vida de un documento](#ciclo-de-vida-de-un-documento).

#### ¿Cómo invitar a firmar a un usuario?

<Tabs>
  <Tab title="Antes de crear un documento">
    Al crear un documento, puedes invitar a los usuarios que desees a firmarlo.

    <Frame>
      <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/invite-before-create.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=67a4e81c9f8e74a69a288b443410655b" data-path="images/advanced/documents/invite-before-create.png" />
    </Frame>
  </Tab>

  <Tab title="Después de crear el documento">
    Recuerda que, en este momento, tu documento puede estar en estado de borrador (Draft), lo que te permite añadir nuevos firmantes al documento si no los habías agregado anteriormente.

    <Frame>
      <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/invite-after-create.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=d9e45ad7fcc893a6d348dbba47a2a905" data-path="images/advanced/documents/invite-after-create.png" />
    </Frame>
  </Tab>

  <Tab title="Compartir QR">
    Hay una tercera forma de invitar a tus usuarios a firmar: mediante una URL o un código QR. Ambos métodos los llevarán directamente al documento para que puedan firmar.

    <Frame>
      <img width="100%" noZoom src="https://mintcdn.com/plumaa/eICWheQnGC9o2c7H/images/advanced/documents/invite-create-qr.png?fit=max&auto=format&n=eICWheQnGC9o2c7H&q=85&s=84bca738e9fadbbdac0f7d7e5971f27e" data-path="images/advanced/documents/invite-create-qr.png" />
    </Frame>
  </Tab>
</Tabs>

### Finalización

Una vez que todos los invitados hayan firmado el documento el documento se marcará como finalizado y no procesará más firmas.

### Tokenización

En algunos casos, los documentos firmados pueden ser convertidos en piezas digitales para su posterior endoso en el sistema de información de Plumaa ID.

Las organizaciones deberán especificar a un propietario inicial que podrá reclamar el endosable digital. Este propietario podrá transferir la pieza digital a otros propietarios a través de la aplicación móvil.

<Tip>Revisa la guía de [tokenización](/advanced/tokenization).</Tip>