> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/shopware6_en_us/pdf-documents/single-upload-of-documents.md).
# Single Upload of Documents
## 1. Upload from the document card
The easiest way to upload a document to Shopware is directly from the respective document card.
**Posted sales invoice / credit memo / shipment**
{% stepper %}
{% step %}
Open the *"posted sales invoice / shipment / credit memo"*.
{% endstep %}
{% step %}
Click *"**Upload PDF to Shopware**".*
{% endstep %}
{% step %}
The document is automatically generated as a PDF and uploaded.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
**Note for *****posted sales invoices:***
The document type is automatically set to "Invoice", and the customer is matched by the customer number or email address.
{% endhint %}
## 2. Manual PDF upload
In addition to the automatic PDF upload, you can also upload your own PDF files manually. For example, open an invoice, credit memo, or shipment menu.
> Then follow this path:
>
> *"Actions"* :right: *"Shopware Documents"* :right: *"Other"* :right: *"Upload Manual PDF"*
Now upload the corresponding PDF file from your computer. The document is automatically assigned to the associated document number and transferred to Shopware.
{% hint style="warning" %}
The manual PDF must be a valid PDF file. Other file types are not accepted.
{% endhint %}
## 3. Upload of document attachments
You can also upload documents to Shopware that are already stored as an attachment on a record in BC. To do so, open the [document attachments](#id-3.-upload-of-document-attachments) or open the Attachments FactBox (on the right) of the required record and select the corresponding file. Then click the *downward-pointing arrow* next to *"Documents"* and select *"Upload to Shopware"* to transfer the document to Shopware. You may also need to select a document type.
The FactBox is located on the right
## 4. Customer mapping
The document is mapped to the Shopware customer automatically by:
Customer number
The BC customer number is matched against the Shopware customer number.
Email address
If no customer number is found, the email address is used.
{% hint style="info" %}
For the mapping to succeed, the customer must **exist** **both** in Business Central **and** in Shopware, and the customer number or email address must match.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.solutioo.de/shopware/shopware6_en_us/pdf-documents/single-upload-of-documents.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
