# Bundles

Source: https://developer.avalara.com/products/communications/integration-guides/communications-integration/nyk8825403889760/

Guide: Communications

# Bundles

Learn about bundles, their components, and how they are used in AFC transactions.

Product offerings by Telecommunication companies include grouping of services into a special price for competitive and/or other strategic reasons. The grouping of services is called “bundling.”

AFC handles these bundled products through the creation of a Bundle. Instead of creating a transaction with multiple line items, use a Bundle with one line item to easily apply a set group (bundle) of products. Taxes calculated for bundled transactions are calculated for each transaction/service defined within the bundle. Brackets and other logic is applied to the transaction as a whole rather than individual line items.

The Bundle is made up of:

-   Assigned Bundle Transaction and Service IDs to be used in an AFC transaction
    -   Sequential IDs (for example, 20000/20001 for the first bundle and 20000/20002 for the second bundle)
    -   Transaction ID and Service ID can’t be changed
-   Transaction/Service pairs
-   Percentage of the sale amount to apply to the particular Transaction/Service pair

There are no limits to the number of Transaction/Service pairs that can be included in a Bundle. Multiple bundles - up to 200 - can also be created in the same Bundle (each with their own unique Bundle ID). The percentages must total to 100%.

## Create a bundle

Bundles are created in the Communications Customer Portal. Information about how to add bundles is available in the [**Create a bundle**](https://knowledge.avalara.com/bundle/qvv1656594440497/page/Add_a_Bundle_Group_to_apply_separate_transaction_service_pairs_to_bundled_items.html) Knowledge Center article.

## Using a bundle

Bundles are applied to a client profile. Pass the associated `client_profile_id` as part of the header to use the Bundle.

Create a transaction using the Bundle Transaction ID and Bundle Service ID (`tran` is 20000 and `serv` is 20001, for this example) and specify the sale amount (`chg`).

**View example**:

```
{
  "cmpn": {
    "bscl": 0,
    "svcl": 0,
    "fclt": false,
    "frch": false,
    "reg": false
  },
  "inv": [
    {
      "bill": {
        "cnty": "Johnson",
        "ctry": "USA",
        "int": true,
        "geo": false,
        "city": "Overland Park",
        "st": "KS",
        "zip": "66212"
      },
      "cust": 0,
      "lfln": false,
      "date": "2018-12-01T12:00:00Z",
      "itms": [
        {
          "ref": "Line Item 001 - Bundle",
          "chg": 100,
          "sale": 1,
          "tran": 20000,
          "serv": 20001
        }
      ],
      "invm": true,
      "dtl": false,
      "summ": true
    }
  ]
} 
```

Note

Bundled tax calculations return detailed results (`txs`) when more than one bundle item returns the same tax type.