> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas.md).

# Seguimiento de pedidos de tarjetas

D1 envía actualizaciones en tiempo real sobre la producción y el envío de tarjetas físicas al backend de su emisor.

Use notificaciones (webhooks), estado a demanda o ambos.

### Flujo a alto nivel

<figure><img src="/files/501daffc5d7d896d913d2212f791e585a61b3112" alt=""><figcaption><p>Flujo a alto nivel de los eventos de producción y envío de tarjetas físicas.</p></figcaption></figure>

### Transiciones de estado

Este diagrama muestra las transiciones típicas desde la solicitud hasta el envío.

También incluye rutas de excepción y en espera.

<figure><img src="/files/7628e2d55e29d8501462ff99974ce0c0944df140" alt=""><figcaption><p>Transiciones de estado que incluyen excepciones y estados en espera.</p></figcaption></figure>

<details>

<summary>Más diagramas</summary>

<figure><img src="/files/506c2514068d55f82930ac4e0f2c6094ccd10d34" alt=""><figcaption><p>Vista operativa de los pasos de emisión y cambios de estado.</p></figcaption></figure>

<figure><img src="/files/4b67ee2bab64ff20e62a1933fe2161c63cc18565" alt=""><figcaption><p>Diagrama de secuencia para notificaciones y cambios de estado durante la emisión de tarjetas físicas.</p></figcaption></figure>

</details>

### Cómo funciona

Use uno o ambos enfoques.

{% tabs %}
{% tab title="Notificaciones (recomendado)" %}

* Reciba notificaciones por cada paso de producción y actualización de envío.
* Gestione la entrega al menos una vez. Espere reintentos y duplicados.
* Implemente el endpoint de callback definido en [Notificaciones de backend](/central-issuance/es/integrar-notificaciones-de-d1/notificaciones-de-backend.md).
  {% endtab %}

{% tab title="A demanda" %}

* Consulte el estado actual de producción/envío en cualquier momento.
* Vea [Rastrear pedidos a demanda](/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas/seguimiento-de-pedidos-bajo-demanda.md).
  {% endtab %}
  {% endtabs %}

### APIs requeridas

<table><thead><tr><th width="140.79998779296875">API</th><th width="180.79998779296875">Entrante/Saliente</th><th>Descripción</th></tr></thead><tbody><tr><td><a href="/pages/f23ada62984c0b5d99019917a8a5192925fcfabe#post-notifications-d1-v2-issuers-issuerid-cards">Notificaciones</a></td><td>Emisor &#x3C;- Thales D1</td><td>Reciba notificaciones para la <code>PRODUCE</code> operación.</td></tr></tbody></table>

### Contenido de la API

Las notificaciones y las respuestas a demanda utilizan el mismo objeto de operación.

Pueden incluir:

<table><thead><tr><th width="153.5999755859375">Campo</th><th width="420.7999267578125">Descripción</th><th>Presencia</th></tr></thead><tbody><tr><td><code>operationId</code></td><td>Identificador único para la instancia de la operación. Úselo para desduplicar y correlacionar.</td><td>Requerido</td></tr><tr><td><code>operation</code></td><td>Tipo de operación. Siempre <code>PRODUCE</code> para el seguimiento de la emisión de tarjetas físicas.</td><td>Requerido</td></tr><tr><td><code>status</code></td><td>Estado de la operación: <code>PENDIENTE</code>, <code>EXITOSO</code>, o <code>FALLIDO</code>.</td><td>Requerido</td></tr><tr><td><code>startTime</code></td><td>Marca de tiempo ISO 8601 cuando la operación comenzó.</td><td>Requerido</td></tr><tr><td><code>endTime</code></td><td>Marca de tiempo ISO 8601 cuando la operación se completó.</td><td>Condicional</td></tr><tr><td><code>cardId</code></td><td>Identificador interno de la tarjeta en D1.</td><td>Requerido</td></tr><tr><td><code>details</code></td><td><p>Carga útil específica de la emisión.</p><p>Vea <a href="/spaces/r0HenlpQHEC2HIv7EcgY/pages/fa2c17202aed4c8f2188ce88f500978641414313">Rastrear producción</a> y <a href="/spaces/r0HenlpQHEC2HIv7EcgY/pages/cf1a76dcaac8da46fd7467e832575d59a419086d">Rastrear envío</a>.</p></td><td>Requerido</td></tr><tr><td><code>errorCode</code></td><td>Causa de fallo legible por máquina.</td><td>Condicional</td></tr><tr><td><code>error</code></td><td>Descripción corta legible por humanos del fallo.</td><td>Condicional</td></tr><tr><td><code>inputFileName</code></td><td>Nombre del archivo que contiene las solicitudes de emisión de tarjetas.</td><td>Condicional</td></tr><tr><td><code>issuerRequestId</code></td><td>Identificador de correlación proporcionado por el backend de su emisor.</td><td>Condicional</td></tr></tbody></table>

Nivel superior `status` es el estado de la operación.

`details.status` es el estado de la emisión de la tarjeta física.

### Entrega e idempotencia

Las notificaciones pueden llegar fuera de orden y más de una vez.

* Use `operationId` para desduplicar y correlacionar eventos.
* Use `startTime`/`endTime` para decidir qué evento es el más reciente.
* Use la API a demanda para reconciliar el estado si detecta brechas.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.