RouteurStable

Search company

Searches for a company within the merchant scope from business identifiers and routes according to whether a usable match exists.

Company / contact
Search company
Companies & contacts
Typed result

Vue d’ensemble

Searches for a company within the merchant scope from business identifiers and routes according to whether a usable match exists.

Exemple

Before creating a company received from an ERP, search for a match by registration number, tax identifier, or source reference.

Decision routes

found

Company found

A usable match was identified in the current scope.

Recommended actionReuse the returned company instead of creating a duplicate.
not_found

No company found

No company matches the supplied criteria.

Recommended actionCreate a new company when the process has sufficient authoritative data.

Parameters 5

source_referenceOptionnelstring
Stable reference from your source system, used for correlation and idempotency when the operation contract provides for it.
countryOptionnelcountry code
Country used as a company-search criterion.
registration_numberOptionnelstring
Company registration number in its national registry.
tax_identifierOptionnelstring
Tax or VAT identifier used to identify or create the company.
legal_nameOptionnelstring
Official legal name of the company as represented in the Ormuz model.

Outputs 3

selected_routeenum
Business route chosen by the node according to the search or check result.
companyCompany
Canonical platform company obtained or created by the operation.
matched_byenum
Criterion that actually identified the company found.

Behavior

Supplied criteria are sent to the merchant's canonical search. found exposes the company and the criterion that matched; not_found allows continuation to creation.

Limits and responsibilities

  • A search without a discriminating identifier may be too ambiguous to replace a business deduplication rule.
  • The node creates nothing on the not_found route.