OdooWiki OCA HUB

Delivery SEUR Atlas

delivery_seur_atlas folder_open OCA/l10n-spain open_in_new
Delivery License: AGPL-3

Integración del API SEUR ATLAS con Odoo.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds SEUR Atlas as a shipping carrier in Odoo so you can send shipments, print SEUR labels and follow parcel tracking directly from delivery orders.

This module adds a new delivery method called "Seur Atlas" on the delivery carrier form. When you select it, an "Integration" tab appears where you enter your SEUR customer data (VAT and account code), API credentials (user, password, secret and client), the service and product codes, and how labels should be produced (PDF, ZPL or die-cut A4, template, output as file, link or both, and an optional AZTEC QR code).

From a delivery order, the module sends the shipment to SEUR and stores the returned shipment code as the carrier tracking reference. It then downloads the labels and attaches them to the delivery order as PDF or text files, named after the SEUR shipment code.

It also updates tracking: it retrieves the full tracking history from SEUR, writes it on the delivery order, and maps SEUR event codes to Odoo delivery states such as in transit, delivered, incident or cancelled. A tracking link to the SEUR live tracking page is provided, and shipments can be cancelled from Odoo.

Business rules shown in the code: the sender country is always Spain, Andorra addresses are sent as Spain, parcel weight is split evenly across the number of packages, and rate calculation is not implemented yet. All API calls are logged for debugging when debug mode is active.

Models and fields (1)
  • delivery.carrier · extends an existing modeldelivery_type, seur_atlas_qr, seur_atlas_vat (Account VAT), seur_atlas_client, seur_atlas_secret, seur_atlas_password, seur_atlas_username, seur_atlas_account_code (Account code (CCC)), seur_atlas_label_format, seur_atlas_product_code (Product code), seur_atlas_service_code (Service code), seur_atlas_label_template, seur_atlas_label_output_type

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 15.0

Confirmed on 2026-11-03 in branch 15.0 of OCA/l10n-spain.

terminal Installation and usage

OCA documentation · Odoo 19.0

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

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:

  • Inventario/Ventas > Configuración > Métodos de envío y editar o crear uno nuevo.
  • Escoge Seur Atlas como proveedor.
  • Configura tus credenciales de Atlas: NIF, código de cuenta, nombre de usuario, secreto, y código de cliente.
  • Configura el servicio y producto SEUR que necesites.
  • Configura el formato de etiqueta que necesites:
  • ZPL
  • PDF
  • A4 troquelado
  • 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.

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.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.