CreditNote

Version: v3.0.0

Supporting model

A request/response or nested model — not a stored DynamoDB entity.

Overview

Credit note model

Fields

Field	Type	Required	Default	Description
credit_id	str	❌	—	—
contact_name	str	✅	—	—
contact_id	str	✅	—	—
sales_person	str	❌	—	—
reference	str	❌	—	—
note	str	❌	—	—
total	float	❌	—	—
restocking_fee	float	❌	—	—
reason	str	❌	—	—
issue_date	str	✅	—	—
sales_person_id	str	❌	—	—
line_amount_tax_type	str	✅	—	—
line_items	List[LineItem]	✅	—	—
allocations	List[CreditNoteAllocation]	✅	—	—
dont_sync_to_xero	bool	❌	False	—
is_deleted	bool	❌	False	—
created_at	str	❌	—	—
updated_at	str	❌	—	—
type	str	❌	CREDIT_NOTE	—

Embedded models

Models embedded in the fields above — shown inline; they have no separate page.

LineItem — v2.1.0

Field	Type	Required	Default	Description
item_type	str	✅	—	—
item_name	str	✅	—	—
description	str	✅	—	—
unit_price	float	❌	—	—
tax_type	str	❌	—	—
quantity	int	❌	—	—
account	Account	❌	—	Account model
tag_id	str	❌	—	—
part_id	str	❌	—	—
is_restocked	bool	❌	False	—
discount	float	❌	—	—
tax_amount	float	❌	—	—
line_amount	float	❌	—	—
line_item_id	str	❌	—	—

Change history

• v2.1.0 · 2025-04-17 · Olaniyi Ajayi · Field line_item_id became optional.; Field line_item_id default changed: None → Field(default_factory=lambda : str(uuid4())). (6db62f7db)
• v2.0.0 · 2025-04-09 · Cian (shared account) · Field description type changed: Optional[str] → str (breaking).; Field description became required (breaking).; Field item_name type changed: Optional[str] → str (breaking).; Field item_name became required (breaking).; Field item_type type changed: Optional[str] → str (breaking).; Field item_type became required (breaking).; Field line_item_id type changed: Optional[str] → str (breaking).; Field line_item_id became required (breaking). (6c65e2d22)
• v1.0.0 · 2025-03-15 · Olaniyi Ajayi · Initial version. (338416124)

Account — v5.0.0

Field	Type	Required	Default	Description
account_code	str	❌	—	—
account_id	str	✅	—	—
account_name	str	✅	—	—

Change history

• v5.0.0 · 2025-05-26 · Cian (shared account) · Field account_code type changed: str → Optional[str] (breaking).; Field account_code became optional. (509648ddf)
• v4.0.0 · 2025-05-15 · Cian (shared account) · Field account_code type changed: Optional[str] → str (breaking).; Field account_code became required (breaking). (bdb212c0f)
• v3.0.0 · 2025-05-09 · Cian (shared account) · Field account_code type changed: str → Optional[str] (breaking).; Field account_code became optional. (3a7865c16)
• v2.0.0 · 2025-04-09 · Cian (shared account) · Field account_code type changed: Optional[str] → str (breaking).; Field account_code became required (breaking). (6c65e2d22)
• v1.0.0 · 2025-03-15 · Olaniyi Ajayi · Initial version. (338416124)

CreditNoteAllocation — v2.1.0

Field	Type	Required	Default	Description
invoice_id	str	✅	—	—
invoice_display_id	str	✅	—	—
amount	float	✅	—	—
date	str	✅	—	—
allocation_id	str	❌	—	—

Change history

• v2.1.0 · 2025-09-12 · Olaniyi Ajayi · Field amount became optional.; Field amount default changed: None → Field(..., ge=0). (e2ad92a30)
• v2.0.0 · 2025-05-15 · Cian (shared account) · Field invoice_display_id type changed: int → str (breaking). (9d75bf4fd)
• v1.0.0 · 2025-05-14 · Cian (shared account) · Initial version. (02e6bfcc7)

APIs / Triggers

No API or event interacts with this object directly.

Change history

v3.0.0 · 2026-06-02 · Cian (shared account) · 82b67e3db

Restore source files without generated outputs

• Removed field note (breaking).

v2.2.0 · 2026-05-29 · Olaniyi Ajayi · 424792de4

Invoice: add note to credit note model

• Added optional field note.

v2.1.1 · 2025-09-12 · Olaniyi Ajayi · e2ad92a30

account unique check

• Field restocking_fee default changed: None → Field(None, ge=0).
• Field total default changed: None → Field(None, ge=0).

v2.1.0 · 2025-08-03 · Cian (shared account) · d02ae5d48

fxfx

• Added optional field is_deleted.

v2.0.0 · 2025-05-15 · Cian (shared account) · 582ac4d2a

fx

• Field allocations type changed: List[Allocation] → List[CreditNoteAllocation] (breaking).

v1.0.0 · 2025-03-16 · Cian (shared account) · feca668a3

models

• Initial version.

Generated from dismantly-backend/Microservices/Invoice/dependencies/models.py. Do not edit by hand.