Easypost Shipping OCA

Paso 1: Configurar el transportista de entrega

• Vaya a Inventario → Configuración → Métodos de entrega
• Cree un nuevo método de entrega o edite uno existente
• Establezca Provider en Easypost OCA
• En la pestaña Easypost Configuration, configure los siguientes campos:
• Easypost Test API Key: Su clave de API de prueba del panel de EasyPost (para desarrollo y pruebas)
• Easypost Production API Key: Su clave de API de producción (para envíos reales)
• Label Format: Elija el formato de etiqueta según su impresora:
• PDF (predeterminado): Formato estándar, funciona con todas las impresoras
• ZPL: Para impresoras térmicas Zebra (impresión térmica directa)
• EPL2: Para impresoras térmicas Eltron/Zebra heredadas
• Delivery Multiple Packages: Seleccione la estrategia de envío para pedidos con múltiples paquetes:
• Shipments (predeterminado): Cree un envío individual para cada paquete, cobrado por separado
• Batch: Cree un envío por lotes con todos los paquetes en una sola transacción
• Configure la pestaña Pricing según sea necesario (precio fijo, porcentaje o basado en fórmula)
• Active la casilla Test Environment durante el desarrollo para usar la clave de API de prueba
• Guarde el método de entrega

Paso 2: Configurar el empaquetado de productos (opcional)

Para obtener cálculos de envío precisos utilizando tipos de paquete específicos del transportista:

• Vaya a Inventario → Configuración → Empaquetados de producto
• Cree o edite un empaquetado de producto
• Establezca Carrier en Easypost OCA
• Configure las dimensiones del paquete: Length, Width, Height (en pulgadas)
• Establezca Shipper Package Code para el empaquetado específico del transportista (por ejemplo, "Parcel", "FedExBox", "FlatRateEnvelope")
• Establezca Carrier Prefix para filtrar por un transportista específico si es necesario (por ejemplo, "USPS", "FedEx")
• Guarde el empaquetado

Paso 3: Configurar la dirección del almacén

Asegúrese de que su almacén tenga una dirección completa que se utilizará como dirección del remitente:

• Vaya a Inventario → Configuración → Almacenes
• Edite su almacén
• Establezca la Address completa con todos los campos requeridos:
• Dirección
• Ciudad
• Estado/Provincia
• Código ZIP/Postal
• País
• Verifique que la dirección sea correcta - esta será la dirección "Ship From" en todas las etiquetas

Paso 4: Habilitar el registro de API (opcional)

Para depurar interacciones con la API y solucionar problemas:

• Edite el transportista de entrega configurado en el Paso 1
• Vaya a la pestaña Advanced Options
• Active la casilla Log XML
• Consulte los registros de solicitud/respuesta de la API en Ajustes → Técnico → Registro

Notas importantes de configuración

• Modo de prueba vs producción: Alterne la casilla Test Environment para cambiar entre las claves de API de prueba y de producción. Pruebe siempre a fondo en modo de prueba antes de pasar a producción.
• Unidades de peso: El módulo convierte automáticamente los pesos de los productos a onzas (requisito de EasyPost). Asegúrese de que todos los productos tengan el peso configurado.
• Conversión de moneda: EasyPost devuelve las tarifas en USD. El módulo las convierte automáticamente a la moneda del pedido utilizando los tipos de cambio de Odoo.
• USPS/UPS End Shipper: Estos transportistas requieren un ID de end shipper para ciertos servicios. El módulo lo crea y gestiona automáticamente - no se necesita configuración manual.
• Seguridad de las claves de API: Mantenga segura su clave de API de producción. Nunca confirme las claves de API en el control de versiones ni las comparta públicamente.
• Caché de tarifas: Las tarifas de EasyPost se calculan en tiempo real. Las tarifas mostradas en el momento de la cotización pueden diferir ligeramente en el momento del envío si ha pasado tiempo.

Flujo de trabajo 1: Calcular tarifas de envío en el pedido de venta

• Cree un nuevo pedido de venta: Vaya a Ventas → Pedidos → Presupuestos → Crear
• Añada productos al pedido (asegúrese de que los productos tengan el peso configurado)
• Establezca el Cliente con una dirección de envío completa
• Haga clic en el botón Add Shipping
• En el asistente Add a shipping method:
• Seleccione su método de entrega Easypost OCA de la lista
• Haga clic en el botón Get Rate
• El sistema:
• Consultará la API de EasyPost con los detalles del pedido (peso, direcciones de origen/destino)
• Seleccionará automáticamente la tarifa más baja de todos los transportistas disponibles
• Añadirá una línea de envío al pedido con el nombre del transportista (p. ej., "Easypost - USPS Priority")
• El pedido de venta ahora muestra:
• Línea de envío con el nombre del transportista y el precio calculado
• Datos almacenados: shipment_id, rate_id, carrier_name (para la creación posterior del envío)
• Confirme el pedido cuando esté listo para continuar

Flujo de trabajo 2: Generar etiquetas de envío (paquete único)

