Invoice Template

OpenAPI Schema

The following schema is based on OpenAPI 3.0 and is provided in our downloadable OpenAPI document.

{
  "description": "An invoice template.",
  "properties": {
    "acceptedPaymentTypes": {
      "description": "An array of payment types this invoice template accepts.",
      "items": {
        "description": "A string identifying a specific payment type.",
        "enum": [
          "cash-check",
          "credit-card"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "brandTheme": {
      "$ref": "#/components/schemas/BrandTheme"
    },
    "brandThemeId": {
      "description": "The identifier for the brand theme this invoice template uses.",
      "type": "integer"
    },
    "created": {
      "description": "The creation date of this invoice.",
      "format": "date-time",
      "readOnly": true,
      "type": "string"
    },
    "currencyCode": {
      "description": "Identifies the currency represented in `price`.",
      "readOnly": true,
      "type": "string"
    },
    "currencySymbol": {
      "description": "The currency symbol for the currency used for this invoice template.",
      "readOnly": true,
      "type": "string"
    },
    "discounts": {
      "description": "An array of discounts applied to this invoice template.",
      "items": {
        "$ref": "#/components/schemas/InvoiceDiscount"
      },
      "maxItems": 1,
      "type": "array"
    },
    "emailAutomationGroupId": {
      "description": "The identifier for the email automation group this invoice template\nuses.",
      "nullable": true,
      "type": "integer"
    },
    "grandTotal": {
      "description": "The invoice template grand total.",
      "type": "number"
    },
    "id": {
      "description": "The identifier for this invoice template",
      "type": "integer"
    },
    "invoiceRetainerLabel": {
      "description": "This label represents how the studio wishes to refer to the initial\npayment represented by `retainerPercent` or `retainerFixedAmount` for this\ninvoice. This property is required if `retainerPercent` or\n`retainerFixedAmount` contain non-null values.\n\nThe following labels are available. You are responsible for displaying\nappropriate human-readable strings for these labels, translated for your\naudience.\n\n| ShootProof Identifier | Description |\n| --------------------- | ----------- |\n| `non-refundable-payment` | The initial payment should be referred to as a \"non-refundable payment\" when displaying the invoice to the studio's customer. |\n| `deposit` | The initial payment should be referred to as a \"deposit\" when displaying the invoice to the studio's customer. |\n| `retainer` | The initial payment should be referred to as a \"retainer\" when displaying the invoice to the studio's customer. |",
      "enum": [
        "non-refundable-payment",
        "deposit",
        "retainer"
      ],
      "nullable": true,
      "type": "string"
    },
    "items": {
      "description": "An array of line items for this invoice template.",
      "items": {
        "$ref": "#/components/schemas/InvoiceItem"
      },
      "type": "array"
    },
    "languageCode": {
      "description": "The Unicode CLDR language tag for the language used in this invoice\ntemplate.",
      "type": "string"
    },
    "links": {
      "$ref": "#/components/schemas/Links"
    },
    "name": {
      "description": "The name of this invoice template.",
      "type": "string"
    },
    "notesToClient": {
      "description": "Notes to display on the invoice for the client.",
      "type": "string"
    },
    "paymentConfirmationText": {
      "description": "A message sent to the client upon receipt of payment.",
      "type": "string"
    },
    "retainerFixedAmount": {
      "description": "Suggested fixed amount of retainer. If a retainer is defined, one of\n`retainerPercent` or `retainerFixedAmount` will be non-null.",
      "nullable": true,
      "type": "number"
    },
    "retainerPercent": {
      "description": "Suggested amount of retainer in a percentage from 1-100. If a\nretainer is defined, one of `retainerPercent` or\n`retainerFixedAmount` will be non-null.",
      "maximum": 100,
      "minimum": 1,
      "nullable": true,
      "type": "number"
    },
    "salesTaxPercent": {
      "description": "A decimal number from 0-100, specifying the sales tax percentage. Required\nif `salesTaxTitle` has a non-zero length value.",
      "maximum": 100,
      "minimum": 0,
      "type": "number"
    },
    "salesTaxTitle": {
      "description": "A label to apply to the sales tax percent on the invoice when viewed\nby the client. Required if `salesTaxPercent` has a non-zero length value.",
      "type": "string"
    },
    "salesTaxTotal": {
      "description": "The total amount of sales tax on the invoice template.",
      "type": "number"
    },
    "subtotal": {
      "description": "The invoice template subtotal.",
      "type": "number"
    },
    "taxableSubtotal": {
      "description": "The taxable subtotal of the invoice template, based on its taxable\nitems.",
      "type": "number"
    },
    "type": {
      "description": "The type of object represented.",
      "enum": [
        "invoice-template"
      ],
      "type": "string"
    }
  },
  "required": [
    "type",
    "name",
    "brandThemeId",
    "acceptedPaymentTypes",
    "languageCode",
    "items"
  ],
  "title": "Invoice Template",
  "type": "object"
}