Skip to content

Commit

Permalink
Merge PR #3657 into 15.0
Browse files Browse the repository at this point in the history
Signed-off-by pedrobaeza
  • Loading branch information
OCA-git-bot committed Aug 8, 2024
2 parents aa23d53 + 2a99a06 commit 6971296
Show file tree
Hide file tree
Showing 21 changed files with 1,787 additions and 0 deletions.
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:52b3156a78ba6d8cbee87b6ba275e842a7a306bbc3f79cc89469bfb776d56356
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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.
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": "15.0.1.0.0",
"depends": [
"delivery",
"delivery_package_number",
"delivery_price_method",
"delivery_state",
],
"data": ["views/delivery_carrier_views.xml"],
}
3 changes: 3 additions & 0 deletions delivery_seur_atlas/models/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
from . import delivery_carrier
from . import seur_request_atlas
from . import seur_master_data
Loading

0 comments on commit 6971296

Please sign in to comment.