Consultar Guías
GET/t1/pgs/guias-estatus/comercio/:clave/registros/:registros/pag/:page
Este endpoint permite consultar todas las guías de envío previamente generadas, mostrando información relevante sobre cada una.
Permite obtener un historial de guías de envío, aplicando filtros por número de guía, número de orden, rango de fechas, estatus de la guía o nombre de la paquetería. Además, proporciona un enlace directo para descargar el PDF de cada guía, facilitando la gestión de los envíos de manera específica y eficiente.
Request
Header Parameters
Token de acceso en formato Bearer. Ejemplo: Bearer "access_token".
Query Parameters
Columna por la cual se desea ordenar, es requerida cuando el parámetro 'orden_columna' esta presente y diferente de null. Las opciones permitidas son: fecha_hora, num_orden, nombre_cliente, orden_columna.
Forma por la cual se desea ordenar una columna, es requerida cuando el parámetro 'columna' esta presente y diferente de null. Las opciones permitidas son: asc, desc.
Número de guía o rastreo.
Fecha en que se creo la guía, indica la fecha de inicio de búsqueda.
Fecha en que se creo la guía, indica la fecha final de búsqueda.
Número de orden de t1envios.
Estatus de la guía: 1. Por Recolectar, 2. Recolectado, 3. En Transito, 4. Entregado.
Nombre de mensajería, las opciones permitidas son: DHL, FEDEX, ESTAFETA, UBER, TOOKAN, REDPACK, YVOY, 99MIN.
Responses
- 200
- 400
Respuesta de petición.
Response Headers
- application/json
- Schema
- Example (from schema)
- Estructura de Response
Schema
[
]
Indica si la petición fue exitosa o no. true | false
Mensaje arrojado del resultado de la petición.
detail
object
Detalle de la respuesta.
data
array
Array con información requerida.
Número de orden de t1envios.
Número de guía o rastreo.
Fecha y hora de creación de la guía.
Estatus de la guía.
Pedido Comercio.
Id del comercio.
Costo de la guía.
Id de la mensajería ocupada.
Nombre de la mensajería ocupada.
Nombre del destinatario.
Telefono del destinatario.
Email del destinatario.
Dirección del destinatario.
Indica si el paquete tiene seguro.
Valor del paquete asegurado.
Link para obtener y descargar el pdf de la guía.
Indica si la guía fue cancelada.
Código de la mensajería ocupada.
Estatus de la guía.
Estatus de la guía.
Link para rastrear en tiempo real la guía.
{
"success": boolean,
"message": "string",
"detail": {
"data": [
{
"num_orden": "string",
"guia": "string",
"fecha_hora": "datetime",
"status_entrega": "integer",
"pedido_comercio": "string",
"comercio_id": "integer",
"costo_total": "string",
"mensajeria_id": "string",
"mensajeria": "string",
"nombre_destino": "string",
"telefono_destino": "string",
"email_destino": "string",
"direccion_destino": "string",
"seguro": "boolean",
"valor_paquete": "float",
"link_documento": "string",
"paq_adicional": "boolean",
"cancelada": "boolean",
"codigo_mensajeria": "string",
"estatus": "string",
"estatus_generico": "string",
"link_rastreo": "string",
},
]
}
}
{
"success": true,
"message": "Búsqueda exitosa!",
"detail": {
"data": [
{
"num_orden": "2099",
"guia": "3095640564",
"fecha_hora": "2024-11-12 13:46:37",
"status_entrega": 1,
"pedido_comercio": "",
"comercio_id": 152,
"costo_total": "182.62",
"mensajeria_id": 1,
"mensajeria": "DHL",
"nombre_destino": "Juan Perez",
"telefono_destino": "2221112121",
"email_destino": "email_destinatario@example.com",
"direccion_destino": "Calle Yapango 8 San Antonio Naucalpan de Juárez México, 53570",
"seguro": 0,
"valor_paquete": 849.9,
"link_documento": "https://s3.plataformat1.com/guias/test/t1Envios/2024/11/3095640......",
"paq_adicional": 0,
"cancelada": "false",
"codigo_mensajeria": "IA",
"estatus": "Guía generada",
"estatus_generico": "In Process",
"link_rastreo": "https://landingt1envios.monadic.solutions/track/t?trackingnumber=309.....",
},
{
"num_orden": "2100",
"guia": "3095640565",
"fecha_hora": "2024-11-12 12:15:23",
"status_entrega": 1,
"pedido_comercio": "",
"comercio_id": 152,
"costo_total": "203.72",
"mensajeria_id": 1,
"mensajeria": "DHL",
"nombre_destino": "Juan Perez",
"telefono_destino": "2221112121",
"email_destino": "email_destinatario@example.com",
"direccion_destino": "Calle Yapango 8 San Antonio Naucalpan de Juárez México, 53570",
"seguro": 0,
"valor_paquete": 956.23,
"link_documento": "https://s3.plataformat1.com/guias/test/t1Envios/2024/11/3095640......",
"paq_adicional": 0,
"cancelada": "false",
"codigo_mensajeria": "IA",
"estatus": "Guía generada",
"estatus_generico": "In Process",
"link_rastreo": "https://landingt1envios.monadic.solutions/track/t?trackingnumber=309.....",
},
]
}
}
Posibles errores por falta de algún campo requerido.
Response Headers
- application/json
- Schema
- Example (from schema)
- Error
Schema
error
object
{
"success": true,
"message": "string",
"error": {
"orden_columna": [
"string"
]
}
}
{
"success": false,
"message": "The given data was invalid.",
"error": {
"orden_columna": [
"El campo orden columna es obligatorio cuando columna está presente."
]
}
}