• Después de confirmar el pedido de venta, se crea automáticamente una orden de entrega
• Vaya a Inventario → Órdenes de entrega y abra la orden de entrega
• Haga clic en Check Availability para reservar stock
• Establezca las cantidades Done para cada línea de producto
• Haga clic en el botón Validate - el sistema automáticamente:
• Creará un envío de EasyPost usando la tarifa almacenada (o calculará una nueva tarifa si ha caducado)
• Comprará el envío (cargará a su cuenta de EasyPost)
• Descargará la etiqueta de envío en el formato configurado (PDF/ZPL/EPL2)
• Adjuntará la etiqueta al picking en los mensajes del Chatter
• Establecerá el número de seguimiento en la orden de entrega
• Encuentre la etiqueta de envío en la sección Chatter en la parte inferior
• Haga clic en el adjunto para descargar e imprimir la etiqueta
• Adjunte la etiqueta impresa a su paquete y envíelo

Flujo de trabajo 3: Envíos con múltiples paquetes

Si su orden de entrega contiene múltiples paquetes:

• En la orden de entrega, después de establecer las cantidades Done
• Use el botón Put in Pack para crear paquetes:
• Seleccione productos para el primer paquete
• Haga clic en Put in Pack - crea el Paquete 1
• Repita para paquetes adicionales
• Haga clic en Validate - el comportamiento depende de la configuración de su transportista: Modo Shipments (predeterminado):
• Crea un envío individual de EasyPost para cada paquete
• Cada paquete obtiene su propio número de seguimiento
• Cada paquete se cobra por separado
• El sistema genera un único PDF/ZPL combinado con todas las etiquetas en secuencia Modo Batch:
• Crea un envío por lotes que contiene todos los paquetes
• Los paquetes se compran juntos en una sola transacción
• Puede proporcionar mejores tarifas para envíos a granel
• Un único archivo de etiqueta combinado con todas las etiquetas de los paquetes
• Todos los números de seguimiento se muestran en la orden de entrega (separados por comas)
• El archivo de etiqueta combinado contiene todas las etiquetas de los paquetes - imprima y adjunte a los paquetes correspondientes

Flujo de trabajo 4: Seguir envíos

Después de la creación del envío:

• Abra la orden de entrega
• Haga clic en el botón/enlace Tracking en el formulario
• Abre la página de seguimiento de EasyPost en una nueva pestaña del navegador
• Vea el estado del envío en tiempo real, el historial de ubicaciones y la confirmación de entrega

Uso de empaques de producto para tarifas precisas

Para usar tipos de paquete específicos del transportista (cajas de tarifa plana, sobres, etc.):

• En la orden de entrega, después de usar Put in Pack
• Edite el registro Package creado
• Establezca el campo Packaging en un empaque de producto configurado para EasyPost (consulte CONFIGURE.rst)
• Las dimensiones del empaque y el código de paquete del remitente se envían a EasyPost
• Da como resultado tarifas más precisas y garantiza la compatibilidad con el transportista

Guía de formatos de etiqueta

Elija el formato de etiqueta adecuado para su configuración de impresión:

• Formato PDF:
• Funciona con todas las impresoras estándar
• Se puede previsualizar en el navegador antes de imprimir
• Ideal para oficinas con impresoras láser/de inyección de tinta normales
• Tamaño de etiqueta: normalmente 8.5"x11" o 4"x6"
• Formato ZPL:
• Para impresoras térmicas de etiquetas Zebra
• Impresión térmica directa (no requiere tinta/tóner)
• Común en almacenes y departamentos de envío
• Requiere una impresora térmica compatible con ZPL
• Formato EPL2:
• Para impresoras térmicas Eltron heredadas y Zebra más antiguas
• Úselo solo si su impresora no es compatible con ZPL
• Menos común en las operaciones de envío modernas

Notas importantes de uso

• Peso del producto requerido: Todos los productos del pedido deben tener el peso configurado. Los pedidos sin peso no pueden calcular tarifas de envío.
• Direcciones completas requeridas: Tanto la dirección del almacén (origen del envío) como la dirección del cliente (destino del envío) deben estar completas con calle, ciudad, estado/provincia, código postal y país.
• Envíos en modo de prueba: Los envíos creados en modo de prueba (con clave de API de prueba) no se envían realmente. Son envíos simulados con fines de prueba y no se aplican cargos.
• No se pueden cancelar envíos: Los envíos de EasyPost no se pueden cancelar a través de Odoo. Algunos transportistas permiten reembolsos dentro de las 24 horas - use el panel de EasyPost para solicitudes de reembolso.
• Caducidad de tarifas: Las tarifas de envío pueden cambiar entre la cotización y el envío si ha pasado mucho tiempo. El sistema recalculará automáticamente las tarifas en el momento del envío si la tarifa almacenada ha caducado.
• Múltiples transportistas: EasyPost compara automáticamente las tarifas de múltiples transportistas (USPS, UPS, FedEx, etc.) y selecciona la tarifa más baja. Puede ver el nombre del transportista seleccionado en la línea de envío (p. ej., "Easypost - USPS Priority").
• Actualizaciones de seguimiento: La información de seguimiento está disponible inmediatamente después de la creación del envío. Los eventos de seguimiento reales (escaneos, entrega) aparecen a medida que el transportista procesa el envío.