Metadata-Version: 2.1
Name: odoo-addon-delivery_seur_atlas
Version: 15.0.1.0.2
Summary: Integrate SEUR Atlas API
Home-page: https://github.com/OCA/l10n-spain
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 15.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.8
Requires-Dist: odoo-addon-delivery-package-number <15.1dev,>=15.0dev
Requires-Dist: odoo-addon-delivery-price-method <15.1dev,>=15.0dev
Requires-Dist: odoo-addon-delivery-state <15.1dev,>=15.0dev
Requires-Dist: odoo <15.1dev,>=15.0a

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

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

.. |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/licence-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/15.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-15-0/l10n-spain-15-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=15.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.

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:%2015.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/15.0/delivery_seur_atlas>`_ project on GitHub.

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