Centurio Systémová a modulová dokumentácia
🔍
🏛️ Architektúra platformy
🇩🇪 Deutsch 🇬🇧 English 🇫🇷 Français 🇪🇸 Español 🇮🇹 Italiano 🇳🇱 Nederlands 🇵🇱 Polski 🇵🇹 Português 🇨🇿 Čeština 🇸🇰 Slovenčina 🇭🇺 Magyar 🇷🇴 Română 🇧🇬 Български 🇬🇷 Ελληνικά 🇩🇰 Dansk 🇫🇮 Suomi 🇸🇪 Svenska 🇱🇹 Lietuvių 🇱🇻 Latviešu 🇪🇪 Eesti 🇭🇷 Hrvatski 🇸🇮 Slovenščina 🇲🇹 Malti 🇮🇪 Gaeilge 🇷🇺 Русский 🇺🇦 Українська 🇹🇷 Türkçe 🇳🇴 Norsk bokmål 🇷🇸 Српски 🇮🇸 Íslenska 🇨🇭 Schwiiz/Suisse
🔑 Login
🏠 Všetky moduly / sales_billing / Trhové obchodovanie (dropshipping)
🚚

Trhové obchodovanie (dropshipping)

dropship sales_billing 🛡️ RLS Protected

Priame dodávky od dodávateľa k konečným zákazníkom, generácia PO dodávateľov a blokovanie na vyúčtovanie.

Fachliche Bestimmung: V prípade, že sa ponuka s ponukou na ponuku na ponuku na ponuku na ponuku na ponuku, sa automaticky vytvorí nákupná objednávka od dodávateľa s adresou dodávky zákazníka.
⚡ Pracovné postupy a životné cykly (4) 🗄️ Modely údajov & Felder (2) 🔌 Úvodné body (UI & API) (24) 🛡️ Regulatory & Compliance

⚡ Pracovné postupy a životné cykly

Výroba z dĺžky a výroba z dĺžky dropship_lifecycle

Obchodné a logistické prevádzky letových obchodov bez medzičasového skladovania.

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
Identifikácia trasy
resolve_route určuje obchodovanie na trasách na základe kategórie výrobkov alebo prekrývajúcich pozícií.
Aktionen: Prejsť k prechodnému rozlozu
2. PURCHASE_ORDER
Generácia objednávok
DropshipService spája pozície podľa dodávateľ a vytvára PO s procurement_type='dropship'.
Aktionen: Poskytovateľná adresa = adresa zákazníka
3. TRACKING
Prevádzkovateľ
dodávateľ oznámi sledovaci číslo a odosielateľa.
Aktionen: Status "in_transit"
4. DELIVERY_CONFIRM
Poskytovanie
Potvrdenie doručenia zákazníkovi (POD).
Aktionen: Status "dosiahol"
5. BILLING_RELEASE
Údaje o faktúre
billing_released sa nastaví na True; zákaznícky účet sa uvoľní.
Aktionen: vydaná faktúra

Kundenauftrag → Abwicklung cascade:business.customer_order.fulfill

Kaskade (review_gated).

1. order
Verkaufsauftrag anlegen / bestätigen
sales
Aktionen: sales.create
2. issue
Návrh výstupov
inventár
Aktionen: stock.issue.create
3. tour
Plánovanie výstupov
logistika
Aktionen: create_tour
4. project
projekt / prideľovanie nákladov
projekty
Aktionen: link_project
5. task
objednávka vykonať / vypočítať
úlohy
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), začiatok: 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

🗄️ Modely údajov & Felder

DropshipLines dropship_lines RLS Aktiv
37 Poľy / stĺpce

Tabelle dropship_lines

Feldname Typ údajov Povinnosť Schlüssel Využitie
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 Poľy / stĺpce

Tabelle sales_agents

Feldname Typ údajov Povinnosť Schlüssel Využitie
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é body (UI & API)

Art Metód Koniec / cesta Titel & Zweck Uprava
⚡ 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
Ponuky na filtrovanie
Filtrovanie ponuky s pozíciami v oblasti trhového obchodu
 quotes:read
🖥️ WEB-UI GET /purchasing#dropship
V prípade potreby:
V prípade potreby sa použije aj technická pomoc na účely tohto článku.
 purchasing:read
⚡ REST API GET /api/v1/dropshipping
Pôvodné položky
Poskytovanie pozícií v rámci trhového obchodu s údajmi o dodávateľoch a dôkazov
 quotes:read
⚡ REST API POST /api/v1/dropshipping/{id}/assign-supplier
_GT9_0__
Počíta sa k dodávateľ a vytvára nákupné objednávky
 purchasing:write
⚡ REST API POST /api/v1/dropshipping/{id}/tracking
Zloženie sledovania
Vloženie čísla sledovania a nastavenie stavu na in_transit
 purchasing:write
⚡ REST API POST /api/v1/dropshipping/{id}/delivered
Potvrdenie doručenia
Zodpovedá na doručenie a vydá vyúčtovanie
 purchasing:write

🛡️ Regulatory & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • UStG §25b (Vnútornom spoločenskom triangovom obchode)
  • GoBD (Fakturovanie po poskytnutí služby)
Vymedzené moduly:
➔ finance ➔ purchasing ➔ catalog ➔ customers ➔ suppliers