Export-EulandaAddressToShopify

EulandaXtools — Funktionsreferenz

Export-EulandaAddressToShopify

ÜBERSICHT

Exportiert EULANDA-Adressen als Shopify-Kunden.

SYNTAX

Export-EulandaAddressToShopify [-Shop] <string> [-Token] <string> [-ApiVersion] <string> [[-Udl]
    <string>] [[-BreadcrumbPath] <string[]>] [[-AddressMatch] <string[]>] [-SendInvite]
    [[-MaxRetries] <int>] [[-TimeoutSec] <int>] [<CommonParameters>]

BESCHREIBUNG

Orchestrierungsfunktion, die für eine oder mehrere Adressen folgende Schritte ausführt:

1. Adressen per Merkmalbaum (BreadcrumbPath) oder MATCH-Code selektieren

2. Adressdaten per Get-AddressData laden

3. Pro Adresse: E-Mail prüfen (ohne E-Mail wird übersprungen)

4. Feld-Mapping auf Shopify CustomerSetInput

5. Kunde in Shopify anlegen oder aktualisieren (Set-ShopifyCustomer)

6. Metafield eulanda.match mit MATCH-Code setzen

7. Optional: Einladungs-E-Mail senden (nur klassische Konten)

8. Ergebnis-Array zurückgeben

Kontakt-Behandlung (Phase 1): Nur die Adress-E-Mail wird verwendet, ein Kunde pro Adresse. Adressen ohne E-Mail werden übersprungen. Kontakte werden vorerst ignoriert.

PARAMETER

-Shop

Type: string

Shopify-Shop-Domain, z.B. 'mein-shop.myshopify.com'.

-Token

Type: string

Admin API Access Token (shpat_...) der Custom App.

-ApiVersion

Type: string

API-Version, z.B. '2026-01'.

-Conn

Geöffnete ADO-Connection zur EULANDA-Datenbank.

-Udl

Type: string

Alternativ: Pfad zur UDL-Datei. Wird verwendet, wenn kein Conn übergeben wird.

-BreadcrumbPath

Type: string[]

Ein oder mehrere Merkmalbaum-Pfade zur Adress-Selektion, z.B. '\Shop'. Alle Adressen unter den angegebenen Pfaden werden exportiert.

-AddressMatch

Type: string[]

Ein oder mehrere MATCH-Codes zur direkten Adress-Selektion. Alternative zu -BreadcrumbPath.

-SendInvite

Type: switch

Wenn gesetzt, wird nach dem Anlegen eine Einladungs-E-Mail gesendet. Funktioniert nur mit klassischen Shopify-Kundenkonten.

-MaxRetries

Type: int
Default: 3

Maximale Anzahl Wiederholungen bei Rate-Limit.

-TimeoutSec

Type: int
Default: 60

HTTP Timeout in Sekunden.

AUSGABEN

pscustomobject[]

BEISPIELE

# Alle Adressen unter \Shop exportieren
Export-EulandaAddressToShopify -Shop 'mein-shop.myshopify.com' `
  -Token 'shpat_abc123' -ApiVersion '2026-01' `
  -Udl 'C:\EulandaXtools\Eulanda_1.udl' `
  -BreadcrumbPath @('\Shop')
# Einzelne Adresse per MATCH-Code
Export-EulandaAddressToShopify -Shop $shop -Token $token `
  -ApiVersion '2026-01' -Conn $conn -AddressMatch 'MUSTERKUNDE'
# Mit Einladungs-E-Mail (nur klassische Konten)
Export-EulandaAddressToShopify -Shop $shop -Token $token `
  -ApiVersion '2026-01' -Conn $conn `
  -BreadcrumbPath @('\Shop') -SendInvite