> 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/centro-de-seguimiento.md).
# Centro de seguimiento
Utilice el hub de seguimiento para recibir actualizaciones de producción, envío o devolución de una tarjeta física producida fuera de Thales D1.
### Flujo
1. Solicitud del back-end del emisor para rastrear la tarjeta
2. D1 se conecta con los transportistas para recuperar la información del envío
3. Los transportistas envían estados de envío periódicos
4. D1 da formato y envía los estados al back-end del emisor
### Diagrama de secuencia
### Cómo funciona
{% tabs %}
{% tab title="PRODUCCIÓN" %}
* Utilice `trackingType = PRODUCTION` para recibir una actualización de finalización de producción.
* Thales D1 envía una notificación con `status = SUCCESSFUL`.
* La notificación incluye `details.status = CARD_SHIPPED`.
{% endtab %}
{% tab title="ENVÍO" %}
* Utilice `trackingType = SHIPMENT` para recibir actualizaciones del progreso del envío.
* Thales D1 envía primero una notificación con `status = PENDING`.
* Thales D1 luego envía una o más notificaciones con `status = SUCCESSFUL` a medida que cambian los datos del envío.
* Cuando está disponible, la notificación incluye `details.shipment`. Consulte [Seguimiento del envío](/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas/seguimiento-del-envio.md).
{% endtab %}
{% tab title="DEVOLUCIÓN" %}
* Utilice `trackingType = RETURN` para recibir una actualización de la tarjeta devuelta.
* Thales D1 envía una notificación con `status = SUCCESSFUL`.
* La notificación incluye `details.status = CARD_RETURNED`.
{% endtab %}
{% endtabs %}
### APIs requeridas
| API | Entrada/Salida | Descripción |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------- |
| [Hub de seguimiento](/central-issuance/es/integrar-la-api-de-d1/referencia-de-la-api-de-d1/api-entrante-hacia-d1/api-del-centro-de-seguimiento.md#post-issuers-issuerid-physicalcards-cardid-track) | Emisor -> Thales D1 | Solicite seguimiento de producción, envío o devolución para una tarjeta física. |
| [Notificaciones](/central-issuance/es/integrar-la-api-de-d1/referencia-de-la-api-de-d1/api-saliente-desde-d1/api-de-tarjetas.md#post-notifications-d1-v2-issuers-issuerid-cards) | Emisor <- Thales D1 | Reciba notificaciones para la `STANDALONE_TRACKING` operación. |
### Entradas de la API
Entradas requeridas de la API de D1:
* `issuerId`: Identificador único del emisor.
* `cardId`: Identificador único de la tarjeta.
* `trackingType`: Tipo de seguimiento a realizar. Los valores admitidos son `PRODUCCIÓN`, `ENVÍO`, y `DEVOLUCIÓN`.
#### Ejemplos
**Tipo de seguimiento = PRODUCCIÓN**
```json
{
"trackingType": "PRODUCTION",
"productionSite": "Londres"
}
```
**Tipo de seguimiento = ENVÍO**
```json
{
"trackingType": "SHIPMENT",
"trackingNumber": "61293150000079650811",
"shipmentDate": "2023-01-21T17:32:28Z",
"productionSite": "Londres",
"postalCode": "WC2N5DU",
"countryCode": "GB"
}
```
**Tipo de seguimiento = DEVOLUCIÓN**
```json
{
"trackingType": "RETURN",
"productionSite": "Londres"
}
```
### Seguimiento del resultado
Consuma las notificaciones en la `STANDALONE_TRACKING` operación.
Campos clave:
* `operation`: Siempre `STANDALONE_TRACKING`.
* `status`: Estado de la operación. Los valores son `PENDING`, `SUCCESSFUL`, o `FAILED`.
* `cardId`: Identificador de la tarjeta usado en la solicitud.
* `details.trackingType`: `PRODUCCIÓN`, `ENVÍO`, o `DEVOLUCIÓN`.
* `details.productionSite`: Identificador del sitio de producción, cuando esté disponible.
* `details.status`: Resultado del seguimiento, como `CARD_SHIPPED` o `CARD_RETURNED`.
* `details.shipment`: Detalles del seguimiento del envío para `ENVÍO` actualizaciones. Consulte [Seguimiento del envío](/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas/seguimiento-del-envio.md).
De nivel superior `status` es el estado de la operación.
`details.status` es el estado de seguimiento empresarial.
{% hint style="info" %}
Las notificaciones pueden llegar más de una vez y pueden llegar fuera de orden. Utilice `operationId` para desduplicar eventos.
{% endhint %}
Secuencia de notificaciones por tipo de seguimiento:
| trackingType | Notificaciones enviadas |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PRODUCCIÓN` | Una notificación con `status = SUCCESSFUL` y `details.status = CARD_SHIPPED`. |
| `DEVOLUCIÓN` | Una notificación con `status = SUCCESSFUL` y `details.status = CARD_RETURNED`. |
| `ENVÍO` | Una notificación con `status = PENDING`, luego una o más notificaciones con `status = SUCCESSFUL` a medida que estén disponibles las actualizaciones del envío. |
#### Ejemplos de notificaciones
**Tipo de seguimiento = PRODUCCIÓN**
```json
{
"operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
"operation": "STANDALONE_TRACKING",
"status": "SUCCESSFUL",
"issuerId": "issuer-001",
"cardId": "c-9f8e7d6c5b4a",
"timestamp": "2026-05-22T09:38:00Z",
"details": {
"trackingType": "PRODUCTION",
"productionSite": "PERSO-CENTER-FR-01",
"status": "CARD_SHIPPED"
}
}
```
**Tipo de seguimiento = ENVÍO — primera notificación**
```json
{
"operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
"operation": "STANDALONE_TRACKING",
"status": "PENDING",
"issuerId": "issuer-001",
"cardId": "c-9f8e7d6c5b4a",
"timestamp": "2026-05-22T09:38:05Z",
"details": {
"trackingType": "SHIPMENT",
"productionSite": "PERSO-CENTER-FR-01",
"status": "CARD_SHIPPED"
}
}
```
**Tipo de seguimiento = ENVÍO — notificación posterior (con detalles del envío)**
```json
{
"operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
"operation": "STANDALONE_TRACKING",
"status": "SUCCESSFUL",
"issuerId": "issuer-001",
"cardId": "c-9f8e7d6c5b4a",
"timestamp": "2026-05-22T14:12:33Z",
"details": {
"trackingType": "SHIPMENT",
"productionSite": "PERSO-CENTER-FR-01",
"status": "CARD_SHIPPED",
"shipment": {
"carrier": "fedex",
"trackingNumber": "1234567890",
"status": "IN_TRANSIT",
"message": "En tránsito",
"trackingUrl": "https://www.fedex.com/track?trk=1234567890",
"estimatedDeliveryDate": "2026-05-24T00:00:00Z",
"lastUpdatedAt": "2026-05-22T13:55:00Z",
"lastCheckpoint": {
"checkpointTime": "2026-05-22T13:55:00Z",
"city": "París",
"countryName": "Francia",
"message": "Llegó a la instalación"
}
}
}
}
```
**Tipo de seguimiento = DEVOLUCIÓN**
```json
{
"operationId": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
"operation": "STANDALONE_TRACKING",
"status": "SUCCESSFUL",
"issuerId": "issuer-001",
"cardId": "c-9f8e7d6c5b4a",
"timestamp": "2026-05-25T10:02:11Z",
"details": {
"trackingType": "RETURN",
"productionSite": "PERSO-CENTER-FR-01",
"status": "CARD_RETURNED"
}
}
```
---
# 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, and the optional `goal` query parameter:
```
GET https://docs.payments.thalescloud.io/central-issuance/es/implementar-la-emision-centralizada/centro-de-seguimiento.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.