Input Data Reference



Payer information represents the details of the entity that is receiving an invoice or quote. Unlike line item data, payer data is completely freeform and is passed unmodified to templates by the invoice generator. This means the information schema for payer data is prescribed entirely by the template, providing users with the freedom to incorporate any type of payer information they like when writing templates.

Unlike payee data, there are no special circumstances under which the invoice generator will inspect the contents of payer data and transform it.

Data format

When using this interface: Use this data format:
Command-line interface YAML file
Python API Mapping[str, Any]
gRPC Microservice (coming soon)


Note: the examples provided below follow the information schema prescribed by the default template that ships with the command-line interface for gen-invoice. Your own payer data may look very different if your template prescribes a different schema.

Example YAML file for use with the command-line interface:

name: XYZ Widget Company
  - 1 Widget Road
  - Widgetville
  - WID 9999

due: Within 30 days of receipt

Example data for use with the API:

  "name": "XYZ Widget Company",
  "address": [
    "1 Widget Road",
    "WID 9999"
  "due": "Within 30 days of receipt"