Centurio Systémová a modulová dokumentácia
🏛️ Architektúra platformy 🔑 Login
🏠 Všetky moduly / supply_chain / Nákup a objednávky
🛒

Nákup a objednávky

purchasing supply_chain 🛡️ RLS Protected

Objednávky dodávateľov, žiadosti o ceny (RFQ), zaznamenávanie príjmu tovaru a trojstranná vyrovnávacia sa.

Fachliche Bestimmung: Ovláda celý nákupný proces. Vytvára objednávky z buy-to-order požiadaviek, obchodov na trati alebo minimálnych zásob. Podporuje záložky vstupov tovaru prostredníctvom prevodu LVS a automatizuje trojstupňové vyrovnanie (objednávka <unk> vstup tovaru <unk> prjatá faktúra).

⚡ Pracovné postupy a životné cykly

Základné náklady na spotreby procure_to_pay_lifecycle

Od požiadavky na potreby až po objednávku dodávateľa až po vstup tovaru.

graph LR A[Bedarfsanforderung / BTO] --> B[Bestellung an Lieferant] B --> C[Wareneingang & Prüfung] C --> D[LVS-Lagerzubuchung] D --> E[3-Wege-Rechnungsprüfung]
1. RFQ
Požiadavky na ceny
Žiadosť od jedného alebo viacerých dodávateľov.
Aktionen: Porovnávanie ponúk
2. ORDER
Objednávanie
Vypustiť záväznú objednávku.
Aktionen: Generovať PO-dokumenty
3. RECEIPT
Vstup tovaru
Získať nálezy tovar a overiť množstvo/kvalitnosť.
Aktionen: Vytvorenie zásob LVS
4. INVOICE_MATCH
Účtovná vyrovnávacia
3 - cesta vyrovnanie proti účtu na nákup.
Aktionen: Uvolnenie na platbu

Prešetrovanie potvrdenia objednávky cascade:business.order_confirmation.check

Kaskade (review_gated).

1. match
AB <unk> porovnávanie objednávok
nákup
Aktionen: order_confirmation.match
2. project
projekt / prideľovanie nákladov
projekty
Aktionen: link_project
3. task
Doba dodania / monitorovanie cien
úlohy
Aktionen: create_task

Potvrdenie objednávky <unk> porovnanie objednávky cascade_target:business.order_confirmation.match

Kaskade (review_gated).

1. cascade
Potvrdenie objednávky <unk> porovnanie objednávky

Použitie: agent pre odber tovaru plan:command_goods_receipt_agent

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. goods_receipt_agent
goods_receipt_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "goods_receipt_agent", "condition_fact": null}
Aktionen: goods_receipt_agent

Použitie: koordinátor obstarávania plan:command_procurement_coordinator_agent

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. procurement_coordinator_agent
procurement_coordinator_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "procurement_coordinator_agent", "condition_fact": null}
Aktionen: procurement_coordinator_agent

Použitie: funkcia agent plan:command_procurement_rule_function_agent

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. procurement_rule_function_agent
procurement_rule_function_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "procurement_rule_function_agent", "condition_fact": null}
Aktionen: procurement_rule_function_agent

Používateľské príkazy: agent pre verejnú obstarávanie plan:command_procurement_run_function_agent

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. procurement_run_function_agent
procurement_run_function_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "procurement_run_function_agent", "condition_fact": null}
Aktionen: procurement_run_function_agent

Použitie: nákupný agent plan:command_purchase_agent

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. purchase_agent
purchase_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "purchase_agent", "condition_fact": null}
Aktionen: purchase_agent

Použitie: trojstranný agent plan:command_three_way_match_agent

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. three_way_match_agent
three_way_match_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "three_way_match_agent", "condition_fact": null}
Aktionen: three_way_match_agent

Vstupné položky plan:goods_receipt_followup

Zkontrolovaný trvalý plán (durable_plan), začiatok: domain_event.

1. three_way_match_agent
three_way_match_agent
{"key": "step_0", "label": "Bestellung, Wareneingang und Rechnung abgleichen", "adapter": "agent.execute", "agent": "three_way_match_agent", "condition_fact": null}
Aktionen: three_way_match_agent

Vypúšťanie status:dropship_line

Pozorovateľné stave (only observable_only).

1. needs_supplier
needs_supplier
Status <unk>needs_supplier<unk> stavu strojovej dropshipu.
2. requested
požadované
Status <unk>nažiadaný <unk> stavového strojového letiska.
3. ordered
Objednané
Status <unk>ordered<unk> stavového strojového dropu.
4. confirmed
potvrdené
Status <unk>potvrdený <unk> stav strojovej dropky.
5. shipped
Vyplatené
Status <unk>shipped<unk> stavového strojového dropu.
6. delivered
dodané
Status <unk>delivered<unk> stavového strojového dropu.
7. issue
Vydanie
Status <unk>vytvorenie <unk>vytvorenia
8. cancelled
zrušené
Status <unk> zrušený <unk> stavový stroj dropship.

