Results for “update_charges”
34 results
AI-generated from documented ETRM metadata — verify critical details on the linked pages.
Overview
CSF_DEBRIEF_CHARGES is an APPS-owned PL/SQL package body in Oracle E-Business Suite, classified under the ETRM API taxonomy as OTHER. It functions as a wrapper for charge processing, exposing a controlled interface to the Service Billing Engine for the creation, maintenance, and removal of charge lines associated with field service debrief transactions. The package header comment states its purpose as "Wrapper for Charges," and the single shared implementation file (csfdbchb.pls) further identifies the typical service-billing role the package plays.
The package sits within the CSF (Customer Support/Field Service) schema and operates on the debrief model, where a debrief header aggregates one or more debrief lines representing labor, material, expense, and return activity captured by a field service technician. When a debrief is submitted for billing, this package translates the debrief line context into the structures required by the Service Billing Engine private package (CS_SERVICE_BILLING_ENGINE_PVT), persisting the resulting charges against the originating repair order and debrief lines.
Key Procedures and Functions
- CREATE_CHARGES — The principal entry point of the package. It accepts the originating source identifiers, incident, business process, line category, inventory item, revision, unit of measure, quantity, billing and transaction type, customer product, warranty and after-warranty cost attributes, currency, return reason, inventory organization, subinventory, serial number, final charge flag, and labor start/end dates, and returns a status, message count, and message data. Internally it declares a record of type Cs_service_billing_engine_pvt.SBE_Rec_Type, resolves a price list from a dedicated cursor, and drives the billing engine to produce charge records.
- UPDATE_CHARGES — Modifies existing charge records previously generated for a debrief, allowing corrections to quantities, costs, or billing attributes without recreating the charge line.
- DELETE_CHARGES — Removes charge records associated with a debrief line, supporting reversal or cancellation of billing activity prior to final accounting.
- UPDATE_LAB_RS_LOC — Updates labor resource and location information used by the charge process, reflecting the resource and site context recorded on the associated task and assignment records.
Tables Accessed
- CSD_REPAIRS — The repair order header table that anchors the debrief and its associated charges to a depot or field repair.
- CSF_DEBRIEF_HEADERS and CSF_DEBRIEF_LINES — The debrief documents and lines from which charge attributes such as item, quantity, and labor dates are derived.
- CS_ESTIMATE_DETAILS — Provides estimate detail context, including the estimate detail identifier referenced during charge creation.
- CS_TXN_BILLING_TYPES — Supplies billing type definitions used to classify each charge line.
- HZ_LOCATIONS and HZ_PARTY_SITES — Resolve the location and party site associated with the service activity.
- JTF_RS_RESOURCE_EXTNS — Holds resource information for the technician or resource responsible for the labor charge.
- JTF_TASKS_B and JTF_TASK_ASSIGNMENTS — Supply task and assignment data linking the resource and location to the debrief activity.
Usage Notes
The package is typically invoked from the field service debrief and service billing flows rather than directly by end users. One other package references it, indicating that CSF_DEBRIEF_CHARGES is called programmatically when debrief lines are submitted, priced, or repriced, and when charge corrections or reversals are required. Custom code should call the documented public procedures and honor the returned X_Return_Status, X_Msg_Count, and X_Msg_Data outputs, applying standard FND_API message handling and committing only after a successful status is returned. Because the package writes to service billing structures, it should be invoked within a properly scoped transaction to avoid partial charge records.