BeyondERP.Newsletter
Menu

Setup step on the Form setup page · Procurement and sourcing

Set up Form setup

Use this page to control what goes on procurement documents, such as which type of note attached to a purchase order is included when it is sent through cXML.

Used by
Accounts payable manager, Auditor, Purchasing manager
Business process
Procure goods and services
Menu item
PurchFormLetterParameters
Main table
VendFormletterParameters
Data entity
PurchFormletterRequestForQuotationFormPrintingConfigurationEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you set how printed or stored procurement documents look, such as requests for quotation and purchase orders.
What you do hereUse this page to control what goes on procurement documents, such as which type of note attached to a purchase order is included when it is sent through cXML.
Form setup page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Form setup1 screen

Use this page to control what goes on procurement documents, such as which type of note attached to a purchase order is included when it is sent through cXML.

  1. Screen 1

    Choose how purchase documents print items

    Go to Procurement and sourcing > Setup > Forms > Form setup, General tab

    1. Open the General tab
    2. Choose which item number prints on purchase documents
    3. Choose how the external item description and product dimensions print
    4. Select Save after any change
    1Item number in formsOur
    2External item descriptionOverwrite
    3Print product dimensionsAfter item number
    Choose how purchase documents print items (zoomed on the outlined fields)
    Show the full screenChoose how purchase documents print items
    page title tab to open what to set or check

How to use it

  1. Go to Procurement and sourcing > Setup > Forms > Form setup.
  2. On the General tab, set Item number in forms, Include both name and description and External item description.
  3. Under PRODUCT DIMENSIONS, set Print product dimensions and the Product dimension separator.
  4. Select another tab, such as Purchase inquiry, Purchase confirmation, Receipts list, Product receipt, Request for quotation, Purchase requisition or Purchase agreement, to set up that document.
  5. Select Save.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it meansExampleTable column
Include documents of typeOn the Purchase order tab, the type of note attached to a purchase order that is included in the cXML document; only text notes are included.Microsoft Learn
Item number in formsOurItemNum
External item descriptionOverwriteExternalItemOverwriteAppend
Print product dimensionsAfter item numberItemDimPlacement

Test checklist

  1. Set Include documents of type on the Purchase order tab to a note type, and set POCOMMENTS to TRUE on the vendor's external catalog.
  2. Create a purchase order for the cXML vendor and attach a text note of that type with Restriction External, plus one with Restriction Internal.
  3. With cXML test mode set to Test, confirm the order.
  4. On the Purchase order request page, open the Request XML text tab and check that only the external note appears in the header comments.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Form setupOn the Purchase order tab, set Include documents of type to the note type your buyers use for vendor-facing notesWhen POCOMMENTS or VENDCOMMENTS is TRUE on the external catalog, only text notes whose Type matches this field and whose Restriction is External are added to the cXML purchase order.Expecting every note on the order to reach the vendor. Notes with Restriction set to Internal, notes of another type, and file attachments are left out of the cXML message.
Solution architect

5Design impact

Shared or per companyPer company: each legal entity has its own records. Microsoft data model
Can it be undoneReversible: The setting is read when the cXML message is built at purchase order confirmation, so a change applies to orders confirmed afterwards.
Technical architect

6Technical

Menu itemPurchFormLetterParameters Checked in Dynamics 365
FormPurchFormLetterParameters Checked in Dynamics 365
TableVendFormletterParametersShown as “Vendor, form parameters” in Record infoChecked in Dynamics 365
Data entitiesPurchFormletterRequestForQuotationFormPrintingConfigurationEntityRequest for quotation form printing configurations Microsoft data model VendorFormSetupEntityVendor, form parameters Microsoft data model PurchFormletterPurchaseRequisitionFormPrintingConfigurationEntityPurchase requisition form printing configurations Microsoft data model PurchFormletterPurchaseOrderFormPrintingConfigurationEntityPurchase order form printing configurations Microsoft data model VendFormletterVendorFacingFormPrintingConfigurationEntityVendor facing form printing configurations Microsoft data model PurchFormletterWarehouseReceiptListFormPrintingConfigurationEntityReceipt list form printing configurations Microsoft data model PurchFormletterProductReceiptFormPrintingConfigurationEntityProduct receipt form printing configurations Microsoft data model PurchFormletterPurchaseAgreementFormPrintingConfigurationEntityPurchase agreement form printing configurations Microsoft data model PurchFormletterPurchaseInquiryFormPrintingConfigurationEntityPurchase inquiry form printing configurations Microsoft data model VendFormletterVendorInvoiceFormPrintingConfigurationEntityVendor invoice form printing configurations Microsoft data model
Who can open itPrivilegesMaintain setup of purchase order documents PurchFormLetterParametersMaintainView setup of purchase order documents PurchFormLetterParametersViewDutiesInquire into purchase order to invoice policies PurchOrderToInvoicePoliciesInquireEnable purchase order to invoice process PurchOrderToInvoiceProcessEnable
3 security rolesAuditor AuditPolicyManagerPurchasing manager TradePurchasingManagerAccounts payable manager VendInvoiceAccountsPayableManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itPurchasing manager TradePurchasingManagerAccounts payable manager VendInvoiceAccountsPayableManagerTo use itAuditor AuditPolicyManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, Edit, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=PurchFormLetterParameters
Integrate withPurchFormletterRequestForQuotationFormPrintingConfigurationEntity data entity Microsoft data model
Data migrationPurchFormletterRequestForQuotationFormPrintingConfigurationEntity (Request for quotation form printing configurations): loaded for each company, in Microsoft's default template 320 - Procurement and sourcing.VendorFormSetupEntity (Vendor, form parameters): loaded for each company, in Microsoft's default template 120 - Accounts payable.PurchFormletterPurchaseRequisitionFormPrintingConfigurationEntity (Purchase requisition form printing configurations): loaded for each company, in Microsoft's default template 320 - Procurement and sourcing.Load order: Microsoft's default template 320 - Procurement and sourcing loads Request for quotation form printing configurations at execution unit 1, level 30, sequence 10. Lower levels load first, and entities at the same level load in sequence order.Load first: the default templates at lower levels (System setup to General ledger)Microsoft Learn
Table definitionVendFormletterParameters columns and relations Microsoft data model
Everyone

8Sources

To cite this step: PS-SETUP-260, Set up Form setup. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/PS-SETUP-260