Skip to main content

Integrate SEUR Atlas API

Project description

Beta License: AGPL-3 OCA/l10n-spain Translate me on Weblate Try me on Runboat

Integración del API SEUR ATLAS con Odoo.

Table of contents

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.

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

Authors

  • Tecnativa

Contributors

Tecnativa

  • Pedro M. Baeza

  • David Vidal

  • Víctor Martínez

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page