Distribución de tarjetas físicas
Conoce qué significan los diferentes estados que puede tener el envío de tus tarjetas físicas nominadas o innominadas.
___
Introducción
Resolvemos la distribución de tarjetas físicas con diferentes partners de logística por país para que lleguen al domicilio de tus clientes. Para hacerte la vida más fácil, nosotros nos encargaremos de toda la comunicación con los proveedores de logísticas y tú podrás conocer el estado de cada envío fácilmente configurando un webhook.
En el momento de la integración, podrás elegir si deseas que nuestro proveedor de logística informe sobre las novedades del envío a tus clientes o no.
A continuación, te contaremos qué significan los diferentes estados que puede tener el envío de tus tarjetas físicas, nominadas o innominadas. Conocer cada uno te permitirá hacer un seguimiento correcto de los envíos, resolver las consultas de tus clientes y tomar medidas necesarias si surge algún inconveniente.
Estados del envío
A continuación, te contaremos qué significa cada estado y los detalles que podrás encontrar en el campo status_detail.
Cuando creas una solicitud de envío pasará por estos estados:
CREATED: es un estado interno que usamos para dar feedback de que se creó una solicitud de envío pero aún no nos comunicamos con nuestro proveedor de logística.
PENDING: es el estado de espera hasta que nuestro proveedor de logística acepte la solicitud de envío.
TRACKED: significa que nuestro proveedor de logística aceptó la solicitud de envío y comenzará el proceso de recolección y distribución. Si quieres saber más detalles sobre este estado, consulta el campo
status_detailque tendrá alguno de estos valores:
| Valores | Descripción |
|---|---|
| TRACKED | Nuestro proveedor de logística aceptó la solicitud de envío. |
| SHIPMENT_CONFIRMED | La solicitud de envío está confirmada. |
| READY_FOR_DISTRIBUTION | Nuestro proveedor de logística está preparado para comenzar el recorrido. |
| ROAD_TO_PICKUP | Nuestro proveedor de logística aceptó la solicitud de envío y le asignó un ID de seguimiento. |
| UNSUCCESSFUL_PICKUP | Las tarjetas no estaban listas para que nuestro proveedor de logística las retire. |
| POSTED_SHIPPING | Nuestro proveedor de logística aceptó la solicitud de envío y le asignó un ID de seguimiento. |
Rechazo del envío
Si nuestro proveedor de logística rechaza la solicitud de envío, te lo comunicaremos usando el estado REJECTED. Esto suele pasar porque el domicilio de envío tiene algún dato incorrecto o está fuera de cobertura.
También podría figurar como REJECTED si nuestro proveedor de embozado no logra personalizar la tarjeta.
¿Qué hago si el domicilio que cargué tiene un error?
- Si se trata de una tarjeta nominada tendrás que actualizar los datos de envío de la tarjeta.
- Si se trata de un lote de innominadas tendrás que actualizar los datos de envío del lote.
- Si son tarjetas innominadas tendrás que generar un nuevo envío.
Ten en cuenta que no hay límite de tiempo para actualizar datos de envío o generar uno. Y si lo haces, generaremos un nuevo ID.
Puedes obtener más detalles sobre el estado REJECTED en el campo status_detail. Estos son los valores posibles:
| Valores | Descripción |
|---|---|
| REJECTED | Por algún motivo no pudimos crear el envío con nuestro proveedor. |
| WRONG_CITY_REGION_COMBINATION | No se corresponden los datos de "ciudad" y de "región" del domicilio de destino. |
| OUT_OF_COVERAGE | El domicilio de destino está fuera de la zona de cobertura de nuestro proveedor de logística. |
| CARD_NOT_PERSONALIZED | Nuestro proveedor de embozado no pudo personalizar la tarjeta. Tendrás que crear otra. |
| SHIPMENT_REPLACED | Nuestro proveedor de logística no aceptó la solicitud de envío. Tendrás que crear otro. |
Cuando comience la distribución, el envío puede pasar por los siguientes estados:
- IN_TRANSIT/IN_WAREHOUSE/DISTRIBUTION: indica que la tarjeta está en proceso de distribución. Para saber más detalles, revisa el campo
status_detail. Estos son los valores posibles:
| Valores | Descripción |
|---|---|
| IN_TRANSIT | La tarjeta está en camino al domicilio de destino. |
| RECEIVED_BY_CARRIER | Nuestro proveedor de logística recibió la cantidad de tarjetas que esperaba según lo que le informamos. |
| RECEIVED_BY_CARRIER | La tarjeta está en preparación para viajar a otra sucursal de nuestro proveedor de logística. |
| START_OF_CUSTODY | La tarjeta comenzó su período de custodia de 30 días en el depósito de nuestro proveedor de logística. |
| VISIT_SCHEDULED: | Coordinamos la visita para entregar la tarjeta. |
| CALL_SCHEDULED: | Agendamos una llamada con el destinatario para coordinar la entrega. |
| VISIT_CONFIRMED: | Confirmamos la fecha y horario para hacer la visita. |
| OPERATOR_REASSIGNED: | Asignamos el envío a otro transportista. |
| DISTRIBUTION: | La tarjeta está en camino al domicilio de destino. |
| ZONE_ASSIGNED: | Nuestro proveedor logístico asignó la zona de reparto para la tarjeta. |
| TRANSFERRED_TO_CARRIER: | Listo para empezar la distribución de la tarjeta. |
| NEW_DELIVERY_ATTEMPT: | Comenzando un nuevo intento de entrega. |
- FAILED_DELIVERY_ATTEMPT: indica que la entrega falló por algún motivo. Si las reglas de tu contrato lo permiten, nuestro proveedor de logística hará una nueva visita. Puedes obtener más detalles sobre este estado en el campo
status_detail. Estos son los valores posibles:
| Valores | Descripción |
|---|---|
| FAILED_DELIVERY_ATTEMPT | No pudimos entregar la tarjeta. |
| CALL_FAILED_UNKNOWN | No pudimos comunicarnos telefónicamente para coordinar la entrega. |
| NO_ACCESS | No pudimos entregar la tarjeta porque no pudimos acercarnos al domicilio. |
| WRONG_ADDRESS | No pudimos entregar la tarjeta porque el domicilio informado era incorrecto. |
| FAILED_VISIT_DEAD | No pudimos entregar la tarjeta porque el titular falleció. |
| WRONG_OPERATOR_ZONE | No pudimos entregar la tarjeta porque le asignamos el envío a un operador de otra zona. |
| CALL_RESCHEDULED | No pudimos comunicarnos telefónicamente para coordinar la entrega y vamos a intentar llamarlo nuevamente. |
| CALL_FAILED_DEAD | No pudimos comunicarnos telefónicamente para coordinar la entrega. |
| MISSING_NUMBER | El número de teléfono del destinatario es incorrecto y no logramos contactarlo para coordinar la entrega. |
| WEATHER | No pudimos entregar la tarjeta por condiciones climáticas adversas. |
| CLIENT_TRIP | No pudimos entregar la tarjeta porque el destinatario está de viaje. |
| CLIENT_NOT_PRESENT | No pudimos entregar la tarjeta porque el destinatario no estaba en el horario de la visita. |
| INCOMPLETE_ADDRESS | No pudimos entregar la tarjeta porque el domicilio de entrega estaba incompleto. |
| CALL_FAILED | No pudimos comunicarnos telefónicamente para coordinar la entrega. |
| WHATSAPP_FAILED | No pudimos comunicarnos por WhatsApp para coordinar la entrega. |
| COURIER_FAILED | No pudimos entregar la tarjeta porque el transportista no se presentó en el horario acordado. |
| MISSING_DOCUMENTS | No pudimos entregar la tarjeta porque el destinatario no presentó los documentos de identificación aceptados. |
| CLIENT_UNKNOWN | No pudimos comunicarnos telefónicamente con el destinatario para coordinar la entrega. No lo conocen en el número informado. |
| NO_CALL | Visitamos el domicilio de entrega sin previo contacto telefónico y no pudimos entregar la tarjeta. |
| ZONE_PROBLEMS | No pudimos entregar la tarjeta porque tuvimos problemas con la zona de destino. |
| CLIENT_WORK | No pudimos entregar la tarjeta porque el destinatario no estaba disponible por trabajo. |
| FAILED_VISIT_UNKNOWN | Fuimos al domicilio pero no pudimos entregar la tarjeta. |
| FAILED_VISIT | No pudimos entregar la tarjeta porque nadie nos respondió en el domicilio. |
| OPERATOR_REASSIGNED | Asignamos el envío a otro transportista. |
| REFUSED | No pudimos entregar la tarjeta porque el receptor se negó (solo aplica para 🇧🇷). |
| VISIT_DEAD | No pudimos entregar la tarjeta porque el titular falleció (solo aplica para 🇧🇷). |
| MOVED | No pudimos entregar la tarjeta porque el titular se mudó de domicilio (solo aplica para 🇧🇷). |
| MISSING_DOCUMENTS | No pudimos entregar la tarjeta porque el titular no tenía la documentación necesaria. (solo aplica para 🇧🇷). |
| BAD_ROUTING | No pudimos entregar la tarjeta (solo aplica para 🇧🇷). |
| MAILBOX | No pudimos entregar la tarjeta, pero volveremos a intentarlo (solo aplica para 🇧🇷). |
| DAMAGED_ORDER | Ocurrió un imprevisto durante la distribución que imposibilitó la entrega de la tarjeta. Deberás solicitar un nuevo envío para este cliente (solo aplica para 🇧🇷). |
| INCOMPLETE_RECORD_OF_RECIPIENTS | No pudimos entregar la tarjeta porque el titular no tenía la documentación necesaria (solo aplica para 🇧🇷). |
| EX_EMPLOYEE | No pudimos entregar la tarjeta, pero volveremos a intentarlo (solo aplica para 🇧🇷). |
| CLIENT_REQUEST | No pudimos entregar la tarjeta por pedido del destinatario (solo aplica para 🇧🇷). |
| STREET_NOT_EXISTS | No pudimos entregar la tarjeta porque la calle indicada no existe (solo aplica para 🇧🇷). |
| NEIGHBORHOOD_IS_MISSING | No pudimos entregar la tarjeta porque el barrio indicado no existe (solo aplica para 🇧🇷). |
| BLOCK_APARTMENT_MISSING | No pudimos entregar la tarjeta porque el departamento indicado no existe (solo aplica para 🇧🇷). |
| EXTENSION_MISSING | No pudimos entregar la tarjeta, pero volveremos a intentarlo (solo aplica para 🇧🇷). |
| WAITING_EXCEEDED | No pudimos entregar la tarjeta (solo aplica para 🇧🇷). |
| STRIKE | No pudimos entregar la tarjeta. No pudimos acercarnos al domicilio por una movilización social (solo aplica para 🇧🇷). |
| DAMAGED_VEHICULE | No pudimos entregar la tarjeta porque se daño el vehículo que la transportaba (solo aplica para 🇧🇷). |
| OTHERS | No pudimos entregar la tarjeta (solo aplica para 🇧🇷). |
| CLIENT_REQUEST | No pudimos entregar la tarjeta por pedido del destinatario (solo aplica para 🇧🇷). |
| COVERAGE | No pudimos entregar la tarjeta. Hablamos con el titular de la tarjeta y detectamos que el destino de entrega está fuera de cobertura (solo aplica para 🇨🇴). |
| FAILED_VISIT_UKNOWN | No pudimos entregar la tarjeta. Fuimos al domicilio y un tercero nos informó que no conoce al titular (solo aplica para 🇨🇴). |
START_OF_CUSTODY: este estado se usa cuando falló el intento de entrega y nuestro proveedor de logística ya no hará más visitas. En este caso, la tarjeta queda en custodia por 30 días esperando que el destinatario la retire.
END_OF_CUSTODY: este estado se usa cuando transcurrió el tiempo de custodia por el depósito de nuestro proveedor logístico. El estado transicionará automáticamente a
NOT_DELIVEREDy tendrás que solicitar un nuevo envío para este cliente.
Si se completa el envío, finalizará con uno de estos estados:
- IN_WAREHOUSE: indica que un paquete de tarjetas innominadas ingresó exitosamente al centro de almacenamiento.
- DELIVERED: indica que la tarjeta llegó correctamente al destinatario.
Los estados de entrega exitosa son finales, es decir que no volverán a cambiar.
Si nuestro proveedor de logística no logra concretar la entrega, lo informaremos con alguno de estos estados, según corresponda:
- NOT_DELIVERED: indica que no pudimos entregar la tarjeta. Para saber la razón, revisa el campo
status_detail. Estos son los valores posibles:
| Valores | Descripción |
|---|---|
| NOT_DELIVERED | No pudimos entregar la tarjeta. |
| ROAD_TO_RETURN | No pudimos entregar la tarjeta y vamos a devolverla al lugar de origen. |
| UNSUCCESSFUL_RETURN | No pudimos devolver la tarjeta al lugar de origen. |
| RETURNED_TO_WAREHOUSE | La tarjeta volvió al depósito de nuestro proveedor de logística. |
| FRAUD | Suspendimos la distribución por análisis de fraude. |
| FRAUD_CLIENT | A pedido de nuestro cliente, suspendimos la distribución por análisis de fraude. |
| CLIENT_CANCELED | Nuestro cliente cancela la distribución de la tarjeta. |
| RETURNED | No pudimos entregar la tarjeta y la regresaremos al origen. |
- DESTRUCTION: indica que tuvimos que destruir la tarjeta porque no llegó a las manos del destinatario. Para ver la razón, puedes consultar el campo
status_detailque tendrá alguno de estos valores
| Valores | Descripción |
|---|---|
| DESTRUCTION | Tuvimos que destruir la tarjeta porque no llegó a las manos del destinatario. Deberás solicitar un nuevo envío para este cliente. |
| DESTROYED_BY_CLIENT | Tuvimos que destruir la tarjeta porque no llegó a las manos del destinatario. Deberás solicitar un nuevo envío para este cliente. |
- ACCIDENT: usamos este estado cuando ocurre un imprevisto durante la distribución que imposibilita la entrega de las tarjetas. Para ver la razón, puedes consultar el campo
status_detailque tendrá alguno de estos valores:
| Valores | Descripción |
|---|---|
| ACCIDENT | Ocurrió un imprevisto y no pudimos entregar la tarjeta. |
| LOST | Se perdió la tarjeta. |
| STOLEN | Robaron la tarjeta. |
Encuentra información de nuestra API de envíos y descubre todos los endpoints y webhooks para crear, obtener información y recibir actualizaciones sobre los envíos en nuestra API reference.