# PurchaseInvoiceById: Bouw7 Purchase Invoice by ID
Returns a single purchase invoice based on the given ID.
Returns a single purchase invoice based on the given ID.
- Catalog: `Bouw7`
- Schema: `PurchaseInvoicing`
- Label: Purchase Invoice by ID
This is a read-only table function. The Bouw7 API may not support changing the data or the Invantive UniversalSQL driver for Bouw7 does not cover it. In the latter case, please use the table NativePlatformScalarRequests to upload data to the Bouw7 API.
## Parameters of Table Function
The following parameters can be used to control the behaviour of the table function `PurchaseInvoiceById`. A value must be provided at all times for required parameters, but optional parameters in general do not need to have a value and the execution will default to a pre-defined behaviour. Values can be specified by position and by name. In both cases, all parameters not specified will be evaluated using their default values.
Value specification by position is done by listing all values from the first to the last needed value. For example: a `select * from table(value1, value2, value3)` on a table with four parameters will use the default value for the fourth parameter and the specified values for the first three.
Value specification by name is done by listing all values that require a value. For example with `select * from table(name1 => value1, name3 => value3)` on the same table will use the default values for the second and fourth parameters and the specified values for the first and third.
| Name | Data Type | Required | Default Value | Documentation |
|---|:---:|:---:|:---:|---|
| `id` | `` | ☑ | | |
## Columns of Table Function
The columns of the table function `PurchaseInvoiceById` are shown below. Each column has an SQL data type.
| Name | Data Type | Label | Required | Documentation |
|---|:---:|---|:---:|---|
| `approval_canApprove` | `char` | | ☐ | Whether or not the current authenticated user can approve the approval. |
| `approval_createdAt` | `datetime` | | ☐ | The creation time of the entity. |
| `approval_createdBy` | `varchar2` | | ☐ | The user that created the entity. |
| `approval_currentApprover_approvalDate` | `datetime` | | ☐ | The date at which the approver denied/approved the approval. |
| `approval_currentApprover_approvalStatus` | `int64` | | ☐ | The approval status of this approver. |
| `approval_currentApprover_comment` | `varchar2` | | ☐ | Comment left by the approver. Can be null. |
| `approval_currentApprover_createdAt` | `datetime` | | ☐ | The creation time of the entity. |
| `approval_currentApprover_createdBy` | `varchar2` | | ☐ | The user that created the entity. |
| `approval_currentApprover_id` | `int64` | | ☐ | ID of the approver. |
| `approval_currentApprover_index` | `int64` | | ☐ | Current index of the approver. |
| `approval_currentApprover_updatedAt` | `datetime` | | ☐ | The last updated time of the entity. |
| `approval_currentApprover_updatedBy` | `varchar2` | | ☐ | The user that last updated the entity. |
| `approval_currentIndex` | `int64` | | ☐ | The current index of the approver which turn it is to vote on the approval. |
| `approval_id` | `int64` | | ☐ | ID of the approval. |
| `approval_isApproved` | `char` | | ☐ | Whether or not the approval has been approved. |
| `approval_lastActionDate` | `datetime` | | ☐ | Date of the last action done to this approval. Will be null when no action has been made. |
| `approval_updatedAt` | `datetime` | | ☐ | The last updated time of the entity. |
| `approval_updatedBy` | `varchar2` | | ☐ | The user that last updated the entity. |
| `approval_workflowId` | `int64` | | ☐ | The workflow that this approval is based of. |
| `bookNumber` | `int64` | Book Number | ☐ | The booknumber of the purchase invoice. |
| `branch_code` | `varchar2` | Branch Code | ☐ | The code for this branch |
| `branch_division_description` | `varchar2` | | ☐ | The description of the division. |
| `branch_division_exactDivisionId` | `varchar2` | | ☐ | The division ID of an Exact Online environment. |
| `branch_division_glAccountCode` | `varchar2` | | ☐ | A default general ledger account code to use for sales related items. |
| `branch_division_glAccountCodePurchase` | `varchar2` | | ☐ | A default general ledger account code to use for purchase related items. |
| `branch_division_id` | `int64` | | ☐ | The ID of the division. |
| `branch_division_journalCode` | `varchar2` | | ☐ | A default journal code to use for sales related items. |
| `branch_division_journalCodePurchase` | `varchar2` | | ☐ | A default journal code to use for purchase related items. |
| `branch_division_salesInvoiceNumberPrefix` | `varchar2`(3) | | ☐ | The prefix (3 digits) used to generate invoice number range per division. |
| `branch_id` | `int64` | Branch ID | ☐ | The ID of the branch. |
| `branch_name` | `varchar2` | Branch Name | ☐ | The name of this branch |
| `canBeDeleted` | `char` | Can Be Deleted | ☐ | Whether the invoice can be deleted. |
| `canBookToExact` | `char` | Can Book to Exact | ☐ | Whether it is allowed to book to Exact. |
| `canBookToTwinfield` | `char` | Can Book to Twinfield | ☐ | Whether it is allowed to book to Twinfield. |
| `canUseCostCenter` | `char` | Can Use Cost Centre | ☐ | True if the user can use cost center functionality. |
| `chainLiabilityDocumentExpirationDate` | `datetime` | Chain Liability Document Expiration Date | ☐ | The newest expiration date of the chain liability document(s) associated with the contact, in ATOM format. |
| `comments` | `varchar2` | Comments | ☐ | Comment associated with the purchase invoice. |
| `contact_contactType_id` | `int64` | Contact Contact Type ID | ☐ | The ID of contact type. |
| `contact_contactType_name` | `varchar2` | Contact Contact Type Name | ☐ | The name of contact type. |
| `contact_email` | `varchar2` | Contact Email | ☐ | The email address. |
| `contact_id` | `int64` | Contact ID | ☐ | ID of contact. |
| `contact_isVatShifted` | `char` | Contact Is VAT Shifted | ☐ | Whether VAT is shifted for the contact. |
| `contact_name` | `varchar2` | Contact Name | ☐ | Name of contact. |
| `contact_phoneNumber` | `varchar2` | Contact Phone Number | ☐ | The phone number of the contact. |
| `createdAt` | `datetime` | Created at | ☐ | The creation time of the entity. |
| `createdBy` | `varchar2` | Created by | ☐ | The user that created the entity. |
| `createDeliveryTicket` | `char` | Create Delivery Ticket | ☐ | Whether or not to create a delivery ticket. |
| `createDeliveryTicketForRemainingCosts` | `char` | Create Delivery Ticket for Remaining Costs | ☐ | Whether or not to create a delivery ticket for the remaining costs. |
| `date` | `datetime` | Date | ☐ | Purchase invoice date. |
| `datePaid` | `varchar2` | Date Paid | ☐ | Purchase invoice paid date. |
| `deliveryTicket_cost` | `varchar2` | Delivery Ticket Cost | ☐ | The costs for this delivery ticket. |
| `deliveryTicket_id` | `int64` | Delivery Ticket ID | ☐ | The ID of delivery ticket. |
| `deliveryTicket_initialCost` | `varchar2` | Delivery Ticket Initial Cost | ☐ | The initial costs for this delivery ticket. |
| `deliveryTicket_processed` | `char` | Delivery Ticket Processed | ☐ | Whether the delivery ticket has been processed. |
| `deliveryTicket_ticketDate` | `datetime` | Delivery Ticket Ticket Date | ☐ | The date for which the delivery ticket were logged. |
| `deliveryTicket_ticketNumber` | `varchar2` | Delivery Ticket Ticket Number | ☐ | Ticket number of delivery ticket. |
| `division_description` | `varchar2` | Division Description | ☐ | The description of the division. |
| `division_exactDivisionId` | `varchar2` | Division Exact Division ID | ☐ | The division ID of an Exact Online environment. |
| `division_glAccountCode` | `varchar2` | Division General Ledger Account Code | ☐ | A default general ledger account code to use for sales related items. |
| `division_glAccountCodePurchase` | `varchar2` | Division General Ledger Account Code Purchase | ☐ | A default general ledger account code to use for purchase related items. |
| `division_id` | `int64` | Division ID | ☐ | The ID of the division. |
| `division_journalCode` | `varchar2` | Division Journal Code | ☐ | A default journal code to use for sales related items. |
| `division_journalCodePurchase` | `varchar2` | Division Journal Code Purchase | ☐ | A default journal code to use for purchase related items. |
| `division_salesInvoiceNumberPrefix` | `varchar2`(3) | Division Sales Invoice Number Prefix | ☐ | The prefix (3 digits) used to generate invoice number range per division. |
| `dueDate` | `datetime` | Due Date | ☐ | Purchase invoice due date. |
| `exactFinancialPeriod_endDate` | `datetime` | | ☐ | The end date of the exact financial period in Y-m-d format. |
| `exactFinancialPeriod_financialPeriod` | `int64` | | ☐ | The period of the exact financial period. |
| `exactFinancialPeriod_financialYear` | `int64` | | ☐ | The year of the exact financial period. |
| `exactFinancialPeriod_id` | `int64` | | ☐ | The ID of the exact financial period. |
| `exactFinancialPeriod_startDate` | `datetime` | | ☐ | The start date of the exact financial period in Y-m-d format. |
| `exactPaymentCondition` | `varchar2`(255) | Exact Payment Condition | ☐ | The code of the Exact Online payment condition for this purchase invoice. |
| `file_createdAt` | `datetime` | File Created at | ☐ | The creation time of the entity. |
| `file_createdBy` | `varchar2` | File Created by | ☐ | The user that created the entity. |
| `file_extension` | `varchar2` | File Extension | ☐ | The extension of the file. |
| `file_id` | `int64` | File ID | ☐ | The ID of this file |
| `file_modelId` | `int64` | File Model ID | ☐ | The ID of the associated type. |
| `file_modelType` | `varchar2` | File Model Type | ☐ | The category of the file. |
| `file_name` | `varchar2` | File Name | ☐ | The public name of the file. |
| `file_secureHash` | `varchar2` | | ☐ | A secure random hash for the file, that can be used for retrieving thumbnails without additional authentication. |
| `file_size` | `int64` | File Size | ☐ | The size of the file in bytes. |
| `file_updatedAt` | `datetime` | File Updated at | ☐ | The last updated time of the entity. |
| `file_updatedBy` | `varchar2` | File Updated by | ☐ | The user that last updated the entity. |
| `file_uri` | `varchar2` | File URI | ☐ | The URI of the file, used to fetch the contents. |
| `fromBasecone` | `char` | From Basecone | ☐ | Whether the invoice is imported from Basecone. |
| `gAccountAmount` | `varchar2` | G-Account Amount | ☐ | The g account amount of the purchase invoice. |
| `id` | `int64` | ID | ☐ | The ID of purchase invoice. |
| `invoiceNumber` | `varchar2` | Invoice Number | ☐ | The invoice number of purchase invoice. |
| `isBooked` | `char` | Is Booked | ☐ | Whether the invoice is already booked. |
| `isMutable` | `char` | | ☐ | Whether the purchase invoice is mutable. |
| `nextPurchaseInvoiceId` | `int64` | Next Purchase Invoice ID | ☐ | The ID of the next purchase invoice starting from this purchase invoice. Null when no next purchase invoice available. |
| `orderNumber` | `varchar2` | Order Number | ☐ | The order number of the purchase invoice. |
| `paymentReference` | `varchar2` | Payment Reference | ☐ | The payment reference of the purchase invoice. |
| `previousPurchaseInvoiceId` | `int64` | Previous Purchase Invoice ID | ☐ | The ID of the previous purchase invoice starting from this purchase invoice. Null when no previous purchase invoice available. |
| `project_branch_code` | `varchar2` | | ☐ | The code for this branch |
| `project_branch_id` | `int64` | | ☐ | The ID of the branch. |
| `project_branch_name` | `varchar2` | | ☐ | The name of this branch |
| `project_category_code` | `varchar2` | | ☐ | The code for the category. |
| `project_category_createdAt` | `datetime` | | ☐ | The creation time of the entity. |
| `project_category_createdBy` | `varchar2` | | ☐ | The user that created the entity. |
| `project_category_generalCostsOrProfit` | `varchar2` | | ☐ | The general costs or profit for the category. |
| `project_category_generalCostsPercentage` | `varchar2` | | ☐ | The general costs percentage for the category. |
| `project_category_grossProfitMargin` | `varchar2` | | ☐ | The gross profit margin for the category. |
| `project_category_id` | `int64` | | ☐ | The ID of the category. |
| `project_category_name` | `varchar2` | | ☐ | The name of the category. |
| `project_category_updatedAt` | `datetime` | | ☐ | The last updated time of the entity. |
| `project_category_updatedBy` | `varchar2` | | ☐ | The user that last updated the entity. |
| `project_city` | `varchar2` | Project City | ☐ | The city of the project. |
| `project_contact_email` | `varchar2` | Project Contact Email | ☐ | The email address. |
| `project_contact_id` | `int64` | Project Contact ID | ☐ | ID of contact. |
| `project_contact_isVatShifted` | `char` | | ☐ | Whether VAT is shifted for the contact. |
| `project_contact_name` | `varchar2` | Project Contact Name | ☐ | Name of contact. |
| `project_contact_phoneNumber` | `varchar2` | | ☐ | The phone number of the contact. |
| `project_createdAt` | `datetime` | Project Created at | ☐ | The creation time of the entity. |
| `project_createdBy` | `varchar2` | Project Created by | ☐ | The user that created the entity. |
| `project_deliveryDate` | `datetime` | Project Delivery Date | ☐ | Delivery date for the project. |
| `project_endDate` | `datetime` | Project End Date | ☐ | End date for the project. |
| `project_fullProjectNumber` | `varchar2` | Project Full Project Number | ☐ | The full project number including year. |
| `project_houseNumber` | `varchar2` | Project House Number | ☐ | The house number for the project. |
| `project_id` | `int64` | Project ID | ☐ | The ID of the project. |
| `project_information` | `varchar2` | Project Information | ☐ | The information of the project. |
| `project_name` | `varchar2` | Project Name | ☐ | The name of the project. |
| `project_projectNumber` | `varchar2` | Project Project Number | ☐ | The project number. |
| `project_reference` | `varchar2` | Project Reference | ☐ | The reference of the project. |
| `project_startDate` | `datetime` | Project Start Date | ☐ | Start date for the project. |
| `project_status_closesProject` | `char` | Project Status Closes Project | ☐ | Whether or not this status closes a project. |
| `project_status_createdAt` | `datetime` | Project Status Created at | ☐ | The creation time of the entity. |
| `project_status_createdBy` | `varchar2` | Project Status Created by | ☐ | The user that created the entity. |
| `project_status_id` | `int64` | Project Status ID | ☐ | The ID of the status. |
| `project_status_invoicesProject` | `char` | Project Status Invoices Project | ☐ | Whether or not this status invoices a project. |
| `project_status_name` | `varchar2` | Project Status Name | ☐ | The name of the status. |
| `project_status_plansProject` | `char` | Project Status Plans Project | ☐ | Whether or not this status plans a project. |
| `project_status_updatedAt` | `datetime` | Project Status Updated at | ☐ | The last updated time of the entity. |
| `project_status_updatedBy` | `varchar2` | Project Status Updated by | ☐ | The user that last updated the entity. |
| `project_streetName` | `varchar2` | Project Street Name | ☐ | The street name for the project. |
| `project_updatedAt` | `datetime` | Project Updated at | ☐ | The last updated time of the entity. |
| `project_updatedBy` | `varchar2` | Project Updated by | ☐ | The user that last updated the entity. |
| `project_zipCode` | `varchar2` | Project ZIP Code | ☐ | The zip code for the project. |
| `status` | `int64` | Status | ☐ | Status of the purchase invoice. |
| `updatedAt` | `datetime` | Updated At | ☐ | The last updated time of the entity. |
| `updatedBy` | `varchar2` | Updated by | ☐ | The user that last updated the entity. |