Centurio Rendszer- & moduldokumentáció
🏛️ Platform-architektúra 🔑 Login
🏠 Minden modul / sales_billing / A hajók és a hajók közötti kereskedelem
🚚

A hajók és a hajók közötti kereskedelem

dropship sales_billing 🛡️ RLS Protected

A szállító által a végső ügyfeleknek történő közvetlen szállítása, a szállító által a PO-generáció és a számlázás kiadásának zárása.

Fachliche Bestimmung: A "Triangle" és "Route" üzletágok a vásárlás és az eladás során is átfogóan alakultak ki. A "Route" pozíciókkal rendelkező ajánlat elfogadása esetén automatikusan vásárlási rendelést generál a beszállítótól a vásárló szállítási címével.

⚡ Munkaforgalmak és életciklusok

A következők: dropship_lifecycle

A forgalmi és logisztikai folyamat a forgalmi forgalom között nem tartós tárolás nélkül.

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
Ruterekódás
a resolve_route a termékkategóriára vagy a pozíció túllépésre vonatkozóan meghatározza a járatüzemeltetést.
Aktionen: A raktártermelés túlmenni
2. PURCHASE_ORDER
Megrendelési generáció
A DropshipService beszállító szerint állásokat egyesít és PO-t termel a procurement_type='dropship'.
Aktionen: Az átviteli cím = ügyfélcím
3. TRACKING
A szállítási felügyelet
beszállító jelentse a nyomkövetési számot és a szállítási szolgáltatót.
Aktionen: A "in_transit" állapot
4. DELIVERY_CONFIRM
Szállítmány
A szállítás ügyfélszemélyhez (POD) történő megerősítése.
Aktionen: "Adott" állapot
5. BILLING_RELEASE
Számlázási számlák
A billing_released True-ra áll; a ügyfélszámlákat felszabadítják.
Aktionen: kimenő számla

Kundenauftrag → Abwicklung cascade:business.customer_order.fulfill

Kaskade (értékelés_kapcsolt).

1. order
Verkaufsauftrag anlegen / bestätigen
sales
Aktionen: sales.create
2. issue
A termék kiállításának tervezett könyvelése
Inventárium
Aktionen: - A "Stock.issue.create"
3. tour
A szállítási utazás tervezése
logisztika
Aktionen: create_tour
4. project
projekt / költségállomány
projektek
Aktionen: link_project
5. task
megrendelés kivitelezése / számítástechnikai
feladatok
Aktionen: create_task

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

Kaskade (értékelés_kapcsolt).

1. cascade
Verkaufsauftrag anlegen / bestätigen

Benutzerbefehl: sales order agent plan:command_sales_order_agent

Megvizsgált tartós terv (durable_plan), kezdő: manuál_kommand.

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

🗄️ Adatmodellek & Felder

DropshipLines dropship_lines RLS Aktiv
37 Felt / oszlop

Tabelle dropship_lines

Feldname Adattípus Kötelesség Schlüssel Szakmai jelentés
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 Felt / oszlop

Tabelle sales_agents

Feldname Adattípus Kötelesség Schlüssel Szakmai jelentés
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

🔌 A kezdő pontok (UI és API)

Art A módszer Végpont / út Titel & Zweck A jogosultság
⚡ 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
A szűrőcsatornák
A pályázati pozíciók szűrése
quotes:read
🖥️ WEB-UI GET /purchasing#dropship
Átjárási vásárlás
A következőket kell alkalmazni:
purchasing:read
⚡ REST API GET /api/v1/dropshipping
A következő szöveg lép:
Szállítóállományi pozíciók, amelyek a szállító- és igazolási adatokkal rendelkeznek
quotes:read
⚡ REST API POST /api/v1/dropshipping/{id}/assign-supplier
A Bizottság
Megjegyzés:
purchasing:write
⚡ REST API POST /api/v1/dropshipping/{id}/tracking
A nyomkövetés
Beállítja a nyomon követési számot és a statusot a in_transit-re
purchasing:write
⚡ REST API POST /api/v1/dropshipping/{id}/delivered
Az átadást megerősíteni
Beadott állapotot állít és számlázási engedélyt ad
purchasing:write

🛡️ A szabályozás és a megfelelés

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • UStG §25b (A közösségi belső háromszöges ügyletek)
  • A következők:
Összefüggött modulok:
➔ finance ➔ purchasing ➔ catalog ➔ customers ➔ suppliers