SOAP

Path: Integration > Web services > SOAP · tier official · system integration · narrative reviewed (checked by Opus)

Overview

This section covers practical topics for developers who call Business Central SOAP web services from client code. The pages are standalone how-to and reference topics, with no subtopics.

Start with Use SystemService to Find Companies if your client needs a company name before it calls other web services. Then read the pages on proxies and optional fields, which explain how generated client code behaves. GetRecIdFromKey is a reference for converting a bookmark key into a record ID.

Key points

• GetRecIdFromKey converts a bookmark key, which holds primary key and concurrency information, into a record ID for web service operations.
• With a statically generated SOAP proxy, data can be lost. Avoid this by regenerating the proxy whenever the client application builds.
• The SystemService SOAP web service has a Companies method that lists the companies in a Business Central database.
• Use SystemService to get company names before accessing other web services.
• Optional fields in web service clients use Boolean *Specified properties for .NET value types.
• For reference types, a null value indicates that a field has no value.

Learn pages

• GetRecIdFromKey
• Preserving Data When Working with a Statically Generated Proxy
• Use SystemService to Find Companies
• Using Properties Indicate the Presence of a Value in a Field: Using properties with Visual Studio to indicate the presence of a value in a field.

Videos and posts

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

• Dynamics 365 Business Central 2025 Wave 1 release: the state of SOAP deprecation. (community post): “exposing Microsoft UI pages as SOAP endpoints is off by default”

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.