🚚

Kluspārdošana (dropshipping)

dropship sales_billing 🛡️ RLS Protected

Direktā piegāde no piegādātāja uz galīgo klientu, piegādātāja PO ražošana un fakturēšanas atlaidums.

Fachliche Bestimmung: Izveido reālu trikāļu un garšu darījumu bezmaksas iepirkuma un pārdošanas. Priekšlikumu pieņemšanas laikā ar garšu pozīcijām tiek automātiski iegādātas pirkšanas pasūtījums piegādātājam ar klienta piegādes adresi.

⚡ Darbības plūsmas un dzīves cikļi (2) 🗄️ Datu modeļi & laukumi (2) 🔌 Izstādes punkti (UI un API) (24) 🛡️ Regulators & atbilstība

⚡ Darbības plūsmas un dzīves cikļi

Strāvas dzīves cikls & faktūras aizturēšana `dropship_lifecycle`

Kaufmännischer und logistischer Ablauf des Streckengeschäfts ohne Zwischenlagerung.

sequenceDiagram Customer->>ERP: Bestellt Artikel (Route: Dropship) ERP->>Supplier: PO (Lieferadresse: Kunde, Typ: dropship) Note over ERP: billing_released = False (Fakturasperre) Supplier->>Customer: Liefert Ware direkt aus Supplier-->>ERP: Sendungsnummer / Zustellnachweis ERP->>ERP: Status = delivered & billing_released = True ERP->>Customer: Ausgangsrechnung wird generiert

1. ROUTE_DETECTION

Rūtas atciemošana

resolve_route nosaka maršrutas darbību, izmantojot produktu kategoriju vai pozīciju pārrēķinus.

Aktionen: Pārkāpties no noliktavas

2. PURCHASE_ORDER

Pieprasījumu ražošana

DropshipService apvieno pozīcijas pēc piegādātājs un veido PO ar procurement_type='dropship'.

Aktionen: piegādes adrese = klientu adrese

3. TRACKING

Saldības uzraudzība

piegādātājs paziņo izsekošanas numuru un nosūtīšanas pakalpojumu sniedzēju.

Aktionen: "In_transit" statuss

4. DELIVERY_CONFIRM

Pārdod

Pārbaudes apstiprinājums klientam (POD).

Aktionen: "Deleverēts" statuss

5. BILLING_RELEASE

Izstrādājumu atdešana

billing_released tiek iestrādāts True; klientu rekords tiek atvērts.

Aktionen: izrakstīts rēķins

