↩️

Retournări și reclamații

returns supply_chain 🛡️ RLS Protected

Gestionarea returnurilor pentru clienți și furnizori, verificarea calității, depozitarea și creanțarea creditelor.

Fachliche Bestimmung: Procesul RMA cuprinzător (autorizarea returnului mărfurilor). Clienții sau tehnicienii de servicii anunță trimiterile înapoi. Sistemul atribuie un număr RMA, conduce muncitorul de la depozit prin verificarea calității și erorilor, face rost de mărfuri fără erori și încurajează automat crearea de credite sau livrări de schimb.

⚡ Fluxuri de lucru (3) 🗄️ Modele de date & câmpuri (5) 🔌 Puncte de inițiere (UI & API) (40) 🛡️ Reglementări și respectare

⚡ Fluxuri de lucru

RMA-uri de returnare `rma_workflow`

De la intrarea în retur, la verificarea tehnologică, la credit.

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

Înregistrare a returnării

client sau Serviciul intern informează cu motiv

Aktionen: Numărul RMA generat

2. RECEIVE

Intrare & identificare

Pachetul se întâlneşte în depozit, scanarea codului de bară a RMA.

Aktionen: Încadrarea în

3. INSPECT

Verificarea condiției

Examinare: Nouă, folosită, necesară reparații sau deșeuri.

Aktionen: Documentarea rezultatelor verificării

4. SETTLE

Încadrarea

Reîntrădarea în depozit sau decăderea, eliberarea creditelor.

Aktionen: Crearea de credit

Benutzerbefehl: returns agent `plan:command_returns_agent`

Geprüfter Durable-Plan (unreviewed_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

Întoarcerea `status:return_order`

În cazul în care se aplică o metodă de verificare a situaţiei, se poate observa o metodă de verificare a situaţiei.

1. draft

proiect

Statutul de la proiectul de la statutul de la returnare a mașinii.

2. requested

solicitate

Statut <unk>receat <unk>receat <unk>receat

3. approved

aprobate

Statutul de retur al mașinii de stat

4. rejected

respingerea

Statutul de regresie a mașinii de stat

5. in_transit

in_transit

Statutul <unk>in_transit<unk> al mașinii de întoarcere.

6. part_received

part_received

Statut <unk>part_received<unk> al mașinii de returnare a stării.

7. received

primite

Statut <unk>a primit <unk>a statutul de returnare a mașinii.

8. inspected

inspecționat

Statutul de regresare a mașinii de stat

9. resolved

Răspunde

Statut de returnare a mașinii de stat

10. closed

închis

Statutul de returnare a mașinii de stat

11. cancelled

anulate

Statutul de regresare a mașinii de stat

🗄️ Modele de date & câmpuri

ReturnLines return_lines RLS Aktiv

30 Câmpuri / coloane

Tabelle return_lines

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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 Câmpuri / coloane

Tabelle return_notes

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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 Câmpuri / coloane

Tabelle return_orders

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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 Câmpuri / coloane

Tabelle return_policies

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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 Câmpuri / coloane

Tabelle return_reasons

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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

🔌 Puncte de inițiere (UI & API)

Art	Metoda	Punctul de încheiere / traseul	Titel & Zweck	Asigurarea
⚡ REST API	GET	`/api/v1/returns`	list_returns Semantic binding: inventory_only; mutation=False	`returns`
⚡ REST API	GET	`/api/v1/returns/analytics`	analiză 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`	meta 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`	aprobă Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/cancel`	anulare Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/close`	în apropiere 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`	inspecţie 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`	înregistrat Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/reject`	respingerea Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/resolve`	soluţionarea Semantic binding: operator_surface; mutation=True	`returns`
⚡ REST API	POST	`/api/v1/returns/{return_id}/ship`	Nave 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`

🛡️ Reglementări și respectare

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

BGB dreptul de retragere (§355)
Dreptul de garanție (§ 437 BGB)
Proba de credite

Module legate:

➔ inventory ➔ finance ➔ customers ➔ portal