---
id: object/page/189
type: object
title: Page 189 "Incoming Document"
summary: Page 189 "Incoming Document" in Base Application (Microsoft.EServices.EDocument). 1 public procedures, 1 events. Present since at least BC23, still in BC30, changed in BC24.
tier: official
language: en
tags:
  - page
  - base application
versions:
  introduced: null
  last_changed: "24"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 594f0890d66652d4a564ba796cd81ace5ccce99c40428749d660e332fde51c33
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/eServices/EDocument/IncomingDocument.Page.al
    title: src/Layers/W1/BaseApp/eServices/EDocument/IncomingDocument.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/across-about-the-data-exchange-framework
    title: About the Data Exchange Framework
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-how-to-receive-and-convert-electronic-documents
    title: Receive and convert electronic documents
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/across-about-the-data-exchange-framework
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-how-to-receive-and-convert-electronic-documents
  objects: []
  features: []
  topics:
    - topic/business-central/business-functionality/general-business-functionality/exchange-data-electronically
    - topic/business-central/business-functionality/general-business-functionality/exchange-data-electronically/exchange-data
    - topic/business-central/business-functionality/purchasing
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes:
    - change/bcapps/10251
object_type: page
object_id: 189
name: Incoming Document
namespace: Microsoft.EServices.EDocument
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "24"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/across-about-the-data-exchange-framework.md
  - docs/learn-smb-docs/business-central/purchasing-how-to-receive-and-convert-electronic-documents.md
counts:
  fields: 0
  procedures: 7
  events: 1
  subscribers: 0
  controls: 42
  actions: 36
relations:
  out: 1
  referenced_by: 0
  pages: 1
  extended_by: 0
  event_subscribers: 1
  calls: 2
  called_by: 3
  implements: 0
---

# Page 189 "Incoming Document"

> Page 189 "Incoming Document" in Base Application (Microsoft.EServices.EDocument). 1 public procedures, 1 events. Present since at least BC23, still in BC30, changed in BC24.

