Create Invoice

{
  "type": "object",
  "properties": {
    "balance": {
      "type": "number",
      "description": "Balance of invoice due."
    },
    "billing_address": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "description": "Name of city."
        },
        "contact_name": {
          "type": "string"
        },
        "country": {
          "type": "string",
          "description": "country code according to ISO 3166-1 alpha-2."
        },
        "county": {
          "type": "string",
          "description": "Address field that holds a sublocality, such as a county"
        },
        "email": {
          "type": "string"
        },
        "fax": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "latitude": {
          "type": "string"
        },
        "line1": {
          "type": "string",
          "description": "Line 1 of the address e.g. number, street, suite, apt #, etc."
        },
        "line2": {
          "type": "string",
          "description": "Line 2 of the address"
        },
        "line3": {
          "type": "string",
          "description": "Line 3 of the address"
        },
        "line4": {
          "type": "string",
          "description": "Line 4 of the address"
        },
        "longitude": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "phone_number": {
          "type": "string"
        },
        "postal_code": {
          "type": "string",
          "description": "Zip code or equivalent."
        },
        "row_version": {
          "type": "string",
          "description": "A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object."
        },
        "salutation": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "description": "Name of state"
        },
        "street_number": {
          "type": "string",
          "description": "Street number"
        },
        "string": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "primary",
            "secondary",
            "home",
            "office",
            "shipping",
            "billing",
            "other"
          ]
        },
        "website": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time when the object was created."
    },
    "created_by": {
      "type": "string",
      "description": "The user who created the object."
    },
    "currency": {
      "type": "string",
      "description": "Indicates the associated currency for an amount of money. Values correspond to [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).",
      "enum": [
        "UNKNOWN_CURRENCY",
        "AED",
        "AFN",
        "ALL",
        "AMD",
        "ANG",
        "AOA",
        "ARS",
        "AUD",
        "AWG",
        "AZN",
        "BAM",
        "BBD",
        "BDT",
        "BGN",
        "BHD",
        "BIF",
        "BMD",
        "BND",
        "BOB",
        "BOV",
        "BRL",
        "BSD",
        "BTN",
        "BWP",
        "BYR",
        "BZD",
        "CAD",
        "CDF",
        "CHE",
        "CHF",
        "CHW",
        "CLF",
        "CLP",
        "CNY",
        "COP",
        "COU",
        "CRC",
        "CUC",
        "CUP",
        "CVE",
        "CZK",
        "DJF",
        "DKK",
        "DOP",
        "DZD",
        "EGP",
        "ERN",
        "ETB",
        "EUR",
        "FJD",
        "FKP",
        "GBP",
        "GEL",
        "GHS",
        "GIP",
        "GMD",
        "GNF",
        "GTQ",
        "GYD",
        "HKD",
        "HNL",
        "HRK",
        "HTG",
        "HUF",
        "IDR",
        "ILS",
        "INR",
        "IQD",
        "IRR",
        "ISK",
        "JMD",
        "JOD",
        "JPY",
        "KES",
        "KGS",
        "KHR",
        "KMF",
        "KPW",
        "KRW",
        "KWD",
        "KYD",
        "KZT",
        "LAK",
        "LBP",
        "LKR",
        "LRD",
        "LSL",
        "LTL",
        "LVL",
        "LYD",
        "MAD",
        "MDL",
        "MGA",
        "MKD",
        "MMK",
        "MNT",
        "MOP",
        "MRO",
        "MUR",
        "MVR",
        "MWK",
        "MXN",
        "MXV",
        "MYR",
        "MZN",
        "NAD",
        "NGN",
        "NIO",
        "NOK",
        "NPR",
        "NZD",
        "OMR",
        "PAB",
        "PEN",
        "PGK",
        "PHP",
        "PKR",
        "PLN",
        "PYG",
        "QAR",
        "RON",
        "RSD",
        "RUB",
        "RWF",
        "SAR",
        "SBD",
        "SCR",
        "SDG",
        "SEK",
        "SGD",
        "SHP",
        "SLL",
        "SOS",
        "SRD",
        "SSP",
        "STD",
        "SVC",
        "SYP",
        "SZL",
        "THB",
        "TJS",
        "TMT",
        "TND",
        "TOP",
        "TRC",
        "TRY",
        "TTD",
        "TWD",
        "TZS",
        "UAH",
        "UGX",
        "USD",
        "USN",
        "USS",
        "UYI",
        "UYU",
        "UZS",
        "VEF",
        "VND",
        "VUV",
        "WST",
        "XAF",
        "XAG",
        "XAU",
        "XBA",
        "XBB",
        "XBC",
        "XBD",
        "XCD",
        "XDR",
        "XOF",
        "XPD",
        "XPF",
        "XPT",
        "XTS",
        "XXX",
        "YER",
        "ZAR",
        "ZMK",
        "ZMW",
        "BTC",
        "ETH"
      ]
    },
    "currency_rate": {
      "type": "number",
      "description": "Currency Exchange Rate at the time entity was recorded/generated."
    },
    "customer": {
      "type": "object",
      "description": "The customer this entity is linked to.",
      "required": [
        "id"
      ],
      "properties": {
        "company_name": {
          "type": "string",
          "description": "The company name of the customer."
        },
        "display_id": {
          "type": "string",
          "description": "The display ID of the customer."
        },
        "display_name": {
          "type": "string",
          "description": "The display name of the customer."
        },
        "id": {
          "type": "string",
          "description": "The ID of the customer this entity is linked to."
        },
        "name": {
          "type": "string",
          "description": "The name of the customer. Deprecated, use display_name instead."
        }
      }
    },
    "customer_memo": {
      "type": "string",
      "description": "Customer memo"
    },
    "deposit": {
      "type": "number",
      "description": "Amount of deposit made to this invoice."
    },
    "discount_amount": {
      "type": "number",
      "description": "Discount amount applied to this invoice."
    },
    "discount_percentage": {
      "type": "number",
      "description": "Discount percentage applied to this invoice."
    },
    "downstream_id": {
      "type": "string",
      "description": "The third-party API ID of original entity"
    },
    "due_date": {
      "type": "string",
      "format": "date",
      "description": "The invoice due date is the date on which a payment or invoice is scheduled to be received by the seller - YYYY-MM-DD."
    },
    "id": {
      "type": "string",
      "description": "A unique identifier for an object."
    },
    "invoice_date": {
      "type": "string",
      "format": "date",
      "description": "Date invoice was issued - YYYY-MM-DD."
    },
    "invoice_sent": {
      "type": "boolean",
      "description": "Invoice sent to contact/customer."
    },
    "line_items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "User defined item code"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when the object was created."
          },
          "created_by": {
            "type": "string",
            "description": "The user who created the object."
          },
          "department_id": {
            "type": "string",
            "description": "Department id"
          },
          "description": {
            "type": "string",
            "description": "User defined description"
          },
          "discount_amount": {
            "type": "number",
            "description": "Discount amount applied to the line item when supported downstream."
          },
          "discount_percentage": {
            "type": "number",
            "description": "Discount percentage applied to the line item when supported downstream."
          },
          "id": {
            "type": "string",
            "description": "A unique identifier for an object."
          },
          "item": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "User defined item code"
              },
              "id": {
                "type": "string",
                "description": "ID of the linked item. A reference to the [invoice item](https://developers.apideck.com/apis/accounting/reference#tag/Invoice-Items) that was used to create this line item"
              },
              "name": {
                "type": "string",
                "description": "User defined item name"
              }
            }
          },
          "ledger_account": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "The code assigned to the account."
              },
              "id": {
                "type": "string",
                "description": "The unique identifier for the account."
              },
              "name": {
                "type": "string",
                "description": "The name of the account."
              },
              "nominal_code": {
                "type": "string",
                "description": "The nominal code of the account."
              }
            }
          },
          "line_number": {
            "type": "integer",
            "description": "Line number in the invoice"
          },
          "location_id": {
            "type": "string",
            "description": "Location id"
          },
          "quantity": {
            "type": "number"
          },
          "row_id": {
            "type": "string",
            "description": "Row ID"
          },
          "row_version": {
            "type": "string",
            "description": "A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object."
          },
          "tax_amount": {
            "type": "number",
            "description": "Tax amount"
          },
          "tax_rate": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "Tax rate code"
              },
              "id": {
                "type": "string",
                "description": "The ID of the object."
              },
              "name": {
                "type": "string",
                "description": "Name of the tax rate"
              },
              "rate": {
                "type": "number",
                "description": "Rate of the tax rate"
              }
            }
          },
          "total_amount": {
            "type": "number",
            "description": "Total amount of the line item"
          },
          "type": {
            "type": "string",
            "description": "Item type",
            "enum": [
              "sales_item",
              "discount",
              "info",
              "sub_total"
            ]
          },
          "unit_of_measure": {
            "type": "string",
            "description": "Description of the unit type the item is sold as, ie: kg, hour."
          },
          "unit_price": {
            "type": "number"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when the object was last updated."
          },
          "updated_by": {
            "type": "string",
            "description": "The user who last updated the object."
          }
        },
        "additionalProperties": false
      }
    },
    "number": {
      "type": "string",
      "description": "Invoice number."
    },
    "po_number": {
      "type": "string",
      "description": "A PO Number uniquely identifies a purchase order and is generally defined by the buyer. The buyer will match the PO number in the invoice to the Purchase Order."
    },
    "raw": {
      "type": "boolean"
    },
    "reference": {
      "type": "string",
      "description": "Optional invoice reference."
    },
    "row_version": {
      "type": "string",
      "description": "A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object."
    },
    "shipping_address": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "description": "Name of city."
        },
        "contact_name": {
          "type": "string"
        },
        "country": {
          "type": "string",
          "description": "country code according to ISO 3166-1 alpha-2."
        },
        "county": {
          "type": "string",
          "description": "Address field that holds a sublocality, such as a county"
        },
        "email": {
          "type": "string"
        },
        "fax": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "latitude": {
          "type": "string"
        },
        "line1": {
          "type": "string",
          "description": "Line 1 of the address e.g. number, street, suite, apt #, etc."
        },
        "line2": {
          "type": "string",
          "description": "Line 2 of the address"
        },
        "line3": {
          "type": "string",
          "description": "Line 3 of the address"
        },
        "line4": {
          "type": "string",
          "description": "Line 4 of the address"
        },
        "longitude": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "phone_number": {
          "type": "string"
        },
        "postal_code": {
          "type": "string",
          "description": "Zip code or equivalent."
        },
        "row_version": {
          "type": "string",
          "description": "A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object."
        },
        "salutation": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "description": "Name of state"
        },
        "street_number": {
          "type": "string",
          "description": "Street number"
        },
        "string": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "primary",
            "secondary",
            "home",
            "office",
            "shipping",
            "billing",
            "other"
          ]
        },
        "website": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "source_document_url": {
      "type": "string",
      "description": "URL link to a source document - shown as 'Go to [appName]' in the downstream app. Currently only supported for Xero."
    },
    "status": {
      "type": "string",
      "description": "Invoice status",
      "enum": [
        "draft",
        "submitted",
        "authorised",
        "partially_paid",
        "paid",
        "void",
        "credit",
        "deleted"
      ]
    },
    "sub_total": {
      "type": "number",
      "description": "Sub-total amount, normally before tax."
    },
    "tax_code": {
      "type": "string",
      "description": "Applicable tax id/code override if tax is not supplied on a line item basis."
    },
    "tax_inclusive": {
      "type": "boolean",
      "description": "Amounts are including tax"
    },
    "template_id": {
      "type": "string",
      "description": "Optional invoice template"
    },
    "terms": {
      "type": "string",
      "description": "Terms of payment."
    },
    "total": {
      "type": "number",
      "description": "Total amount of invoice, including tax."
    },
    "total_tax": {
      "type": "number",
      "description": "Total tax amount applied to this invoice."
    },
    "type": {
      "type": "string",
      "description": "Invoice type",
      "enum": [
        "standard",
        "credit",
        "service",
        "product",
        "supplier",
        "other"
      ]
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time when the object was last updated."
    },
    "updated_by": {
      "type": "string",
      "description": "The user who last updated the object."
    },
    "x-apideck-app-id": {
      "type": "string"
    },
    "x-apideck-consumer-id": {
      "type": "string"
    },
    "x-apideck-service-id": {
      "type": "string"
    }
  },
  "required": [
    "x-apideck-app-id",
    "x-apideck-consumer-id"
  ],
  "additionalProperties": false
}