Invoiceless is a serverless API for sending simple recurring invoices by email using AWS Lambda, API Gateway, CloudWatch Events, and SES.

0. Make sure you have the AWS CLI installed
1. Clone the repository
2. From the top level directory, run

aws cloudformation package --template-file template.yaml --s3-bucket [your s3 bucket] --output-template-file packaged.yaml

aws cloudformation deploy --template-file ./packaged.yaml --stack-name invoiceless --capabilities CAPABILITY_IAM

Sends an invoice immediately to the recipients specified in agreement_info.client_emails.

agreement_info.verified_sender_arn is optional and only needs to be specified if your AWS SES account is still on probation. You can verify the address in agreement_info.provider_email by following the steps from AWS here.

agreement_info.net specifies the number of days until the invoice is due. It can be any integer from 1 to 120.

headers = {'content-type': 'application/json'}
url = '[api URL]/invoices/'

body = {
  "agreement_info": {
    "net": 30,
    "client_emails": [
      "[email protected]",
      "
    ],
    "provider_email": "[email protected]",
    "verified_sender_arn": "arn:aws:ses:us-east-1:[account]:identity/[email protected]"
  },
  "client_info": {
    "client_id": "1001",
    "name": "My Client",
    "street": "1 Corporate Pkwy",
    "city": "Bigcity",
    "state": "TX",
    "country": "USA",
    "post_code": "01010"
  },
  "service_provider_info": {
    "name": "My Name",
    "street": "123 Main St",
    "city": "Anywhere",
    "state": "NY",
    "country": "USA",
    "post_code": "12345"
  },
  "line_items": [
    {
      "name": "Widgets",
      "description": "Default widgets",
      "units": 10,
      "unit_price": 125
    },
    {
      "name": "Customized Widgets",
      "description": "Reinforced widgets",
      "units": 10,
      "unit_price": 125
    }
  ]
}

requests.post(url, data=json.dumps(body), headers=headers)

This call creates a CloudWatch rule that sends your invoice on a recurring schedule that you specify.

The API request looks the same as the example above, except for the addition of a top-level body attribute called schedule_expression:

body = {
  "schedule_expression": "cron(0 12 25 * ? *)",
  "agreement_info": {
    ...

Refer to AWS's schedule expressions syntax guide for help creating your schedule.

The example above will send a recurring invoice on the 25th day of every month at 12:00 PM.

Removes the CloudWatch Events rule for the specified client ID. Note that Invoiceless only supports one recurring invoice per client at the moment.

Invoiceless uses PyInvoice to generate simple invoices that will be sent via email to the destination addresses you specify.