vendors resource type

Represents a vendor in Dynamics 365 Business Central.

Note

For information about enabling APIs for Dynamics NAV see Enabling the APIs for Dynamics 365 Business Central.

Methods

Method Return Type Description
GET vendors vendors Gets a vendor object.
POST vendors vendors Creates a vendor object.
PATCH vendors vendors Updates a vendor object.
DELETE vendor none Deletes a vendor object.

Subpages

Method Return Type Description
GET vendor defaultDimensions default dimensions Gets the default dimensions of vendor.
POST vendor defaultDimensions default dimensions Creates the default dimensions of vendor.
PATCH vendor defaultDimensions default dimensions Updates the default dimensions of vendor.
DELETE vendor defaultDimensions default dimensions Deletes the default dimensions of vendor.

Properties

Property Type Description
id GUID The unique ID of the vendor. Non-editable.
number string The vendor number.
displayName string The vendor's display name.
address NAV.PostalAddress The vendor's address.
phoneNumber string The vendor's telephone number.
email string The vendor's email address.
website string The vendor's website address.
taxRegistrationNumber string The vendor's tax registration number.
currencyId GUID The default currency code ID for the vendor.
currencyCode string The default currency code for the vendor.
irs1099Code string Specifies a 1099 code for the vendor. US only.
paymentTermsId GUID The default payment terms ID for the vendor.
paymentTerms NAV.PaymentTerms The default payment terms for the vendor.
paymentMethodId GUID The default payment method ID for the vendor.
paymentMethod NAV.PaymentMethod The default payment method for the vendor.
taxLiable boolean Specifies if the vendor is liable for tax.
blocked string Specifies which transactions with the vendor that cannot be posted. Accepted values are blank, Payment or All
balance decimal The vendor's balance. Read-Only.
lastModifiedDateTime datetime The last datetime the vendor was modified. Read-Only.

Relationships

None

JSON representation

Here is a JSON representation of the vendor.

{
  "id": "GUID",
  "number": "string",
  "displayName": "string",
  "address": "NAV.PostalAddress",
  "phoneNumber": "string",
  "email": "string",
  "website": "string",
  "taxRegistrationNumber": "string",
  "currencyId": "GUID",
  "currencyCode": "string",
  "irs1099Code": "string",
  "paymentTermsId": "GUID",
  "paymentMethodId": "GUID",
  "paymentMethod": "NAV.PaymentMethod",
  "taxLiable": "boolean",
  "blocked": "string",
  "balance": "decimal",
  "lastModifiedDateTime": "datetime"
}

See also

Graph Reference
Working with Dynamics 365 Business Central in Microsoft Graph
Enabling the APIs for Dynamics 365 Business Central
Endpoints for the APIs
Error Codes
Get Vendor
Create Vendor
Update Vendor
Delete Vendor