---
title: "Send only the PDF of an invoice to be put in the system"
slug: "preview-send-only-the-pdf-of-an-invoice-to-be-put-in-the-system"
updated: 2025-11-21T20:01:51Z
published: 2026-02-10T12:53:32Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://www.bloxs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send only the PDF of an invoice to be put in the system

Post/api/v1/invoices/purchaseinvoices/pdfonly

Send the PDF of an invoice to be scanned and processed further based on the given PDF.

		
			

**Description**

This endpoint allows users to upload purchase invoices as PDF documents to Bloxs. This functionality is only available to users who have activated the "Scan and Recognize" module (available at an additional cost).

The field recognition feature automatically populates the purchase invoice entry screen based on the scanned PDF. After the initial recognition, the user must review the invoice screen to verify the recognized fields, complete any missing information, and confirm the data before proceeding with further processing.

Only PDF files are supported, including multi-page documents. There is no maximum size to the pdf file.

**Use Case**

The user utilizes a different program for creating its purchase invoices, however uses Bloxs for further adminstrative processing. After creating the purchase invoice the user wants to have the invoice available in Bloxs. By using this endpoint the user will be able to see the pdf file in Bloxs, and have the individual data fields from the invoice available as structured data in Bloxs.

**Request****fields**

The request contains the following fields:

| Field | Description |
| --- | --- |
| subject | The subject field of the purchase invoice. In many cases, the invoice number is used as the subject (text). The most logical approach is to combine the invoice number with a brief description. The description field is the field used when searching for the purchase invoice in Bloxs especially when no invoice number can be extracted directly from the PDF. |
| fileName | This property defines the name of the file which is added. |
| mimeType | The format of the file in accordance with the MIME standards. The only MIME type which is accepted is PDF (application/pdf). |
| base64 | The base64 string of the document. |
| relatedIdentifiers | Used to specify references of service tickets, contracts, purchase orders and/or supplier code. These values are used in Bloxs to retrieve data and automatically populate fields in the purchase order screen, facilitating the financial process. In particular for object details and general ledger accounts. A maximum of 10 entries can be entered, each with a maximum length of 50 characters. Multiple references can be entered in 1 request. In this case they need to be entered as an array. It is not necessary to specify to which type of entity the number is linked to (for example a service ticket or a contract). |

		
		
SecurityHTTPType Bearer

Please enter a valid token

Body parameters<select class='api-response-data' aria-label='Media type'><option value='c0b0a0ea-16fb-4cf7-b572-81b836b49c6f'>application/json</option>
</select>Expand Allobject  subjectstring    RequiredMin length0Max length512
fileobject (APIFilePutModel)  RequiredfileNamestring    RequiredMin length1Max length512
mimeTypestring    RequiredMin length1Max length100
base64string    RequiredMin length1

relatedIdentifiers Array of string  | null  string    

Responses202

null

400

The PDF file data has validation issues

<select class='api-response-data' aria-label='Media type'><option value='ecd92775-4892-464c-9734-fce6e7af00c4'>application/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
traceIdstring   | null  
statusinteger  (int32)    
errorsobject | null  property* Array of string  | null  additionalPropertiesstring