weclapp und HubSpot anbinden ohne Datenmüll: Gerichteter Deal-Sync, Angebot/Auftrag und Kommissionsfeld für Partner
Kurz gesagt: Verbindest du HubSpot und weclapp pauschal per Zwei-Wege-Kontaktsync, landen unqualifizierte Marketing-Leads leicht im ERP, während Angebote, Beleg-PDFs und indirekte Partnerverkäufe trotzdem Handarbeit bleiben. Sauber läuft die Kopplung als gerichteter Stufen-Sync per API und n8n: HubSpot führt Marketing und frühe Pipeline, erst ab einer festen Deal-Stage entstehen in weclapp über POST /party und POST /quotation (oder POST /salesOrder) Debitor und Belegentwurf, fertige PDFs und Status fließen an den Deal zurück, und bei Partnergeschäften trennen customerId, das Kommissionsfeld (commission) und die Lieferadresse Rechnungsempfänger und Endkunde ohne Double-Count.
In wachsenden B2B-, SaaS- und Handelsunternehmen arbeiten Marketing und Vertrieb häufig in HubSpot, während Einkauf, Lager, Auftragsabwicklung und vorbereitende Buchhaltung in weclapp zu Hause sind. Sobald beide Welten zusammenwachsen sollen, kippen Standard-Integrationen fast immer an denselben drei Stellen: Unreife Kontakte belasten ohne saubere Filterung den weclapp-Kundenstamm, Angebote werden doppelt abgetippt, und sobald ein Systemhaus oder Reseller zwischen dir und dem Endkunden steht, stimmen entweder die Pipeline-Zahlen oder die Rechnungsadressen nicht mehr. Dieser Leitfaden zeigt dir eine belastbare Schnittstellen-Architektur vom ersten Deal-Trigger bis zur Dubletten-Bereinigung vor dem Go-live.
Das Wichtigste in Kürze
- Klare Systemgrenze statt Zwei-Wege-Rauschen. HubSpot verantwortet Kampagnen, Lead-Qualifizierung, Aktivitäten und frühe Verkaufschancen; weclapp bleibt das alleinige kaufmännische System of Record für Artikel, Preise, Steuern, Angebote, Aufträge und Rechnungen.
- Erst die Deal-Stage öffnet das Tor ins ERP. Ein gerichteter Webhook- und n8n-Workflow legt Firma, Ansprechpartner:in und Angebots- oder Auftragsentwurf erst dann in weclapp an, wenn ein HubSpot-Deal die vereinbarte Reifestufe erreicht.
- Kalkulation in weclapp, Beleg-PDF zurück an den Deal. Staffelpreise, Stücklisten und Umsatzsteuer rechnet weclapp; Angebotsnummer, Nettobetrag, Status und das erzeugte PDF laufen über die gespeicherte Deal-ID eindeutig an HubSpot zurück.
-
Partner- und Reseller-Geschäft ohne Double-Count. Der kaufmännische Partner steht als Debitor (
customerId) am Beleg, während der Endkunde strukturiert über HubSpot Association Labels, das weclapp-Kommissionsfeld (commission) und optional die abweichende Lieferadresse geführt wird. - Neugeschäft sofort starten, Altbestand per Prüfliste bereinigen. Statt monatelang auf eine vollständige Stammdaten-Sanierung zu warten, geht der ID-gebundene Deal-Sync vorab live, während der Vertrieb Bestands-Dubletten über eine vorbereitete Abgleichstabelle klärt.
Wo ziehst du die Systemgrenze zwischen HubSpot CRM und weclapp – und wann reicht der Standard-Sync?
Bevor das erste Feld gemappt wird, braucht dein Projekt eine eindeutige Antwort darauf, welches System welche Wahrheit führt. Im HubSpot App Marketplace steht mit weclapp Data Sync eine offizielle Anbindung auf Basis von HubSpot Data Sync bereit (in der weclapp-eigenen Dokumentation unter doc.weclapp.com existiert dazu kein separates Handbuchkapitel). Laut HubSpot-Dokumentation gleicht Data Sync Kontakte und Unternehmen einseitig oder in beide Richtungen ab und lässt sich über Listen oder Eigenschaften filtern; benutzerdefinierte Feldzuordnungen setzen ein entsprechendes HubSpot-Daten-Abonnement (etwa Data Hub beziehungsweise Operations Hub ab Starter) voraus.
Für ein kleines Team mit reinem Direktvertrieb, das lediglich gefilterte Kontaktdaten zwischen CRM und ERP synchron halten möchte und Belege manuell anstößt, kann dieser Standard-Sync genügen. Sobald jedoch Deal-gesteuerte Angebotsprozesse, komplexe Kalkulationen oder indirekter Partnervertrieb hinzukommen, stößt ein reiner Kontakt- und Unternehmens-Sync an strukturelle Grenzen:
| Anforderung im Alltag | HubSpot Data Sync (Standard) | Gerichteter Stufen-Sync (API & n8n) | Kaufmännische Wirkung |
|---|---|---|---|
| Tausende Marketing- und Event-Leads in HubSpot | Synchronisiert nur Kontakte & Unternehmen (Filterung über Listen/Felder nötig, kein Deal-Stage-Trigger) | Übergabe erst bei definierter Deal-Stage (z. B. Angebot angefordert) | weclapp-Kundenstamm erhält nur kaufreife Accounts |
| Angebot & Auftrag mit Staffelpreisen, Sets & Steuern | Kein automatischer Belegentwurf mit PDF-Rückfluss an den HubSpot-Deal | Anlage per POST /quotation oder POST /salesOrder; PDF & Status fließen zurück |
Kalkulation und Steuerfindung bleiben zu 100 % in weclapp |
| Indirektes Geschäft über Partner / Reseller | 1:1-Zuordnung ohne Trennung von Rechnungsempfänger und Endkunde am Beleg | Association Labels in HubSpot + Partner als customerId + Endkunde in commission
|
Saubere Debitorenbuchhaltung ohne doppelten Pipeline-Umsatz |
| Produkt- & Modul-Segmentierung für Bestandskund:innen | Spiegelung ganzer Artikelstämme bläht das CRM mit Wartungs- und Varianten-SKUs auf | Gezielter Rückfluss schlanker Unternehmens-Auswahlfelder (Produktsparte, aktive Module) | Marketing segmentiert präzise ohne ERP-Artikelballast in HubSpot |
Den übergreifenden Vergleich zwischen fertigen Konnektoren, Middleware und eigener API-Strecke findest du auf unserer Leistungsseite zu weclapp-Schnittstellen.
Fazit: Nutze HubSpot für Reichweite, Qualifizierung und Kontaktaktivitäten, aber überlass Artikel, Preise, Steuern und Belege konsequent weclapp über eine klar gerichtete Übergabeschwelle.
Wie läuft der gerichtete Deal-zu-Beleg-Sync über die APIs von HubSpot und weclapp technisch ab?
Statt beide Datenbanken ununterbrochen gegeneinander abzugleichen, zerlegst du den Prozess in einem n8n-Workflow in vier klar getrennte, idempotente Schritte mit eindeutigen Fremdschlüsseln:

