---
title: "Creación idempotente de trabajos de impresión"
description: "Evita impresiones duplicadas al repetir solicitudes después de un tiempo de espera agotado o un fallo de red."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/es/docs/">Documentación de CloudPrint</a><span aria-hidden="true">/</span><span>Referencia de la API</span></nav>

# Creación idempotente de trabajos de impresión

<p class="docs-lead">Evita impresiones duplicadas al repetir solicitudes después de un tiempo de espera agotado o un fallo de red.</p>

<div class="api-reference-actions"><span><strong>Versión de la API:</strong> v1</span><a href="/docs/api/v1/openapi.json">Descargar OpenAPI v1 en JSON</a><a href="/es/docs/api/v1/explorer/">Abrir el explorador interactivo de la API</a><a href="/es/docs/api/v1/idempotency/index.md">Ver como Markdown</a></div>

## Por qué es necesaria

El tiempo de espera puede agotarse después de que CloudPrint acepte la solicitud. Si creas otro trabajo, el documento podría imprimirse dos veces.

## Cómo definir la clave

Usa una clave estable como `shipment-18451-label-v1`, de hasta 128 caracteres, y conserva la misma para reintentos con el mismo contenido.

## Reglas de reutilización

La misma cuenta, clave y contenido devuelven el resultado original; usar la misma clave con otro contenido devuelve `409 Conflict`.

## Recuperación

Tras un fallo de red, repite la solicitud con la misma clave. Cuando conozcas `print_job_id`, consulta el estado en lugar de crear otro trabajo.

## Documentación relacionada

<div class="docs-card-grid"><a class="docs-card" href="/es/docs/api/v1/print-jobs/create/"><strong>Crear un trabajo de impresión</strong><span>Envía un documento subido a una impresora seleccionada con idempotencia y opciones de impresión explícitas.</span></a>
<a class="docs-card" href="/es/docs/api/v1/errors/"><strong>Errores y reintentos de la API de CloudPrint</strong><span>Gestiona estados HTTP, errores legibles por máquina, límites de solicitudes, trazabilidad y reintentos seguros.</span></a>
<a class="docs-card" href="/es/docs/api/print-jobs/"><strong>Crear y seguir trabajos de impresión</strong><span>Envía un documento a una impresora, evita duplicados y comprueba el resultado físico.</span></a></div>

<nav class="docs-resource-links" aria-label="Siguientes pasos"><a href="https://cloudprint.me/status/">Estado del servicio</a><a href="/es/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Abrir cuenta</a><a href="/docs/legal/privacy/">Política de privacidad</a><a href="/docs/legal/terms/">Términos de uso</a><a href="/docs/legal/payments-and-refunds/">Pagos y reembolsos</a><a href="/docs/legal/data-processing/">Tratamiento de datos</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>