Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[16.0][MIG] delivery_seur_atlas: Migration to 16.0 #3810

Open
wants to merge 14 commits into
base: 16.0
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
157 changes: 157 additions & 0 deletions delivery_seur_atlas/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,157 @@
===================
Delivery SEUR Atlas
===================

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

.. |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/16.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-16-0/l10n-spain-16-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=16.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:%2016.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/16.0/delivery_seur_atlas>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 change: 1 addition & 0 deletions delivery_seur_atlas/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
18 changes: 18 additions & 0 deletions delivery_seur_atlas/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Copyright 2022 Tecnativa
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
{
"name": "Delivery SEUR Atlas",
"summary": "Integrate SEUR Atlas API",
"author": "Tecnativa, Odoo Community Association (OCA)",
"website": "https://github.com/OCA/l10n-spain",
"license": "AGPL-3",
"category": "Delivery",
"version": "16.0.1.0.0",
"depends": [
"delivery",
"delivery_package_number",
"delivery_price_method",
"delivery_state",
],
"data": ["views/delivery_carrier_views.xml"],
}
Loading
Loading