↩️

Wyrzuty i reklamacje

returns supply_chain 🛡️ RLS Protected

Zarządzanie zwrotami dla klientów i dostawców, kontrola jakości, składowanie i ustalenie kredytów.

Fachliche Bestimmung: W przypadku gdy w przypadku wprowadzania w obrębie przedsiębiorstwa lub przedsiębiorstwa w ramach systemu RMA, w przypadku wprowadzania w obrębie przedsiębiorstwa w ramach systemu RMA, w przypadku wprowadzania w obrębie przedsiębiorstwa w ramach systemu RMA, w przypadku wprowadzania w obrębie przedsiębiorstwa w ramach systemu RMA, w przypadku wprowadzania w obrębie przedsiębiorstwa w ramach systemu RMA, w przypadku gdy w obrębie przedsiębiorstwa wprowadzone w obrębie przedsiębiorstwa w obrębie przedsiębiorstwa w obrębie przedsiębiorstwa w obrębie przedsiębiorstwa

⚡ Przepływy pracy i cykle życia (3) 🗄️ Modele danych (5) 🔌 Punkty wyjścia (UI & API) (40) 🛡️ Regulatoryzacja i zgodność

⚡ Przepływy pracy i cykle życia

W przypadku wprowadzania w życie decyzji o przyznaniu `rma_workflow`

Od wpisu zwrotu, do kontroli technicznej, do kredytu.

stateDiagram-v2 [*] --> REGISTER: RMA anlegen REGISTER --> RECEIVE: Ware trifft ein RECEIVE --> INSPECT: Qualitätsprüfung INSPECT --> RESTOCK: Ware einwandfrei -> Lagerzubuchung INSPECT --> SCRAP: Defekt -> Schrottbuchung RESTOCK --> SETTLE: Gutschrift auslösen SCRAP --> SETTLE: Kulanz- / Garantiegutschrift SETTLE --> [*]

1. REGISTER

Wniosek o zwrot

klient lub służba wewnętrzna zgłasza wysyłkę z powodem.

Aktionen: Numer RMA

2. RECEIVE

Wprowadzenie i identyfikacja

Pakiet trafi w magazyn, skan kodu barkowego RMA.

Aktionen: Wykonanie zlecenia

3. INSPECT

Sprawdzanie stanu

Przesyłanie: nowość, użyte, potrzebne do naprawy lub śmieci.

Aktionen: Dokumentacja wyników badania

4. SETTLE

Wyrządzanie

Wpływ w dół lub składane w dół, wywołanie kredytu.

Aktionen: Wytwarzanie kredytów

Benutzerbefehl: returns agent `plan:command_returns_agent`

Sprawdzony plan trwały (durable_plan), start: manual_command.

1. returns_agent

returns_agent

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

Aktionen: returns_agent

Wraca `status:return_order`

W przypadku, gdy urządzenie jest w stanie obserwowanym (only observable_only), nie ma konieczności dokonywania przechodów.

1. draft

wdrażanie

Status <unk>draft <unk> statystycznej maszyny powrotu.

2. requested

wymagane

Status <unk>został wymagany <unk> powrotu maszyny do stanu.

3. approved

zatwierdzone

Status <unk> zatwierdzony <unk> statystycznej maszyny powrotu.

4. rejected

Odmowa

Status <unk> odrzucony <unk> powrót maszyny do stanu.

5. in_transit

in_transit

Status <unk>in_transit<unk> maszynę powrotu do stanu.

6. part_received

part_received

Status <unk>part_received<unk> zwrotu maszyny stanu.

7. received

otrzymane

Status <unk> otrzymał <unk> statystycznej maszyny powrotu.

8. inspected

wprowadzone do kontroli

Status «inspected» der Zustandsmaschine Retoure.

9. resolved

wprowadzone

Status <unk>resolved<unk> statystycznej maszyny powrotu.

10. closed

zamknięte

Status <unk>z zamknięty <unk> powrotu maszyny do stanu.

11. cancelled

odwołane

Status <unk>anulowany <unk> powrót maszyny do stanu.

🗄️ Modele danych

ReturnLines return_lines RLS Aktiv

30 Wyroby

Tabelle return_lines

