Fees are reported as additional line items, where you can either apply the fee to a specific item (see reference_number parameter below), or to the whole invoice. If the fee applies to the entire invoice, you can omit the reference_number parameter.

Fees need to have a parameter type with the value "FEE" in the line item details.

In the example below, a transaction includes one sale-related line item, with a fee applied to the first line item.

Fee items should use positive values for the unit_price, net_price, and tax_breakdown.amount fields in regular transactions, and negative values for credit adjustments.

Example request:

{
  "country_code": "NG",
  "language_code": "EN",
  "currency_code": "NGN",
  "type": "SIMPLIFIED",
  "transaction_id": "Reference105",
  "transaction_date": "2023-01-05T01:00:00+00:00",
  "supplier": {
    "id": "8db9a4a4aaec4c969a402692eb33035c"
  },
  "items": [
    {
      "number": 1,
      "name": "Delivery Service",
      "type": "SERVICES",
      "quantity": 1.0,
      "unit_price": 10.0,
      "net_price": 10.0,
      "tax_breakdown": [
        {
          "rate": 27,
          "amount": 2.7,
          "regime": "VAT"
        }
      ]
    },
    {
      "number": 2,
      "reference_number": 1,
      "type": "FEE",
      "name": "Additional Charge",
      "quantity": 1.0,
      "unit_price": 1.0,
      "net_price": 1.0,
      "tax_breakdown": [
        {
          "rate": 27,
          "amount": 0.27,
          "regime": "VAT"
        }
      ]
    }
  ],
  "total_amount": 13.97,
  "total_net_amount": 11.0,
  "total_tax_amount": 2.97,
  "payments": [
    {
      "type": "DEBIT",
      "amount": 13.97
    }
  ]
}