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 para el flujo de extremo a extremo.

Los campos de seguimiento del transportista son opcionales. La disponibilidad depende de la integración con el transportista.

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

{
  "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

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

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.

Ejemplo message valores

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