Appearance
UpsertInvoiceInput
Type: Input
Input for creating or updating an invoice
Fields
| Name | Type | Default | Description |
|---|---|---|---|
| attachments | [InvoiceFileAttachmentInput!] | Document attachments. When provided, replaces existing attachments on the invoice. | |
| billingAddressId | AddressID | Billing address ID | |
| contactId | ContactID | Contact person ID | |
| creditedInvoiceId | InvoiceID | ID of the invoice this credit note applies to | |
| currency | CurrencyISO! | Currency code (required) | |
| customerId | CustomerID! | Customer ID (required) | |
| dueDate | ISO8601 | Due date (ISO8601) | |
| id | InvoiceID | ID for update; omit for create | |
| internalNotes | String | Internal notes | |
| invoiceNumber | String! | Invoice number (required) | |
| issueDate | ISO8601! | Issue date (ISO8601) | |
| kind | InvoiceKind! | Type of invoice document (required) | |
| notes | String | Notes visible to the customer | |
| orderId | OrderID | Associated order ID | |
| paidAmount | Float | Amount paid so far | |
| paidAt | ISO8601 | Payment date (ISO8601) | |
| paymentMethod | String | Payment method | |
| paymentReference | String | Payment reference | |
| paymentTerms | String | Payment terms | |
| status | InvoiceStatus | Invoice status | |
| subtotalAmount | Float! | Subtotal amount before tax | |
| taxAmount | Float! | Tax amount | |
| taxRate | Float | Tax rate percentage | |
| totalAmount | Float! | Total amount including tax |