Vstup tovaru status:goods_receipt

Pozorovateľné stave (only observable_only).

1. draft
návrh
Status <unk>výpis <unk> stavového stroja vstup tovaru.
2. posted
Vydané
Status <unk>posted<unk> stavového stroja vstup tovaru.
3. cancelled
zrušené
Status <unk> zrušený<unk> stavového zariadenia vstup tovaru.

Objednávanie status:purchase

Pozorovateľné stave (only observable_only).

1. draft
návrh
Status <unk>výpis <unk> objednávky strojov v stave.
2. sent
posielať
Status <unk>sending <unk> stavového stroja objednávky.
3. partially_received
partially_received
Status <unk>partially_received<unk> objednávky strojovej stavby.
4. received
prijaté
Status <unk>obdržaný <unk> objednávky strojovej stavby.
5. cancelled
zrušené
Status <unk> zrušený<unk> objednávky strojovej stavby.

Objednaná požiadavka status:purchase_requisition

Pozorovateľné stave (only observable_only).

1. draft
návrh
Status <unk>výpis <unk> stavové zariadenie objednávka.
2. submitted
Predložené
Status <unk>podaný <unk> stavové zariadenie
3. approved
schválené
Status <unk>opísaný <unk> stavové zariadenie
4. rejected
Odmietnuté
Status <unk>odmietaný<unk> stavové strojové požiadavky na objednávku.
5. ordered
Objednané
Status <unk>ordered<unk> stavového stroja
6. cancelled
zrušené
Status <unk> zrušený <unk> stavové zariadenie

Požiadavky na ceny status:purchase_rfq

Pozorovateľné stave (only observable_only).

1. draft
návrh
Status <unk>výpis <unk>prehľad ceny stavebného stroja.
2. sent
posielať
Status <unk>sent<unk> stavového stroja
3. partially_quoted
partially_quoted
Status <unk>partially_quoted<unk> z stavebného stroja
4. quoted
citované
Status <unk>quoted<unk> z stavebného stroja
5. ordered
Objednané
Status <unk>ordered<unk> stavového stroja
6. cancelled
zrušené
Status <unk> zrušený <unk> stavového stroja

Vývoz status:supplier_quote

Pozorovateľné stave (only observable_only).

1. draft
návrh
Status <unk>výpis <unk> stavového stroja
2. received
prijaté
Status <unk>prijímal <unk> stavový stroj dodávateľská ponuka.
3. accepted
prijaté
Status <unk>Accepted<unk> stavového stroja
4. rejected
Odmietnuté
Status <unk>opodmietaný <unk> stavového stroja

🗄️ Modely údajov & Felder

ProcurementNeeds procurement_needs RLS Aktiv
24 Poľy / stĺpce

Tabelle procurement_needs

Feldname Typ údajov Povinnosť Schlüssel Využitie
run_id UUID Ja * FK ➔ procurement_runs.id Feld run_id
rule_id UUID Ja * FK ➔ reordering_rules.id Feld rule_id
product_id UUID Ja * FK ➔ products.id Feld product_id
location_id UUID Nein FK ➔ locations.id Feld location_id
supplier_info_id UUID Nein FK ➔ product_supplierinfo.id Feld supplier_info_id
physical_quantity NUMERIC(14, 4) Ja * - Feld physical_quantity
reserved_quantity NUMERIC(14, 4) Ja * - Feld reserved_quantity
incoming_quantity NUMERIC(14, 4) Ja * - Feld incoming_quantity
forecast_quantity NUMERIC(14, 4) Ja * - Feld forecast_quantity
requested_quantity NUMERIC(14, 4) Ja * - Feld requested_quantity
ordered_quantity NUMERIC(14, 4) Ja * - Feld ordered_quantity
status VARCHAR(48) Ja * - Feld status
purchase_id UUID Nein FK ➔ purchases.id Feld purchase_id
purchase_item_id UUID Nein FK ➔ purchase_items.id Feld purchase_item_id
explanation TEXT Ja * - Feld explanation
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
ProcurementRuns procurement_runs RLS Aktiv
16 Poľy / stĺpce

Tabelle procurement_runs

