---
title: Attachments to Peppol invoices
description: Explains how to send attachments through the interface, API, XML and SFTP and what to check when an attachment is missing.
---

[Skip to content](https://knowledge.qvalia.com/how-to-add-attachments-to-a-peppol-e-invoice#main-content)

- [English](https://knowledge.qvalia.com/how-to-add-attachments-to-a-peppol-e-invoice)
- [Svenska](https://knowledge.qvalia.com/sv/hur-lägger-man-till-bilagor-till-en-peppol-e-faktura)

English

Show submenu for translations

[Submit a ticket](https://knowledge.qvalia.com/kb-tickets/new?hsLang=en) [Customer portal](https://servicedesk.qvalia.com/tickets?hsLang=en)

![Qvalia Logo New Blue transparent.png\]](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png)

Open main navigation

Close main navigation

- - [English](https://knowledge.qvalia.com/how-to-add-attachments-to-a-peppol-e-invoice)
    - [Svenska](https://knowledge.qvalia.com/sv/hur-lägger-man-till-bilagor-till-en-peppol-e-faktura)

  English
  
  Show submenu for translations
- [Submit a ticket](https://knowledge.qvalia.com/kb-tickets/new)
- [Customer portal](https://servicedesk.qvalia.com/tickets)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://knowledge.qvalia.com/?hsLang=en)
2. [Invoice management](https://knowledge.qvalia.com/invoice-management?hsLang=en)

# Attachments to Peppol invoices

## Attachments are sent as part of the invoice's structured message. How you add them depends on whether the invoice is created in the interface or sent through API, XML or SFTP.

- In the Qvalia interface, you can add PDF attachments up to 8 MB in total per invoice.
- Through the API, you can send attachment formats supported by Peppol. The complete API request, including base64-encoded attachments, may be up to 100 MB.
- In a Peppol XML file, the attachment is embedded in `AdditionalDocumentReference` under `EmbeddedDocumentBinaryObject`.
- Over SFTP, you can place the invoice file and its PDF attachments in the same ZIP or 7Z archive and upload it to `/send`.

### Send an attachment through the Qvalia interface

Add the attachment when creating the invoice. Attachments must be PDF files and may total up to 8 MB. The interface shows an error if the limit is exceeded.

### Send an attachment through API or Peppol XML

The API supports formats including PDF, PNG, JPEG, CSV, Excel and OpenDocument. The attachment is sent base64-encoded with the correct MIME type and file name. Remember that base64 encoding increases the amount of data and that the complete API request must remain within 100 MB.

If you produce the Peppol XML yourself, place the attachment in `AdditionalDocumentReference` under `EmbeddedDocumentBinaryObject`, with `mimeCode` and file name specified.

### Send separate PDF attachments over SFTP

1. Create a ZIP or 7Z archive containing the invoice file and its PDF attachments.
2. Upload the archive to `/send` on your SFTP.
3. Qvalia extracts the archive and uses the PDF files as invoice attachments.

An archive is only needed when sending separate attachment files. Upload an invoice without separate attachments as a normal XML file to `/send`. An attachment already embedded in Peppol XML also requires no archive.

Prefer file names using English letters and digits, without spaces, and a lowercase file extension, for example `invoice123.pdf`. Special characters in a file name can prevent the attachment from being processed correctly.

Contact Qvalia before sending several invoices with separate attachments in the same archive so that the setup can be verified.

### If the recipient cannot see the attachment

1. Check that the attachment is actually present in the sent message.
2. Check whether there is only a document reference. A reference is not the same as an embedded attachment.
3. Ask the recipient to check that their system reads and displays embedded Peppol attachments.
4. Find the invoice in the transaction log and contact support if the sent message needs to be checked.

### If it still does not work

- **Check once more:** the channel, file type, total size, MIME type and file name.
- **Have this ready when contacting support:** invoice number, recipient, channel, attachment file name and type, timestamp and internal transaction ID.
- **Contact support:** through the support form at the bottom of https://qvalia.com or at help@qvalia.com.

- [General](https://knowledge.qvalia.com/general?hsLang=en#main-content)

    - [Peppol](https://knowledge.qvalia.com/general?hsLang=en#peppol)
- [Partner](https://knowledge.qvalia.com/partner?hsLang=en)
- [Logs and monitoring](https://knowledge.qvalia.com/logs-and-monitoring?hsLang=en)
- [Integrations](https://knowledge.qvalia.com/integrations?hsLang=en)
- [Invoice management](https://knowledge.qvalia.com/invoice-management?hsLang=en)
- [Order management](https://knowledge.qvalia.com/order-management?hsLang=en)
- [Data management](https://knowledge.qvalia.com/data-management?hsLang=en)
- [Security and compliance](https://knowledge.qvalia.com/security-and-compliance?hsLang=en)
- [Account](https://knowledge.qvalia.com/account?hsLang=en)
- [Troubleshooting](https://knowledge.qvalia.com/troubleshooting?hsLang=en)

[![Chill listening crop-3](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?width=107&height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png "Chill listening crop-3")](https://qvalia.com/)

Knowledge base

Copyright © 2025, Qvalia