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

[Feature Request] Add option to add PDF417 barcode to invoice #1017

Open
bgradis opened this issue Jan 18, 2024 · 5 comments
Open

[Feature Request] Add option to add PDF417 barcode to invoice #1017

bgradis opened this issue Jan 18, 2024 · 5 comments
Labels
Feature Request Improvement or Feature Request
Milestone

Comments

@bgradis
Copy link

bgradis commented Jan 18, 2024

Expected Behavior

I would like to have an option to add a PDF417 barcode to the invoice which is used in Croatian invoices.

PDF417 spec can be found here (in Croatian language): https://www.hub.hr/sites/default/files/inline-files/2DBK_EUR_Uputa_1.pdf

Current Behavior

Screenshots

Example of an invoice with PDF417 barcode:
image

Possible Solution

Steps to Reproduce

Context (Environment)

Detailed Description

Possible Implementation

Failure Logs

@marneu
Copy link

marneu commented Jan 18, 2024 via email

@nielsdrost7
Copy link
Contributor

@bgradis thank you for your issue and @marneu thank you for the suggestion.
On the forums we're talking about all those QR possibilities, because, well, everyone invented their own standards
https://community.invoiceplane.com/t/topic/10627

@nielsdrost7 nielsdrost7 added this to the 1.6.2 milestone Jan 18, 2024
@nielsdrost7 nielsdrost7 added the Feature Request Improvement or Feature Request label Jan 18, 2024
@nielsdrost7 nielsdrost7 changed the title [Feature request] Add option to add PDF417 barcode to invoice [Feature Request]: Add option to add PDF417 barcode to invoice Jan 18, 2024
@nielsdrost7 nielsdrost7 changed the title [Feature Request]: Add option to add PDF417 barcode to invoice [Feature Request] Add option to add PDF417 barcode to invoice Jan 19, 2024
@nielsdrost7 nielsdrost7 pinned this issue Jan 19, 2024
@Verony-makesIT
Copy link
Contributor

@bgradis,
In the screenshot of your invoice, I also see a QR code.
Is this the the equivalent of this pdf417 barcode?
If so can you take me a screenshot (without resizing) so I can decode the (text?) data. (Just to see what the content looks like.)
A QR code is actually easier to create and put on your invoice.

@bgradis
Copy link
Author

bgradis commented Jan 19, 2024

Hmm, I should explain in detail.

QR codes on Croatian invoices are usually used for checking invoice validity on the tax administration server. QR code contains URL to https://porezna.gov.hr and sends ZKI or JIR code and invoice date. ZKI code is issuer_id and is always created based on the certificate provided by the tax administration. JIR code is received from the tax administration server as a response to sending ZKI to the tax server and is also required but in case of network issues, you have 48 hours to send all remaining ZKI codes.

All invoices/receipts that have cash or card transactions must have that code as fiscalisation law states. Transactional invoices don't need that.

Specifications for fiscalisation and QR codes can be found here: https://www.porezna-uprava.hr/HR_Fiskalizacija/Documents/Fiskalizacija-Tehnicka%20specifikacija%20za%20korisnike_v2.0.pdf (page 48)

Example of QR code used for fiscalisation:
image

PDF417 or maybe it would be better to say HUB-3 PDF417. HUB-3 means Croatian Banking Association (Hrvatska Udruga Banaka) and they define payment slip (not sure if correct translation) type which is called HUB-3 and it looks like this:
image
You usually receive that from the utility company for paying the bill. You can see that the PDF417 code is on the screenshot of the HUB3 payment slip. This is handy for scanning with mobile banking apps and accountants which have handheld scanners. I think almost all Croatian banks provide some sort of mobile app with some sort of mPayment variant.
Ad of one of the banks:
image

PDF417 barcode on the HUB3 payment slip contains all data from it in the structure defined in the following document: https://www.hub.hr/sites/default/files/inline-files/2DBK_EUR_Uputa_1.pdf

So basically instead of typing all invoice data, you can scan the code with your mPayment app and the payment order in the app will be prepared with all fields waiting for you to confirm so the transaction can be made.
So for example, HUB3 payment slip with following data structure and arrangement:
image

will have the corresponding PDF417 code:
image

@Verony-makesIT
Copy link
Contributor

@bgradis,
Thank you for this detailed explanation.
I had hoped for a moment that the QR code could also be useful for your purpose. Not so.
Maybe these links can help you a bit further on your way?

  1. Feature Request: Add Barcode for DataMatrix and PDF417 mpdf/mpdf#475
  2. https://github.com/ihabunek/pdf417-php

@Verony-makesIT Verony-makesIT unpinned this issue Jan 30, 2024
@nielsdrost7 nielsdrost7 pinned this issue Mar 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Feature Request Improvement or Feature Request
Projects
None yet
Development

No branches or pull requests

4 participants