Logística Inversa
Developers ● Documentación Técnica Logística Inversa Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Índice de contenidos Índice de Contenidos Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Edit Template Generación de guía electrónica logística inversa Genera una solicitud de recolección y GE en logística inversa para para el recojo de los distintos productos; puede consistir en 1 o más productos (SKU) a entregar Urbano genera un único número de GE por cada llamado a la WS y es entregado como respuesta a la información que ha sido recibida. El número de GE será el dato de enlace entre el cliente y Urbano para el posterior seguimiento y consulta de información de un envío. La GE se debe enlazar a un código de seguimiento, por ejemplo, la orden de compra; lo que hace única a la entrega. Los datos a enviar para la generación de las GE logística inversa son los que se muestra a continuación VER TABLA.2: Tabla No.2 Editar Tag Tipo Longitud Requerido Ejemplo Descripción GRUPO 1: IDENTIFICADOR DE SERVICIO ID Shipper Numerico 8 Obligatorio 834 Proporsionado por UE ID Contrato Numerico 9 Obligatorio 1722 Proporsionado por UE GRUPO 2: IDENTIFICADOR DEL ENVIO Código de Rastreo Alfanumerico 20 Obligatorio Para Relacionar la Compra y la GE Urbano Numero de Guia Alfanumerico 20 Opcional Numero Boleta/ Factura de Venta Alfanumerico 16 Opcional GRUPO: 3 DATOS DEL ORIGEN (RECOLECCION) Origen es un Ce .Ac. Alfanumerico 2 Obligatorio (SI ó NO) NO Si la Recolección es una Agencia del Shipper Codigo del Ce.Ac./cliente Alfanumerico 12 Obligatorio si anterior es SI AGE001 Codigo del Centro de Actividad si el Anterior es SI, si es NO Codigo del Cliente Nombre del Ce.Ac. /Cliente Alfanumerico 100 Obligatorio Maria Magdalena Nombre del Centro Actividad si Anterior es SI, si es No es nombre del Cliente quien entregara la mercaderia Dirección de la Recolección Alfanumerico 120 Obligatorio si anterior es SI Dirección del Almacen para Recolección Ubigeo de la Direccion Alfanumerico 6 Obligatorio si anterior es SI 150118 Código Único de Distrito (Según Tabla INEI) Localidad de la Direccion Alfanumerico 100 Obligatorio si anterior es Vacio Miraflores/Lima/Lima Nombre de la Localidad de la Direccion, Solo si en Ubigeo es Vacio Referencia de la Direccion Alfanumerico 100 Opcional Referencia de la Direccion Fecha Sugerida de Recoleccion Alfanumerico 10 Obligatorio 16/05/2018 Fecha para la que se Programará el Retiro, confirmar con SAC si puede ser HOY Arco Horario Alfanumerico 2 Obligatorio PM/AM Arco Horario en que Hurbano Pasara a Retirar el producto Numero Telefono Alfanumerico 50 Opcional 996378392/4151800 Sison mas de un Telefono, estas deben estar separados por el/ Correo Electrónico Alfanumerico 50 Opcional [email protected] GRUPO: 4 DATOS DEL RECEPTOR (Cliente) Destino es un Ce.Ac. Alfanumerico 2 Obligatorio (SI o NO) SI SI,si la Entrega es una Agencia del Shipper Codigo Ce.Ac. /Cliente Alfanumérico 12 Obligatorio si anterior es SI 9987460 Codigo del Centro de Actividad si el Anterior es SI, si es NO Codigo del Cliente Nombre del Ce.Ac./Cliente Alfanumérico 100 Obligatorio Juan Perez Nombre del Centro Actividad si Anterior es SI, si es No es nombre del Cliente quien entregara la mercaderia Direccion Para la Entrega Alfanumérico 120 Obligatorio si anterior es SI Pje. Santiago (140) Direccion del Almacen para Recoleccion Ubigeo de la Direccion Alfanumérico 6
Cotizador
Developers ● Documentación Técnica Cotizador Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Índice de contenidos Índice de Contenidos Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Edit Template Cotizador de Envíos Permite realizar un análisis de valores para el envío de productos según se requiera, previo a la generación de la solicitud o guía electrónica; ésto se genera a través del Web Service Integrador de URBANO, Ejemplo en PHP para mayor información VER Anexo 5 y Tabla: 5. Para la implementación tenga en cuenta los siguientes métodos: Descripción de Métodos Parámetros de envío El cuerpo de la solicitud incluye un solo parámetro codificado en URL llamado json, que contiene un objeto JSON con los siguientes campos: Editar Tag Tipo Longitud Requerido Ejemplo Descripción linea Numérico 1 Si 3 1: Postal, 2: Valorados, 3: Logistica id_orden Numérico 9 Si 1722 Código de contrato proporsionado por Urbano origen Alfanumérico 5 Si 13101 Código único de comuna (Código INE) destino Alfanumérico 5 Si 5101 Código único de comuna (Código INE) peso Numérico 4 Si En Kilogramos alto Numérico 5 Si En centimetros largo Numérico 5 Si En centimetros ancho Numérico 5 Si En centimetros tipo_empaque Alfanumérico 2 Si PQ Código del tipo de empaque, por defecto debe ser PQ seguro Numérico Valor del producto en CLP en caso de contar con seguro adicional URL del Servicio: https://app.usend.cl/ws/ue/tracking/ Método HTTP: POST Cabeceras Requeridas user: Identificación del usuario para acceder al servicio. pass: Contraseña o token de autenticación. Content-Type: Tipo de contenido de la solicitud. Valor: application/x-www-form-urlencoded cURL de Ejemplo Copiar curl –location ‘https://app.usend.cl/ws/ue/cotizarenvio’ –header ‘user: {{USER}}’ –header ‘pass: {{PASS}}’ –header ‘Content-Type: application/x-www-form-urlencoded’ –data-urlencode ‘json={«linea»:»3″,»id_orden»:»1078″,»origen»:»13123″,»destino»:»05101″,»peso»:»2″,»alto»:»15″,»largo»:»15″,»ancho»:»15″,»tipo_empaque»:»PQ»,»seguro»:»100000″}’ Descripción de Parámetros de Salida de los Métodos Usados A continuación, se detallan los métodos y una breve descripción de los parámetros de salida de cada método: Esquema de respuesta A continuación, se muestran algunos mensajes que puede devolver el Web Services: Cotización Generada Correctamente: Copiar [ { «error_sql»: «0», «error_info»: «», «id_servicio»: «1», «servicio»: «Distribucion», «valor_ennvio»: «3304.00», «time_envio»: «1 00:00», «valor_envio_aereo»: «0.00», «time_aereo»: «0 00:00» }, { «error_sql»: «0», «error_info»: «», «id_servicio»: «3», «servicio»: «Seguro», «valor_ennvio»: «0.00» } ] Error en el Proceso: Copiar [ { «error_sql»: «-1», «error_info»: «Origen no valido …», «id_servicio»: «0», «servicio»: «», «valor_ennvio»: «0.00» } ] Descripción de Movimientos Editar Campo Descripción error_sql Indica el código del error, pero también como un contador de la cantidad de check points enviados por este método error_info Indica la descripción del error en caso de que hubiera uno, si es que hay error es menos < cero, caso contrario es cero id_servicio Indica el numero servicio Servicio Indica el nombre del servicio valor_envio Indica el valor del envio time_envio Indica el tiempo que se demora en llegar el envio valor_envio_aereo Indica el valor del envío aéreo time_aereo Indica el tiempo que se demora en llegar el envío aéreo Descripción de Métodos Para el envío de direcciones se debe coordinar previamente con Urbano, con la finalidad de poderles compartir la tabla de cobertura (comunas). Es importante que el envío de información sea en base a los servicios contratados por el cliente. Urbano es quien provee las credenciales de acceso para el consumo del Web Service, la información en las imágenes adjuntas son ejemplos genéricos.
Tracking
Developers ● Documentación Técnica Servicio de Tracking Usend (GET) Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Índice de contenidos Índice de Contenidos Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Edit Template 1. Descripción Técnica del Servicio Este servicio permite consultar el estado detallado de una guía específica mediante una solicitud HTTP GET. La consulta se realiza utilizando un único parámetro llamado json, que debe ser incluido en la URL como parte de la cadena de consulta (query string). El valor del parámetro json debe ser una cadena JSON válida, con campos como «guia», «docref» y «vp_linea». Es importante destacar que estos datos viajan en la URL, y no en el cuerpo de la petición, lo que puede generar confusión al compararse con métodos POST. Al final de esta página, puede utilizar el botón «Abrir Formulario de Prueba» para ingresar datos y generar automáticamente ejemplos de código en cURL, PHP y Java listos para usar. 2. Endpoint URL: https://app.usend.cl/ws/ue/tracking/ Método: GET 3. Encabezados HTTP requeridos user: Usuario autorizadopass: Contraseña del servicio 4. Parámetros (en el campo json) Editar Campo Tipo Descripción Obligatorio guia String Número de guía a consultar No docref String Campo de referencia opcional No vp_linea String Código de línea operativa Sí 5. Ejemplo de Petición Copiar curl -G «https://app.usend.cl/ws/ue/tracking/» –data-urlencode ‘json={«guia»:»WB174333000″,»docref»:»»,»vp_linea»:»3″}’ -H «user: {{user}}» -H «pass: {{pass}}» 6. Ejemplo de Respuesta Copiar [ { «sql_error»: «1», «msg_error»: «Ok», «guia»: «WB186756797», «servicio»: «CONVATEC», «origen»: «SCL», «f_ingreso»: «18/06/2024», «destino»: «CCP», «chk»: «EN», «estado»: «ENTREGADO», «sub_estado»: «ENTREGADO A TERCERO», «fecha»: «21/06/2024», «hora»: «14:03», «docref»: «82893», «codigo_cliente»: «2[-10227065», «cliente»: «Ilustre Municipalidad De Lebu – ilustre municipalidad de lebu», «direccion»: «IGNACIO CARRERA PINTO 1441 Int.», «cli_refere»: «», «ciudad»: «LEBU – BIOBIO», «tipo_zona»: «Rural», «cli_telefono»: «», «contenido»: «- Insumos medicos», «piezas»: «4», «peso»: «12.80», «peso_volumen»: «26.74», «remite»: «Ceva Freight Management Logistica De Chile Ltda. (Abraham Aquino)», «dir_remite»: «AV. LO BOZA 120, MODULO D, OF. 2 Int.», «ciudad_ubigeo»: «PUDAHUEL – SANTIAGO», «cod_service»: «NO», «cod_montos»: «0.00», «cod_estado»: «», «cod_fecha»: «», «cant_cedibles»: «1», «tipo»: «G», «guia_pieza»: «18675679», «nro_pieza»: «0», «guia_numero»: «18675679», «seguro_env»: «NO», «movimientos»: [ { «chk»: «SS», «fecha»: «18/06/2024», «hora»: «15:53», «estado»: «SOLICITUD DE SERVICIO», «sub_estado»: «Pick Up (File)», «apunts»: «», «agencia»: «SCL», «gps_px»: «0», «gps_py»: «0» }, { «chk»: «AO», «fecha»: «18/06/2024», «hora»: «19:29», «estado»: «ADMITIDO EN HUB», «sub_estado»: «Arribo En Origen», «apunts»: «», «agencia»: «SCL», «gps_px»: «0», «gps_py»: «0» }, { «chk»: «DD», «fecha»: «18/06/2024», «hora»: «22:07», «estado»: «DESPACHADO A DESTINO», «sub_estado»: «Despacho A Destino», «apunts»: «De:SCL –> Hacia:CCP ID : 1037997», «agencia»: «SCL», «gps_px»: «0», «gps_py»: «0» }, { «chk»: «AD», «fecha»: «19/06/2024», «hora»: «06:47», «estado»: «ARRIBADO EN DESTINO», «sub_estado»: «Arribo Agencia (Manual)», «apunts»: «En:CCP Hacia:SCL Rendicion:5646», «agencia»: «CCP», «gps_px»: «0», «gps_py»: «0» }, { «chk»: «AA», «fecha»: «25/06/2024», «hora»: «13:07», «estado»: «POD ADMITIDO EN ORIGEN», «sub_estado»: «Pod Admitido En Origen(Manual)», «apunts»: «», «agencia»: «SCL», «gps_px»: «0», «gps_py»: «0» }, { «chk»: «LA», «fecha»: «25/06/2024», «hora»: «16:02», «estado»: «POD LIQUIDADO», «sub_estado»: «Liquidado Al Shipper», «apunts»: «Contacto::Abraham Aquino (ID :73038)», «agencia»: «SCL», «gps_px»: «0», «gps_py»: «0» } ], «img»: [ { «img_path»: «», «img_fecha»: «», «img_hora»: «», «n_visita»: «0» } ], «piezas_estado»: [ { «piezas»: «PK220570819CCP», «estado»: «YA FUE ENTREGADO (ENTREGADO A TERCERO)», «fecha_estado»: «21/06/2024», «hora_estado»: «14:03», «estado_id»: «EN» }, { «piezas»: «PK220570827CCP», «estado»: «YA FUE ENTREGADO (ENTREGADO A TERCERO)», «fecha_estado»: «21/06/2024», «hora_estado»:
Etiquetas
Developers ● Documentación Técnica Servicio de Creación de Etiquetas Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Índice de contenidos Índice de Contenidos Etiqueta Servicio de Creación de Etiquetas 1. Descripción Técnica del Servicio 2. Endpoint 3. Encabezados HTTP requeridos 4. Parámetros (en el campo json) A. Identificación del Servicio B. Datos del Envío C. Datos del Vendedor (Seller) D. Datos del Receptor / Cliente E. Dirección de Entrega F. Datos del Producto a Entregar G. Cedibles H. Datos para Despachos I. Datos para la Entrega J. Datos Autorizados para Entrega K. Datos para Cobranza Ejemplo con curl Ejemplo de Respuesta Exitosa Descripción de los campos en la respuesta Ejemplos de Código PHP Java (HttpURLConnection) Node.js (axios) Diseño de Etiqueta Datos mínimos obligatorios para la entrega Datos técnicos requeridos por Usend Ejemplo de JSON de Entrada Ejemplos de Respuestas con Error Descripción de errores comunes Códigos Ubigeo Formulario de Prueba Integrado Menú conmutador hamburguesa Seguimiento 1. Descripción Técnica del Servicio 2. Endpoint Menú conmutador hamburguesa Cotizador Cotizador de Envíos Descripción de Métodos Parámetros de envío Cabeceras Requeridas cURL de Ejemplo Descripción de Parámetros de Salida de los Métodos Usados Esquema de respuesta Cotización Generada Correctamente Error en el Proceso Descripción de Movimientos Descripción de Métodos Menú conmutador hamburguesa Logística Inversa Generación de guía electrónica logística inversa Tabla No.2 Descripción de Métodos y Parámetros Guía Electrónica Parámetro de Envió URL del servicio Esquema de la Respuesta Guía Generada Correctamente Guía Generada Correctamente Datos para Cobranza Datos para Retorno de Prueba de Entrega Descripción de la Respuesta Respuesta 2 Menú conmutador hamburguesa Edit Template 1. Descripción Técnica del Servicio El servicio permite la generación de una Orden de Transporte (OT) para cada punto de entrega o destinatario, mediante una integración con nuestra API REST. Cada OT puede incluir uno o más productos (SKU) y representa una unidad logística independiente que será gestionada por Usend desde su recolección hasta su entrega final. Por cada solicitud al servicio, el sistema de Usend genera un número único de OT, el cual se devuelve como parte de la respuesta. Este identificador sirve como nexo entre el cliente y Usend, permitiendo el seguimiento del envío y la trazabilidad completa del proceso. Para garantizar unicidad y trazabilidad, la OT debe estar vinculada a un código de seguimiento proporcionado por el cliente, como una orden de compra o número de pedido. El número de OT es un código alfanumérico de hasta 11 caracteres, con un dígito verificador incluido, y se considera el identificador oficial para todas las operaciones logísticas y de tracking posteriores. La estructura de datos esperada para generar una OT incluye información del contrato, detalles del envío, datos del destinatario, dirección de entrega, productos involucrados, documentos asociados (cedibles), y parámetros logísticos como peso, cantidad de piezas, seguros y ventanas horarias de entrega. Al final de esta página, puede utilizar el botón «Abrir Formulario de Prueba» para ingresar datos y generar automáticamente ejemplos de código en cURL, PHP, Java y Node listos para usar. Para consumir el servicio, se debe enviar un payload en formato JSON que contiene todos los datos necesarios para la generación de la OT (detalles del contrato, destinatario, dirección, productos, logística, etc.). Este JSON debe viajar dentro de una variable llamada json, utilizando el formato application/x-www-form-urlencoded, como se ilustra a continuación: Copiar –header «Content-Type: application/x-www-form-urlencoded» –data-urlencode ‘json={ … JSON completo … }’ Este diseño permite que el servicio pueda integrarse fácilmente desde entornos web, móviles o servidores, manteniendo compatibilidad con sistemas que no permiten el uso de application/json de forma nativa. 2. Endpoint URL: https://app.usend.cl/ws/ue/ge/ Método: POST Content-Type: application/x-www-form-urlencoded 3. Encabezados HTTP requeridos user: Usuario autorizadopass: Contraseña del servicio 4. Parámetros (en el campo json) A. Identificación del Servicio Editar Campo Tipo Longitud Obligatorio Ejemplo Descripción linea Numérico 1 Sí 3 Tipo de servicio: 1 (Postal), 2 (Valorados), 3 (Logística) id_contrato Numérico 9 Sí 1722 Identificador de contrato proporcionado por Usend B. Datos del Envío Editar Campo Tipo Longitud Obligatorio Ejemplo Descripción cod_rastreo Alfanumérico 20 Sí 5410724479257 Código de rastreo asociado a la compra cod_barra Alfanumérico 25 No Código de barras (si se usa el del cliente) fech_emi_vent Fecha 10 No 13/09/2023 Fecha de emisión de la venta nro_o_compra Alfanumérico 16 No 1015 Número de orden de compra o pedido nro_guia_trans Alfanumérico 20 No 1 Número de guía de transporte C. Datos del Vendedor (Seller) Editar Campo Tipo Longitud Obligatorio Ejemplo Descripción venta_seller Alfanumérico 2 No NO ¿Corresponde a un seller? (SI/NO) sell_codigo Alfanumérico 12 No RUT o código del seller sell_nombre Alfanumérico 80 No Razón social del seller sell_direcc Alfanumérico 100 No Dirección del almacén de recolección sell_ubigeo Alfanumérico 6 No Código INE
Plugin
Nuestros Plugin Ya se encuentran disponibles nuestros Plugin Oficiales para que puedas integrar de manera sencilla los sitios e-commerce desarrollados en Vtex, Prestashop, WooCommerce, Magento y Shopify. Shopify Requisito: La tienda creada en Shopify tenga habilitada la función de Shipping. VTEX Integración por polígonos de georreferenciación. WooCommerce Magento Php: 7.3.16 +Magento: 2.4.0MySql: 5.6 + PrestaShop Php: 7.3 – 7.4Prestashop: 1.7.x a 1.7.8.9MySql: 5.6 ¿Estás Listo Para Empezar? Optimiza tus entregas hoy mismo. Escríbenos y un asesor logístico te atenderá de inmediato.
