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

[17.0][MIG] delivery_gls_asm: Migration to 17.0 #3865

Open
wants to merge 43 commits into
base: 17.0
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
39f3dee
[ADD] gls_asm_delivery: New module
chienandalu Jun 5, 2020
46c8d4c
Translated using Weblate (Spanish)
chienandalu Oct 6, 2020
827900f
[IMP] delivery_gls and delivery_seur: add informative exceptions
chienandalu Oct 8, 2020
dd700fa
[FIX] delivery_gls_asm: manifest
chienandalu Oct 9, 2020
4aeab71
[FIX] delivery_gls_manifest: manifest destination name
chienandalu Oct 15, 2020
92c33f7
[FIX] delivery_gls_asm: Proper signature for gls_asm_rate_shipment
pedrobaeza Feb 17, 2021
555d214
[IMP] delivery_gls_asm: black, isort, prettier
victoralmau Feb 25, 2021
887d5a0
[FIX] delivery_gls_asm: escaping shipping vals for xml
chienandalu Mar 9, 2021
9846bff
[MIG] delivery_gls_asm: Migration to 13.0
victoralmau Feb 25, 2021
b3ff264
Added translation using Weblate (Catalan)
brendapaniagua Mar 19, 2021
45798fe
Translated using Weblate (Spanish)
brendapaniagua Mar 19, 2021
0f16d1a
Translated using Weblate (Catalan)
brendapaniagua Mar 22, 2021
7732cc3
[13.0][IMP] delivery_gls_asm: black, isort, prettier
hildickethan Apr 15, 2021
d52949d
[14.0][MIG] delivery_gls_asm: Migration to 14.0
hildickethan Apr 16, 2021
c183dac
[14.0][IMP] delivery_gls_asm: Pick-up request integration
hildickethan Jul 29, 2021
fa9a0b4
[14.0][IMP] delivery_gls_asm: GLS states
hildickethan Nov 11, 2021
51e7c5c
[12.0][FIX] delivery_gls_asm: Escape destination street
hildickethan Nov 29, 2021
3e12b60
[FIX] delivery_gls_asm: escaped int
chienandalu Jan 12, 2022
9bc48e3
[14.0][FIX] delivery_gls_asm: stock_picking_batch fail
Reyes4711-S73 Mar 23, 2022
a82826d
[IMP] delivery_gls_asm: warn about reference limit
chienandalu Dec 9, 2021
5780dab
[14.0][IMP] delivery_gls_asm: Referencia albarán
hildickethan Apr 1, 2022
5fa41bc
[14.0][IMP] delivery_gls_asm: Cash on delivery
hildickethan Apr 7, 2022
acf54ca
[IMP] delivery_gls_asm: master data
chienandalu May 10, 2022
0588f9b
[IMP] delivery_gls_asm: fallback to commercial entity phone
chienandalu May 10, 2022
ad59557
[IMP] delivery_gls_asm: Mark as return
hildickethan Feb 21, 2022
c841fb4
[14.0][FIX] delivery_gls_asm: Convert into list if not Iterable
hildickethan Jun 7, 2022
64e8e7e
[IMP] delivery_gls_asm: International tracking links
hildickethan Jul 13, 2022
435e65c
[IMP] delivery_gls_asm: Add maintainers
hildickethan Jul 14, 2022
ea122d6
[14.0][FIX] delivery_gls_asm: prevent escape of bool
Jul 22, 2022
5b8a5f5
[IMP] delivery_gls_asm: hide cancel button for other carriers
mariadforgeflow Oct 18, 2022
e21cc2d
[MIG] delivery_gls_asm: Migration to 15.0
victoralmau Oct 19, 2022
fe9aae2
Translated using Weblate (Spanish)
Ivorra78 Jul 5, 2023
7b03c2c
[FIX]delivery_gls_asm: Discontinued GetManifiesto API method
manuelregidor Jul 25, 2023
d1d69d1
[FIX] delivery_gls_asm: delivery_package_number compatibility
chienandalu Sep 19, 2023
cf052ab
[IMP] delivery_gls_asm: Notas envío GLS
hildickethan May 19, 2023
8385e61
Translated using Weblate (Spanish)
Ivorra78 Sep 27, 2023
7ab3fff
[FIX] *: Linter fixes
pedrobaeza Oct 28, 2023
d475f77
[MIG] delivery_gls_asm: Migration to 16.0
hildickethan Dec 15, 2023
ab81258
[IMP] delivery_gls_asm: Nuevo servicio '96 - BUSINESS PARCEL'
ioans73 Feb 8, 2024
ac75834
[IMP] delivery_gls_asm: rename/add shipping times
chienandalu Apr 16, 2024
90195be
[IMP] delivery_gls_asm: Check value being sent
hildickethan May 27, 2024
b7c33d7
[IMP] delivery_gls_asm: pre-commit auto fixes
Tisho99 Dec 19, 2024
36f1f56
[MIG] delivery_gls_asm: Migration to 17.0
Tisho99 Dec 19, 2024
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
222 changes: 222 additions & 0 deletions delivery_gls_asm/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,222 @@
================
Delivery GLS-ASM
================

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

