# Generate Group Invoice

Creates a new Premium Billing Invoice for the selected Group.

Endpoint: POST /generate-group-invoice
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

  - `vbasoftware-database` (string, required)
    Target database

## Request fields (application/json):

  - `invoice_Key` (integer,null)

  - `group_ID` (string,null)

  - `division_ID` (string,null)

  - `subscriber_ID` (string,null)

  - `groupDivisionCaptive` (string,null)

  - `bill_From` (string,null)

  - `bill_Thru` (string,null)

  - `invoice_Date` (string,null)

  - `due_Date` (string,null)

  - `user_ID` (string,null)

  - `regenerate` (boolean)

  - `input_Date` (string,null)

  - `activity_ID` (string,null)

  - `client_ID` (string,null)

## Response 200 fields (text/plain):

  - `data` (object)

  - `data.invoice_Key` (integer, required)
    Unique identifier for the Invoice Note: This field is marked as NOT NULL in the database and therefore required by the API.

  - `data.additional_Invoice_Level` (string,null)
    Specifies invoice level of additional invoices defined on the prem rate.

  - `data.bill_Address` (string,null)
    Address of the group or individual the Invoice is for

  - `data.bill_Address2` (string,null)
    Second line for the Address of the group or individual the Invoice is for

  - `data.bill_City` (string,null)
    City of the group or individual the Invoice is for

  - `data.bill_County_Code` (string,null)
    County of the group or individual the Invoice is for.

  - `data.bill_Name` (string,null)
    Name of the group or individual the Invoice is for

  - `data.bill_State` (string,null)
    State of the group or individual the Invoice is for

  - `data.bill_Zip_Code` (string,null)
    Zip Code of the group or individual the Invoice is for

  - `data.billing_Cycle_ID` (string,null)
    This is the Billing Cycle the invoice was gerenated for.

  - `data.billing_From` (string,null)
    First day of the Invoice period

  - `data.billing_Thru` (string,null)
    Last day of the Invoice period

  - `data.due_Date` (string,null)
    Due Date of the Invoice

  - `data.entry_Date` (string)
    Date record was first added to the system

  - `data.entry_User` (string,null)
    User that first added the record to the system

  - `data.finalized` (boolean, required)
    Finalized invoices cannot be changed Note: This field is marked as NOT NULL in the database and therefore required by the API.

  - `data.finalized_Date` (string,null)
    Date the Invoice was Finalized

  - `data.finalized_User` (string,null)
    User that Finalized the Invoice

  - `data.invoice_Date` (string,null)
    Date of the Invoice

  - `data.invoice_Level` (string,null)
    Level of the Invoice: Group, Division, or Subscriber

  - `data.invoice_Number` (string,null)
    Number assigned to this Invoice

  - `data.invoice_Status` (string,null)
    Status of the Invoice: Open or Closed

  - `data.original_Invoice_Key` (integer,null)
    Identifies the Invoice that this Invoice was created from

  - `data.pay_Period` (integer,null)
    This number represents sequence of the payroll from the beginning of the payroll year.

  - `data.update_Date` (string)
    Date the record was last updated in the system

  - `data.update_User` (string,null)
    User that last updated the record in the system

  - `error` (object)

  - `error.detail` (string,null)
    A human-readable explanation specific to this occurrence of the problem.

  - `error.instance` (string,null)
    A URI reference that identifies the specific occurrence of the problem.It may
or may not yield further information if dereferenced.

  - `error.status` (integer)
    The HTTP status code([RFC7231], Section 6) generated by the origin server for
this occurrence of the problem.

  - `error.title` (string,null)
    A short, human-readable summary of the problem type.It SHOULD NOT change from
occurrence to occurrence of the problem, except for purposes of localization(e.g.,
using proactive content negotiation; see[RFC7231], Section 3.4).

  - `error.type` (string,null)
    A URI reference [RFC3986] that identifies the problem type. This specification
encourages that, when dereferenced, it provide human-readable documentation for
the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member
is not present, its value is assumed to be "about:blank".

  - `debug` (object)

  - `debug.activityID` (string, required)


## Response 401 fields