Feldname Typ údajov Povinnosť Schlüssel Využitie
status VARCHAR(48) Ja * - Feld status
trigger VARCHAR(32) Ja * - Feld trigger
started_at DATETIME Ja * - Feld started_at
finished_at DATETIME Nein - Feld finished_at
idempotency_key VARCHAR(128) Nein - Feld idempotency_key
summary JSONB Ja * - Feld summary
error_message TEXT Nein - Feld error_message
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/purchasing/procurement/rules/{rule_id}
delete_reordering_rule
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API GET /api/v1/dropshipping
list_lines
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/dropshipping/meta
meta
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/goods-receipts
list_receipts
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/goods-receipts/{receipt_id}
get_receipt
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/goods-receipts/{receipt_id}/labels.pdf
goods_receipt_labels_pdf
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/goods-receipts/{receipt_id}/landed-costs
list_landed_costs
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/procurement/rules
list_reordering_rules
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/procurement/runs
list_procurement_runs
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/procurement/runs/{run_id}/needs
list_procurement_needs
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/purchases
list_purchases
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/purchases/open
list_open_purchases
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/purchases/{purchase_id}
get_purchase
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/purchases/{purchase_id}/matching
get_purchase_matching
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/purchases/{purchase_id}/pdf
get_purchase_pdf
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/reports/supplier-scorecard
supplier_scorecard_report
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/requisitions
list_purchase_requisitions
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/requisitions/{requisition_id}
get_purchase_requisition
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/rfqs
list_rfqs
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/rfqs/{rfq_id}
get_rfq
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/rfqs/{rfq_id}/compare
compare_rfq_quotes
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/settings
get_purchasing_settings
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/supplier-portal/purchases
list_purchases
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /api/v1/purchasing/supplier-portal/rfqs
list_rfqs
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /dropshipping
dropshipping_page
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing
purchasing_page
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/new
purchase_create_page
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/orders/{purchase_id}
purchase_order_detail_page
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/receipts/{receipt_id}
goods_receipt_detail_page
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/tab/procurement
purchasing_tab_procurement
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/tab/purchases
purchasing_tab_purchases
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/tab/receipts
purchasing_tab_receipts
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/{purchase_id}
purchase_order_detail_page
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API GET /purchasing/{purchase_id}/pdf
purchase_order_pdf_view
Semantic binding: inventory_only; mutation=False
purchasing
⚡ REST API PATCH /api/v1/purchasing/goods-receipts/{receipt_id}
update_receipt_draft
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API PATCH /api/v1/purchasing/goods-receipts/{receipt_id}/items/{item_id}/tracking
update_receipt_item_tracking
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API PATCH /api/v1/purchasing/procurement/rules/{rule_id}
update_reordering_rule
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/quotes/{quote_id}/create
create_for_quote
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/{line_id}/cancel
zrušiť
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/{line_id}/delivered
dodané
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/{line_id}/issue
Vydanie
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/{line_id}/release-billing
release_billing
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/{line_id}/supplier
assign_supplier
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/dropshipping/{line_id}/tracking
sledovanie
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/goods-receipts
create_receipt
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/goods-receipts/{receipt_id}/landed-costs
create_landed_cost
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/goods-receipts/{receipt_id}/post
post_receipt
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/goods-receipts/{receipt_id}/print-labels
print_goods_receipt_labels
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/procurement/rules
create_reordering_rule
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/procurement/run
run_procurement
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases
create_purchase
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/approve
approve_purchase
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/confirm-supplier
confirm_purchase_supplier
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/items
add_item_to_purchase
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/receive
quick_receive_purchase
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/send
send_purchase
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/send-email
send_purchase_email
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/purchases/{purchase_id}/tax-context
confirm_purchase_tax_context
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/requisitions
create_purchase_requisition
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/requisitions/{requisition_id}/approve
approve_purchase_requisition
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/requisitions/{requisition_id}/convert-to-purchase
convert_purchase_requisition
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/requisitions/{requisition_id}/reject
reject_purchase_requisition
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/requisitions/{requisition_id}/submit
submit_purchase_requisition
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/rfqs
create_rfq
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/rfqs/{rfq_id}/quotes
record_supplier_quote
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/rfqs/{rfq_id}/quotes/{quote_id}/purchase
create_purchase_from_quote
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/rfqs/{rfq_id}/suppliers
add_rfq_supplier
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/supplier-portal/invoices
upload_invoice
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/supplier-portal/rfqs/{rfq_id}/respond
respond_rfq
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing/supplier-portal/suppliers/{supplier_id}/access-token
issue_access_token
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /purchasing/settings/grouping
web_update_purchasing_grouping
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API PUT /api/v1/purchasing/settings
update_purchasing_settings
Semantic binding: operator_surface; mutation=True
purchasing
⚡ REST API POST /api/v1/purchasing
Objednávanie
Vytvára nové objednávky
purchasing:write

🛡️ Regulatory & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • Prehľadateľnosť
  • HGB § 377 (odvolanie pri príjme tovaru)
Vymedzené moduly:
➔ suppliers ➔ inventory ➔ dropship ➔ crossdock