.. |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/17.0/delivery_gls_asm
: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-17-0/l10n-spain-17-0-delivery_gls_asm
: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=17.0
:alt: Try me on Runboat

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

Este módulo integra la API de GLS España (antigua API de ASM) con Odoo.
No es válido para integraciones de GLS en otros países, que podrían usar
otras APIs.

**Table of contents**

.. contents::
:local:

Installation
============

Este módulo necesita la librería python suds-py3 y depende igualmente de
los módulos de OCA/delivery-carrier delivery_package_number y
delivery_state.

La API de GLS/ASM no provee métodos de cálculo de precio, de modo que
para poder calcular los costes de envío sería recomendable instalar el
módulo delivery_price_method.

Configuration
=============

Para configurar el transportista:

1. Vaya a *Inventario > Configuración > Entrega > Método de envío* y
cree uno nuevo.
2. Escoja *GLS ASM* Como proveedor.
3. Configure los datos de servicio que tiene contratados y el producto
de envío que desea utilizar.

Si no tiene credenciales todavía, puede poner datos inventados y dejar
el método de envío en "Entorno de prueba". Se utilizará el usuario de
pruebas de la API GLS ASM.

Si GLS cambiase en un futuro el usuario de prueba, puede cambiarlo en
los *Parámetros del sistema* en la clave delivery_gls_asm.api_user_demo.

Usage
=====

Estas son las distintas operaciones posibles con este módulo:

Grabar servicios
----------------

1. Al confirmar el albarán, el servicio se grabará en GLS.
2. Con la respuesta, se registrará en el chatter la referencia de
envío y las etiquetas correspondientes.
3. Para gestionar los bultos del envío, se puede utilizar el campo de
número de bultos que añade delivery_package_number (ver el README
para mayor información) o bien el flujo nativo de Odoo con
paquetes de envío. El módulo mandará a la API de GLS/ASM el número
correspondiente y podremos descargar las etiquetas en PDF con su
correspondiente numeración.

Pedir recogidas
---------------

1. Al confirmar el albarán con un servicio de recogida, el envío NO
se grabará en GLS.
2. Aparecerá un botón de "Enviar recogida" en la parte superior para
solicitarlo
3. Con la respuesta, se registrará en el chatter la referencia de
envío
4. Para gestionar los bultos del envío, se puede utilizar el campo de
número de bultos que añade delivery_package_number (ver el README
para mayor información) o bien el flujo nativo de Odoo con
paquetes de envío.

Cancelar servicios
------------------

1. Al igual que en otros métodos de envío, en los albaranes de salida
podemos cancelar un servicio determinado mediante la acción
correspondiente en la pestaña de *Información Adicional*, sección
*Información de entrega* una vez el pedido esté confirmado y la
expedición generada.
2. Podremos generar una nueva expedición una vez cancelado si fuese
necesario.

