Use Cases / Context

SEUR deja de dar servicio con su antigua API SOAP en 2025 para reemplazarla completamente con la nueva API Atlas basada en servicios web.

Hay una buena documentación de los métodos disponibles en el sitio web de la API Atlas (son necesarias credenciales para acceder).

Installation

Este módulo depende de los módulos delivery_package_number, delivery_price_method y delivery_state que se pueden encontrar en OCA/delivery-carrier.

Los siguientes puertos y hosts necesitan ser visibles desde tu despliegue de Odoo:

• Test: servicios.apipre.seur.io:443
• Production: servicios.api.seur.io:443

Configuration

Lo primero que necesitarás serán una credenciales para el API Atlas. Contacta con tu oficina de SEUR para conseguirlas y pruébalas en el sitio principal del API Atlas.

Una vez que tu oficina te facilite las credenciales necesarias, ya puedes configurar tus transportistas.

De momento, no hay implementados métodos de cálculo de tarifas de envío, de modo que necesitarás apoyarte en los métodos de precio de Odoo seleccionándolos en el campo Método de precio.

Para configurar tus servicios SEUR, debes ir a:

1. Inventario/Ventas > Configuración > Métodos de envío y editar o crear uno nuevo.
2. Escoge Seur Atlas como proveedor.
3. Configura tus credenciales de Atlas: NIF, código de cuenta, nombre de usuario, secreto, y código de cliente.
4. Configura el servicio y producto SEUR que necesites.
5. Configura el formato de etiqueta que necesites:
   • ZPL
   • PDF
   • A4 troquelado
6. Configura la plantilla de etiqueta y el tipo de salida.

Si deseas configurar varios servicios con las mismas credenciales, duplica un ya creado y cambia el servicio o el producto en la copia.

El timeout por defecto para las peticiones a la API es de 5 segundos. Se puede configurar uno distinto con la clave seur_atlas_timeout en ir.config_parameter.

Usage

Los códigos de envío se generan cuando un albarán cuyo transportista está configurado con SEUR Atlas como proveedor se valida. La etiqueta se genera también en ese momento y se adjunta al documento de acuerdo con los parámetros configurados en el transportista.

Para cancelar un envío, ve a la pestaña Información adicional y haz click en el enlace Cancelar envío que está al lado del campo Códgio de envío.

Known issues / Roadmap

• Implementar el cálculo de tarifas de envío. Ahora el API tiene soporte para ello, aunque hace necesario implementar de forma correcta la gestión de paquetes de envío, así como un uso correcto por parte de los usuarios.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/l10n-spain project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.