SupplySupplier

Represents a supplier in the supply chain management system.

Supply suppliers are external parties that provide materials, products, or services to the supply chain. Each supplier maintains comprehensive business information, performance metrics, and operational details that help with supplier management and procurement decisions.

Supplier Information

• **Business Details**: Name, contact information, location, and establishment year
• **Performance Metrics**: Quality ratings, on-time delivery rates, response times
• **Financial Terms**: Payment terms, shipping terms, tax information
• **Operational Data**: Lead times, business hours, time zones, and Incoterms

Status Management

Suppliers can be active or inactive, allowing for proper lifecycle management without losing historical data and relationships.

Relationships

Each supplier belongs to a company and can be associated with multiple products and addresses for comprehensive supplier management.

type SupplySupplier {
  address: Address
  addresses: [Address!]!
  archiveWarnings: [String!]!
  archivedAt: ISO8601DateTime
  attachments: [File!]
  brand: Brand @deprecated
  brandId: ID @deprecated
  businessHours: String
  canBeArchived: Boolean!
  category: String
  contact: SupplySupplierContact
  contacts: [SupplySupplierContact!]!
  createdAt: ISO8601DateTime!
  deletedAt: ISO8601DateTime @deprecated
  email: String
  handle: String
  id: ID!
  incoterms: String
  lastPurchaseDate: ISO8601DateTime
  leadTime: Int
  legalName: String
  location: String
  name: String!
  notes: String
  onTimeDelivery: BigDecimal
  paymentTerms: String
  phone: String
  products: [Product!]!
  qualityRating: BigDecimal
  responseTime: BigDecimal
  shippingTerms: String
  status: SupplySupplierStatusEnum!
  taxId: String
  timeZone: String
  totalCost: MonetaryValue
  updatedAt: ISO8601DateTime!
  website: String
  yearEstablished: Int
}

Fields

SupplySupplier.address ● Address object common

Primary address of the supplier (first in the list)

SupplySupplier.addresses ● [Address!]! non-null object common

Addresses associated with this supplier

SupplySupplier.archiveWarnings ● [String!]! non-null scalar common

Human-readable warnings that the supplier is still in use (open purchase orders, linked products). Empty when there is nothing to warn about. Advisory only — archiving is not blocked.

SupplySupplier.archivedAt ● ISO8601DateTime scalar common

When the supplier was archived, or null if not archived.

SupplySupplier.attachments ● [File!] list object common

Documents and files attached to this supplier

SupplySupplier.brand ● Brand deprecated object common

DEPRECATED

This field will be removed in the future. Brand is becoming a product-only attribute.

Brand this supplier belongs to

SupplySupplier.brandId ● ID deprecated scalar common

DEPRECATED

This field will be removed in the future. Brand is becoming a product-only attribute.

ID of the brand this supplier belongs to

SupplySupplier.businessHours ● String scalar common

Business operating hours

SupplySupplier.canBeArchived ● Boolean! non-null scalar common

Whether the supplier can be archived without warnings. False when the supplier is still in use (see archiveWarnings). Archiving is still permitted.

SupplySupplier.category ● String scalar common

Category or type of supplier

SupplySupplier.contact ● SupplySupplierContact object suppliers

Primary contact person for this supplier

SupplySupplier.contacts ● [SupplySupplierContact!]! non-null object suppliers

All contact persons associated with this supplier

SupplySupplier.createdAt ● ISO8601DateTime! non-null scalar common

Creation timestamp

SupplySupplier.deletedAt ● ISO8601DateTime deprecated scalar common

DEPRECATED

Use archived_at instead. This field will be removed in the future.

Soft deletion timestamp

SupplySupplier.email ● String scalar common

Email address of the supplier

SupplySupplier.handle ● String scalar common

URL-friendly identifier for the supplier, unique within the company

SupplySupplier.id ● ID! non-null scalar common

ID of the supplier

SupplySupplier.incoterms ● String scalar common

International Commercial Terms (Incoterms)

SupplySupplier.lastPurchaseDate ● ISO8601DateTime scalar common

Timestamp of the last purchase made from this supplier

SupplySupplier.leadTime ● Int scalar common

Lead time in days for orders from this supplier

SupplySupplier.legalName ● String scalar common

Legal / registered name of the supplier

SupplySupplier.location ● String scalar common

Location of the supplier

SupplySupplier.name ● String! non-null scalar common

Name of the supplier

SupplySupplier.notes ● String scalar common

Additional notes or comments about the supplier

SupplySupplier.onTimeDelivery ● BigDecimal scalar common

On-time delivery percentage (0-100)

SupplySupplier.paymentTerms ● String scalar common

Payment terms offered by the supplier

SupplySupplier.phone ● String scalar common

Phone number of the supplier

SupplySupplier.products ● [Product!]! non-null object products

Products supplied by this supplier

SupplySupplier.qualityRating ● BigDecimal scalar common

Quality rating (0-10 scale)

SupplySupplier.responseTime ● BigDecimal scalar common

Average response time in hours

SupplySupplier.shippingTerms ● String scalar common

Shipping terms and conditions

SupplySupplier.status ● SupplySupplierStatusEnum! non-null enum suppliers

Current status of the supplier

SupplySupplier.taxId ● String scalar common

Tax identification number

SupplySupplier.timeZone ● String scalar common

Time zone of the supplier

SupplySupplier.totalCost ● MonetaryValue object common

Total cost of all purchases made from this supplier

SupplySupplier.updatedAt ● ISO8601DateTime! non-null scalar common

Last update timestamp

SupplySupplier.website ● String scalar common

Website URL of the supplier

SupplySupplier.yearEstablished ● Int scalar common

Year the supplier was established

Returned By

supplyArchiveSupplier mutation ● supplyRegisterSupplier mutation ● supplySupplier query ● supplyUnarchiveSupplier mutation ● supplyUpdateSupplier mutation

Member Of

OrderFulfillment object ● ProductCost object ● ProductSupplier object ● PurchaseOrder object ● SupplySupplierConnection object ● SupplySupplierContact object ● SupplySupplierEdge object