Base Application · Microsoft.EServices.EDocument · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/eServices/EDocument/IncomingDocument.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Incoming Document |
| SourceTable | Incoming Document |
| PageType | Document |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| General | Description | [Description](../table/130.md#fields) | Specifies the description of the incoming document. You must enter the description manually. <small>from the table field</small> |
|  | Link to Document | [URL](../table/130.md#fields) | Specifies a link to the attached file. |
|  | Main Attachment | `AttachmentFileName` | Specifies the main attachment. Only this attachment is processed by the OCR and document exchange services. |
|  | Data Exchange Type | [Data Exchange Type](../table/130.md#fields) | Specifies the data exchange type that is used to process the incoming document when it is an electronic document. <small>from the table field</small> |
|  | Record | `RecordLinkTxt` | Specifies the record, document, journal line, or ledger entry, that is linked to the incoming document. |
|  | Document Type | [Document Type](../table/130.md#fields) | Specifies the type of document or journal that the incoming document can be connected to. <small>from the table field</small> |
|  | Document No. | [Document No.](../table/130.md#fields) | Specifies the number of the related document or journal line that is created for the incoming document. <small>from the table field</small> |
|  | StatusField | [Status](../table/130.md#fields) | Specifies the status of the incoming document record. <small>from the table field</small> |
|  | OCR Status | [OCR Status](../table/130.md#fields) | Specifies the status of the incoming document record when it takes part in the OCR process. <small>from the table field</small> |
|  | OCR Track ID | [OCR Track ID](../table/130.md#fields) | Specifies the process stage of the track ID in relation to the OCR service. <small>from the table field</small> |
|  | Job Queue Status | [Job Queue Status](../table/130.md#fields) | Specifies the status of the job queue entry that is processing the incoming document. <small>from the table field</small> |
| Control71 | OCR Service Doc. Template Code | [OCR Service Doc. Template Code](../table/130.md#fields) | Specifies the code of the document template that you want the OCR service provider to use when they convert the incoming-document file to an electronic document. Chose the field to pick a supported document template from the OCR Service Setup window. <small>from the table field</small> |
|  | OCR Service Doc. Template Name | [OCR Service Doc. Template Name](../table/130.md#fields) | Specifies the name of the document template that you want the OCR service provider to use when they convert the incoming-document file to an electronic document. Chose the field to pick a supported document template from the OCR Service Setup window. <small>from the table field</small> |
|  | OCR Result | `OCRResultFileName` | Specifies what process stage the attached PDF or image file is in relation to the OCR service. |
| Control72 | Created Date-Time | [Created Date-Time](../table/130.md#fields) | Specifies when the incoming document line was created. <small>from the table field</small> |
|  | Created By User Name | [Created By User Name](../table/130.md#fields) | Specifies the name of the user who created the incoming document line. <small>from the table field</small> |
|  | Released | [Released](../table/130.md#fields) | Specifies if the incoming document has been approved. <small>from the table field</small> |
|  | Released Date-Time | [Released Date-Time](../table/130.md#fields) | Specifies when the incoming document was approved. <small>from the table field</small> |
|  | Released By User Name | [Released By User Name](../table/130.md#fields) | Specifies the name of the user who approved the incoming document. <small>from the table field</small> |
|  | Last Date-Time Modified | [Last Date-Time Modified](../table/130.md#fields) | Specifies when the incoming document line was last modified. <small>from the table field</small> |
|  | Last Modified By User Name | [Last Modified By User Name](../table/130.md#fields) | Specifies the name of the user who last modified the incoming document line. <small>from the table field</small> |
|  | Posted | [Posted](../table/130.md#fields) | Specifies if the document or journal line that was created for this incoming document has been posted. <small>from the table field</small> |
|  | Posted Date-Time | [Posted Date-Time](../table/130.md#fields) | Specifies when the related document or journal line was posted. <small>from the table field</small> |
|  | Posting Date | [Posting Date](../table/130.md#fields) | Specifies when the document or journal line that relates to the incoming document was posted. <small>from the table field</small> |
| Content | Supporting Attachments | part [Page 194 "Incoming Document Attachments"](../page/194.md) | — |
| Financial Information | Vendor No. | [Vendor No.](../table/130.md#fields) | Specifies the number of the vendor on the incoming document. The field may be filled automatically. <small>from the table field</small> |
|  | Vendor Name | [Vendor Name](../table/130.md#fields) | Specifies the name of the vendor on the incoming document. The field may be filled automatically. <small>from the table field</small> |
|  | Vendor VAT Registration No. | [Vendor VAT Registration No.](../table/130.md#fields) | Specifies the VAT registration number of the vendor, if the document contains that number. The field may be filled automatically. <small>from the table field</small> |
|  | Vendor IBAN | [Vendor IBAN](../table/130.md#fields) | Specifies the IBAN of the vendor on the incoming document. |
|  | Vendor Bank Branch No. | [Vendor Bank Branch No.](../table/130.md#fields) | Specifies the bank branch number of the vendor on the incoming document. |
|  | Vendor Bank Account No. | [Vendor Bank Account No.](../table/130.md#fields) | Specifies the bank account number of the vendor on the incoming document. <small>from the table field</small> |
|  | Vendor Phone No. | [Vendor Phone No.](../table/130.md#fields) | Specifies the phone number of the vendor on the incoming document. <small>from the table field</small> |
|  | Vendor Invoice No. | [Vendor Invoice No.](../table/130.md#fields) | Specifies the document number of the original document you received from the vendor. You can require the document number for posting, or let it be optional. By default, it's required, so that this document references the original. Making document numbers optional removes a step from the posting proc... <small>from the table field</small> |
|  | Vendor Order No. | [Order No.](../table/130.md#fields) | Specifies the order number, if the document contains that number. The field may be filled automatically. <small>from the table field</small> |
|  | Document Date | [Document Date](../table/130.md#fields) | Specifies the date that is printed on the incoming document. This is the date when the vendor created the invoice, for example. The field may be filled automatically. <small>from the table field</small> |
|  | Due Date | [Due Date](../table/130.md#fields) | Specifies the date when the vendor document must be paid. The field may be filled automatically. <small>from the table field</small> |
|  | Currency Code | [Currency Code](../table/130.md#fields) | Specifies the currency code, if the document contains that code. The field may be filled automatically. <small>from the table field</small> |
|  | Amount Excl. VAT | [Amount Excl. VAT](../table/130.md#fields) | Specifies the amount excluding VAT for the whole document. The field may be filled automatically. <small>from the table field</small> |
|  | Amount Incl. VAT | [Amount Incl. VAT](../table/130.md#fields) | Specifies the amount including VAT for the whole document. The field may be filled automatically. <small>from the table field</small> |
|  | VAT Amount | [VAT Amount](../table/130.md#fields) | Specifies the amount of VAT that is included in the total amount. <small>from the table field</small> |
| Content | Errors and Warnings | part [Page 701 "Error Messages Part"](../page/701.md) | — |
| FactBoxes | WorkflowStatus | part [Page 1528 "Workflow Status FactBox"](../page/1528.md) | — |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Setup | Setup | Define the general journal type to use when creating journal lines. You can also specify whether it requires approval to create documents and journal lines. | [Page 191 "Incoming Documents Setup"](../page/191.md) |
|  | Data Exchange Types | View the data exchange types that are available to convert electronic documents to documents in Dynamics 365. | [Page 1213 "Data Exchange Types"](../page/1213.md) |
|  | Activity Log | View the status and any errors if the document was sent as an electronic document or OCR file through the document exchange service. |  |
|  | OCR Setup | Open the OCR Service Setup window, for example to change credentials or enable the service. |  |
|  | Approvals | View a list of the records that are waiting to be approved. For example, you can see who requested the record to be approved, when it was sent, and when it is due to be approved. |  |
| Processing | Create Document | Create a document, such as a purchase invoice, automatically by converting the electronic document that is attached to the incoming document record. |  |
|  | Create Journal Line | Create a journal line automatically by converting the electronic document that is attached to the incoming document record. |  |
|  | Create Manually | Create a document, such as a purchase invoice, manually from information in the file that is attached to the incoming document record. |  |
|  | Attach File | Attach a file to the incoming document record. |  |
|  | Replace Main Attachment | Attach another file to be used as the main file attachment on the incoming document record. |  |
|  | Attach Image from Camera | Add a picture from your device camera to the document. |  |
|  | Map Text to Account | Create a mapping of text on incoming documents to identical text on specific debit, credit, and balancing accounts in the general ledger or on bank accounts so that the resulting document or journal lines are prefilled with the specified information. | [Page 1254 "Text-to-Account Mapping Wksh."](../page/1254.md) |
| Release | Release | Release the incoming document to indicate that it has been approved by the incoming document approver. |  |
|  | Reopen | Reopen the incoming document record after it has been approved by the incoming document approver. |  |
|  | Reject | Reject to approve the incoming document. |  |
| Status | Set To Processed | Set the incoming document to processed. It will then be moved to the Processed Incoming Documents window. |  |
|  | Set To Unprocessed | Set the incoming document to unprocessed. This allows you to edit information or perform actions for the incoming document. |  |
| Approval | Approve | Approve the requested changes. |  |
|  | Reject | Reject to approve the incoming document. |  |
|  | Delegate | Delegate the approval to a substitute approver. |  |
|  | Comments | View or add comments for the record. |  |
| Request Approval | Send Approval Request | Request approval of the incoming document. You can send an approval request as part of a workflow if this has been set up in your organization. |  |
|  | Cancel Approval Request | Cancel requesting approval of the incoming document. |  |
| Incoming Document | Open Record | Open the document, journal line, or entry that the incoming document is linked to. |  |
|  | Remove Reference to Record | Remove the link that exists from the incoming document to a document, journal line, or entry. |  |
|  | Find entries... | Find entries and documents that exist for the document number and posting date on the selected document. (Formerly this action was named Navigate.) |  |
| Record | Journal Line | Open the record that the incoming document is linked to. |  |
|  | Purchase Invoice | Open the record that the incoming document is linked to. |  |
|  | Purchase Credit Memo | Open the record that the incoming document is linked to. |  |
|  | Sales Invoice | Open the record that the incoming document is linked to. |  |
|  | Sales Credit Memo | Open the record that the incoming document is linked to. |  |
| OCR | Send to Job Queue | Send the attached PDF or image file to the OCR service by the job queue according to the schedule, provided that no errors exist. |  |
|  | Remove from Job Queue | Remove the scheduled processing of this record from the job queue. |  |
|  | Send to OCR Service | Send the attached PDF or image file to the OCR service immediately. |  |
|  | Receive from OCR Service | Get any electronic documents that are ready to receive from the OCR service. |  |
|  | Correct OCR Data | Open a window where you can teach the OCR service how to interpret data on PDF and image files so that future documents created by the OCR service are more correct. | [Page 1272 "OCR Data Correction"](../page/1272.md) |

## Events published

- `OnCloseIncomingDocumentFromAction(var IncomingDocument: Record "Incoming Document")` (integration)
  - subscribers: [Codeunit 1294 "OCR Service Mgt."](../codeunit/1294.md) OnCloseIncomingDocumentHandler

## Procedures

- `AskUserPermission(): Boolean` (protected)

Plus 5 local procedures.

## Triggers

OnAfterGetCurrRecord, OnAfterGetRecord, OnInit, OnInsertRecord, OnModifyRecord, OnNewRecord, OnOpenPage

## Relations

- source table [Table 130 "Incoming Document"](../table/130.md)

## Pages and codeunits on this table

- [Page 190 "Incoming Documents"](../page/190.md) (card page)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 1535 "Approvals Mgmt."](../codeunit/1535.md) (3 calls: `SetControlVisibility → CanCancelApprovalForRecord`, `SetControlVisibility → HasOpenApprovalEntries`, `SetControlVisibility → HasOpenApprovalEntriesForCurrentUser`)
- [Codeunit 1907 "Camera"](../codeunit/1907.md) (1 call: `OnOpenPage → IsAvailable`)

## Called by

- [Table 130 "Incoming Document"](../table/130.md) (3 calls: `CreateFromAttachment → (object)`, `ShowCard → (object)`, `ShowCardFromEntryNo → (object)`)
- [Codeunit 1294 "OCR Service Mgt."](../codeunit/1294.md) (1 call: `OnCloseIncomingDocumentHandler → (object)`)
- [Page 344 "Navigate"](../page/344.md) (1 call: `ShowRecords → (object)`)

## Recent changes

- 2026-08-19 [#10251 Ruleset hardening: promote 5 rules from Warning to Error](../../changes/bcapps/10251.md) (main, BC30, refactor)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24

## Documented on Microsoft Learn

- [About the Data Exchange Framework](https://learn.microsoft.com/dynamics365/business-central/across-about-the-data-exchange-framework)
- [Receive and convert electronic documents](https://learn.microsoft.com/dynamics365/business-central/purchasing-how-to-receive-and-convert-electronic-documents)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "Incoming Document")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.