Detalle
Descripción General
Este endpoint permite obtener detalles de un envío/viaje realizado por el api partner corporativo. Dado un id único
Endpoint
URL: baseURL/V2/corporate-api-partner/get-trip/:id
Método: GET
Solicitud
:id Id único del viaje
Respuesta
Ejemplo de Respuesta Exitosa
bash
{
"success": true,
"code": "00",
"msg": "ok",
"data": {
"trip": {
"trip_id": "667c6f8616eb67ae4ce1d381",
"unique_id": 61197,
"total": 5,
"trip_details": {
"trip_status": "DRIVER_CANCELLED_TRIP",
"is_provider_accepted": false,
"source_address": "Este es el inicio de la ruta",
"destination_address": "Esta es la direccion final de la ruta",
"source_location": [
10.4346014,
-66.862743
],
"destination_location": [
10.4970614,
-66.8879179
],
"service_type": {
"service_type_id": "62bf17d17645af072a6e23f6",
"typename": "Envíos Moto",
"description": "Moto",
"shipment_description_en": "Shipments.",
"shipment_description_es": "Envio"
}
},
"provider_details": {
"provider_id": "507f1f77bcf86cd799439011",
"provider_name": "Ruben Rodriguez",
"unique_id": "78910",
"phone": "4241112233",
"country_phone_code": "+58",
"email": "[email protected]",
"picture": "https://riderys3bucket.s3-sa-east-1.amazonaws.com/provider_profile/6686b082934378a5910dbf04D3bM.jpg",
"vehicle_detail": {
"type": "Sedan",
"brand": "Toyota",
"model": "Camry",
"color": "White",
"passing_year": 2020,
"plate_no": "ABC1234"
},
"provider_location": [
10.4345121,
-66.8597461
]
},
"shipment": {
"responsible_full_name": "Juan Perez",
"responsible_phone": "4242225889",
"package_description": "Pedido 53",
"source_instructions": "pedir a la cajera",
"destination_instructions": "Esperar que bajen"
},
"corporate_api_partner_shipment_details": {
"_id": "667c6f8416eb67ae4ce1d36f",
"order_id": "ORD123456",
"shop": {
"id": "SHOP987",
"name": "MiTienda23",
"email": "[email protected]",
"phone_mobile": "123-456-7890",
"phone_fixed": "098-765-4321",
"location": [
"Tienda1",
"Tienda2"
],
"_id": "667c6f8416eb67ae4ce1d370"
},
"client": {
"username": "myuser123",
"full_name": "John Doe",
"email": "[email protected]",
"phone_mobile": "4242225889",
"phone_fixed": "2129458730",
"_id": "667c6f8416eb67ae4ce1d371"
},
"shipment_details": {
"type": "delivery_ridery",
"payment_type": "pago_movil",
"weight": 2.5,
"weight_unit": "kg",
"cost": 15.99,
"currency": "USD",
"origin_address_reference_point": "Al lado de la plza",
"_id": "667c6f8416eb67ae4ce1d372"
},
"product_array": [
{
"product_id": "SKU12345",
"image_url": "http://example.com/image1.jpg",
"name": "Cri Cri",
"aisle": "Chucherías",
"quantity": 2,
"price": 10.5,
"currency": "USD",
"_id": "667c6f8416eb67ae4ce1d373"
},
{
"product_id": "SKU67890",
"image_url": "http://example.com/image2.jpg",
"name": "Ibuprofeno 2",
"aisle": "Medicinas",
"quantity": 1,
"price": 20,
"currency": "USD",
"_id": "667c6f8416eb67ae4ce1d374"
}
],
"order_guide_url": "corporate-api-partner-config/667c6f8616eb67ae4ce1d381_1720015655744.pdf"
},
"created_at": "2024-06-26T19:44:06.464Z",
"post_transactions": [
{
"_id": "673272392bfe8e53ed58e411",
"authorization_id": "291577",
"merchant_id": "000000999999999",
"state": 1,
"amount_bs": 2540,
"amount_usd": 0,
"reference": "",
"bank": "0191",
"sourceSerial": "",
"provider_id": "65ea233b00e5834bb0767210",
"provider_unique_id": 1610,
"trip_id": "6732717d0464f45dd51ea869",
"trip_unique_id": 32406,
"date_transaction": "2024-11-11T17:08:08.395Z",
"meta_data": {
"amount_bs": 2540,
"authorization_id": "291577",
"date_transaction": "2024-11-11T17:08:08.395Z",
"merchant_id": "000000999999999",
"pos_response_message": "APROBADA",
"state": "00"
},
"pos_response_message": "APROBADA",
"created_at": "2024-11-11T21:08:09.035Z",
"updated_at": "2024-11-11T21:08:09.035Z",
"unique_id": 590,
"__v": 0
}
]
}
}
}Detalles
| Campo | Descripción | Tipo |
|---|---|---|
| trip_id | Identificador único del viaje. | String |
| unique_id | Identificador único numérico del viaje. | Number |
| total | Total del envío en USD. | Number |
| trip_details.trip_status | Estado del viaje (por ejemplo, "DRIVER_CANCELLED_TRIP"). | String |
| trip_details.is_provider_accepted | Indica si el proveedor ha aceptado el viaje. | Boolean |
| trip_details.source_address | Dirección de origen del viaje. | String |
| trip_details.destination_address | Dirección de destino del viaje. | String |
| trip_details.source_location | Coordenadas de la ubicación de origen. | Array |
| trip_details.destination_location | Coordenadas de la ubicación de destino. | Array |
| service_type.service_type_id | Identificador del tipo de servicio. | String |
| service_type.typename | Nombre del tipo de servicio (por ejemplo, "Envíos Moto"). | String |
| service_type.description | Descripción del tipo de servicio. | String |
| service_type.shipment_description_en | Descripción del envío en inglés. | String |
| service_type.shipment_description_es | Descripción del envío en español. | String |
| provider_details.provider_id | ID único del proveedor (conductor). | String |
| provider_details.provider_name | Nombre del proveedor. | String |
| provider_details.unique_id | Identificador único del proveedor. | String |
| provider_details.phone | Número de teléfono del proveedor. | String |
| provider_details.country_phone_code | Código telefonico del pais del proveedor. | String |
| provider_details.email | Correo electrónico del proveedor. | String |
| provider_details.picture | Imagen del proveedor. | String |
| provider_details.vehicle_detail.type | Tipo de vehículo del proveedor. | String |
| provider_details.vehicle_detail.brand | Marca del vehículo. | String |
| provider_details.vehicle_detail.model | Modelo del vehículo. | String |
| provider_details.vehicle_detail.color | Color del vehículo. | String |
| provider_details.vehicle_detail.passing_year | Año de registro del vehículo. | Number |
| provider_details.vehicle_detail.plate_no | Número de placa del vehículo. | String |
| provider_details.provider_location | Coordenadas de la ubicación del proveedor. | Array |
| shipment.responsible_full_name | Nombre completo del responsable del envío. | String |
| shipment.responsible_phone | Teléfono del responsable del envío. | String |
| shipment.package_description | Descripción del paquete. | String |
| shipment.source_instructions | Instrucciones en el origen. | String |
| shipment.destination_instructions | Instrucciones en el destino. | String |
| corporate_api_partner_shipment_details._id | Identificador único del detalle del envío. | String |
| corporate_api_partner_shipment_details.order_id | Identificador del pedido. | String |
| shop.id | Identificador de la tienda. | String |
| shop.name | Nombre de la tienda. | String |
| shop.email | Correo electrónico de la tienda. | String |
| shop.phone_mobile | Teléfono móvil de la tienda. | String |
| shop.phone_fixed | Teléfono fijo de la tienda. | String |
| shop.location | Ubicaciones de la tienda. | String |
| client.username | Nombre de usuario del cliente. | String |
| client.full_name | Nombre completo del cliente. | String |
| client.email | Correo electrónico del cliente. | String |
| client.phone_mobile | Teléfono móvil del cliente. | String |
| client.phone_fixed | Teléfono fijo del cliente. | String |
| shipment_details.type | Tipo de envío. | String |
| shipment_details.payment_type | Tipo de pago. | String |
| shipment_details.weight | Peso del envío. | Number |
| shipment_details.weight_unit | Unidad de peso. | String |
| shipment_details.cost | Costo del envío. | Number |
| shipment_details.currency | Moneda del costo. | String |
| shipment_details.origin_address_reference_point | Punto de referencia de la dirección de origen. | String |
| product_array.product_id | Identificador del producto. | String |
| product_array.image_url | URL de la imagen del producto. | String |
| product_array.name | Nombre del producto. | String |
| product_array.aisle | Pasillo del producto. | String |
| product_array.quantity | Cantidad del producto. | Number |
| product_array.price | Precio del producto. | Number |
| product_array.currency | Moneda del precio del producto. | String |
| order_guide_url | URL de la guía del pedido. (Si lo hubiere) | String |
| created_at | Fecha y hora de creación del viaje. | String |
| created_at | Fecha y hora de creación del viaje. | String |
| post_transactions | Array con las transacciones de pos. | Array |
| post_transaction.authorization_id | Id de la autorizacion de las transacciones. | String |
| post_transaction.merchant_id | Id del merchant asociado a la transaccion. | String |
| post_transaction.state | Estado de la operacion 1 aprobado 2 rechazado. | Number |
| post_transaction.amount_bs | Cantidad en bs | Number |
| post_transaction.bank | Codigo del banco perteneciente al pos | String |
| post_transaction.trip_id | Id del viaje | String |
| post_transaction.trip_unique_id | Id unico del viaje | String |
| post_transaction.meta_data | Objeto para guardar la metadata | Object |