Invoice Line

Manage Invoice Line Items.

Fetch Invoice Lines

GET https://app.clubcollect.com/api/v2/invoices/:id/lines

Path Parameters

Name	Type	Description
id*	string	ID of Invoice for which Line Items wish to be retrieved.

Query Parameters

Name	Type	Description
api:key	string	Partner API Key (Deprecated)

Headers

Name	Type	Description
Authorization*	string	ApiKey <api_key>
Content-Type*	string	Must be: application/json.

200

{
  "import_id": "...",
  "invoice_id": "...",
  "invoice_lines": [
    {
      "invoice_line_id": "...",
      "type": "INVOICE-LINE",
      "amount_cents": 10000,
      "description": "Membership fee",
      "date": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "CREDIT-LINE",
      "amount_cents": -1000,
      "description": "Deduction",
      "date": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "PAYMENT-LINE",
      "amount_cents": -123,
      "description": null,
      "date": "...",
      "payment_method": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "CHARGEBACK-LINE",
      "amount_cents": 123,
      "description": null,
      "date": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "CHARGEBACK-FEE-LINE",
      "amount_cents": 123,
      "description": null,
      "date": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "CHARGEBACK-FEE-PAYMENT-LINE",
      "amount_cents": 123,
      "description": null,
      "date": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "LATE-PAYMENT-FEE-LINE",
      "amount_cents": 123,
      "description": null,
      "date": "..."
    },
    {
      "invoice_line_id": "...",
      "type": "LATE-PAYMENT-FEE-PAYMENT-LINE",
      "amount_cents": 123,
      "description": null,
      "date": "...",
      "payment_method": "..."

    },
    {
      "invoice_line_id": "...",
      "type": "INSTALLMENT-FEE-LINE",
      "amount_cents": 123,
      "description": null,
      "date": "..."
      },
      {
        "invoice_line_id": "...",
        "type": "INSTALLMENT-FEE-PAYMENT-LINE",
        "amount_cents": -123,
        "description": null,
        "date": "...",
        "payment_method": "..."
        }
      ],
    "amount_total_cents": "..."
  }

404

{
  "error": "invalid_invoice_id"
}

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).

Type	Subtype	Description
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).

Type	Subtype	Description
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.

Type	Subtype	Description
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.

Type	Subtype	Description
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.

Type	Subtype	Description
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.