💶

Nabídky, účty a dlužníci (financování)

finance sales_billing 🛡️ RLS Protected

Účtovný tok od konce do konce: výpočet, přijetí nabídek, přeměna projektů, stanovení účtů a připomínky.

Fachliche Bestimmung: Centrální centrum prodeje a fakturace. Nabídky jsou zaznamenávány, vypočítány a zasílány. Při přijetí se systém automaticky kaskaduje do projekt a stavebního příkazu a nákupu (stráce nebo BTO).

⚡ Pracovní toky a životní cykly (8) 🗄️ Data modely a pole (2) 🔌 Úvodní místa (UI a API) (52) 🛡️ Regulační a dodržovací

⚡ Pracovní toky a životní cykly

Kotožní k hotovosti `quote_to_cash_cascade`

Od nabídka až po přijetí, automatické konverze objednávek, částečné dodání až po závěrečný účet.

stateDiagram-v2 [*] --> DRAFT: Angebot anlegen DRAFT --> SENT: Versenden an Kunden SENT --> ACCEPTED: Kunde bestätigt Angebot ACCEPTED --> CONVERTED: convert_to_project() state CONVERTED { direction LR WorkOrder: Arbeitsauftrag Dropship: Streckenbestellung BTO: Einkaufslager } CONVERTED --> INVOICED: Rechnung erstellen (ZUGFeRD/DATEV) INVOICED --> PAID: Zahlungseingang (SEPA/Bank) PAID --> [*]

1. DRAFT

Návrh

Účetní jednotka (společnost)

Aktionen: Výpočet cen

2. SENT

Odesíláno

Generování PDF a zasílání zákazníkům e-mailem nebo portálem.

Aktionen: Kontrolní lhůta

3. ACCEPTED

Údaje

zákazník přijímá nabídka (online nebo v ERP).

Aktionen: provést konvertu_project

4. CONVERTED

Větrné

Automatické generování pracovních objednávek, objednávání nebo rezervace materiálů.

Aktionen: _GT4_0__ / _GT11_1__

5. INVOICED

Včetně

Výroba daňových předpisů vydaná faktura (PDF/A-3, ZUGFeRD).

Aktionen: Vytvořené účetní stablky pro DATEV

Použití: účetní agent `plan:command_billing_agent`

Kontrolovaný trvalý plán (durable_plan), start: manual_command.

1. billing_agent

billing_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: billing_agent

Použití: billing general agent `plan:command_billing_general_agent`

Kontrolovaný trvalý plán (durable_plan), start: manual_command.

1. billing_general_agent

billing_general_agent

Aktionen: billing_general_agent

Použití: agent pro odtělení `plan:command_dunning_agent`

Kontrolovaný trvalý plán (durable_plan), start: manual_command.

1. dunning_agent

dunning_agent

Aktionen: dunning_agent

Přesílání `plan:invoice_lifecycle`

Zkontrolovaný trvalý plán (durable_plan), start: domain_event.

1. payment_matching_agent

payment_matching_agent

Aktionen: payment_matching_agent

2. dunning_agent

dunning_agent

Aktionen: dunning_agent

Důležitá práce `status:extra_work`

Zobrazovací zařízení (only observable_only) - nepřeprava není nucená <unk> viz servisní validace.

1. detected

zjištěné

Status <unk>detected<unk> stavové stroje

2. accepted

přijatý

Status <unk> přijatý <unk> stavové stroje

3. rejected

Odmítnutí

Status <unk>opodmítnut<unk> stavové stroje

4. quoted

citované

Status <unk>citovaný <unk> stavové stroje

5. invoiced

Účetní dvůr

Status <unk>invoiced<unk> stavové stroje

Číslo č. `status:invoice`

Zobrazovací zařízení (only observable_only) - nepřeprava není nucená <unk> viz servisní validace.

1. draft

návrh

Status <unk>výloha <unk> stavové mašiny GT11_0__.

2. proforma

proforma

Status <unk>proforma<unk> stavové mašiny faktura.

3. issued

vydané

Status <unk>emissed<unk> stálého stroju faktura.

4. sent

posílá

Status <unk>sent<unk> stavu zařízení faktura.

5. partially_paid

partially_paid

Status <unk>partially_paid<unk> stavu strojů faktura.

6. paid

placené

Status <unk>platný<unk> stavového stroju faktura.

