Invoice Line
Manage Invoice Line Items.
Fetch Invoice Lines
GET
https://app.clubcollect.com/api/v2/invoices/:id/lines
Path Parameters
id*
string
ID of Invoice for which Line Items wish to be retrieved.
Query Parameters
api:key
string
Partner API Key (Deprecated)
Headers
Authorization*
string
ApiKey <api_key>
Content-Type*
string
Must be: application/json
.
Note the date format isISO 8601
.
Note that description
is not null
only for regular Invoice Lines and Credit Lines.
Note that payment_method
is present only for Payment Lines and its value can be one of:
ideal
sdd
bank_transfer
credit_card
bancontact
bacs
sofort
paypal
external
Line types
The invoice lines can either increase the invoice outstanding (positive amount), e.g. regular lines, fees, chargebacks; or decrease the outstanding (negative amount), e.g. payments, credits. Furthermore lines can be categorised by their type.
The type of an invoice line is determined by the type
attributes (always present) and the optional subtype
attributes. Below you can find a description of the possible values for invoice lines types.
Regular Lines
This line type is used for lines added to the invoice at creation time, when increasing the invoice amount from the ClubCollect web interface or when a member adds a donation to the invoice (if enabled).
INVOICE-LINE
Amounts added by the partner when an invoice is created will be of this type
INVOICE-LINE
DONATION
Donation added to an invoice
INVOICE-LINE
SURCHARGE
Payment fee charged to the receiver of the invoice
INVOICE-LINE
ADMINISTRATIVE_FEE
Administrative fee charged to the receiver of the invoice
Fees Lines
At certain points of the life cycle of an invoice fees can be added to the invoice (e.g. Member initiating a payment in installments).
INSTALLMENT-FEE
These fees are added to the invoice when it is paid in installments
CHARGEBACK-FEE
When a payment is charged back a fee might be added to the invoice
LATE-PAYMENT-FEE
Late payment fees are penalties that might be added when the invoice is overdue
Payment Lines
Payment lines are added to register new payments happening for an invoice. payment invoice lines will are added to the invoice.
PAYMENT
Payment for the amount invoiced by the partner
PAYMENT
donation
Payments towards donation invoice lines
JEUGDFONDS
jsf
Jeugdfonds payment
PAYMENT-INSTALLMENT-FEE
Payments for installment fees
PAYMENT-CHARGEBACK-FEE
Payments for chargeback fees
PAYMENT-LATE-PAYMENT-FEE
Payments for late payment fees
PAYMENT-PENALTY-FEE
Payment for penalty fees (Legacy)
Chargeback Lines
When a successful payment (usually Sepa Direct Debit) is charged back, chargeback lines are added to the invoice to cancel the amount of the payment that has been charged back.
CHARGEBACK
Chargeback for the amount invoiced by the partner
CHARGEBACK
DONATION
Chargeback line for a donation invoice lines
CHARGEBACK
ADMINISTRATIVE_FEE
Chargeback line for an administrative fee invoice lines
CHARGEBACK-INSTALLMENT-FEE
Chargeback for installment fees
CHARGEBACK-LATE-PAYMENT-FEE
Chargeback for late payment fee
CHARGEBACK-CHARGEBACK-FEE
Chargeback for paid chargeback fees
CHARGEBACK-PENALTY-FEE
Chargeback for penalty fees
Credit Lines
Credit lines are added to the invoice to discount an amount from the amount outstanding. a new invoice line to the invoice.
CREDIT-LINE
Discount applied to the amount invoiced by the partner
CREDIT-LINE
DONATION
Credit for donation lines
CREDIT-LINE
SURCHARGE
Credits for the payment fee
CREDIT-LINE
ADMINISTRATIVE_FEE
Credits for the administrative fee
CREDIT-CHARGEBACK-FEE
Credits for a chargeback fee
CREDIT-INSTALLMENT-FEE
Credit for an installment fee
CREDIT-LATE-PAYMENT-FEE
Credit for a late payment fee
CREDIT-PENALTY-FEE
Credit for a Penalty fee
Note: penalty lines are a legacy type. You might see some of them for older invoices but no new invoice lines of this type are created. with have this type.
Last updated