---
title: "Documentos firmados"
description: "Cómo emitir, entregar, mostrar y verificar un documento firmado: una constancia que firmás vos, queda anclada on-chain y cualquiera puede comprobar."
---

> Documentation Index
> Fetch the complete documentation index at: https://sovra-id-docs-1044960690985.us-central1.run.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentos firmados

Un documento firmado es una **credencial sin holder**: vos lo firmás y lo entregás. No hay wallet ni flujo de aceptación. Una sola llamada valida los datos, los firma y ancla la firma **on-chain** (la registra en SovraChain). El resultado es un string, el `credential`, que cualquiera puede verificar contra la cadena sin depender de Sovra.

Si lo que necesitás es una credencial que viva en la wallet de una persona, andá a [Credenciales](https://sovra-id-docs-1044960690985.us-central1.run.app/credenciales/). La comparación entre los dos está en [Documentos firmados](https://sovra-id-docs-1044960690985.us-central1.run.app/conceptos/documentos-firmados/).

## El flujo de punta a punta

```mermaid
sequenceDiagram
    autonumber
    participant S as Tu servidor
    participant API as API de Sovra
    participant C as SovraChain
    participant D as Destinatario

    S->>API: POST /api/v1/issuer/documents
    API-->>S: 201 status signed + credential
    API->>C: Ancla la firma
    API-->>S: Webhook document.status-changed (anchored)
    S-->>D: Entrega el credential o un enlace público
    D->>C: Verifica firma, emisor y anclaje
```

El mismo flujo con `curl`:

```bash
export BASE_URL="https://test-api-sovra.flagonsa.com"
export SOVRA_API_KEY="sovra_sk_..."

# 1. Emitir: valida, firma y responde enseguida con status "signed".
curl -s -X POST "$BASE_URL/api/v1/issuer/documents" \
  -H "Authorization: Bearer $SOVRA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "schema_id": "document_example",
    "claims": { "date": "20-08-2026", "idDocument": 1234567,
                "content": "Contenido de Prueba", "isConfidential": false }
  }'
# Guardá `credential`: ese string ES el documento.

# 2. Esperar el webhook document.status-changed con status "anchored".

# 3. (Opcional) Publicarlo para compartir un enlace. Todo documento nace privado.
curl -s -X PUT -H "Authorization: Bearer $SOVRA_API_KEY" \
  "$BASE_URL/api/v1/issuer/documents/$DOCUMENT_ID/visibility/public"

# 4. El destinatario lo lee sin API key, y lo verifica contra la cadena.
curl -s "$BASE_URL/api/v1/documents/$DOCUMENT_ID"
```

## Cuatro cosas para saber antes de integrar

1. **Guardá `credential`.** Es el documento. El resto de la respuesta se puede volver a pedir.
2. **El anclaje tarda.** La emisión responde con `status: "signed"`, y un verificador rechaza todo lo que no esté `anchored`. Entregá cuando llegue el webhook [`document.status-changed`](https://sovra-id-docs-1044960690985.us-central1.run.app/webhooks/#documentstatus-changed).
3. **Todo documento nace privado.** Volverlo privado cierra el enlace, pero no las copias ya entregadas.
4. **No hay endpoint de verificación, a propósito.** Un veredicto habría que creerlo; una firma se puede comprobar.

## Las páginas de esta sección

- **Crear un esquema** — El molde del documento: sus campos, el diseño de la hoja y cuándo está listo para emitir.
- **Emitir** — La llamada, qué guardar y cómo listar lo emitido.
- **Estados y revocación** — `signed`, `anchored`, `failed` y `revoked`, y cuándo un documento se puede entregar.
- **Visibilidad y entrega** — Publicar, despublicar y las dos formas de hacerle llegar el documento a alguien.
- **Renderizado** — Cómo dibujar la hoja A4 a partir del JSON público.
- **Verificación** — Cómo comprobar un documento contra la cadena, y qué no prueba un resultado válido.
- **Errores de documentos** — Cada código de error, con su causa y su arreglo.
- **Referencia de la API** — Todos los endpoints de documentos firmados.

## Recursos

- [Colección de Postman](https://github.com/sovrahq/id-docs/blob/main/docs/resources/sovra-documentos-firmados.postman_collection.json): importala y configurá `base_url`, `api_key` y `schema_id`. Más detalle en [Emitir](https://sovra-id-docs-1044960690985.us-central1.run.app/documentos/emitir/#colección-de-postman).
- Especificación OpenAPI en vivo: `GET {baseUrl}/openapi/api`.
- Boilerplate de renderizado `document-render-boilerplate`: dibuja la hoja A4 a partir del JSON público. Ver [Renderizado](https://sovra-id-docs-1044960690985.us-central1.run.app/documentos/renderizado/#boilerplate-de-referencia).

Source: https://sovra-id-docs-1044960690985.us-central1.run.app/documentos/index.mdx