7. overdue

zpožděný

Status <unk>práva <unk> stálého stroju faktura.

8. cancelled

zrušen

Status <unk> zrušen<unk> stavové mašiny faktura.

Přenos peppolu `status:peppol_transmission`

Zobrazovací zařízení (only observable_only) - nepřeprava není nucená <unk> viz servisní validace.

1. draft

návrh

Status <unk>výloha <unk> stavové stroje Peppol

2. queued

v řadě

Status <unk>queued <unk> stavové stroje Peppol přenos.

3. transmitting

přenosu

Status <unk>prenos <unk> stavové stroje Peppol přenos.

4. delivered

přepravované

Status <unk>delivered<unk> stavové stroje Peppol

5. rejected

Odmítnutí

Status <unk>opodmítnut<unk> stavové stroje Peppol-transfer

6. failed

Neúspěšný

Status <unk>neúspěšný <unk> stavové stroje Peppol

🗄️ Data modely a pole

InvoiceItems invoice_items RLS Aktiv

34 Plochy / sloupci

Tabelle invoice_items

Feldname	Typ údajů	Povinnost	Schlüssel	Vědecké význam
`invoice_id`	`UUID`	Ja *	FK ➔ invoices.id	Feld invoice_id
`position`	`INTEGER`	Ja *	-	Feld position
`line_type`	`VARCHAR(48)`	Ja *	-	Feld line_type
`product_id`	`UUID`	Nein	FK ➔ products.id	Feld product_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`accounting_category_id`	`UUID`	Nein	FK ➔ accounting_categories.id	Feld accounting_category_id
`cost_type_id`	`UUID`	Nein	FK ➔ cost_types.id	Feld cost_type_id
`cost_center`	`VARCHAR(64)`	Nein	-	Feld cost_center
`cost_object`	`VARCHAR(64)`	Nein	-	Feld cost_object
`description`	`TEXT`	Ja *	-	Feld description
`quantity`	`NUMERIC(14, 4)`	Ja *	-	Feld quantity
`unit`	`VARCHAR(16)`	Ja *	-	Feld unit
`unit_price`	`NUMERIC(14, 2)`	Ja *	-	Feld unit_price
`discount_percent`	`NUMERIC(5, 2)`	Ja *	-	Feld discount_percent
`tax_rate`	`NUMERIC(6, 4)`	Ja *	-	Feld tax_rate
`tax_regime`	`VARCHAR(32)`	Ja *	-	Feld tax_regime
`purchase_price`	`NUMERIC(14, 2)`	Nein	-	Feld purchase_price
`margin_amount`	`NUMERIC(14, 2)`	Nein	-	Feld margin_amount
`margin_tax_amount`	`NUMERIC(14, 2)`	Nein	-	Feld margin_tax_amount
`net_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld net_amount
`tax_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld tax_amount
`gross_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld gross_amount
`source_work_log_id`	`UUID`	Nein	FK ➔ work_logs.id	Feld source_work_log_id
`source_expense_item_id`	`UUID`	Nein	FK ➔ expense_items.id	Feld source_expense_item_id
`tracking_entries`	`JSONB`	Ja *	-	Feld tracking_entries
`deducted_invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld deducted_invoice_id
`purchase_item_id`	`UUID`	Nein	FK ➔ purchase_items.id	Feld purchase_item_id
`source_invoice_item_id`	`UUID`	Nein	FK ➔ invoice_items.id	Feld source_invoice_item_id
`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
`metadata`	`JSONB`	Ja *	-	Feld metadata

Invoices invoices RLS Aktiv

65 Plochy / sloupci

Tabelle invoices

Feldname	Typ údajů	Povinnost	Schlüssel	Vědecké význam
`invoice_type`	`VARCHAR(48)`	Ja *	-	Feld invoice_type
`invoice_subtype`	`VARCHAR(48)`	Ja *	-	Feld invoice_subtype
`invoice_number`	`VARCHAR(64)`	Ja *	-	Feld invoice_number
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`bill_to_customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld bill_to_customer_id
`supplier_id`	`UUID`	Nein	FK ➔ suppliers.id	Feld supplier_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`accounting_category_id`	`UUID`	Nein	FK ➔ accounting_categories.id	Feld accounting_category_id
`cost_type_id`	`UUID`	Nein	FK ➔ cost_types.id	Feld cost_type_id
`cost_center`	`VARCHAR(64)`	Nein	-	Feld cost_center
`cost_object`	`VARCHAR(64)`	Nein	-	Feld cost_object
`original_invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld original_invoice_id
`quote_id`	`UUID`	Nein	FK ➔ quotes.id	Feld quote_id
`purchase_id`	`UUID`	Nein	FK ➔ purchases.id	Feld purchase_id
`goods_receipt_id`	`UUID`	Nein	FK ➔ goods_receipts.id	Feld goods_receipt_id
`contract_id`	`UUID`	Nein	-	Feld contract_id
`document_id`	`UUID`	Nein	FK ➔ documents.id	Feld document_id
`issue_date`	`DATE`	Nein	-	Feld issue_date
`due_date`	`DATE`	Nein	-	Feld due_date
`sent_at`	`DATETIME`	Nein	-	Feld sent_at
`payment_terms`	`VARCHAR(128)`	Nein	-	Feld payment_terms
`payment_term_code`	`VARCHAR(32)`	Nein	-	Feld payment_term_code
`notes`	`TEXT`	Nein	-	Feld notes
`reference`	`VARCHAR(128)`	Nein	-	Feld reference
`delivery_date`	`DATE`	Nein	-	Feld delivery_date
`currency`	`VARCHAR(3)`	Ja *	-	Feld currency
`subtotal`	`NUMERIC(14, 2)`	Ja *	-	Feld subtotal
`discount_total`	`NUMERIC(14, 2)`	Ja *	-	Feld discount_total
`net_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld net_amount
`tax_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld tax_amount
`gross_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld gross_amount
`paid_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld paid_amount
`residual_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld residual_amount
`skonto_days`	`INTEGER`	Nein	-	Feld skonto_days
`skonto_percent`	`NUMERIC(5, 2)`	Nein	-	Feld skonto_percent
`skonto_date`	`DATE`	Nein	-	Feld skonto_date
`skonto_amount`	`NUMERIC(14, 2)`	Nein	-	Feld skonto_amount
`tax_breakdown`	`JSONB`	Nein	-	Feld tax_breakdown
`tax_exemption_reason`	`VARCHAR(255)`	Nein	-	Feld tax_exemption_reason
`dunning_level`	`INTEGER`	Ja *	-	Feld dunning_level
`dunning_date`	`DATE`	Nein	-	Feld dunning_date
`dunning_fee`	`NUMERIC(14, 2)`	Ja *	-	Feld dunning_fee
`bank_name`	`VARCHAR(255)`	Nein	-	Feld bank_name
`iban`	`VARCHAR(50)`	Nein	-	Feld iban
`bic`	`VARCHAR(20)`	Nein	-	Feld bic
`billing_mode`	`VARCHAR(48)`	Ja *	-	Feld billing_mode
`cumulative_sequence`	`INTEGER`	Nein	-	Feld cumulative_sequence
`previous_invoices_net`	`NUMERIC(14, 2)`	Ja *	-	Feld previous_invoices_net
`total_performance_net`	`NUMERIC(14, 2)`	Ja *	-	Feld total_performance_net
`retention_rate`	`NUMERIC(5, 2)`	Ja *	-	Feld retention_rate
`retention_amount`	`NUMERIC(14, 2)`	Ja *	-	Feld retention_amount
`measurement_id`	`UUID`	Nein	FK ➔ project_measurements.id	Feld measurement_id
`status`	`VARCHAR(48)`	Ja *	-	Feld status
`external_accounting_id`	`VARCHAR(128)`	Nein	-	Feld external_accounting_id
`idempotency_key`	`VARCHAR(128)`	Nein	-	Feld idempotency_key
`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/invoices/{invoice_id}`	delete_invoice Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	DELETE	`/api/v1/invoices/{invoice_id}/items/{item_id:uuid}`	delete_invoice_item Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	DELETE	`/api/v1/pricelists/{pricelist_id}/items/{item_id}`	delete_item Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	GET	`/api/v1/invoices`	list_invoices Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}`	get_invoice Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}/credit-remaining`	get_credit_remaining Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}/delivery-note.pdf`	get_invoice_delivery_note Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}/html`	get_invoice_html Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}/payments`	list_invoice_payments Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}/pdf`	get_invoice_pdf Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/invoices/{invoice_id}/zugferd-xml`	get_zugferd_xml Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/peppol/invoices/{invoice_id}/ubl`	get_invoice_peppol_ubl Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/peppol/lookup`	lookup_peppol_recipient Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/peppol/schemes`	list_peppol_schemes Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/peppol/transmissions`	list_peppol_transmissions Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/peppol/transmissions/{transmission_id}`	get_peppol_transmission Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/pricelists`	list_pricelists Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/pricelists/{pricelist_id}/items`	list_items Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/api/v1/pricelists/{pricelist_id}/resolve`	resolve_price Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/invoices`	invoices_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/invoices/new`	invoice_create_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/invoices/{invoice_id}`	invoice_detail_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/portal/{slug}/rechnungen`	invoices_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/portal/{slug}/rechnungen/{invoice_id}/pdf`	invoice_pdf_download Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/pricelists`	pricelists_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/pricelists/new`	pricelists_new_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	GET	`/pricelists/{pricelist_id}/edit`	pricelists_edit_page Semantic binding: inventory_only; mutation=False	`invoices`
⚡ REST API	PATCH	`/api/v1/invoices/{invoice_id}`	update_invoice Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	PATCH	`/api/v1/invoices/{invoice_id}/items/reorder`	reorder_invoice_items Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	PATCH	`/api/v1/invoices/{invoice_id}/items/{item_id:uuid}`	update_invoice_item Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	PATCH	`/api/v1/pricelists/{pricelist_id}`	update_pricelist Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices`	create_invoice Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/collective-credit-note`	create_collective_credit_note Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/final-from-partials`	create_final_invoice_from_partials Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/from-work-order/{work_order_id}`	create_invoice_from_work_order Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/convert-final`	convert_to_final_invoice Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/convert-proforma`	convert_to_proforma Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/credit-note`	create_credit_note Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/dunning`	escalate_invoice_dunning Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/escalate-ticket`	escalate_invoice_to_ticket Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/issue`	issue_invoice Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/items`	add_invoice_item Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/partial-credit-note`	create_partial_credit_note Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/payments`	register_invoice_payment Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/send`	send_invoice Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/invoices/{invoice_id}/stock-issue`	create_invoice_stock_issue Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/peppol/invoices/{invoice_id}/transmit`	transmit_invoice_via_peppol Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/pricelists`	create_pricelist Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/api/v1/pricelists/{pricelist_id}/items`	add_item Semantic binding: operator_surface; mutation=True	`invoices`
⚡ REST API	POST	`/portal/{slug}/rechnungen/{invoice_id}/gutschrift-anfordern`	credit_note_request Semantic binding: operator_surface; mutation=True	`invoices`
🖥️ WEB-UI	GET	`/quotes`	Přehled nabídky Seznam všech nabídek s statusovým filtrem a značkou	`quotes:read`
⚡ REST API	POST	`/api/v1/quotes/{id}/convert-to-workorder`	Úprava Kaskadiální přijaté nabídka v projekt & WorkOrder	`quotes:write`

