Skip to content
Closed
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
6 changes: 6 additions & 0 deletions setup/stock_picking_signature/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,
)
104 changes: 104 additions & 0 deletions stock_picking_signature/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
.. image:: https://odoo-community.org/readme-banner-image
:target: https://odoo-community.org/get-involved?utm_source=readme
:alt: Odoo Community Association

=======================
Stock Picking Signature
=======================

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

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
:target: https://odoo-community.org/page/development-status
:alt: Alpha
.. |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-nuobit%2Fodoo--addons-lightgray.png?logo=github
:target: https://github.com/nuobit/odoo-addons/tree/16.0/stock_picking_signature
:alt: nuobit/odoo-addons

|badge1| |badge2| |badge3|

This module extends the stock picking signature functionality in Odoo 16.

While Odoo 16 already includes a signature field on pickings, it is limited to outgoing
deliveries only and lacks metadata tracking. This module adds:

* **Configurable per picking type**: A ``Require Signature`` option on operation types
lets administrators enable signature requirements for any type of transfer (receipts,
deliveries, internal transfers).
* **Signature metadata**: ``Signed By`` and ``Signed On`` fields are automatically
populated when a signature is captured.
* **Validation enforcement**: Transfers with a required signature cannot be validated
without one.
* **Extended reports**: Signature block added to the Picking Operations report in
addition to the existing Delivery Slip report.
* **Signature tab**: A dedicated "Signature" notebook tab on the picking form shows
signature details.

.. IMPORTANT::
This is an alpha version, the data model and design can change at any time without warning.
Only for development or testing purpose, do not use in production.
`More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
:local:

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

* Integration with ``sign_oca`` (`OCA/sign <https://github.com/OCA/sign>`_) for PDF
document signing workflows on stock pickings.
* Integration with ``stock_picking_portal``
(`OCA/stock-logistics-workflow <https://github.com/OCA/stock-logistics-workflow>`_)
for portal-based signature capture, allowing external partners to sign pickings
directly from the portal.

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

Bugs are tracked on `GitHub Issues <https://github.com/nuobit/odoo-addons/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/nuobit/odoo-addons/issues/new?body=module:%20stock_picking_signature%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
~~~~~~~

* NuoBiT Solutions SL

Contributors
~~~~~~~~~~~~

* `NuoBiT <https://www.nuobit.com>`__:

* Eric Antones <[email protected]>

Maintainers
~~~~~~~~~~~

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

Current maintainer:

|maintainer-eantones|

This module is part of the `nuobit/odoo-addons <https://github.com/nuobit/odoo-addons/tree/16.0/stock_picking_signature>`_ project on GitHub.

You are welcome to contribute.
1 change: 1 addition & 0 deletions stock_picking_signature/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
from . import models
24 changes: 24 additions & 0 deletions stock_picking_signature/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Copyright 2026 NuoBiT Solutions SL - Eric Antones <[email protected]>
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

{
"name": "Stock Picking Signature",
"summary": "Configurable signature requirement per picking type",
"author": "NuoBiT Solutions SL",
"maintainers": ["eantones"],
"category": "Warehouse",
"development_status": "Alpha",
"version": "16.0.1.0.0",
"license": "AGPL-3",
"website": "https://github.com/nuobit/odoo-addons",
"depends": [
"stock",
],
"data": [
"views/stock_picking_type_views.xml",
"views/stock_picking_views.xml",
"report/report_deliveryslip.xml",
"report/report_stockpicking_operations.xml",
],
"installable": True,
}
48 changes: 48 additions & 0 deletions stock_picking_signature/i18n/ca.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * stock_picking_signature
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Language: ca\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#. module: stock_picking_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking__require_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking_type__require_signature
msgid "Require Signature"
msgstr "Requerir signatura"

#. module: stock_picking_signature
#: model:ir.model.fields,help:stock_picking_signature.field_stock_picking_type__require_signature
msgid "If enabled, a signature will be required to validate transfers of this operation type."
msgstr "Si s'activa, es requerirà una signatura per validar les transferències d'aquest tipus d'operació."

#. module: stock_picking_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking__signed_by
msgid "Signed By"
msgstr "Signat per"

#. module: stock_picking_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking__signed_on
msgid "Signed On"
msgstr "Signat el"

#. module: stock_picking_signature
#: model_terms:ir.ui.view,arch_db:stock_picking_signature.report_picking
#: model_terms:ir.ui.view,arch_db:stock_picking_signature.view_picking_form
msgid "Signature"
msgstr "Signatura"

#. module: stock_picking_signature
#: code:addons/stock_picking_signature/models/stock_picking.py:0
#, python-format
msgid "The following transfers require a signature before validation:\n%s"
msgstr "Les transferències següents requereixen una signatura abans de la validació:\n%s"
48 changes: 48 additions & 0 deletions stock_picking_signature/i18n/es.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * stock_picking_signature
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Language: es\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#. module: stock_picking_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking__require_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking_type__require_signature
msgid "Require Signature"
msgstr "Requerir firma"

#. module: stock_picking_signature
#: model:ir.model.fields,help:stock_picking_signature.field_stock_picking_type__require_signature
msgid "If enabled, a signature will be required to validate transfers of this operation type."
msgstr "Si se activa, se requerirá una firma para validar las transferencias de este tipo de operación."

#. module: stock_picking_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking__signed_by
msgid "Signed By"
msgstr "Firmado por"

