> 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/seguimiento-del-envio.md).

# Seguimiento del envío

D1 puede proporcionar seguimiento del envío después de que se envíe una tarjeta física.

Recibes actualizaciones del envío:

* En las notificaciones enviadas al backend de tu emisor.
* En las respuestas de estado bajo demanda, cuando estén disponibles.

### Cuando el seguimiento del envío está disponible

El seguimiento del envío suele estar disponible después de `details.status = CARD_SHIPPED`.

Consulta [Seguimiento del pedido de tarjeta](/central-issuance/es/implementar-la-emision-centralizada/seguimiento-de-pedidos-de-tarjetas.md) para el flujo de extremo a extremo.

{% hint style="info" %}
Los campos de seguimiento del transportista son opcionales. La disponibilidad depende de la integración con el transportista.
{% endhint %}

### Transportistas admitidos

| Código del transportista | Nombre del transportista |
| ------------------------ | ------------------------ |
| chronopost-france        | Chronopost France        |
| dhl                      | DHL Express              |
| dhl-global-mail          | DHL eCommerce            |
| deutsch-post             | Deutsche Post Mail       |
| estafeta                 | Etafeta                  |
| fedex                    | FedEx®                   |
| la-poste-colissimo       | La Poste                 |
| nacex                    | NACEX                    |
| spanish-seur             | Seur España              |
| singapore-post           | Singapore Post           |
| spain-correos-es         | Correos de España        |
| ups                      | UPS                      |
| usps-iv-api              | USPS Informed Visibility |

### Objeto Shipment

Cuando está presente, `details.shipment` puede incluir:

* `carrier`: Código del transportista (por ejemplo, `fedex`).
* `trackingNumber`: Referencia de seguimiento del transportista.
* `status`: Estado del envío del transportista.
* `message`: Mensaje normalizado del transportista para mostrar.
* `trackingUrl`: URL directa al seguimiento del transportista.
* `redirectUrl`: URL de la página de destino del transportista para acciones de entrega.
* `pickupDate`: Marca de tiempo ISO 8601 cuando el transportista recogió el paquete.
* `estimatedDeliveryDate`: Marca de tiempo ISO 8601 de entrega estimada.
* `lastUpdatedAt`: Marca de tiempo ISO 8601 del último evento.
* `deliveryDate`: Marca de tiempo ISO 8601 de la entrega, cuando se proporciona.
* `signedBy`: Destinatario de la firma, cuando se proporciona.
* `failedDeliveryAttempts`: Número de intentos fallidos de entrega, cuando se proporciona.
* `lastCheckpoint`:
  * `checkpointTime`: La fecha y hora del evento de control, proporcionada por el transportista. Usa la zona horaria del control. El formato puede variar según cómo lo proporcione el transportista.
  * `city`: Información de la ciudad proporcionada por el transportista.
  * `countryName`: Nombre del país del control; también puede contener otra información de ubicación.
  * `message`: Mensaje del control.

#### Ejemplo

```json
{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "SUCCESSFUL",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_SHIPPED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos",
        "shipment": {
          "pickupDate": "2025-01-21T17:32:28Z",
          "carrier": "fedex",
          "trackingNumber": "61293150000079650811",
          "status": "IN_TRANSIT",
          "message": "En tránsito",
          "trackingUrl": "https://www.fedex.com/apps/fedextrack/?tracknumbers=61293150000079650811&cntry_code=US",
          "redirectUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=61293150000079650811&cntry_code=US",
          "estimatedDeliveryDate": "2025-01-21T17:32:28Z",
          "lastUpdatedAt": "2025-01-21T17:32:28Z",
          "lastCheckpoint": {
            "checkpointTime": "2025-01-21T17:32:28Z",
            "city": "Nueva York",
            "countryName": "Estados Unidos",
            "message": "Llegó a la instalación"
          }
        }
      }
    }
  ]
}
```

#### Estados del envío

<table><thead><tr><th width="206.4000244140625">Código de estado</th><th>Descripción</th></tr></thead><tbody><tr><td><code>INFO_RECEIVED</code></td><td>El transportista recibió la solicitud de envío y recogerá el paquete.</td></tr><tr><td><code>IN_TRANSIT</code></td><td>El paquete se está moviendo por la red del transportista.</td></tr><tr><td><code>OUT_FOR_DELIVERY</code></td><td>El paquete está en reparto o listo para recogida.</td></tr><tr><td><code>FAILED_ATTEMPT</code></td><td>El transportista intentó la entrega y normalmente reintentará.</td></tr><tr><td><code>DELIVERED</code></td><td>El paquete fue entregado.</td></tr><tr><td><code>AVAILABLE_FOR_PICKUP</code></td><td>El paquete está disponible en un punto de recogida.</td></tr><tr><td><code>EXCEPTION</code></td><td>El paquete está retenido, no entregado o devuelto.</td></tr><tr><td><code>EXPIRED</code></td><td>No hay información de seguimiento durante 30 días desde que se añadió.</td></tr><tr><td><code>PENDING</code></td><td>La información de seguimiento aún no está disponible.</td></tr></tbody></table>

#### Mensajes del envío (subestado)

`message` es una cadena normalizada para mostrar. Los valores pueden variar con el tiempo. Proporciona detalles adicionales sobre el estado del envío.