🛡️ Regulační a dodržovací

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

GoBD (Fortlaufende Nummerierung, Unveränderbarkeit)
UStG § 14 (příslušné údaje o účtech)
ZUGFeRD 2.2 / XRechnung (PEPPOL)

Vkládání:

➔ dropship ➔ customers ➔ workorders ➔ purchasing ➔ accounting

Nabídky, účty a dlužníci (financování)

⚡ Pracovní toky a životní cykly

Kotožní k hotovosti quote_to_cash_cascade

Použití: účetní agent plan:command_billing_agent

Použití: billing general agent plan:command_billing_general_agent

Použití: agent pro odtělení plan:command_dunning_agent

Přesílání plan:invoice_lifecycle

Důležitá práce status:extra_work

Číslo č. status:invoice

Přenos peppolu status:peppol_transmission

🗄️ Data modely a pole

🔌 Úvodní místa (UI a API)

🛡️ Regulační a dodržovací

Kotožní k hotovosti `quote_to_cash_cascade`

Použití: účetní agent `plan:command_billing_agent`

Použití: billing general agent `plan:command_billing_general_agent`

Použití: agent pro odtělení `plan:command_dunning_agent`

Přesílání `plan:invoice_lifecycle`

Důležitá práce `status:extra_work`

Číslo č. `status:invoice`

Přenos peppolu `status:peppol_transmission`