Vendor list

Vendors and suppliers registered in your ERP.

Part of Counterparties in the register catalog.

Register ID

vendor_listUse this name to ask for the register. The API calls it a shelf ID.

Each record is

A stateThe current value of something, replaced when it changes.

Status

AvailableFilled today from connected systems, uploads or public data.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Business Central
• Dynamics 365 Finance & Operations
• HubSpot

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

• HammerTech
• MapTrackPartial
• Mitti
• MYOB Acumatica
• MYOB BusinessPartial
• Oracle Aconex
• Payapps
• Procore
• Xero Accounting

Fields

24 fields: 2 required, 20 optional, 2 defined by each organisation.

Required

Every record carries these fields.

vendor_entity_idWhole number

Demiton canonical VENDOR spine node this fact is about.

Example: 8801

source_systemText

The bound system that produced this record (D365_BUSINESS_CENTRAL/D365_FINOPS/HUBSPOT/…)

Example: D365_BUSINESS_CENTRAL

Optional

Present when the source system records them.

vendor_numberText

The supplier account code that joins this record to AP transactions across systems.

Example: VEND-8801

nameText

Registered/trading name of the supplier party.

Example: Highlands Aggregate Supplies Pty Ltd

tax_registration_numberText

The supplier's ABN / GST / VAT registration number.

country_codeTextUnit: ISO 3166-1 alpha-2

The supplier's country.

Example: AU

source_external_idText

The raw record key in the producing system (BC vendor no)

emailText

Supplier contact email.

phoneText

Supplier contact phone.

websiteText

Supplier website / domain.

address_line_1Text

Street address line 1.

address_line_2Text

Street address line 2.

cityText

Locality.

Example: Emerald

stateText

State/territory code.

Example: QLD

postal_codeText

Postal code.

blockedText

Source's blocked/payment-hold status for the supplier.

tax_liableTrue or false

Whether the supplier is taxable in the source's tax setup.

Example: true

default_currency_codeTextUnit: ISO 4217

The supplier's default transaction currency.

Example: AUD

modified_atDate and timeISO 8601, with time zone

Source last-modified timestamp (freshness)

tax_reporting_classificationText

The source's statutory tax-reporting classification for this supplier (BC irs1099Code)

tax_registration_schemeText

The scheme the tax registration number belongs to (AU ABN / NZ NZBN / US UEI / an EU codelist value)

registration_statusText

Verified-at-a-point-in-time registration status (e.g. ABN active/cancelled, SAM active)

Defined by each organisation

Their contents come from the organisation's own forms or systems, so they differ between organisations.

payment_terms_referenceText

Source id of the tenant-configured payment-terms row.

payment_method_referenceText

Source id of the tenant-configured payment-method row.

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

vendor_list.example.json

{
  "city": "Emerald",
  "country_code": "AU",
  "default_currency_code": "AUD",
  "name": "Highlands Aggregate Supplies Pty Ltd",
  "source_system": "D365_BUSINESS_CENTRAL",
  "state": "QLD",
  "tax_liable": true,
  "vendor_entity_id": 8801,
  "vendor_number": "VEND-8801"
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/vendor_list/v1.json

Show the full JSON Schema

Loading the schema…