🚚

Yolculuk (Drop Shipping)

dropship sales_billing 🛡️ RLS Protected

Satıcıdan son müşterilere doğrudan teslimat, satıcı PO üretimi ve fatura çıkartma engelliği.

Fachliche Bestimmung: Gerçek üçgen ve rota ticaretlerini satış ve satın alma açısından birer kesintisiz olarak oluşturun. Bir rota pozisyonları ile bir teklif kabul edilirken, müşterinin teslimat adresi ile tedarikçiye otomatik olarak bir satın alma siparişleri oluşturulur. Aynı zamanda, bu pozisyon için müşteri faturaları fiziksel teslimat kanıtı ( teslimat/ izleme) bulunana kadar bir fatura çıkışı kapısı ile kapatılır.

⚡ İş akışları ve yaşam döngüleri (1) 🗄️ Verim modelleri & alanlar (2) 🔌 Giriş noktaları (UI & API) (24) 🛡️ Yönetim ve Uyum

⚡ İş akışları ve yaşam döngüleri

Yolu yaşam döngüsü & Faktura kapalı `dropship_lifecycle`

Yolculukların aralarında depolama yapılmadan yapılan ticaret ve lojistik işlemleri.

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

Yol Tanıması

resolve_route, ürün kategorisine veya konum ödenemelerine göre rotacılık değerini belirler.

Aktionen: Kaynak Gereksinimlerini Atlatmak

2. PURCHASE_ORDER

Sipariş üretimi

DropshipService pozisyonları tedarikçi'ya göre bir araya getirir ve PO'yu procurement_type='dropship' ile oluşturur.

Aktionen: Satın alma adresleri = Müşteri adresleri

3. TRACKING

Versandüberwachung

tedarikçi takip numarasını ve nakliye servisini bildirir.

Aktionen: "in_transit" durum

4. DELIVERY_CONFIRM

Teslimat

Müşteriye teslimat onayı (POD).

Aktionen: "Yapılmış" durum

5. BILLING_RELEASE

Faturayı bırakmak

Billing_released True'a ayarlanır. Müşteri hesabı açılır.

Aktionen: Yapılandırılabilir

🗄️ Verim modelleri & alanlar

DropshipLines dropship_lines RLS Aktiv

37 Alanlar / Sütunlar

Tabelle dropship_lines

Feldname	Verim tipi	İade	Schlüssel	Mesleki anlam
`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 Alanlar / Sütunlar

Tabelle sales_agents

Feldname	Verim tipi	İade	Schlüssel	Mesleki anlam
`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

🔌 Giriş noktaları (UI & API)

Art	Metod	Son nokta / yol	Titel & Zweck	Yasal
⚡ REST API	DELETE	`/api/v1/sales/orders/{order_id}/items/{item_id}`	delete_item Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	GET	`/api/v1/sales/orders`	list_sales_orders Semantic binding: not_evaluated; mutation=False	`sales`
⚡ REST API	GET	`/api/v1/sales/orders/{order_id}`	get_sales_order Semantic binding: not_evaluated; mutation=False	`sales`
⚡ REST API	GET	`/api/v1/sales/summary`	sales_summary Semantic binding: not_evaluated; mutation=False	`sales`
⚡ REST API	GET	`/portal/{slug}/bestellung`	order_form Semantic binding: not_evaluated; mutation=False	`sales`
⚡ REST API	GET	`/verkauf`	sales_page Semantic binding: not_evaluated; mutation=False	`sales`
⚡ REST API	GET	`/verkauf/{order_id}`	sales_order_page Semantic binding: not_evaluated; mutation=False	`sales`
⚡ REST API	PATCH	`/api/v1/sales/orders/{order_id}`	update_sales_order Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	PATCH	`/api/v1/sales/orders/{order_id}/items/{item_id}`	update_item Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders`	create_sales_order Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/from-quote/{quote_id}`	create_from_quote Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/cancel`	cancel_sales_order Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/confirm`	confirm_sales_order Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/invoice`	invoice_sales_order Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/items`	add_item Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/mark-delivered`	mark_delivered Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/api/v1/sales/orders/{order_id}/start-delivery`	start_delivery Semantic binding: not_evaluated; mutation=True	`sales`
⚡ REST API	POST	`/portal/{slug}/bestellung`	order_submit Semantic binding: not_evaluated; mutation=True	`sales`
🖥️ WEB-UI	GET	`/quotes?status=dropship`	Sıralama filtreleri Satış pozisyonları ile süzülmüş teklifler	`quotes:read`
🖥️ WEB-UI	GET	`/purchasing#dropship`	Yol Ticaretleri Alışveriş Kendilerine özel alışveriş araçları, numaraları ve izleme araçları	`purchasing:read`
⚡ REST API	GET	`/api/v1/dropshipping`	Yolu pozisyonları API Satıncı ve kanıt verileri olan satılık pozisyonları	`quotes:read`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/assign-supplier`	Gönderilir Satın alma siparişini verir ve oluşturuyor	`purchasing:write`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/tracking`	İzlemeyi depol İzleme numarasını girin ve statusı in_transit olarak ayarlayın	`purchasing:write`
⚡ REST API	POST	`/api/v1/dropshipping/{id}/delivered`	Teslimat onay Satırlama durumu teslim edildi ve faturayı onayladı	`purchasing:write`

🛡️ Yönetim ve Uyum

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

UStG §25b (İçbirlik Üçgenlik İşleri)
Görevler (Görüntü sağlandıktan sonra faturalanma)

Bağlantı modüller: