Metadata-Version: 2.1
Name: odoo-addon-delivery_seur_atlas
Version: 18.0.1.0.0.2
Requires-Python: >=3.10
Requires-Dist: odoo-addon-delivery_package_number==18.0.*
Requires-Dist: odoo-addon-delivery_price_method==18.0.*
Requires-Dist: odoo-addon-delivery_state==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Integrate SEUR Atlas API
Home-page: https://github.com/OCA/l10n-spain
License: AGPL-3
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

===================
Delivery SEUR Atlas
===================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:9d261d88a69e5bdad4e41a4796add62307b9fd2a5e345167e24c87aece27300e
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--spain-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-spain/tree/18.0/delivery_seur_atlas
    :alt: OCA/l10n-spain
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-spain-18-0/l10n-spain-18-0-delivery_seur_atlas
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-spain&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Integración del API SEUR ATLAS con Odoo.

**Table of contents**

.. contents::
   :local:

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 <https://sds.seur.io/public-api>`__ (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 <https://sds.seur.io>`__.

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 <https://github.com/OCA/l10n-spain/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 <https://github.com/OCA/l10n-spain/issues/new?body=module:%20delivery_seur_atlas%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

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

Credits
=======

Authors
-------

* Tecnativa

Contributors
------------

`Tecnativa <https://www.tecnativa.com>`__

- Pedro M. Baeza
- David Vidal
- Víctor Martínez

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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 <https://github.com/OCA/l10n-spain/tree/18.0/delivery_seur_atlas>`_ project on GitHub.

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