Change Request

Change Request

Change Request is a document used to add additional charges to an existing job (Air Shipment, Sea Shipment, Transport Job, Warehouse Job, Declaration). When approved, the charges are applied to the linked job.

To access Change Request, go to:

Home > Pricing Center > Change Request

1. How to Use

1. Open a job (e.g., Air Shipment, Transport Job).
2. Click Create Change Request (from the Additional Charges or custom button).
3. Add charge lines in the Charges child table.
4. Submit the Change Request.
5. Approve the Change Request – charges are applied to the job.
6. Optionally, create a Sales Quote from the Change Request for billing.

2. Supported Job Types

• Air Shipment
• Sea Shipment (via Sea Shipment Charges)
• Transport Job
• Warehouse Job
• Declaration

Complete field reference

All fields from DocType Change Request and nested child tables, in form order (including layout breaks). Columns: Label with technical field name in backticks, Type, and Description (from the DocType definition and standard freight/ERP semantics).

Label (Field name)	Type	Description
Naming Series (naming_series)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: CR-.#########.
Job Type (job_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Transport Job, Warehouse Job, Air Shipment, Sea Shipment, Declaration.
Job (job)	Dynamic Link	Purpose: References another document whose DocType is chosen in field job_type (same pattern as ERPNext Dynamic Link). What to enter: First set the DocType field, then pick the document name for that type.
column_break_cr	Column Break	Purpose: Continues the current row in a second column (standard ERP two-column layout). What to enter: No data — layout only.
Status (status)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Draft, Submitted, Approved, Sales Quote Created. Behaviour: Read-only here — value comes from calculation, another field, or workflow.
Costs (section_break_charges)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Charges (charges)	Table	Purpose: Stores repeating Change Request Charge lines (child records) such as packages, charges, legs, or documents. What to enter: Use Add row, fill each line, and remove rows you do not need. Save the parent to persist child rows.
Remarks (section_break_remarks)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Remarks (remarks)	Long Text	Purpose: Long remarks: cargo description, marks & numbers, special instructions, legal text. What to enter: Enter the full operational or legal wording; paste from external docs if allowed by policy.
Sales Quote (sales_quote)	Link	Purpose: Creates a controlled reference to Sales Quote so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Sales Quote. Create the master first if it does not exist. Behaviour: Read-only here — value comes from calculation, another field, or workflow.
Amended From (amended_from)	Link	Purpose: Creates a controlled reference to Change Request so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Change Request. Create the master first if it does not exist. Behaviour: Read-only here — value comes from calculation, another field, or workflow.

Child table: Change Request Charge (field charges on parent)

Label (Field name)	Type	Description
Service Type (service_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Air, Sea, Transport, Customs, Warehousing.
Charge Group (charge_group)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Origin, Destination, Freight, Customs, Documentation, Storage, Insurance, Other.
Item Code (item_code)	Link	Purpose: Creates a controlled reference to Item so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Item. Create the master first if it does not exist.
Item Name (item_name)	Data	Purpose: Short free-text for codes, references, or labels that are not master-linked. What to enter: Type the value as it should appear on print/PDF (no line breaks). Behaviour: Read-only here — value comes from calculation, another field, or workflow. Behaviour: Auto-filled from item_code.item_name when the link/source changes — verify after edits.
Charge Type (charge_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Revenue, Cost, Margin, Disbursement, Other.
Charge Category (charge_category)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Freight, Fuel Surcharge, Terminal Handling, Port Charges, Customs Clearance, Documentation, Insurance, Storage, Detention, Demurrage, Other.
column_break_core	Column Break	Purpose: Continues the current row in a second column (standard ERP two-column layout). What to enter: No data — layout only.
Tariff (tariff)	Link	Purpose: Creates a controlled reference to Tariff so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Tariff. Create the master first if it does not exist.
Revenue Tariff (revenue_tariff)	Link	Purpose: Creates a controlled reference to Tariff so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Tariff. Create the master first if it does not exist.
Cost Tariff (cost_tariff)	Link	Purpose: Creates a controlled reference to Tariff so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Tariff. Create the master first if it does not exist.
Use Tariff in Revenue (use_tariff_in_revenue)	Check	Purpose: Boolean flag that drives validation, billing, DG handling, or UI (depending on the field label). What to enter: Tick Yes / enabled, untick No / disabled.
Use Tariff in Cost (use_tariff_in_cost)	Check	Purpose: Boolean flag that drives validation, billing, DG handling, or UI (depending on the field label). What to enter: Tick Yes / enabled, untick No / disabled.
Bill To (bill_to)	Link	Purpose: Creates a controlled reference to Customer so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Customer. Create the master first if it does not exist.
Pay To (pay_to)	Link	Purpose: Creates a controlled reference to Supplier so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Supplier. Create the master first if it does not exist.
Quotation Type (quotation_type)	Data	Purpose: Short free-text for codes, references, or labels that are not master-linked. What to enter: Type the value as it should appear on print/PDF (no line breaks). Behaviour: Hidden in default layout; may still be set by import, API, or script.
Air Parameters (section_break_air_params)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Air House Type (air_house_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Standard House, Co-load Master, Blind Co-load Master, Co-load House, Buyer's Consol Lead, Shipper's Consol Lead, Break Bulk.
Airline (airline)	Link	Purpose: Creates a controlled reference to Airline so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Airline. Create the master first if it does not exist.
Freight Agent (freight_agent)	Link	Purpose: Creates a controlled reference to Freight Agent so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Freight Agent. Create the master first if it does not exist.
Sea Parameters (section_break_sea_params)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Sea House Type (sea_house_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Standard House, Co-load Master, Blind Co-load Master, Co-load House, Buyer's Consol Lead, Shipper's Consol Lead, Break Bulk.
Freight Agent (freight_agent_sea)	Link	Purpose: Creates a controlled reference to Freight Agent so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Freight Agent. Create the master first if it does not exist.
Shipping Line (shipping_line)	Link	Purpose: Creates a controlled reference to Shipping Line so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Shipping Line. Create the master first if it does not exist.
Transport Mode (transport_mode)	Link	Purpose: Creates a controlled reference to Transport Mode so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Transport Mode. Create the master first if it does not exist. Behaviour: Hidden in default layout; may still be set by import, API, or script.
Common Parameters (section_break_common_params)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Load Type (load_type)	Link	Purpose: Creates a controlled reference to Load Type so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Load Type. Create the master first if it does not exist.
Direction (direction)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Import, Export, Domestic.
Origin Port (origin_port)	Link	Purpose: Creates a controlled reference to UNLOCO so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing UNLOCO. Create the master first if it does not exist.
Destination Port (destination_port)	Link	Purpose: Creates a controlled reference to UNLOCO so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing UNLOCO. Create the master first if it does not exist.
Transport Parameters (section_break_transport_params)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Transport Template (transport_template)	Link	Purpose: Creates a controlled reference to Transport Template so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Transport Template. Create the master first if it does not exist.
Vehicle Type (vehicle_type)	Link	Purpose: Creates a controlled reference to Vehicle Type so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Vehicle Type. Create the master first if it does not exist.
Container Type (container_type)	Link	Purpose: Creates a controlled reference to Container Type so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Container Type. Create the master first if it does not exist.
column_break_transport	Column Break	Purpose: Continues the current row in a second column (standard ERP two-column layout). What to enter: No data — layout only.
Location Type (location_type)	Link	Purpose: Creates a controlled reference to DocType so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing DocType. Create the master first if it does not exist.
Location From (location_from)	Dynamic Link	Purpose: References another document whose DocType is chosen in field location_type (same pattern as ERPNext Dynamic Link). What to enter: First set the DocType field, then pick the document name for that type.
Location To (location_to)	Dynamic Link	Purpose: References another document whose DocType is chosen in field location_type (same pattern as ERPNext Dynamic Link). What to enter: First set the DocType field, then pick the document name for that type.
Pick Mode (pick_mode)	Link	Purpose: Creates a controlled reference to Pick and Drop Mode so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Pick and Drop Mode. Create the master first if it does not exist.
Drop Mode (drop_mode)	Link	Purpose: Creates a controlled reference to Pick and Drop Mode so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Pick and Drop Mode. Create the master first if it does not exist.
Customs Parameters (section_break_customs_params)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Customs Authority (customs_authority)	Link	Purpose: Creates a controlled reference to Customs Authority so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Customs Authority. Create the master first if it does not exist.
Declaration Type (declaration_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Import, Export, Transit, Bonded.
Customs Broker (customs_broker)	Link	Purpose: Creates a controlled reference to Broker so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Broker. Create the master first if it does not exist.
Charge Category (customs_charge_category)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Customs Clearance, Documentation, Storage, Other.
Revenue & Cost (section_break_revenue_cost)	Section Break	Purpose: Visual grouping and optional heading for the fields that follow (improves long freight forms). What to enter: No data — informational layout only.
Revenue (revenue_column)	Column Break	Purpose: Continues the current row in a second column (standard ERP two-column layout). What to enter: No data — layout only.
Calculation Method (calculation_method)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Per Unit, Fixed Amount, Base Plus Additional, First Plus Additional, Percentage.
Unit Rate (unit_rate)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field currency on this form (or company default).
Unit Type (unit_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Distance, Weight, Chargeable Weight, Volume, Package, Piece, Container, TEU, Item Count, Operation Time, Job, Trip, Handling Unit.
Currency (currency)	Link	Purpose: Creates a controlled reference to Currency so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Currency. Create the master first if it does not exist.
Quantity (quantity)	Float	Purpose: Decimal quantity or measurement (weight, volume, count with decimals). What to enter: Enter a number using site decimal precision.
Minimum Quantity (minimum_quantity)	Float	Purpose: Decimal quantity or measurement (weight, volume, count with decimals). What to enter: Enter a number using site decimal precision.
Minimum Charge (minimum_charge)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field currency on this form (or company default).
Maximum Charge (maximum_charge)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field currency on this form (or company default).
Base Amount (base_amount)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field currency on this form (or company default).
UOM (uom)	Link	Purpose: Creates a controlled reference to UOM so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing UOM. Create the master first if it does not exist.
Estimated Revenue (estimated_revenue)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field currency on this form (or company default). Behaviour: Read-only here — value comes from calculation, another field, or workflow.
Revenue Calc Notes (revenue_calc_notes)	Small Text	Purpose: Short note or identifier where a full Text field is not needed. What to enter: One line of text; keep it brief for list views. Behaviour: Read-only here — value comes from calculation, another field, or workflow.
Cost (cost_column)	Column Break	Purpose: Continues the current row in a second column (standard ERP two-column layout). What to enter: No data — layout only.
Calculation Method (cost_calculation_method)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Per Unit, Fixed Amount, Flat Rate, Base Plus Additional, First Plus Additional, Percentage, Location-based.
Unit Cost (unit_cost)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field cost_currency on this form (or company default).
Unit Type (cost_unit_type)	Select	Purpose: Constrains input to predefined values (compliance, mode, status, or internal classification). What to enter: Pick exactly one value from the list: Distance, Weight, Chargeable Weight, Volume, Package, Piece, Container, TEU, Item Count, Operation Time, Job, Trip, Handling Unit.
Currency (cost_currency)	Link	Purpose: Creates a controlled reference to Currency so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Currency. Create the master first if it does not exist.
Quantity (cost_quantity)	Float	Purpose: Decimal quantity or measurement (weight, volume, count with decimals). What to enter: Enter a number using site decimal precision.
Minimum Quantity (cost_minimum_quantity)	Float	Purpose: Decimal quantity or measurement (weight, volume, count with decimals). What to enter: Enter a number using site decimal precision.
Minimum Charge (cost_minimum_charge)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field cost_currency on this form (or company default).
Maximum Charge (cost_maximum_charge)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field cost_currency on this form (or company default).
Base Amount (cost_base_amount)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field cost_currency on this form (or company default).
UOM (cost_uom)	Link	Purpose: Creates a controlled reference to UOM so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing UOM. Create the master first if it does not exist.
Estimated Cost (estimated_cost)	Currency	Purpose: Money amount in the document’s commercial context (freight, duty, insured value). What to enter: Amount in the currency indicated by field cost_currency on this form (or company default). Behaviour: Read-only here — value comes from calculation, another field, or workflow.
Cost Calc Notes (cost_calc_notes)	Small Text	Purpose: Short note or identifier where a full Text field is not needed. What to enter: One line of text; keep it brief for list views. Behaviour: Read-only here — value comes from calculation, another field, or workflow.
Cost Sheet Source (cost_sheet_source)	Link	Purpose: Creates a controlled reference to Cost Sheet so party, place, item, or document data stays consistent for reporting and integrations. What to enter: Type to search or click the link icon; select an existing Cost Sheet. Create the master first if it does not exist. Behaviour: Read-only here — value comes from calculation, another field, or workflow.

3. Related Topics

• Sales Quote
• Air Shipment
• Transport Job
• Warehouse Job
• Declaration