<details>

<summary>Ejemplo <code>message</code> valores</summary>

<table><thead><tr><th width="192.79998779296875">Estado del envío</th><th width="269.60003662109375">Mensaje (subestado)</th><th>Descripción</th></tr></thead><tbody><tr><td><code>DELIVERED</code></td><td><code>Entregado</code></td><td>Confirmar entrega.</td></tr><tr><td><code>DELIVERED</code></td><td><code>Recogido por el cliente</code></td><td>Confirmar recogida.</td></tr><tr><td><code>DELIVERED</code></td><td><code>Firmado por el cliente</code></td><td>Confirmar entrega con firma.</td></tr><tr><td><code>DELIVERED</code></td><td><code>Entregado y cobrado contra reembolso</code></td><td>Confirmar entrega COD.</td></tr><tr><td><code>AVAILABLE_FOR_PICKUP</code></td><td><code>Disponible para recogida</code></td><td>Indicar disponibilidad para recogida.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Excepción</code></td><td>Indicar una excepción de entrega.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>El cliente se mudó</code></td><td>Indicar cambio de domicilio del destinatario.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>El cliente rechazó la entrega</code></td><td>Indicar un rechazo.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Retrasado (despacho de aduanas)</code></td><td>Indicar retraso aduanero.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Retrasado (factores externos)</code></td><td>Indicar retraso externo.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Retenido por pago</code></td><td>Indicar retención por pago.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Dirección incorrecta</code></td><td>Indicar problema con la dirección.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Recogida perdida</code></td><td>Indicar recogida no realizada.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Rechazado por el transportista</code></td><td>Indicar rechazo del transportista.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Devolviendo al remitente</code></td><td>Indicar devolución en curso.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Devuelto al remitente</code></td><td>Confirmar devolución completada.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Daño en el envío</code></td><td>Indicar paquete dañado.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Envío perdido</code></td><td>Indicar paquete perdido.</td></tr><tr><td><code>EXCEPTION</code></td><td><code>Fallo en la recogida por el transportista</code></td><td>Indicar fallo en la recogida por el transportista.</td></tr><tr><td><code>FAILED_ATTEMPT</code></td><td><code>Intento fallido</code></td><td>Indicar intento de entrega fallido.</td></tr><tr><td><code>FAILED_ATTEMPT</code></td><td><code>Destinatario no disponible</code></td><td>Indicar destinatario no disponible.</td></tr><tr><td><code>FAILED_ATTEMPT</code></td><td><code>Negocio cerrado</code></td><td>Indicar negocio cerrado.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>En tránsito</code></td><td>Indicar movimiento en tránsito.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Escaneo de aceptación</code></td><td>Confirmar aceptación por el transportista.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Escaneo de llegada</code></td><td>Confirmar llegada al centro.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Llegó al país/región de destino</code></td><td>Confirmar llegada al destino.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Despacho de aduanas completado</code></td><td>Confirmar despacho de aduanas completado.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Despacho de aduanas iniciado</code></td><td>Confirmar inicio del despacho de aduanas.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Escaneo de salida</code></td><td>Confirmar salida de la instalación.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Problema resuelto</code></td><td>Confirmar resolución del problema.</td></tr><tr><td><code>IN_TRANSIT</code></td><td><code>Reenviado a una dirección de entrega diferente</code></td><td>Indicar reenvío.</td></tr><tr><td><code>INFO_RECEIVED</code></td><td><code>Información recibida</code></td><td>Confirmar recepción de la información de envío.</td></tr><tr><td><code>OUT_FOR_DELIVERY</code></td><td><code>En reparto</code></td><td>Indicar que está en reparto.</td></tr><tr><td><code>OUT_FOR_DELIVERY</code></td><td><code>Cliente contactado</code></td><td>Indicar intento de contacto por parte del transportista.</td></tr><tr><td><code>OUT_FOR_DELIVERY</code></td><td><code>Cita de entrega programada</code></td><td>Indicar cita programada.</td></tr><tr><td><code>PENDING</code></td><td><code>Pendiente</code></td><td>Indicar que no hay seguimiento disponible.</td></tr><tr><td><code>PENDING</code></td><td><code>Cuenta del transportista no conectada</code></td><td>Indicar falta de conexión con el transportista.</td></tr><tr><td><code>PENDING</code></td><td><code>Etiqueta creada, aún sin actualizaciones</code></td><td>Indicar que la etiqueta fue creada.</td></tr><tr><td><code>PENDING</code></td><td><code>Transportista incorrecto</code></td><td>Indicar discrepancia de transportista.</td></tr><tr><td><code>PENDING</code></td><td><code>Sin actualizaciones recientes</code></td><td>Indicar seguimiento desactualizado.</td></tr><tr><td><code>PENDING</code></td><td><code>Transportista no reconocido</code></td><td>Indicar transportista no compatible.</td></tr><tr><td><code>EXPIRED</code></td><td><code>Expirado</code></td><td>Indicar seguimiento expirado.</td></tr></tbody></table>

</details>


---

# 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/seguimiento-de-pedidos-de-tarjetas/seguimiento-del-envio.md?ask=<question>&goal=<endgoal>
```

`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.