🚚

Cestovní podnikání (dropshipping)

dropship sales_billing 🛡️ RLS Protected

Přímé dodávky od dodavatele ke konečným zákazníkům, dodavatelská PO-generování a blokování vyúčtování.

Fachliche Bestimmung: Vytváří se skutečné trojúhelní a tratické obchody bez problémů v nákupu a prodeji. Při přijetí nabídky s tratickými pozicemi se automaticky generuje nákupní objednávka u dodavatele s dodavatelskou adresou.

⚡ Pracovní toky a životní cykly (4) 🗄️ Data modely a pole (2) 🔌 Úvodní místa (UI a API) (24) 🛡️ Regulační a dodržovací

⚡ Pracovní toky a životní cykly

Výše spotřeby `dropship_lifecycle`

obchodní a logistické provozování provozních činností bez mezitímního skladování.

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

Routní identifikace

resolve_route určuje provozní provoz podle kategorií produktů nebo přestupů pozic.

Aktionen: Překročení zásobních potřeb

2. PURCHASE_ORDER

Generování objednávek

DropshipService spojuje pozice podle dodavatel a vytváří PO s procurement_type='dropship'.

Aktionen: Dopravní adresa = adresa zákazníka

3. TRACKING

Kontrolní úprava

dodavatel hlásí sledovací číslo a dodavatele.

Aktionen: Status "in_transit"

4. DELIVERY_CONFIRM

Poskytování

Potvrzení dodání zákazníkovi (POD).

Aktionen: Status "doručen"

5. BILLING_RELEASE

Údaje o fakturach

billing_released se nastaví na True; zákazní účet se odvolá.

Aktionen: vydaná faktura

Kundenauftrag → Abwicklung `cascade:business.customer_order.fulfill`

Kaskade (review_gated).

1. order

Verkaufsauftrag anlegen / bestätigen

sales

Aktionen: sales.create

2. issue

Vytáčení zboží jako návrh

vklad

Aktionen: stock.issue.create

3. tour

Plánování vývozu

logistické

Aktionen: create_tour

4. project

projekt / přidělování nákladních míst

projekty

Aktionen: link_project

5. task

Účetní jednotka

úkoly

Aktionen: create_task

Verkaufsauftrag anlegen / bestätigen `cascade_target:business.sales_order.create`

Kaskade (review_gated).

1. cascade

Verkaufsauftrag anlegen / bestätigen

Benutzerbefehl: sales order agent `plan:command_sales_order_agent`

Kontrolovaný trvalý plán (durable_plan), start: manual_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

🗄️ Data modely a pole

DropshipLines dropship_lines RLS Aktiv

37 Plochy / sloupci

Tabelle dropship_lines

Feldname	Typ údajů	Povinnost	Schlüssel	Vědecké význam
`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 Plochy / sloupci

Tabelle sales_agents

Feldname	Typ údajů	Povinnost	Schlüssel	Vědecké význam
`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

🔌 Úvodní místa (UI a API)

Art	Přípravek	Konečný bod / cesta	Titel & Zweck	Oprávnění
⚡ 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`	Nabídky na filtry Filtrování nabídek s pozicemi v oblasti obchodních linií	`quotes:read`
🖥️ WEB-UI	GET	`/purchasing#dropship`	Koupování Dedicované nákupní jezdecové s identifikačními čísly a sledováním	`purchasing:read`
⚡ REST API	GET	`/api/v1/dropshipping`	Působnost Poskytování pozic v oblasti provozních provozovny s daty o dodavatelech a dokladech	`quotes:read`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/assign-supplier`	Přidělení Přidává dodavatel a vytváří nákupní objednávku	`purchasing:write`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/tracking`	Zásledování Vložte číslo sledování a nastaví status na in_transit	`purchasing:write`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/delivered`	Potvrzení dodání Stanoví status na doručený a udělí úvěrové úvěry	`purchasing:write`

🛡️ Regulační a dodržovací

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

UStG §25b (Vnitřní obchodní transakce v rámci Společenství)
V případě, že se tato částka nevztahuje na účetní jednotku, musí být uvedená částka v položce 1.

Vkládání:

➔ finance ➔ purchasing ➔ catalog ➔ customers ➔ suppliers

Cestovní podnikání (dropshipping)

⚡ Pracovní toky a životní cykly

Výše spotřeby dropship_lifecycle

Kundenauftrag → Abwicklung cascade:business.customer_order.fulfill

Verkaufsauftrag anlegen / bestätigen cascade_target:business.sales_order.create