Feldname	Typ danych	Wymóg	Schlüssel	Znaczenie specjalne
`return_id`	`UUID`	Ja *	FK ➔ return_orders.id	Feld return_id
`position`	`INTEGER`	Ja *	-	Feld position
`stock_owner`	`VARCHAR(16)`	Ja *	-	Feld stock_owner
`product_id`	`UUID`	Nein	FK ➔ products.id	Feld product_id
`stored_article_id`	`UUID`	Nein	FK ➔ stored_articles.id	Feld stored_article_id
`asset_id`	`UUID`	Nein	FK ➔ assets.id	Feld asset_id
`invoice_item_id`	`UUID`	Nein	FK ➔ invoice_items.id	Feld invoice_item_id
`description`	`VARCHAR(255)`	Ja *	-	Feld description
`unit`	`VARCHAR(32)`	Ja *	-	Feld unit
`unit_price`	`NUMERIC(14, 2)`	Nein	-	Feld unit_price
`tax_rate`	`NUMERIC(6, 3)`	Nein	-	Feld tax_rate
`quantity_requested`	`NUMERIC(14, 4)`	Ja *	-	Feld quantity_requested
`quantity_received`	`NUMERIC(14, 4)`	Ja *	-	Feld quantity_received
`quantity_accepted`	`NUMERIC(14, 4)`	Ja *	-	Feld quantity_accepted
`from_location_id`	`UUID`	Nein	FK ➔ locations.id	Feld from_location_id
`tracking_codes`	`JSONB`	Ja *	-	Feld tracking_codes
`reason_id`	`UUID`	Nein	FK ➔ return_reasons.id	Feld reason_id
`condition_grade`	`VARCHAR(1)`	Nein	-	Feld condition_grade
`disposition`	`VARCHAR(24)`	Nein	-	Feld disposition
`disposition_location_id`	`UUID`	Nein	FK ➔ locations.id	Feld disposition_location_id
`disposed_at`	`DATETIME`	Nein	-	Feld disposed_at
`unit_cost`	`NUMERIC(14, 2)`	Nein	-	Feld unit_cost
`inspection_notes`	`TEXT`	Nein	-	Feld inspection_notes
`photo_document_ids`	`JSONB`	Ja *	-	Feld photo_document_ids
`child_return_id`	`UUID`	Nein	FK ➔ return_orders.id	Feld child_return_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

ReturnNotes return_notes RLS Aktiv

9 Wyroby

Tabelle return_notes

Feldname	Typ danych	Wymóg	Schlüssel	Znaczenie specjalne
`return_id`	`UUID`	Ja *	FK ➔ return_orders.id	Feld return_id
`author_id`	`UUID`	Nein	-	Feld author_id
`kind`	`VARCHAR(16)`	Ja *	-	Feld kind
`body`	`TEXT`	Ja *	-	Feld body
`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

ReturnOrders return_orders RLS Aktiv

46 Wyroby

Tabelle return_orders

Feldname	Typ danych	Wymóg	Schlüssel	Znaczenie specjalne
`rma_number`	`VARCHAR(64)`	Ja *	-	Feld rma_number
`kind`	`VARCHAR(24)`	Ja *	-	Feld kind
`status`	`VARCHAR(16)`	Ja *	-	Feld status
`channel`	`VARCHAR(16)`	Ja *	-	Feld channel
`public_token`	`UUID`	Ja *	-	Feld public_token
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`supplier_id`	`UUID`	Nein	FK ➔ suppliers.id	Feld supplier_id
`contract_id`	`UUID`	Nein	FK ➔ contracts.id	Feld contract_id
`invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld invoice_id
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`rental_booking_id`	`UUID`	Nein	FK ➔ rental_bookings.id	Feld rental_booking_id
`ticket_id`	`UUID`	Nein	FK ➔ tickets.id	Feld ticket_id
`parent_return_id`	`UUID`	Nein	FK ➔ return_orders.id	Feld parent_return_id
`policy_id`	`UUID`	Nein	FK ➔ return_policies.id	Feld policy_id
`reason_id`	`UUID`	Nein	FK ➔ return_reasons.id	Feld reason_id
`reason_text`	`TEXT`	Nein	-	Feld reason_text
`resolution`	`VARCHAR(24)`	Nein	-	Feld resolution
`restocking_fee_percent`	`NUMERIC(5, 2)`	Ja *	-	Feld restocking_fee_percent
`credit_note_id`	`UUID`	Nein	FK ➔ invoices.id	Feld credit_note_id
`replacement_ref`	`VARCHAR(255)`	Nein	-	Feld replacement_ref
`repair_work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld repair_work_order_id
`charge_invoice_id`	`UUID`	Nein	FK ➔ invoices.id	Feld charge_invoice_id
`credit_amount`	`NUMERIC(14, 2)`	Nein	-	Feld credit_amount
`carrier`	`VARCHAR(128)`	Nein	-	Feld carrier
`tracking_number`	`VARCHAR(128)`	Nein	-	Feld tracking_number
`return_location_id`	`UUID`	Nein	FK ➔ locations.id	Feld return_location_id
`pickup_address`	`TEXT`	Nein	-	Feld pickup_address
`risk_score`	`INTEGER`	Ja *	-	Feld risk_score
`risk_flags`	`JSONB`	Ja *	-	Feld risk_flags
`requested_at`	`DATETIME`	Nein	-	Feld requested_at
`approved_at`	`DATETIME`	Nein	-	Feld approved_at
`shipped_at`	`DATETIME`	Nein	-	Feld shipped_at
`received_at`	`DATETIME`	Nein	-	Feld received_at
`inspected_at`	`DATETIME`	Nein	-	Feld inspected_at
`resolved_at`	`DATETIME`	Nein	-	Feld resolved_at
`notes`	`TEXT`	Nein	-	Feld notes
`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

