Metadata-Version: 2.1
Name: odoo-addon-delivery_gls_asm
Version: 18.0.1.0.7.1
Requires-Python: >=3.10
Requires-Dist: odoo-addon-delivery_package_number==18.0.*
Requires-Dist: odoo-addon-delivery_state==18.0.*
Requires-Dist: odoo==18.0.*
Requires-Dist: suds-py3
Summary: Delivery Carrier implementation for GLS with ASMRed 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
Description-Content-Type: text/x-rst

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

================
Delivery GLS-ASM
================

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

.. |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_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-18-0/l10n-spain-18-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=18.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:%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>`__:

  - David Vidal
  - Víctor Martínez
  - Sergio Teruel

- `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-hildickethan| image:: https://github.com/hildickethan.png?size=40px
    :target: https://github.com/hildickethan
    :alt: hildickethan

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

|maintainer-hildickethan| 

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

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