Obtener etiquetas
-----------------

1. Si por error hubiésemos eliminado el adjunto de las etiquetas que
obtuvimos en la grabación del servicio, podemos obtenerlas de
nuevo pulsando en el botón "Etiqueta GLS" que tenemos en la parte
superior de la vista formulario del albarán.

Seguimiento de envíos
---------------------

1. El módulo está integrado con delivery_state para poder recabar la
información de seguimiento de nuestros envíos directamente desde
la API de GLS-ASM.
2. Para ello, vaya al albarán con un envío GLS ya grabado y en la
pestaña de *Información adicional* verá el botón *Actualizar
seguimiento* para pedir a la API de GLS que actualice el estado de
este envío en Odoo.

Manifiesto de envíos
--------------------

1. Para obtener el manifiesto de expediciones que firmaría el
repartidor, puede ir al menú *Inventario > Informes > Manifiesto
de Envíos GLS*.
2. También puede obtener el manifiesto desde un smart button en el
formulario del transportista.
3. En el asistente, seleccione el servicio GLS del cual quiere sacar
el manifiesto y la fecha desde la que desea listar los envíos.
4. Pulse en el botón "Manifiesto GLS" para obtener un listado en PDF
de los envíos del servicio seleccionado.

Depuración de errores
---------------------

1. Es importante tener en cuenta que solo funcionará con códigos
postales de España.
2. En cada servicio GLS-ASM dispone de una pestaña llamada "Técnico"
en la que puede consultar la última petición y respuesta a la API
de GLS-ASM. Esto le servirá como ayuda a la hora de depurar
posibles errores de comunicación.
3. También puede activar Odoo con --log-level=debug para registrar
las peticiones y las respuestas en el log.

Known issues / Roadmap
======================

- La API no facilita métodos para cotizar el coste real de los envíos,
por lo que siempre se cotizan a 0. Si la cotización de envíos es
necesaria, puede instalarse el módulo OCA delivery_price_method o
bien personalizar el método de cotización para este tipo de
transportista.

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_gls_asm%0Aversion:%2017.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>`__:

- David Vidal
- Víctor Martínez

- `Studio73 <https://www.studio73.es>`__:

- Ethan Hildick
- David López

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.

.. |maintainer-chienandalu| image:: https://github.com/chienandalu.png?size=40px
:target: https://github.com/chienandalu
:alt: chienandalu
.. |maintainer-hildickethan-S73| image:: https://github.com/hildickethan-S73.png?size=40px
:target: https://github.com/hildickethan-S73
:alt: hildickethan-S73

Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-chienandalu| |maintainer-hildickethan-S73|

This module is part of the `OCA/l10n-spain <https://github.com/OCA/l10n-spain/tree/17.0/delivery_gls_asm>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
2 changes: 2 additions & 0 deletions delivery_gls_asm/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
from . import models
from . import wizard
24 changes: 24 additions & 0 deletions delivery_gls_asm/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Copyright 2020 Tecnativa - David Vidal
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
{
"name": "Delivery GLS-ASM",
"summary": "Delivery Carrier implementation for GLS with ASMRed API",
"version": "17.0.1.1.1",
"category": "Stock",
"website": "https://github.com/OCA/l10n-spain",
"author": "Tecnativa, Odoo Community Association (OCA)",
"license": "AGPL-3",
"application": False,
"installable": True,
"depends": ["delivery_package_number", "delivery_state"],
"external_dependencies": {"python": ["suds-py3"]},
"data": [
"data/delivery_asm_data.xml",
"security/ir.model.access.csv",
"views/delivery_asm_view.xml",
"views/gls_asm_manifest_template.xml",
"views/stock_picking_views.xml",
"wizard/gls_asm_manifest_wizard_views.xml",
],
"maintainers": ["chienandalu", "hildickethan-S73"],
}
Loading
Loading