#. module: stock_picking_signature
#: model:ir.model.fields,field_description:stock_picking_signature.field_stock_picking__signed_on
msgid "Signed On"
msgstr "Firmado el"

#. module: stock_picking_signature
#: model_terms:ir.ui.view,arch_db:stock_picking_signature.report_picking
#: model_terms:ir.ui.view,arch_db:stock_picking_signature.view_picking_form
msgid "Signature"
msgstr "Firma"

#. module: stock_picking_signature
#: code:addons/stock_picking_signature/models/stock_picking.py:0
#, python-format
msgid "The following transfers require a signature before validation:\n%s"
msgstr "Las transferencias siguientes requieren una firma antes de la validación:\n%s"
2 changes: 2 additions & 0 deletions stock_picking_signature/models/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
from . import stock_picking
from . import stock_picking_type
47 changes: 47 additions & 0 deletions stock_picking_signature/models/stock_picking.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Copyright 2026 NuoBiT Solutions SL - Eric Antones <[email protected]>
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from odoo import _, fields, models
from odoo.exceptions import UserError


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

require_signature = fields.Boolean(
related="picking_type_id.require_signature",
)
signed_by = fields.Char(
copy=False,
)
signed_on = fields.Datetime(
copy=False,
)

def write(self, vals):
res = super().write(vals)
if vals.get("signature"):
now = fields.Datetime.now()
for picking in self:
sign_vals = {}
if not picking.signed_by and picking.partner_id:
sign_vals["signed_by"] = picking.partner_id.name
if not picking.signed_on:
sign_vals["signed_on"] = now
if sign_vals:
super(StockPicking, picking).write(sign_vals)
return res

def button_validate(self):
pickings_require_sign = self.filtered(
lambda p: p.require_signature and not p.signature
)
if pickings_require_sign:
raise UserError(
_(
"The following transfers require a signature"
" before validation:\n%s",
"\n".join(pickings_require_sign.mapped("name")),
)
)
return super().button_validate()
13 changes: 13 additions & 0 deletions stock_picking_signature/models/stock_picking_type.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Copyright 2026 NuoBiT Solutions SL - Eric Antones <[email protected]>
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from odoo import fields, models


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

require_signature = fields.Boolean(
help="If enabled, a signature will be required to validate "
"transfers of this operation type.",
)
3 changes: 3 additions & 0 deletions stock_picking_signature/readme/CONTRIBUTORS.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
* `NuoBiT <https://www.nuobit.com>`__:

* Eric Antones <[email protected]>
16 changes: 16 additions & 0 deletions stock_picking_signature/readme/DESCRIPTION.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
This module extends the stock picking signature functionality in Odoo 16.

While Odoo 16 already includes a signature field on pickings, it is limited to outgoing
deliveries only and lacks metadata tracking. This module adds:

* **Configurable per picking type**: A ``Require Signature`` option on operation types
lets administrators enable signature requirements for any type of transfer (receipts,
deliveries, internal transfers).
* **Signature metadata**: ``Signed By`` and ``Signed On`` fields are automatically
populated when a signature is captured.
* **Validation enforcement**: Transfers with a required signature cannot be validated
without one.
* **Extended reports**: Signature block added to the Picking Operations report in
addition to the existing Delivery Slip report.
* **Signature tab**: A dedicated "Signature" notebook tab on the picking form shows
signature details.
6 changes: 6 additions & 0 deletions stock_picking_signature/readme/ROADMAP.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
* Integration with ``sign_oca`` (`OCA/sign <https://github.com/OCA/sign>`_) for PDF
document signing workflows on stock pickings.
* Integration with ``stock_picking_portal``
(`OCA/stock-logistics-workflow <https://github.com/OCA/stock-logistics-workflow>`_)
for portal-based signature capture, allowing external partners to sign pickings
directly from the portal.
19 changes: 19 additions & 0 deletions stock_picking_signature/report/report_deliveryslip.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- Copyright 2026 NuoBiT Solutions SL - Eric Antones <[email protected]>
License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
<odoo>
<template id="report_delivery_document" inherit_id="stock.report_delivery_document">
<xpath
expr="//div[@name='signature']//p[@t-field='o.partner_id.name']"
position="attributes"
>
<attribute name="t-if">not o.signed_by</attribute>
</xpath>
<xpath
expr="//div[@name='signature']//p[@t-field='o.partner_id.name']"
position="after"
>
<p t-if="o.signed_by" t-field="o.signed_by" />
</xpath>
</template>
</odoo>
24 changes: 24 additions & 0 deletions stock_picking_signature/report/report_stockpicking_operations.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
<?xml version="1.0" encoding="utf-8" ?>
<!-- Copyright 2026 NuoBiT Solutions SL - Eric Antones <[email protected]>
License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
<odoo>
<template id="report_picking" inherit_id="stock.report_picking">
<xpath expr="//p[@t-field='o.note']" position="after">
<div t-if="o.signature" class="mt32 ml64 mr4" name="signature">
<div class="offset-8">
<strong>Signature</strong>
</div>
<div class="offset-8">
<img
t-att-src="image_data_uri(o.signature)"
style="max-height: 4cm; max-width: 8cm;"
/>
</div>
<div class="offset-8 text-center">
<p t-if="o.signed_by" t-field="o.signed_by" />
<p t-else="" t-field="o.partner_id.name" />
</div>
</div>
</xpath>
</template>
</odoo>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading