Catalogue BuilderCataloguePass-Through Charges

Pass-Through Charges

A pass-through charge is a cost you pass on to the customer at cost, such as an SMS carrier fee or a third-party data fee. It is rated like any other line, but it is marked on the order, the invoice and the invoice PDF. You also decide, on the plan, whether pass-through lines carry GST.

When to use it

Use pass-through when you buy something on the customer’s behalf and pass the cost on: a carrier fee of ₹1 for each SMS, a licence fee, a courier cost. Do not use it for your own margin. Pass-through amounts are cost recovery, so they are not MRR.

Mark a piece as pass-through

Open the piece

In the rate plan builder, open or add a Usage piece, a Per-event fee, or a One-time fee.

Tick Pass through at cost

The checkbox is under the usage piece and under each per-event fee. For a one-time fee the pass-through flag is set through the API (passThrough).

Set the GST switch

Once any piece is pass-through, a checkbox appears at the bottom of the pieces: Charge GST on pass-through lines. It is ticked by default.

Publish

Click Publish plan.

Settings

SettingWhereAPI fieldAllowed valuesDefaultRules
Pass through at costComponentpassThroughtrue or falsefalseOnly on USAGE, EVENT or ONE_TIME components. Error: Component N passThrough is only allowed on USAGE, EVENT or ONE_TIME components. A non-boolean gives Component N passThrough must be true or false.
Charge GST on pass-through linesRate plan price and add-on pricepassThroughTaxabletrue or falsetrueA non-boolean gives passThroughTaxable must be true or false.
Pass-through on an ad-hoc chargeCharges APIpassThroughtrue or falsefalsepassThrough must be true or false.

The default of passThroughTaxable is true, so nothing escapes GST unless you say so.

The GST switch

SwitchWhat happens to the pass-through lines
On (default)Taxed like any other line, at the line’s tax profile.
OffNo GST on those lines (no CGST, SGST or IGST). Their value stays out of the taxable value, and they still count in the invoice total. GST is still worked out per line for the other lines.

The switch is on the rate plan price, so it covers every pass-through line of that price, including usage, events, one-time fees and pass-through pending charges.

Examples (acceptance checks)

A plan with a ₹15 base fee and a usage piece “Carrier fee” at ₹1 per SMS, marked pass-through. The customer sends 500 SMS. GST 18%.

LineGST switch offGST switch on
Rate plan ₹15.00GST ₹2.70GST ₹2.70
Carrier fee, 500 SMS ₹500.00GST ₹0.00GST ₹90.00
Total GST₹2.70₹92.70
Invoice total₹517.70₹607.70

How it appears on the invoice and PDF

  • The line carries a pass-through mark on the order and the invoice.
  • On the invoice PDF, pass-through lines come after the other lines, under the heading Pass-through charges.
  • An untaxed pass-through line keeps its place in the GST table with a GST amount of 0, and adds nothing to the taxable value. Its total is what it charges.

Example invoice, switch off

#DescriptionTaxable valueGST 18%Total
1Rate plan₹15.00₹2.70₹17.70
Pass-through charges
2Carrier fee (500 SMS)₹0.00₹0.00₹500.00
Total₹15.00₹2.70₹517.70

Edge cases

  • A pass-through line is still rated at cost by the engine, with its model, included quantity, minimum and cap, as any usage or event line.
  • A pass-through line after a renewal-mode End of Term change takes its GST setting from the cart’s price.
  • A pass-through line can be paid from prepaid credits when its component has Paid from credits. The builder ticks that by default for pass-through pieces.
  • The v1 API shows such a price but cannot change it. See v1 is read-only for these settings.