Produkt mit Preis über Public API erstellen

INHALTSVERZEICHNIS

• Einführung

• Produkte

• Produkttypen

• Produkte mit Preis

• Produkte mit Varianten

• Produkt über Public API erstellen

• Autorisierung

• Produkterstellung

• Produkt erstellen

• Beispiel Payload (Produkt mit Preis)

• Beispiel Payload (Produkt mit Varianten)

• Preis für ein Produkt erstellen

• Beispiel Payload (Preis für Variantenprodukt)

• Bild zu Variante über API hinzufügen

• Beispiel Payload (Media Update mit PriceIds)

• Fazit

Einführung

Dieser Artikel erklärt, wie du ein Produkt über die ProfitBoost Public API erstellen kannst. Außerdem werden verschiedene Produkttypen und deren Verwendung behandelt.

Produkte

Produkte sind zentrale Entitäten in ProfitBoost. Sie werden verwendet, um Artikel über verschiedene Kanäle zu verkaufen, z. B.:

• E-Commerce Stores

• Rechnungen

• Angebote (Estimates)

• Weitere Verkaufskanäle

Produkttypen

In ProfitBoost gibt es zwei Haupttypen von Produkten:

• Produkte mit Preis

• Produkte mit Varianten

Produkte mit Preis

Dies sind einfache Produkte ohne Varianten.

Beispiele:

• Poster in einer festen Größe

• Einzelprodukte ohne Auswahloptionen

Produkte mit Varianten

Produkte mit mehreren Optionen wie:

Beispiele:

• T-Shirts (Größe + Farbe)

• Schuhe (Größe + Modell)

Produkt über Public API erstellen

Autorisierung

Für CRUD-Operationen über die Public API wird ein Access Token benötigt.

Dokumentation:
https://marketplace.gohighlevel.com/docs/Authorization/authorization_doc

Produkterstellung

Für die Erstellung eines Produkts werden folgende APIs genutzt:

• Create Product

• Create Price for Product

Empfohlene Reihenfolge:

1. Produkt erstellen

2. Preis erstellen

Produkt erstellen

Wichtige Felder:

• name → Produktname

• locationId → Sub-Account ID

• description → Beschreibung

• productType → z. B. PHYSICAL oder DIGITAL

• image → Standardbild

• availableInStore → Sichtbarkeit im Store

• medias → Medien (Bilder/Videos)

• variants → nur bei Variantenprodukten

Beispiel Payload (Produkt mit Preis)

{
  "name": "High Speed Memory Drive",
  "description": "A high speed memory drive with latest safety features and breath taking design",
  "locationId": "<sub-account_ID>",
  "availableInStore": true,
  "productType": "PHYSICAL",
  "image": "https://via.placeholder.com/150",
  "medias": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "High Speed Memory Drive",
      "url": "https://via.placeholder.com/150",
      "type": "image",
      "isFeatured": true
    }
  ]
}

Beispiel Payload (Produkt mit Varianten)

{
  "name": "T-shirt",
  "description": "Latest t-shirt with latest design and quality",
  "locationId": "<sub_account_id>",
  "availableInStore": true,
  "productType": "PHYSICAL",
  "image": "https://via.placeholder.com/150",
  "medias": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "T-shirt",
      "url": "https://via.placeholder.com/150",
      "type": "image",
      "isFeatured": true
    }
  ],
  "variants": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Color",
      "options": [
        { "id": "550e8400-e29b-41d4-a716-446655440002", "name": "Red" },
        { "id": "550e8400-e29b-41d4-a716-446655440001", "name": "Blue" },
        { "id": "550e8400-e29b-41d4-a716-446655440003", "name": "Green" }
      ]
    }
  ]
}

Preis für ein Produkt erstellen

Wichtige Felder:

• product → Produkt-ID

• locationId → Sub-Account

• name → Preisname

• type → one_time oder recurring

• currency → Währung

• amount → Preis

• variantOptionIds → nur bei Varianten

• trackInventory → Lagerverwaltung

• sku → Artikelnummer

Beispiel Payload (einfacher Preis)

{
  "product": "66b6021be68f7a98102ba272",
  "locationId": "<sub_account_id>",
  "name": "256 GB",
  "type": "one_time",
  "currency": "USD",
  "amount": 100,
  "description": "256 GB of storage",
  "sku": "PS-256GB",
  "isDigitalProduct": false,
  "shippingOptions": {
    "weight": {
      "value": 100,
      "unit": "g"
    },
    "dimensions": {
      "length": 10,
      "width": 10,
      "height": 10,
      "unit": "cm"
    }
  }
}

Beispiel Payload (Preis für Variantenprodukt)

{
  "product": "66b6021be68f7a98102ba272",
  "locationId": "<sub_account_id>",
  "name": "Red / Small",
  "type": "one_time",
  "currency": "USD",
  "amount": 100,
  "description": "Red / Small",
  "sku": "PS-RED-SMALL",
  "isDigitalProduct": false,
  "variantOptionIds": [
    "550e8400-e29b-41d4-a716-446655440002",
    "550e8400-e29b-41d4-a716-446655440112"
  ]
}

Bild zu Variante über API hinzufügen

Bei Variantenprodukten kann ein Bild pro PriceId zugeordnet werden.

Beispiel Payload (Media Update mit PriceIds)

{
  "name": "T-shirt",
  "description": "Latest t-shirt with latest design and quality",
  "locationId": "<sub_account_id>",
  "availableInStore": true,
  "productType": "PHYSICAL",
  "image": "https://via.placeholder.com/150",
  "medias": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "T-shirt",
      "url": "https://via.placeholder.com/150",
      "type": "image",
      "priceIds": ["<created_price_Id>"],
      "isFeatured": true
    }
  ]
}

Fazit

Mit der Public API kannst du in ProfitBoost:

• Produkte erstellen

• Preise definieren

• Varianten verwalten

• Medien gezielt Varianten zuordnen

Damit lassen sich komplette E-Commerce-Strukturen automatisiert aufbauen.