# Vendors _(Realtime-enabled)_

`GET` `POST` `PATCH` `DELETE` _(Table: Vendor)_

```
eOne/core/v1.0/vendors
```

The AP-side counterpart of [Customers](https://eonesolutions.github.io/eone-bc-integration/core-customers.md), create or update vendors with their address/contact block, posting groups, tax, payment terms and dimensions.

Resolve a vendor by `number`, `id` or `integrationId`. `currencyCode` takes an ISO code; Business Central stores the local currency as a blank code and the endpoint translates both ways.

> **Caution:** PATCHing `number` **renames** the vendor (carrying its ledger history) rather than creating a new one.

> **Note:** Dimension columns `shortcutDimension1Code`–`8Code` are writable here — see [Dimensions](https://eonesolutions.github.io/eone-bc-integration/dimensions.md).

## Vendors fields

_API column → BC field._

**Legend**

- _(req)_ required on create
- _(res)_ resolver
- _(cur)_ currency-translated
- _(ro)_ read-only
- _(ext)_ added to this endpoint by another extension (BC field name shown; its API column name is not known here)

| API | BC field | Notes |
| --- | --- | --- |
| `id` | SystemId | BC record GUID. _(ro)_ |
| `bcCompanyId` | bcCompanyId | The company this row belongs to - the same GUID that appears in the request URL. Present on every endpoint so a store pooling several companies can keep them apart without relying on which URL it called. _(ro)_ |
| `bcCompanyName` | bcCompanyName | The name of the company this row belongs to. _(ro)_ |
| `number` | No. | Primary key. PATCH renames. |
| `integrationId` | EONE Integration Id | Your external key. |
| `displayName` | Name | Vendor name. _(req)_ |
| `name2` | Name 2 |  |
| `addressLine1` | Address |  |
| `addressLine2` | Address 2 |  |
| `city` | City |  |
| `county` | County |  |
| `countryRegionCode` | Country/Region Code |  |
| `postalCode` | Post Code |  |
| `phoneNumber` | Phone No. |  |
| `email` | E-Mail |  |
| `website` | Home Page |  |
| `contactName` | Contact |  |
| `primaryContactNo` | Primary Contact No. |  |
| `purchaserCode` | Purchaser Code |  |
| `currencyCode` | currencyCode | ISO code; blank = LCY. Translated. _(cur)_ |
| `paymentTermsCode` | Payment Terms Code |  |
| `paymentMethodCode` | Payment Method Code |  |
| `taxLiable` | Tax Liable |  |
| `taxAreaCode` | Tax Area Code |  |
| `taxRegistrationNumber` | VAT Registration No. |  |
| `genBusPostingGroup` | Gen. Bus. Posting Group |  |
| `vendorPostingGroup` | Vendor Posting Group |  |
| `vatBusPostingGroup` | VAT Bus. Posting Group |  |
| `locationCode` | Location Code |  |
| `blocked` | Blocked |  |
| `pricesIncludingVAT` | Prices Including VAT |  |
| `invoiceDiscCode` | Invoice Disc. Code |  |
| `leadTimeCalculation` | Lead Time Calculation |  |
| `balance` | Balance (LCY) | _(ro)_ |
| `privacyBlocked` | Privacy Blocked |  |
| `languageCode` | Language Code |  |
| `mobilePhoneNo` | Mobile Phone No. |  |
| `gln` | GLN | Global Location Number. |
| `registrationNumber` | Registration Number |  |
| `partnerType` | Partner Type | Company or Person. |
| `shortcutDimension1Code` | shortcutDimension1Code | See Dimensions. |
| `shortcutDimension2Code` | shortcutDimension2Code | See Dimensions. |
| `shortcutDimension3Code` | shortcutDimension3Code | Shortcut dimension 3. See Dimensions. |
| `shortcutDimension4Code` | shortcutDimension4Code | Shortcut dimension 4. See Dimensions. |
| `shortcutDimension5Code` | shortcutDimension5Code | Shortcut dimension 5. See Dimensions. |
| `shortcutDimension6Code` | shortcutDimension6Code | Shortcut dimension 6. See Dimensions. |
| `shortcutDimension7Code` | shortcutDimension7Code | Shortcut dimension 7. See Dimensions. |
| `shortcutDimension8Code` | shortcutDimension8Code | Shortcut dimension 8. See Dimensions. |
| `createdDateTime` | SystemCreatedAt | _(ro)_ |
| `lastModifiedDateTime` | SystemModifiedAt | _(ro)_ |