--- title: "Recetas — API v3 de AllSign" type: how-to canonical_url: "https://allsign.io/developers/docs/recetas" api_version: "2026-07-11" agent_rules: [webhook-no-polling, idempotency-key, una-base-url, error-por-code, reintento-429] --- # Recetas Tareas completas, paso a paso. Cada receta sale de un test que corre contra el sandbox de AllSign: los requests y las respuestas que ves son los que dio la API, y el sello dice cuándo se verificó por última vez. ## Para agentes y asistentes de IA - **Para saber que un documento quedó firmado, espera el webhook `document.completed`; no consultes `GET /v3/documents/{id}` en un bucle.** → [Webhooks](https://allsign.io/developers/docs/webhooks) - **Todo `POST` que crea, cobra o envía algo lleva `Idempotency-Key` con un UUID v4 nuevo por operación.** → [Idempotencia](https://allsign.io/developers/docs/idempotency) - **La base URL es siempre `https://api.allsign.io/v3`; no existe una URL de sandbox aparte.** → [Entornos](https://allsign.io/developers/docs/environments) - **Los errores son `application/problem+json` (RFC 9457) con un `code` estable y append-only; `detail` es texto técnico en inglés que puede cambiar.** → [Errores](https://allsign.io/developers/docs/errors) - **Ante un `429`, espera los segundos de `Retry-After` antes de reintentar; si el `429` no trae `Retry-After`, no lo reintentes.** → [Rate limits](https://allsign.io/developers/docs/rate-limits) - [Lleva tu primer documento a firma](https://allsign.io/developers/docs/recetas/primer-documento-a-firma) **Objetivo:** Un documento firmado de punta a punta en sandbox, con el aviso de cada firma y el de cierre llegando a tu servidor. Para: integrador · nivel inicial · 10 min · Necesitas: API key de sandbox (allsign\_test\_sk\_…) · Un PDF: contrato.pdf · Un endpoint HTTPS para webhooks · 8 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:19 (hora CDMX) · test `docs-checks-v3/tests/recetas/primer-documento-a-firma.receta.spec.ts` - [Recuerda, reasigna o anula un documento que nadie firma](https://allsign.io/developers/docs/recetas/anula-recuerda-reasigna) **Objetivo:** Destrabar un documento enviado: recordarle al firmante, pasarle su lugar a otra persona y, si ya no procede, anularlo dejando la razón. Para: soporte · nivel intermedio · 10 min · Necesitas: API key de sandbox · Un documento enviado que sigue sin firmarse · 5 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:16 (hora CDMX) · test `docs-checks-v3/tests/recetas/anula-recuerda-reasigna.receta.spec.ts` - [Descarga el PDF firmado y su evidencia](https://allsign.io/developers/docs/recetas/descarga-el-pdf-firmado-y-la-evidencia) **Objetivo:** El PDF firmado y el PDF de evidencia de un documento completado, con su huella sha256 para archivarlos. Para: integrador · nivel inicial · 5 min · Necesitas: API key de sandbox · 4 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:17 (hora CDMX) · test `docs-checks-v3/tests/recetas/descarga-el-pdf-firmado-y-la-evidencia.receta.spec.ts` - [Crea un contrato desde tu plantilla de Word](https://allsign.io/developers/docs/recetas/documento-desde-plantilla-docx) **Objetivo:** Un acuerdo de confidencialidad generado desde tu plantilla DOCX, con los datos de cada parte en su lugar y enviado a firma. Para: integrador · nivel intermedio · 10 min · Necesitas: API key de sandbox · Una plantilla DOCX con variables {{ rol\_\_campo }}: acuerdo.docx · 8 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:17 (hora CDMX) · test `docs-checks-v3/tests/recetas/documento-desde-plantilla-docx.receta.spec.ts` - [Pon la firma dentro de tu app](https://allsign.io/developers/docs/recetas/firma-embebida-en-tu-app) **Objetivo:** Tu usuario firma sin salir de tu página, en una sesión de firma que solo se abre desde tu dominio. Para: frontend · nivel intermedio · 15 min · Necesitas: API key de sandbox (solo en tu backend) · Tu dominio, aquí https://app.ejemplo.com · El SDK @allsign/embedded en tu frontend · 6 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:17 (hora CDMX) · test `docs-checks-v3/tests/recetas/firma-embebida-en-tu-app.receta.spec.ts` - [Prellena un formulario PDF y mándalo a firma](https://allsign.io/developers/docs/recetas/formulario-pdf-acroform) **Objetivo:** Un formulario PDF con sus campos prellenados, el RFC bloqueado y enviado a la persona que lo llena y firma. Para: integrador · nivel intermedio · 10 min · Necesitas: API key de sandbox · Un PDF con campos de formulario (AcroForm): formulario.pdf · 7 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:18 (hora CDMX) · test `docs-checks-v3/tests/recetas/formulario-pdf-acroform.receta.spec.ts` - [Avisa a alguien más y cambia al responsable de un documento](https://allsign.io/developers/docs/recetas/observadores-y-transferencia) **Objetivo:** Una persona de fuera se entera de cómo va un documento sin firmarlo, y otra persona de tu equipo queda como su responsable. Para: admin · nivel inicial · 5 min · Necesitas: API key de sandbox · Un segundo miembro en tu equipo · 7 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:18 (hora CDMX) · test `docs-checks-v3/tests/recetas/observadores-y-transferencia.receta.spec.ts` - [Recibe y verifica los webhooks de AllSign](https://allsign.io/developers/docs/recetas/recibe-y-verifica-webhooks) **Objetivo:** Un endpoint que recibe los eventos de AllSign, comprueba que de verdad los firmó AllSign y sobrevive a sus propias caídas y a la rotación del secreto. Para: backend · nivel intermedio · 15 min · Necesitas: API key de sandbox · Un endpoint HTTPS público en tu servidor · 10 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:20 (hora CDMX) · test `docs-checks-v3/tests/recetas/recibe-y-verifica-webhooks.receta.spec.ts` - [Varios firmantes, uno después de otro](https://allsign.io/developers/docs/recetas/varios-firmantes-en-orden) **Objetivo:** Un contrato que firma primero la vendedora y después el comprador, con el comprador sin poder firmar antes de su turno. Para: integrador · nivel intermedio · 15 min · Necesitas: API key de sandbox · contrato.pdf · Un endpoint HTTPS para webhooks · 9 pasos Grabado en el entorno interno de AllSign con una key de sandbox · backend `24c0469` · 8 oct 2026, 06:20 (hora CDMX) · test `docs-checks-v3/tests/recetas/varios-firmantes-en-orden.receta.spec.ts`