Benutzerbefehl: sales order agent `plan:command_sales_order_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. sales_order_agent

sales_order_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "sales_order_agent", "condition_fact": null}

Aktionen: sales_order_agent

🗄️ Datu modeļi & laukumi

DropshipLines dropship_lines RLS Aktiv

37 Šķiet, ka tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā vai ir no tā.

Tabelle dropship_lines

Feldname	Datums	Atbalsts	Schlüssel	Īpaša nozīme
`item_type`	`VARCHAR(24)`	Ja *	-	Feld item_type
`item_id`	`UUID`	Ja *	-	Feld item_id
`quote_id`	`UUID`	Nein	FK ➔ quotes.id	Feld quote_id
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`product_id`	`UUID`	Nein	FK ➔ products.id	Feld product_id
`description`	`VARCHAR(255)`	Ja *	-	Feld description
`quantity`	`NUMERIC(14, 4)`	Ja *	-	Feld quantity
`unit`	`VARCHAR(16)`	Ja *	-	Feld unit
`sales_net`	`NUMERIC(14, 2)`	Ja *	-	Feld sales_net
`supplier_id`	`UUID`	Nein	FK ➔ suppliers.id	Feld supplier_id
`purchase_id`	`UUID`	Nein	FK ➔ purchases.id	Feld purchase_id
`purchase_item_id`	`UUID`	Nein	FK ➔ purchase_items.id	Feld purchase_item_id
`cost_net`	`NUMERIC(14, 2)`	Nein	-	Feld cost_net
`ship_to`	`TEXT`	Nein	-	Feld ship_to
`status`	`VARCHAR(16)`	Ja *	-	Feld status
`carrier`	`VARCHAR(120)`	Nein	-	Feld carrier
`tracking_number`	`VARCHAR(120)`	Nein	-	Feld tracking_number
`tracking_url`	`VARCHAR(512)`	Nein	-	Feld tracking_url
`expected_delivery_date`	`DATE`	Nein	-	Feld expected_delivery_date
`shipped_at`	`DATETIME`	Nein	-	Feld shipped_at
`delivered_at`	`DATETIME`	Nein	-	Feld delivered_at
`proof_document_id`	`UUID`	Nein	FK ➔ documents.id	Feld proof_document_id
`billing_released`	`BOOLEAN`	Ja *	-	Feld billing_released
`release_reason`	`VARCHAR(255)`	Nein	-	Feld release_reason
`chain_review`	`BOOLEAN`	Ja *	-	Feld chain_review
`issue_note`	`VARCHAR(500)`	Nein	-	Feld issue_note
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

SalesAgents sales_agents RLS Aktiv

18 Šķiet, ka tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā vai ir no tā.

Tabelle sales_agents

Feldname	Datums	Atbalsts	Schlüssel	Īpaša nozīme
`name`	`VARCHAR(255)`	Ja *	-	Feld name
`email`	`VARCHAR(320)`	Nein	-	Feld email
`phone`	`VARCHAR(64)`	Nein	-	Feld phone
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`supplier_id`	`UUID`	Nein	FK ➔ suppliers.id	Feld supplier_id
`default_commission_percent`	`NUMERIC(5, 2)`	Nein	-	Feld default_commission_percent
`default_markup_percent`	`NUMERIC(5, 2)`	Nein	-	Feld default_markup_percent
`notes`	`TEXT`	Nein	-	Feld notes
`active`	`BOOLEAN`	Ja *	-	Feld active
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

🔌 Izstādes punkti (UI un API)

Art	Metodes	Galvenā vieta / ceļš	Titel & Zweck	Attaisnošana
⚡ REST API	DELETE	`/api/v1/sales/orders/{order_id}/items/{item_id}`	delete_item Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	GET	`/api/v1/sales/orders`	list_sales_orders Semantic binding: inventory_only; mutation=False	`sales`
⚡ REST API	GET	`/api/v1/sales/orders/{order_id}`	get_sales_order Semantic binding: inventory_only; mutation=False	`sales`
⚡ REST API	GET	`/api/v1/sales/summary`	sales_summary Semantic binding: inventory_only; mutation=False	`sales`
⚡ REST API	GET	`/portal/{slug}/bestellung`	order_form Semantic binding: inventory_only; mutation=False	`sales`
⚡ REST API	GET	`/verkauf`	sales_page Semantic binding: inventory_only; mutation=False	`sales`
⚡ REST API	GET	`/verkauf/{order_id}`	sales_order_page Semantic binding: inventory_only; mutation=False	`sales`
⚡ REST API	PATCH	`/api/v1/sales/orders/{order_id}`	update_sales_order Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	PATCH	`/api/v1/sales/orders/{order_id}/items/{item_id}`	update_item Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders`	create_sales_order Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/from-quote/{quote_id}`	create_from_quote Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/cancel`	cancel_sales_order Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/confirm`	confirm_sales_order Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/invoice`	invoice_sales_order Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/items`	add_item Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/mark-delivered`	mark_delivered Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/start-delivery`	start_delivery Semantic binding: operator_surface; mutation=True	`sales`
⚡ REST API	POST	`/portal/{slug}/bestellung`	order_submit Semantic binding: operator_surface; mutation=True	`sales`
🖥️ WEB-UI	GET	`/quotes?status=dropship`	Strāvas filtrēšanas piedāvājumi Filtrē piedāvājumu ar maršruta darījumu pozīcijām	`quotes:read`
🖥️ WEB-UI	GET	`/purchasing#dropship`	Pārvadājumu veikšana Apdots iepirkuma reižu ar identifikācijas numuru un izslēgšanu	`purchasing:read`
⚡ REST API	GET	`/api/v1/dropshipping`	Rīcības pozīcijas API Pārvadātājas maršruta pozīcijas ar piegādātāju un pierādījumu datu	`quotes:read`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/assign-supplier`	☐ ja ir Atšķir piegādātājs un rada iepirkuma pasūtījumu	`purchasing:write`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/tracking`	Uzglabāt Ja ir reģistrācijas numurs un nav reģistrācijas numurs,	`purchasing:write`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/delivered`	Pieejas apstiprinājums Atceļ statusus uz piegādātu un izsniedz atbrīvojumu	`purchasing:write`

🛡️ Regulators & atbilstība

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

UStG §25b (Komuniskās trijušās darbības)
GoBD (izņemot fakturēšanu pēc sniegšanas)

Saistītie moduli:

➔ finance ➔ purchasing ➔ catalog ➔ customers ➔ suppliers