Products and Services

Products and Services (also called line items) store the catalog entries that appear anywhere you choose items on invoices, quotes, or subscriptions. Each record captures the descriptive text, price, preferred revenue account, and optional analytics so your teams and integrations can reuse the same configuration instead of retyping details on every document.

Prerequisites

• A Naqood API secret or OAuth-issued secret scoped to the target organization
• The organization slug on every query or mutation
• A role with permission to manage products and services

Line item fields

LineItem objects expose the following fields when queried directly or through lists:

Field	Type	Notes
id	ID!	Stable identifier used with mutations.
name	String!	Display name shown on invoices and quotes.
code	String	Optional SKU or product code.
quantity	String!	Default quantity suggested when the item is inserted (usually 1).
unit	String!	Text label for the quantity (for example hour, pcs).
unitPrice	String!	Sales price per unit in the organization currency.
costPrice	String	Optional internal cost per unit.
comment	String	Extra description rendered beneath the line on documents.
accountId	ID!	Revenue or liability account that will be credited by default.
archived	Boolean!	Hides the record from pickers without deleting it.
isDeletable	Boolean	false when the item is already referenced on invoices/subscriptions.
quantitySold	String	Present when using aggregate queries; total units on sent invoices.
valueSold	String	Present when using aggregate queries; total recognized revenue.
createdAt	Timestamp	Record creation timestamp.
updatedAt	Timestamp	Last update timestamp.

Fetch a line item

Retrieve one catalog entry when you know its ID:

query LineItem($lineItemID: ID!) {
  lineItem(lineItemID: $lineItemID) {
    id
    name
    code
    unit
    unitPrice
    quantity
    costPrice
    comment
    archived
    accountId
    isDeletable
    quantitySold
    valueSold
  }
}

List catalog items

List or search items within an organization. Pagination, ordering, and filters use the standard operators (equalTo, notEqualTo, greaterThan, lessThanOrEqualTo, in, and boolean and/or).

query LineItems(
  $slug: Slug!
  $offset: Int
  $limit: Int
  $orderBy: OrderByInput
  $filter: JSONObject
) {
  organization(slug: $slug) {
    lineItems(
      offset: $offset
      limit: $limit
      orderBy: $orderBy
      filter: $filter
    ) {
      count
      entries
    }
  }
}

entries contains an array of LineItem objects, so you can project only the fields you need on the client side.

Create a line item

mutation CreateLineItem($input: CreateLineItemInput!) {
  createLineItem(input: $input) {
    id
    name
    unit
    unitPrice
  }
}

Key CreateLineItemInput properties:

Field	Required	Notes
slug	✅	Organization identifier tied to your API secret.
name	✅	Display name customers will see.
code	Optional	Helpful SKU or internal reference.
quantity	✅	Default quantity suggested when inserting the item.
unit	✅	Singular label for the quantity (for example hour).
unitPrice	✅	Decimal string in the organization currency.
costPrice	Optional	Track the cost side for margin reporting.
comment	Optional	Extra descriptive text rendered under the line.
accountId	✅	Revenue account that will be credited when the item is used.

Example variables:

{
  "input": {
    "slug": "acme-co",
    "name": "Consulting hours",
    "code": "CONS-001",
    "quantity": "1",
    "unit": "hour",
    "unitPrice": "650.00",
    "costPrice": "400.00",
    "comment": "Includes travel within Dubai",
    "accountId": "87da1ad4-6f0a-40dc-a8ba-98abbfb59de6"
  }
}

Update a line item

mutation UpdateLineItem($input: UpdateLineItemInput!) {
  updateLineItem(input: $input) {
    id
    name
    unitPrice
    costPrice
    accountId
    updatedAt
  }
}

Provide the id plus the fields you want to change. Fields you leave out remain unchanged, so you can update price lists, rename items, or reassign revenue accounts incrementally.

Archive or delete

• Archive: archiveLineItem(lineItemID: ID!) hides the catalog entry from selection menus while preserving its history. Use this when an item is temporarily unavailable.
• Restore: unarchiveLineItem(lineItemID: ID!) makes an archived item selectable again.
• Delete: deleteLineItem(lineItemID: ID!) permanently removes a record that has never been used on an invoice or subscription. Check the isDeletable flag first to confirm the item has no dependencies.