Centurio Systémová a modulová dokumentace
🏛️ Architektura platformy 🔑 Login
🏠 Všechny moduly / sales_billing / Prodej a zákazní objednávky
🛒

Prodej a zákazní objednávky

sales sales_billing 🛡️ RLS Protected

Obchodní obchodní nákupy: nabídka převzatí, potvrzení, dodávky, fakturace - bez zákaznického/pracního spojení.

Fachliche Bestimmung: Modul pro prodej pro obchodní a obchodní blízké klienty. Technicky implementován na společné zakázkové síti (order_type='sale'), vědomě oddělený od kontextu služeb v oblasti prodeje: žádné zásoby, žádné montážní řádky, žádné místo provádění. Místo toho je návrh prodejního potrubí Odoo -> Potvrzen -> V dodávce -> V dodávce -> Vypravený -> Fakturovaný s odkazem, podmínkami platby, účtem, termínem dodání a

⚡ Pracovní toky a životní cykly

Plynové řízení (kvota do hotovosti) sales_order_pipeline

Od nabídka nebo od přímého zařízení o potvrzení a dodání do faktura.

stateDiagram-v2 [*] --> DRAFT: Anlegen / aus Angebot DRAFT --> CONFIRMED: Bestätigen CONFIRMED --> IN_DELIVERY: Lieferung starten IN_DELIVERY --> DELIVERED: Als geliefert markieren DELIVERED --> INVOICED: Rechnung erstellen DRAFT --> CANCELLED: Stornieren
1. DRAFT
Návrh
zakázka se zřídí nebo převede z nabídka (idempotent).
Aktionen: Postupní, Ustanovení podmínek pro platbu
2. CONFIRMED
Potvrzené
zakázka potvrzen (plánovaný), lhůta dodání závazná.
Aktionen: Začít dodávky
3. IN_DELIVERY
V dodávce
zboží se v provozu/souhlasí (sklad integrace).
Aktionen: Označení jako dodané
4. DELIVERED
Vydané
V případě výběrů "doručené" fakturační základna.
Aktionen: _GT11_0__
5. INVOICED
Včetně
Návrh účtu z zakázka (regular, záloha, celkové účetní závěrky).

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í

Standard GoBD- und DSGVO-Regelwerk.

Vkládání:
➔ quotes ➔ invoices ➔ customers ➔ inventory ➔ products ➔ contracts