Skip to content

Commit

Permalink
[ADD] stock_picking_delivery_label_link: New module
Browse files Browse the repository at this point in the history
TT51077
  • Loading branch information
chienandalu committed Oct 17, 2024
1 parent 9a9021b commit fbf4287
Show file tree
Hide file tree
Showing 14 changed files with 631 additions and 0 deletions.
6 changes: 6 additions & 0 deletions setup/stock_picking_delivery_label_link/setup.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
import setuptools

setuptools.setup(
setup_requires=['setuptools-odoo'],
odoo_addon=True,
)
93 changes: 93 additions & 0 deletions stock_picking_delivery_label_link/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
=====================================
Link to shipping label in the picking
=====================================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:590b969010f95c7c85176d709a27049c291823e636203aa95019b122d4715f44
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |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%2Fdelivery--carrier-lightgray.png?logo=github
:target: https://github.com/OCA/delivery-carrier/tree/15.0/stock_picking_delivery_label_link
:alt: OCA/delivery-carrier
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/delivery-carrier-15-0/delivery-carrier-15-0-stock_picking_delivery_label_link
: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/delivery-carrier&target_branch=15.0
:alt: Try me on Runboat

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

This module links the carrier generated labels to the picking so it's
easy to spot them.

**Table of contents**

.. contents::
:local:

Use Cases / Context
===================

The final aim of this module is to allow to automatically print those
labels in a CUPS printer. For that, the first step is to be able to tell
which one of the picking attachments correspond to the shipping labels
themeselves.

Usage
=====

Carrier implementations automatically attach the shipping labels in the
picking mail thread. Anyway, they can be manually attached or deleted.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/delivery-carrier/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/delivery-carrier/issues/new?body=module:%20stock_picking_delivery_label_link%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://tecnativa.com>`__

- David Vidal

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/delivery-carrier <https://github.com/OCA/delivery-carrier/tree/15.0/stock_picking_delivery_label_link>`_ 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 stock_picking_delivery_label_link/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
15 changes: 15 additions & 0 deletions stock_picking_delivery_label_link/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Copyright 2024 Tecnativa - David Vidal
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
{
"name": "Link to shipping label in the picking",
"summary": "Links the shipping label(s) to the picking",
"author": "Tecnativa, Odoo Community Association (OCA)",
"website": "https://github.com/OCA/delivery-carrier",
"license": "AGPL-3",
"category": "Delivery",
"version": "15.0.1.0.0",
"depends": ["delivery"],
"data": [
"views/stock_picking_views.xml",
],
}
2 changes: 2 additions & 0 deletions stock_picking_delivery_label_link/models/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
from . import delivery_carrier
from . import stock_picking
21 changes: 21 additions & 0 deletions stock_picking_delivery_label_link/models/delivery_carrier.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Copyright 2024 Tecnativa - David Vidal
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
from odoo import models


class DeliveryCarrier(models.Model):
_inherit = "delivery.carrier"

def send_shipping(self, pickings):
# Shipping labels are attached to the record during this method. There's no
# core hook method for this, and we want to avoid pulling a dependency in
# every carrier implementation.
previous_attachments = {
picking: picking.allowed_shipping_attachement_ids for picking in pickings
}
result = super().send_shipping(pickings)
for picking in pickings:
picking.shipping_label_ids = (
picking.allowed_shipping_attachement_ids - previous_attachments[picking]
)
return result
24 changes: 24 additions & 0 deletions stock_picking_delivery_label_link/models/stock_picking.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Copyright 2024 Tecnativa - David Vidal
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
from odoo import fields, models


class StockPicking(models.Model):
_inherit = "stock.picking"

allowed_shipping_attachement_ids = fields.Many2many(
comodel_name="ir.attachment",
compute="_compute_allowed_shipping_attachement_ids",
)
shipping_label_ids = fields.Many2many(
comodel_name="ir.attachment",
# We don't want the attachment to be deleted by mistake
ondelete="restrict",
domain="[('id', 'in', allowed_shipping_attachement_ids)]",
)

def _compute_allowed_shipping_attachement_ids(self):
for picking in self:
picking.allowed_shipping_attachement_ids = self.env["ir.attachment"].search(
[("res_model", "=", self._name), ("res_id", "=", picking.id)]
)
3 changes: 3 additions & 0 deletions stock_picking_delivery_label_link/readme/CONTEXT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
The final aim of this module is to allow to automatically print those labels in a CUPS
printer. For that, the first step is to be able to tell which one of the picking
attachments correspond to the shipping labels themeselves.
2 changes: 2 additions & 0 deletions stock_picking_delivery_label_link/readme/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
- [Tecnativa](https://tecnativa.com)
- David Vidal
2 changes: 2 additions & 0 deletions stock_picking_delivery_label_link/readme/DESCRIPTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
This module links the carrier generated labels to the picking so it's easy to spot
them.
2 changes: 2 additions & 0 deletions stock_picking_delivery_label_link/readme/USAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
Carrier implementations automatically attach the shipping labels in the picking mail
thread. Anyway, they can be manually attached or deleted.
Loading

0 comments on commit fbf4287

Please sign in to comment.