Gerichteter Lead-to-Order-Datenfluss: Unqualifizierte Kontakte bleiben in HubSpot, erst die Deal-Stage erzeugt Debitor und Belegentwurf in weclapp, und das fertige Beleg-PDF kehrt samt Status an den Deal zurück.
-
Deal-Stage-Trigger abfangen und Relationen nachlesen: Sobald ein Vertriebsmitglied einen Deal in die vereinbarte Stufe verschiebt (etwa „Angebot erstellen“ oder „Auftrag gewonnen“), meldet ein HubSpot-Webhook (
deal.propertyChangeaufdealstage) die Änderung. Da Webhook- und Associations-Aufrufe nur Objekt-IDs und Labels liefern, liest der Workflow zuerst den Deal (GET /crm/v3/objects/deals/{dealId}), ermittelt die verknüpften IDs über die Associations API v4 (GET /crm/v4/objects/deals/{dealId}/associations/companiesund.../contacts) und ruft anschließend die vollständigen Datensätze über/crm/v3/objects/companies/{companyId}und.../contacts/{contactId}ab. -
Debitor und Ansprechpartner:in über
partyin weclapp REST-API v2 anlegen: Während ältere Skripte aus der weclapp-API v1 nochPOST /customerundPOST /contactnutzen, bündelt die aktuelle weclapp REST-API v2 (/webapp/api/v2) Interessent:innen, Kund:innen, Lieferant:innen und Kontakte einheitlich inparty. Der Workflow legt neue Unternehmen perPOST /party(partyType: "ORGANIZATION",customer: true, samt Rechnungsadresse undvatIdentificationNumber) sowie die Kontaktperson als eigenenPOST /party(partyType: "PERSON") an und verknüpft deren ID im Arraycontactsbeziehungsweise alsprimaryContactId. -
Beleggerüst mit eindeutiger
dealIderzeugen: Direkt danach legt n8n perPOST /quotation(mit Angebotstyp Auftrag erzeugen, in der APIquotationType: "SALES_ORDER") beziehungsweise bei Direktabschlüssen perPOST /salesOrderdas editierbare Beleggerüst an. Die HubSpot-dealIdspeicherst du sofort in einem Zusatzfeld (customAttributes) am weclapp-Beleg und schreibst umgekehrt Kundennummer, Belegnummer sowie den direkten weclapp-Link in den HubSpot-Deal zurück. -
Kalkulation in weclapp und PDF-Rückfluss ohne Endlosschleife: Positionen, Staffelpreise, Stücklisten und Steuern kalkuliert der Innendienst in weclapp. Nach Abschluss der Angebotserfassung (
ENTRY_COMPLETED) erzeugt weclapp das Beleg-PDF perPOST /quotation/id/{id}/createQuotationPdfzum Abruf überGET /quotation/id/{id}/downloadLatestQuotationPdfoder schreibt überPOST /quotation/id/{id}/createPublicPageLinkdie Angebots-URL in das FeldpublicLink(bei AuftragsbestätigungenGET /salesOrder/id/{id}/downloadLatestOrderConfirmationPdf). Da ein weclapp-Webhook (Globale Einstellungen → Integration → Webhooks) nurentityId,entityNameund Ereignistyp sendet, liest n8n Status, Nettobetrag und Dokument perGETnach und spielt sie schleifenfrei an den über diedealIdverknüpften HubSpot-Deal zurück (Details unter n8n ohne Webhook-Loop); Angebote ohnedealIdkönnen optional den fehlenden Deal in HubSpot anlegen.
Fazit: Die gespeicherte dealId am weclapp-Beleg und der klare Richtungswechsel zwischen Anlage und PDF-Rückfluss verhindern doppelte Angebote ebenso zuverlässig wie manuelles Datei-Hochladen.
Wie bildest du indirektes Partner- und Reseller-Geschäft ohne Double-Count ab?
Besonders heikel wird die Kopplung zwischen HubSpot und weclapp, sobald du nicht direkt an das nutzende Unternehmen fakturierst, sondern über Systemhäuser, Fachhändler:innen, Agenturen oder Einkaufsverbände verkaufst. In solchen Dreiecksgeschäften beteiligen sich zwei Firmen an demselben Abschluss: Der Partner bestellt und bezahlt die Rechnung zu seinen Partnerkonditionen, während der Endkunde die Softwarelizenz nutzt, das Projekt betreut bekommt oder die Ware per Direktlieferung empfängt.
Baut man diese Konstellation unüberlegt auf, entstehen im Reporting entweder doppelte Umsätze (ein Deal beim Partner und ein zweiter beim Endkunden) oder im ERP falsche Offene Posten. Mit drei sauber abgestimmten Feldern bleibt beides eindeutig:
-
Zwei gelabelte Unternehmens-Verknüpfungen an genau einem HubSpot-Deal: In HubSpot existiert pro Verkaufschance genau ein Deal, damit die Pipeline-Summe niemals doppelt zählt. Über Association Labels der Associations API v4 (
PUT /crm/v4/objects/deals/{dealId}/associations/companies/{companyId}) verknüpfst du an diesem Deal beide Unternehmen mit klaren Rollen – etwa Partner / Rechnungsempfänger und Endkunde. So sieht der Vertrieb auf sowohl der Partner- als auch der Endkunden-Akte alle laufenden Projekte. -
Partner als kaufmännischer Debitor und Endkunde im weclapp-Kommissionsfeld: Beim Übergang nach weclapp setzt der Workflow den Partner als
customerIdam Angebot (quotation) oder Auftrag (salesOrder) ein (bei separaten Zentralregulierern steht ergänzendinvoiceRecipientIdbereit). Den Namen – und optional die HubSpot-Company-ID – des Endkunden schreibt die Schnittstelle strukturiert in das Kopffeld Kommission (commission, laut weclapp-OpenAPI bis zu 255 Zeichen). Der große Vorteil im ERP-Alltag: weclapp vererbt das Kommissionsfeld vom Angebot (quotation) automatisch in den Auftrag (salesOrder) und bis auf die Ausgangsrechnung (salesInvoice), sodass Partner und Buchhaltung auf jedem Abrechnungsbeleg sofort erkennen, für welchen Endkunden fakturiert wird. -
Abweichende Lieferadresse für Lieferschein, Direktversand und Steuerfindung: Da weclapp das Kommissionsfeld auf der Lieferung (
shipment) nicht als eigenes Feld führt, übergibt der Workflow bei physischem Streckengeschäft die Endkundenanschrift zusätzlich als abweichende Lieferadresse (deliveryAddressvom TyprecordAddressmit eigenem Firmennamen im Feldcompany). Dadurch weist der Lieferschein den Endkunden korrekt aus und weclapp zieht für die Umsatzsteuer-Regelprüfung das tatsächliche Lieferland heran, während die Rechnung buchhalterisch beim Partner verbleibt. Für spätere Marketing-Kampagnen nach eingesetzten Modulen synchronisierst du aus weclapp gezielt ein schlankes Auswahlfeld (zum Beispiel Aktive Produktmodule über die HubSpot Properties API) auf das Endkunden-Unternehmen zurück, statt hunderte Lizenz- und Wartungsartikel in HubSpot anzulegen.
Fazit: Association Labels in HubSpot kombiniert mit Partner-customerId, commission-Eintrag für Angebot bis Rechnung und abweichender Lieferadresse für den Versand bilden Dreiecksgeschäfte ohne doppelte Deals ab.
Wie verhinderst du Dubletten vor dem Go-live, ohne das Projekt monatelang zu blockieren?
In gewachsenen Beständen liegen auf beiden Seiten fast immer abweichende Schreibweisen vor: In HubSpot hat sich eine Ansprechpartnerin vor zwei Jahren mit einer Zweit-E-Mail für ein Webinar eingetragen, während die Buchhaltung dieselbe Firma in weclapp mit exakter Rechtsform, Umsatzsteuer-ID und Sammeladresse rechnung@ führt. Wer an dieser Stelle ungeprüft synchronisiert, erzeugt über Nacht hunderte Dubletten.
Laut offizieller HubSpot-Dokumentation dedupliziert HubSpot Kontakte standardmäßig allein über die primäre Email-Adresse und Unternehmen über die Company domain name (beziehungsweise im Data Sync optional über normalisierte Firmennamen ohne Satzzeichen und Groß-/Kleinschreibung). Weder die Umsatzsteuer-Identifikationsnummer (vatIdentificationNumber am weclapp-party-Datensatz) noch deine weclapp-Kundennummer sind in HubSpot ab Werk eindeutige Prüfschlüssel – und mehrere Landesgesellschaften eines Konzerns teilen sich in der Praxis oft dieselbe Web-Domain. Gleichzeitig solltest du Dubletten in weclapp gar nicht erst entstehen lassen: Die Massenaktion Kontakte zusammenfassen bricht im Standardmodus Sicheres Zusammenführen bei abweichenden Feldinhalten ab, übernimmt keine Primär- oder Rechnungsadress-Kennzeichen und führt ein zweites Personenkonto nicht zusammen, sobald der Hauptkunde bereits ein eigenes Personenkonto besitzt.
In der Beratungspraxis hat sich deshalb eine zweistufige Einführung bewährt, die den operativen Betrieb nicht ausbremst:
-
Stufe 1 – Neugeschäft mit dreistufigem Dubletten-Check sofort produktiv nehmen: Der Deal-Stage-Workflow geht zuerst für neue Abschlüsse live und prüft vor jedem
POST /partydeterministisch in fester Reihenfolge: (a) Ist die weclapp-party.idbereits als eindeutige Eigenschaft am HubSpot-Unternehmen hinterlegt? (b) Gibt es in weclapp einen eindeutigen Treffer auf die bereinigtevatIdentificationNumber? (c) Passt die E-Mail-Domain beziehungsweise Firmenanschrift eindeutig zu genau einem Datensatz? Liefert Schritt (c) mehrere mögliche Treffer (etwa zwei Tochtergesellschaften derselben Domain), legt der Workflow bewusst keine Dublette an, sondern stellt den Vorgang mit einem kurzen Prüfhinweis für den Innendienst bereit. - Stufe 2 – Historischen Altbestand per geführter Abgleichsliste verknüpfen: Parallel liest ein einmaliges Analyse-Skript alle bestehenden weclapp-Kund:innen und HubSpot-Companies aus und erzeugt eine übersichtliche Excel-Prüftabelle mit drei Kategorien: sicheres Match (identische USt-IdNr. oder eindeutige Domain plus Ort), Prüffall mit Abweichung (unterschiedliche Schreibweise oder Adresse) und nur in einem System vorhanden. Eine Person aus Vertrieb oder Innendienst entscheidet die wenigen Prüffälle ohne Programmierkenntnisse per Spaltenkommentar, bevor der Backfill die gegenseitigen System-IDs sauber einträgt (mehr zur sicheren Datenübernahme auf unserer Seite zur weclapp-Migration).
Fazit: Entkopple den Go-live des Deal-Workflows von der Altlasten-Sanierung und verlasse dich beim Matching auf System-IDs und USt-IdNr. statt allein auf Firmennamen oder Domains.
Wann passt diese Architektur nicht – und wie verhält sie sich zu MCP-Assistenten?
Nicht jedes Unternehmen braucht eine mehrstufige API-Strecke. Prüfe vor der Umsetzung ehrlich diese drei Abgrenzungen:
-
Kein eigener Marketing-Funnel und kleine Vertriebsmannschaft: Wenn ihr keine Inbound-Kampagnen, kein Lead-Scoring und keine mehrstufigen Partner-Pipelines in HubSpot fahrt, sondern Angebote direkt auf Zuruf schreibt, reicht das integrierte weclapp-CRM aus Kontakten, Verkaufschancen (
opportunity) und Wiedervorlagen oft völlig aus – ein zweites System kostet dann nur Lizenzgebühren und Pflegeaufwand. - Reines B2C-Massengeschäft über Online-Shops: Bestellen tausende Endkund:innen direkt im Webshop ohne vorangehende Angebotsverhandlung, läuft der Auftragsfluss über den Shop-Connector ins weclapp E-Commerce-Center (siehe Shopify-Bundles und Steuern im E-Commerce-Center), während HubSpot allenfalls aggregierte Kaufereignisse für das E-Mail-Marketing erhält.
- Ad-hoc-Abfragen per MCP vs. verlässlicher Hintergrund-Sync: Viele Teams fragen nach einem HubSpot MCP Server in Kombination mit wals.pro AI 4 weclapp. Für punktuelle Analysen im Gespräch – etwa um vor einem Jahresgespräch offene HubSpot-Deals eines Accounts neben dessen Umsätze und offene Posten aus weclapp zu legen – ist die Kombination beider MCP-Verbindungen im KI-Client enorm hilfreich (Details unter wals.pro AI 4 weclapp). Die laufende Belegübergabe zwischen Deal-Stage, Debitor und Angebots-PDF gehört dagegen immer in eine deterministische API-/n8n-Strecke, die rund um die Uhr ohne manuelles Prompting und ohne Sprachmodell-Abweichungen läuft; wie du solche Automatisierungen sauber schneidest, zeigen wir unter Prozessautomatisierung.
Fazit: Nutze MCP-Assistenten für übergreifende Ad-hoc-Einblicke im Dialog, n8n für den verlässlichen Deal-zu-Beleg-Prozess im Hintergrund und das native weclapp-CRM, wenn gar kein separates Marketing-System nötig ist.
Quellen und Grenzen
Stand: 18. November 2026.
- weclapp Dokumentation, Knowledge Base & API-Spezifikation: weclapp REST-API v2 OpenAPI-Spezifikation, 03. Kunden (inkl. Kontakte zusammenfassen), 01. Angebote, 10.1 Globale Einstellungen Angebote, 10.2 Globale Einstellungen Aufträge, Abweichende Lieferadresse oder Rechnungsadresse angeben sowie 03. Webhooks (alle abgerufen am 18.11.2026) – Konsolidierung von Kunden/Kontakten in
party(REST-API v2), EndpunktePOST /quotation(quotationType: "SALES_ORDER"),POST /quotation/id/{id}/createQuotationPdf,GET /quotation/id/{id}/downloadLatestQuotationPdf,POST /quotation/id/{id}/createPublicPageLink,POST /salesOrder, Kopffeldcommission(bis 255 Zeichen auf Angebot, Auftrag und Rechnung, nicht aufshipment),customerId,invoiceRecipientId,deliveryAddress(recordAddress) und Ereignis-Webhooks. - HubSpot Knowledge Base & App Marketplace: weclapp Data Sync im HubSpot Marketplace, Connect and use HubSpot data sync, Match records in data sync und Deduplicate records in HubSpot (alle abgerufen am 18.11.2026) – Funktionsumfang, Filteroptionen und Abo-Voraussetzungen für benutzerdefinierte Feldmappings im Data Sync sowie Standard-Deduplizierung über
Email(Contacts) undCompany domain namebeziehungsweise normalisierte Namen (Companies). - HubSpot Developer Documentation: CRM API v3 – Deals, CRM API v3 – Companies, CRM API v3 – Contacts, Associations API v4 (inkl. Association Labels), CRM Properties API v3 und Webhooks Management & Subscriptions API (alle abgerufen am 18.11.2026).
Grenzen dieses Artikels: Alle beschriebenen API-Endpunkte, Datenfelder und HubSpot-Sync-Funktionen entsprechen dem öffentlich dokumentierten Stand vom 18.11.2026; verfügbare Webhook-Trigger, Custom-Property-Limits und Association Labels in HubSpot hängen vom gebuchten HubSpot-Tarif ab. Umsatzsteuerliche Fragen bei grenzüberschreitenden Dreiecks- und Reihengeschäften zwischen Partner, Hersteller und Endkunde klärst du vorab verbindlich mit deiner Steuerberatung; das ersetzt keine Steuer- oder Rechtsberatung.
Weiterlesen: Unsere Übersicht zu weclapp-Schnittstellen und weclapp-Automatisierung mit n8n zeigt den Architekturrahmen; konkrete Umsetzungsmuster vertiefen n8n ohne Webhook-Loop, weclapp REST-API v2 für Stammdaten und weclapp-Migration.
Häufige Fragen
Gibt es eine fertige Standard-Schnittstelle zwischen HubSpot und weclapp – und wann reicht sie nicht aus?
Im HubSpot App Marketplace gibt es die App „weclapp Data Sync“ auf Basis von HubSpot Data Sync für den gefilterten Abgleich von Kontakten und Unternehmen (benutzerdefinierte Feldzuordnungen setzen ein entsprechendes HubSpot-Daten-Abo voraus). Sobald du jedoch einen Deal-Stage-gesteuerten Übergabe-Trigger, automatische Angebots- oder Auftragsentwürfe samt Beleg-PDF oder indirekte Partnergeschäfte mit Endkundenbezug abbilden möchtest, stößt der reine Kontakt- und Unternehmens-Sync an Grenzen und ein gerichteter API-/n8n-Workflow ist der saubere Weg.
Wie verhindere ich, dass tausende Newsletter-Kontakte aus HubSpot meinen weclapp-Kundenstamm überfluten?
Indem du keinen pauschalen Zwei-Wege-Kontaktsync aktivierst, sondern eine klare Übergabeschwelle definierst: Kontakte und Leads bleiben während der Marketing- und Qualifizierungsphase ausschließlich in HubSpot. Erst wenn ein Deal eine festgelegte Vertriebsstufe erreicht (etwa „Angebot angefordert“ oder „Auftrag gewonnen“), legt der Workflow über die weclapp REST-API v2 gezielt dieses Unternehmen samt Ansprechpartner:in und Belegentwurf in weclapp an.
Welchen API-Endpunkt nutzt man in der aktuellen weclapp REST-API v2 für neue Kund:innen aus HubSpot?
In der aktuellen weclapp REST-API v2 (/webapp/api/v2) wurden die früher getrennten v1-Endpunkte für Kunden und Kontakte in der Ressource party zusammengeführt. Neue Unternehmen legst du per POST /party mit partyType: "ORGANIZATION" und customer: true sowie Ansprechpartner:innen per POST /party mit partyType: "PERSON" an; Angebote und Aufträge folgen über POST /quotation beziehungsweise POST /salesOrder unter Speicherung der HubSpot-dealId in einem Zusatzfeld.
Wie bilde ich Verkäufe über Systemhäuser oder Reseller ab, ohne Umsätze in HubSpot doppelt zu zählen?
Du führst in HubSpot pro Verkaufschance genau einen Deal und verknüpfst daran über Association Labels (Associations API v4) sowohl den Partner als auch den Endkunden. In weclapp wird der Partner als kaufmännischer Debitor (customerId) gesetzt, während der Endkunde im 255 Zeichen fassenden Kopffeld Kommission (commission) für Angebot, Auftrag und Rechnung – und bei Direktversand zusätzlich in der abweichenden Lieferadresse (deliveryAddress) für den Lieferschein – eingetragen wird.
Wie kommt das fertige Angebots-PDF aus weclapp zurück in den HubSpot-Deal?
Nach der Positions- und Preiskalkulation sowie dem Abschluss der Angebotserfassung in weclapp erzeugt weclapp das Belegdokument (POST /quotation/id/{id}/createQuotationPdf zum Abruf über downloadLatestQuotationPdf oder als öffentlicher Angebotslink im Feld publicLink). Ein weclapp-Webhook oder zeitversetzter n8n-Abgleich liest Belegdaten und PDF per GET nach, ordnet den Vorgang über die im Zusatzfeld gespeicherte dealId eindeutig dem HubSpot-Deal zu und aktualisiert dort Angebotsnummer, Nettobetrag, Status und Dokument.
Müssen wir vor dem Start erst monatelang alle historischen Dubletten in HubSpot und weclapp von Hand bereinigen?
Nein. Du kannst den gerichteten Deal-zu-Angebot-Workflow für Neuvorgänge zeitnah live nehmen, sofern er vor einer Neuanlage deterministisch auf gespeicherte System-ID, Umsatzsteuer-ID (vatIdentificationNumber) und Domain prüft und Mehrdeutigkeiten zur Klärung aussteuert. Den Altbestand bereinigst du parallel über eine automatisch erzeugte Excel-Abgleichsliste, die der Vertrieb ohne Zeitdruck prüft und freigibt.