{"title":"complex types JSON (v1.0)","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_complextypes/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_complextypes, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_complextypes","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"(v1.0) Complex data types in JSON for Dynamics 365 Business Central.","date":"2024-05-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"complex types JSON (v1.0)","slug":"complex-types-json-v10","at":0,"chars":3605},{"level":2,"title":"Item category","slug":"item-category","at":466,"chars":324},{"level":3,"title":"Properties","slug":"properties","at":545,"chars":245},{"level":2,"title":"Unit of measure","slug":"unit-of-measure","at":790,"chars":560},{"level":3,"title":"Properties","slug":"properties-1","at":872,"chars":478},{"level":2,"title":"Unit of measure conversion","slug":"unit-of-measure-conversion","at":1350,"chars":470},{"level":3,"title":"Properties","slug":"properties-2","at":1454,"chars":366},{"level":2,"title":"Payment method","slug":"payment-method","at":1820,"chars":317},{"level":3,"title":"Properties","slug":"properties-3","at":1900,"chars":237},{"level":2,"title":"Payment terms","slug":"payment-terms","at":2137,"chars":316},{"level":3,"title":"Properties","slug":"properties-4","at":2215,"chars":238},{"level":2,"title":"Postal address","slug":"postal-address","at":2453,"chars":493},{"level":3,"title":"Properties","slug":"properties-5","at":2533,"chars":413},{"level":2,"title":"Shipment method","slug":"shipment-method","at":2946,"chars":319},{"level":3,"title":"Properties","slug":"properties-6","at":3028,"chars":237},{"level":2,"title":"Line details","slug":"line-details","at":3265,"chars":318},{"level":3,"title":"Properties","slug":"properties-7","at":3341,"chars":242},{"level":2,"title":"Related information","slug":"related-information","at":3583,"chars":22}],"text":"# complex types JSON (v1.0)\n> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.\nThese are the various complex types in Business Central. You can see usage of these complex types in the various individual methods that make use of them.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.\n## Item category\nRepresents an Item Category complex type in Business Central.\n### Properties\nProperty|Type|Description\ncategoryId|string|The unique ID of the item category.\ndescription|string|Specifies the description of the item category.\n```json\n\"ItemCategory\"\n{\n  \"categoryId\": \"string\",\n  \"description\": \"string\"\n}\n```\n## Unit of measure\nRepresents a Unit of Measure complex type in Business Central.\n### Properties\nProperty|Type|Description\ncode|string|The unique ID of the unit of measure.\ndisplayName|string|Specifies the description of the unit of measure.\nsymbol|string|Specifies a graphical representation of the unit of measure.\nunitConversion||Specifies the conversion rate to a different (target) unit of measure.\n```json\n\"UnitOfMeasure\"\n{\n  \"code\":  \"string\",\n  \"displayName\": \"string\",\n  \"symbol\": \"string\",\n  \"unitConversion\": \"NAV.ItemUnitOfMeasureConversion\"\n}\n```\n## Unit of measure conversion\nRepresents a Unit of Measure Conversion complex type in Business Central.\n### Properties\nProperty|Type|Description\ntoUnitOfMeasure|string|Specifies the unit of measure to convert to.\nfromToConversionRate|decimal|Specifies what the (source) base unit of measure is multiplied with in order to convert to the target unit of measure.\n```json\n\"ItemUnitOfMeasureConversion\"\n{\n\"toUnitOfMeasure\": \"string\",\n\"fromToConversionRate\": \"decimal\"\n}\n```\n## Payment method\nRepresents a Payment Method complex type in Business Central.\n### Properties\nProperty|Type|Description\ncode|string|The unique code of the payment method.\ndescription|string|Specifies a text that describes the payment method.\n```json\n\"PaymentMethod\"\n{\n\"code\": \"string\",\n\"description\": \"string\"\n}\n```\n## Payment terms\nRepresents a Payment Terms complex type in Business Central.\n### Properties\nProperty|Type|Description\ncode|string|The unique code of the payment terms.\ndescription|string|Specifies a text that describes the payment terms.\n```json\n\"PaymentTermsType\"\n{\n\"code\": \"string\",\n\"description\": \"string\"\n}\n```\n## Postal address\nRepresents a Postal Address complex type in Business Central.\n### Properties\nProperty|Type|Description\nstreet|string|Postal address street.\ncity|string|Postal address city.\nstate|string|Postal address state.\ncountryLetterCode|string|Postal address country letter code (two character word)\npostalCode|string|Postal address post code\n```json\n\"PostalAddress\"\n{\n\"street\": \"string\",\n\"city\": \"string\",\n\"state\": \"string\",\n\"countryLetterCode\": \"string\",\n\"postalCode\": \"string\"\n}\n```\n## Shipment method\nRepresents a Shipment Method complex type in Business Central.\n### Properties\nProperty|Type|Description\ncode|string|The unique code of the shipment method.\ndescription|string|Specifies the description of the shipment method.\n```json\n\"ShipmentMethod\"\n{\n\"code\": \"string\",\n\"description\": \"string\"\n}\n```\n## Line details\nRepresents a Line Details complex type in Business Central.\n### Properties\nProperty|Type|Description\nnumber|string|The sequence number of the document line details.\ndisplayName|string|The display name of the line.\n```json\n\"documentLineObjectDetails\"\n{\n\"number\": \"string\",\n\"displayName\": \"string\"\n}\n```\n## Related information"}