Generar Guía a Partir de Cotización Previa
POST/guide/create
Este endpoint permite a los usuarios crear una guía de envío utilizando una cotización previamente obtenida. Para realizar esta operación, el usuario debe proporcionar el token de cotización junto con la información requerida del remitente y destinatario. Este método permite utilizar un token de cotización que se escoja de los que arroja la cotización previa y de esta forma se adapte mejor a las necesidades del usuario.
Este endpoint es ideal para quienes buscan gestionar sus envíos de manera efectiva, asegurando un proceso ágil y transparente.
Request
Header Parameters
Token de acceso en formato Bearer. Ejemplo: Bearer "access_token".
Identificador único de la tienda.
- application/json
Body
required
Breve descripción del contenido del paquete (Máx: 25 caracteres).
(Min: 3 - Max: 25)
Nombre del remitente
(Min: 3 - Max: 25)
Apellidos del remitente
(Min: 3 - Max: 35)
Email del remitente
(Min: 3 - Max: 35)
Calle del remitente
(Min: 1 - Max: 15)
Número exterior/interior (casa, edificio, departamento) de la dirección del remitente.
(Min: 3 - Max: 35)
Colonia del remitente.
(Min: 8 - Max: 10)
Teléfono del remitente (Min: 8 caracteres).
(Min: 3 - Max: 35)
Estado del remitente.
(Min: 3 - Max: 35)
Municipio del remitente.
(Min: 3 - Max: 35)
Referencias de la dirección del remitente.
(Min: 3 - Max: 25)
Nombre del destinatario.
(Min: 3 - Max: 25)
Apellidos del destinatario.
(Min: 3 - Max: 35)
Email del destinatario.
(Min: 3 - Max: 35)
Calle del destinatario.
(Min: 1 - Max: 15)
Número exterior/interior (casa, edificio, departamento) de la dirección del destinatario.
(Min: 3 - Max: 35)
Colonia del destinatario.
(Min: 8 - Max: 10)
Teléfono de destinatario (Min: 8 caracteres).
(Min: 3 - Max: 35)
Estado del destinatario.
(Min: 3 - Max: 35)
Municipio del destinatario.
(Min: 3 - Max: 35)
Referencias de la dirección del destinatario.
True si desea generar recolección al crear la guía.
Indica si la guía enviará notificaciones.
Origen desde donde se genera la guía. Valores permitidos: "t1envios".
Clave del comercio proporcionada
(Min: 3 - Max: 60)
Nombre del comercio de origen (Max: 60 caracteres).
(Min: 3 - Max: 60)
Nombre de el comercio de destino (Max: 60 caracteres).
Token de la cotización
Responses
- 200
- 400
Respuesta de petición de generación de guía JSON.
Response Headers
- application/json
- Schema
- Example (from schema)
- Estructura de Response
Schema
Indica si la generación de la guía fue exitosa.
Mensaje que se muestra al obtener la respuesta de la guía.
Ambiente donde se realizó la petición
detail
object
Detalles de la respuesta.
Número de paquetes que contiene la guía
Identificador interno
Nombre de la paquetería o mensajería
Fecha de creación
Costo de la guía
Dirección de destino de la guía
Identificador de guía de mensajería
Contenido de guia (PDF). Archivo codificado.
Link de ubicación de el archivo/guía generado
{
"success": true,
"message": "string",
"location": "string",
"detail": {
"paquetes": "integer",
"num_orden": "string",
"paqueteria": "string",
"fecha_creacion": "string",
"costo": "float",
"destino": "string",
"guia": "string",
"file": "string",
"link_guia": "string"
}
}
{
"success": true,
"message": "Guia Generada!",
"location": "test",
"detail": {
"paquetes": 1,
"num_orden": "3532",
"paqueteria": "FEDEX",
"fecha_creacion": "2024-08-23 18:40:52",
"costo": 104.48,
"destino": "Carlos 22 de diciembre de 1860 manzana 130 62 Leyes de Reforma 3a Sección Iztapalapa",
"guia": "8617898483",
"file": "%PDF-1.4...",
"link_guia": "https://..."
}
}
Posibles errores debido a que no existe la cotización.
Response Headers
- application/json
- Schema
- Example (from schema)
- Error
Schema
{
"success": true,
"message": "string"
}
{
"success": false,
"message": "No existe una cotización con el token proporcionado"
}