ReturnPolicies return_policies RLS Aktiv

22 Wyroby

Tabelle return_policies

Feldname	Typ danych	Wymóg	Schlüssel	Znaczenie specjalne
`name`	`VARCHAR(255)`	Ja *	-	Feld name
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`contract_id`	`UUID`	Nein	FK ➔ contracts.id	Feld contract_id
`is_default`	`BOOLEAN`	Ja *	-	Feld is_default
`window_days`	`INTEGER`	Ja *	-	Feld window_days
`auto_approve`	`BOOLEAN`	Ja *	-	Feld auto_approve
`restocking_fee_percent`	`NUMERIC(5, 2)`	Ja *	-	Feld restocking_fee_percent
`require_inspection`	`BOOLEAN`	Ja *	-	Feld require_inspection
`shipping_paid_by`	`VARCHAR(16)`	Ja *	-	Feld shipping_paid_by
`grade_credit_percent`	`JSONB`	Ja *	-	Feld grade_credit_percent
`condition_matrix`	`JSONB`	Ja *	-	Feld condition_matrix
`max_return_rate_percent`	`NUMERIC(5, 2)`	Ja *	-	Feld max_return_rate_percent
`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

ReturnReasons return_reasons RLS Aktiv

16 Wyroby

Tabelle return_reasons

Feldname	Typ danych	Wymóg	Schlüssel	Znaczenie specjalne
`code`	`VARCHAR(32)`	Ja *	-	Feld code
`label`	`VARCHAR(255)`	Ja *	-	Feld label
`category`	`VARCHAR(32)`	Ja *	-	Feld category
`fault_party`	`VARCHAR(16)`	Ja *	-	Feld fault_party
`default_disposition`	`VARCHAR(24)`	Nein	-	Feld default_disposition
`default_resolution`	`VARCHAR(24)`	Nein	-	Feld default_resolution
`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

🔌 Punkty wyjścia (UI & API)

Art	Wykorzystanie	Punkt końcowy / droga	Titel & Zweck	Właściwości
⚡ REST API	GET	`/api/v1/returns`	list_returns Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/analytics`	analityka Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/contract/{contract_id}/returnables`	contract_returnables Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/invoice/{invoice_id}/items`	invoice_items Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/meta`	w) Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/party-context`	party_context Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/policies`	list_policies Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/reasons`	list_reasons Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/{return_id}`	get_return Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/{return_id}/credit-preview`	credit_preview Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/portal/{slug}/retouren`	returns_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/pub/retoure/status/{token}`	return_status Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/pub/retoure/status/{token}/slip`	return_slip Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/pub/retoure/{tenant_id}`	return_form Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/returns`	returns_list_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/returns/analytics`	returns_analytics_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/returns/new`	returns_new_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/returns/settings`	returns_settings_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/returns/{return_id}`	returns_detail_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/returns/{return_id}/print`	returns_print_page Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	PATCH	`/api/v1/returns/policies/{policy_id}`	update_policy Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	PATCH	`/api/v1/returns/reasons/{reason_id}`	update_reason Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns`	create_return Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/collective-credit-note`	create_collective_credit_note Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/policies`	create_policy Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/reasons`	create_reason Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/approve`	zatwierdzenie Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/cancel`	odwołanie Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/close`	w pobliżu Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/escalate-ticket`	escalate_to_ticket Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/inspect`	wprowadzenie Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/lines/{line_id}/photos`	add_photos Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/notes`	add_note Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/receive`	wysyłanie Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/reject`	odrzucanie Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/resolve`	wprowadzenie Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/ship`	statek Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/portal/{slug}/retouren/anfordern`	return_request Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/pub/retoure/{tenant_id}`	return_lookup Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/pub/retoure/{tenant_id}/submit`	return_submit Semantic binding: operator_surface; mutation=True	`returns`

🛡️ Regulatoryzacja i zgodność

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

BGB prawo odwołania (§355)
Prawo gwarancyjne (§ 437 BGB)
Wypłaty w kredyty

Włączone moduły:

➔ inventory ➔ finance ➔ customers ➔ portal