From 17af61d8dbc32ea15ff41a96f5c1627de1dbbd72 Mon Sep 17 00:00:00 2001 From: Danny van der Sluijs Date: Tue, 9 Apr 2024 10:10:35 +0200 Subject: [PATCH] feat: Update to documentation d.d. 09-04-2024 --- .../Financials/Exact/AcceptQuotation.php | 2 +- src/Picqer/Financials/Exact/Account.php | 4 + .../Financials/Exact/DirectDebitMandate.php | 4 + .../Exact/EmailWithSignOffQuotation.php | 4 +- src/Picqer/Financials/Exact/Employment.php | 4 +- .../Exact/EmploymentOrganization.php | 8 +- .../Financials/Exact/EmploymentSalary.php | 28 +++- .../Exact/EmploymentTaxAuthoritiesGeneral.php | 4 +- .../Exact/ProjectTimeTransaction.php | 2 +- .../Financials/Exact/StockSerialNumber.php | 2 +- src/Picqer/Financials/Exact/SyncAccount.php | 4 + .../Financials/Exact/SyncBankAccount.php | 53 +++++++ src/Picqer/Financials/Exact/SyncDeleted.php | 2 +- src/Picqer/Financials/Exact/SyncEmployee.php | 149 ++++++++++++++++++ .../Financials/Exact/SyncEmployment.php | 61 +++++++ .../Financials/Exact/SyncEmploymentCLA.php | 57 +++++++ .../Exact/SyncEmploymentContract.php | 77 +++++++++ .../Exact/SyncEmploymentOrganization.php | 73 +++++++++ .../Financials/Exact/SyncEmploymentSalary.php | 107 +++++++++++++ .../SyncEmploymentTaxAuthoritiesGeneral.php | 69 ++++++++ .../Financials/Exact/SyncPurchaseOrder.php | 2 +- 21 files changed, 698 insertions(+), 18 deletions(-) create mode 100644 src/Picqer/Financials/Exact/SyncBankAccount.php create mode 100644 src/Picqer/Financials/Exact/SyncEmployee.php create mode 100644 src/Picqer/Financials/Exact/SyncEmployment.php create mode 100644 src/Picqer/Financials/Exact/SyncEmploymentCLA.php create mode 100644 src/Picqer/Financials/Exact/SyncEmploymentContract.php create mode 100644 src/Picqer/Financials/Exact/SyncEmploymentOrganization.php create mode 100644 src/Picqer/Financials/Exact/SyncEmploymentSalary.php create mode 100644 src/Picqer/Financials/Exact/SyncEmploymentTaxAuthoritiesGeneral.php diff --git a/src/Picqer/Financials/Exact/AcceptQuotation.php b/src/Picqer/Financials/Exact/AcceptQuotation.php index cd5bfcdd..4db43e74 100644 --- a/src/Picqer/Financials/Exact/AcceptQuotation.php +++ b/src/Picqer/Financials/Exact/AcceptQuotation.php @@ -8,7 +8,7 @@ * @see https://start.exactonline.nl/docs/HlpRestAPIResourcesDetails.aspx?name=CRMAcceptQuotation * * @property string $QuotationID Identifier of the quotation. - * @property int $Action 0 = No action (Default), 1 = create sales order, 2 = create sales invoice, 3 = create project, 4 = add to existing project, 5 = create subscription, 99 = follow email with sign off action. + * @property int $Action 0 = No action (Default), 1 = create sales order, 2 = create sales invoice, 3 = create project, 4 = add to existing project, 5 = create subscription, 99 = follow email with sign off action. For CRM standalone: Code 99 only applicable for quotation with status '60 - Awaiting online acceptance'. * @property string $AddToExistingProjectSuccess Contains information if the quotation was successfully added to existing project. * @property bool $CreateItemPriceAgreement Create a project item price agreement. Only needed when Action = 3 or Action = 4. Default = True. * @property bool $CreateProjectWBS Create a project work breakdown structure. Only needed when ProjectBudgetType = 2. diff --git a/src/Picqer/Financials/Exact/Account.php b/src/Picqer/Financials/Exact/Account.php index e8a9218a..cca420a5 100644 --- a/src/Picqer/Financials/Exact/Account.php +++ b/src/Picqer/Financials/Exact/Account.php @@ -113,6 +113,8 @@ * @property string $PaymentConditionPurchaseDescription Description of PaymentConditionPurchase * @property string $PaymentConditionSales Code of default payment condition for sales * @property string $PaymentConditionSalesDescription Description of PaymentConditionSales + * @property string $PeppolIdentifier Peppol identifier user entered manually, corresponds to picked peppol adress + * @property int $PeppolIdentifierType Peppol identifier type that user picked manually - GLN, COC, etc * @property string $Phone Phone number * @property string $PhoneExtension Phone number extention * @property string $Postcode Visit address postcode @@ -261,6 +263,8 @@ class Account extends Model 'PaymentConditionPurchaseDescription', 'PaymentConditionSales', 'PaymentConditionSalesDescription', + 'PeppolIdentifier', + 'PeppolIdentifierType', 'Phone', 'PhoneExtension', 'Postcode', diff --git a/src/Picqer/Financials/Exact/DirectDebitMandate.php b/src/Picqer/Financials/Exact/DirectDebitMandate.php index 3cae2925..1401091c 100644 --- a/src/Picqer/Financials/Exact/DirectDebitMandate.php +++ b/src/Picqer/Financials/Exact/DirectDebitMandate.php @@ -9,6 +9,8 @@ * * @property string $ID Primary key * @property string $Account Account to which the mandate belongs. + * @property string $Attachment Contain attachment (Format: Base64 encoded) of the mandate belongs. Binaries are not sent in the response. + * @property string $AttachmentFileName Filename of the attachment to which the mandate belongs. * @property string $BankAccount Bank account to which the mandate belongs. * @property string $CancellationDate Date that the mandate is cancelled. Used to check the validity of the mandate. * @property string $Created Creation date @@ -34,6 +36,8 @@ class DirectDebitMandate extends Model protected $fillable = [ 'ID', 'Account', + 'Attachment', + 'AttachmentFileName', 'BankAccount', 'CancellationDate', 'Created', diff --git a/src/Picqer/Financials/Exact/EmailWithSignOffQuotation.php b/src/Picqer/Financials/Exact/EmailWithSignOffQuotation.php index ec56c210..fec20ba1 100644 --- a/src/Picqer/Financials/Exact/EmailWithSignOffQuotation.php +++ b/src/Picqer/Financials/Exact/EmailWithSignOffQuotation.php @@ -10,7 +10,7 @@ * @property string $QuotationID Identifier of the quotation. * @property string $AcceptEmailLayout If you enter for this field, your customer receives an email with the quotation after approval of the quotation. * @property string $AcceptOpportunityStage The stage of the opportunity after approval of the quotation. - * @property int $Action 0 = No action (Default), 1 = create sales order, 2 = create sales invoice, 3 = create project, 4 = add to existing project, 5 = create subscription + * @property int $Action 0 = No action (Default), 1 = create sales order, 2 = create sales invoice, 3 = create project, 4 = add to existing project, 5 = create subscription. For CRM standalone: If the value is not provided, the default value will set to '2 - create sales invoice'. If the value is provided, the value must be '2 - create sales invoice'. Otherwise, the error message will be thrown. * @property bool $AllowProvideYourRef Allow customers to enter their purchase order number. * @property bool $CreateItemPriceAgreement Create a project item price agreement. Only needed when Action = 3 or Action = 4. Default = True. * @property bool $CreateProjectWBS Create a project work breakdown structure. Only needed when ProjectBudgetType = 2. @@ -19,7 +19,7 @@ * @property string $EmailLayout Based on this layout the email text is produced. * @property string $ErrorMessage Contains the error message if an error occurred during the creation of the Email. * @property string $ExtraText Extra text that can be added to the printed document and email. - * @property string $InvoiceJournal The journal in which the sales invoice will be booked. Mandatory for Action = 2. + * @property string $InvoiceJournal The journal in which the sales invoice will be booked. Mandatory for Action = 2. For CRM standalone: If the value is not provided, the default value will set to 'sales journal'. If the value is provided, the value must be 'sales journal'. Otherwise, the error message will be thrown. * @property int $ProjectBudgetType The budget type of the project that will be created. 0 = None (Default), 1 = Hours per hour type, 2 = Work breakdown structure (WBS). * @property string $ProjectClassification The ID of the project classification. * @property string $ProjectCode The code of the project that will be created. Mandatory for Action = 3. diff --git a/src/Picqer/Financials/Exact/Employment.php b/src/Picqer/Financials/Exact/Employment.php index 1988666f..aece7d05 100644 --- a/src/Picqer/Financials/Exact/Employment.php +++ b/src/Picqer/Financials/Exact/Employment.php @@ -15,8 +15,8 @@ * @property string $Employee Employee ID * @property string $EmployeeFullName Name of employee * @property int $EmployeeHID Numeric number of Employee + * @property int $EmploymentNumber Employment number * @property string $EndDate End date of employment - * @property int $HID Numeric ID of the employment * @property string $Modified Last modified date * @property string $Modifier User ID of modifier * @property string $ModifierFullName Name of modifier @@ -40,8 +40,8 @@ class Employment extends Model 'Employee', 'EmployeeFullName', 'EmployeeHID', + 'EmploymentNumber', 'EndDate', - 'HID', 'Modified', 'Modifier', 'ModifierFullName', diff --git a/src/Picqer/Financials/Exact/EmploymentOrganization.php b/src/Picqer/Financials/Exact/EmploymentOrganization.php index 6e032bc4..2d8b052f 100644 --- a/src/Picqer/Financials/Exact/EmploymentOrganization.php +++ b/src/Picqer/Financials/Exact/EmploymentOrganization.php @@ -22,8 +22,8 @@ * @property string $Employee ID of employee * @property string $EmployeeFullName Name of employee * @property int $EmployeeHID Numeric ID of the employee - * @property string $Employment Employement ID - * @property int $EmploymentHID Numeric ID of the employment + * @property string $Employment Employment ID + * @property int $EmploymentNumber Employment number * @property string $EndDate Organization end date * @property string $JobTitle ID of job title * @property string $JobTitleCode Job title code @@ -31,7 +31,6 @@ * @property string $Modified Last modified date * @property string $Modifier User ID of modifier * @property string $ModifierFullName Name of modifier - * @property string $Notes Explanation or extra information can be stored in the notes * @property string $StartDate Organization start date */ class EmploymentOrganization extends Model @@ -55,7 +54,7 @@ class EmploymentOrganization extends Model 'EmployeeFullName', 'EmployeeHID', 'Employment', - 'EmploymentHID', + 'EmploymentNumber', 'EndDate', 'JobTitle', 'JobTitleCode', @@ -63,7 +62,6 @@ class EmploymentOrganization extends Model 'Modified', 'Modifier', 'ModifierFullName', - 'Notes', 'StartDate', ]; diff --git a/src/Picqer/Financials/Exact/EmploymentSalary.php b/src/Picqer/Financials/Exact/EmploymentSalary.php index 44b37577..3dd364a3 100644 --- a/src/Picqer/Financials/Exact/EmploymentSalary.php +++ b/src/Picqer/Financials/Exact/EmploymentSalary.php @@ -8,23 +8,30 @@ * @see https://start.exactonline.nl/docs/HlpRestAPIResourcesDetails.aspx?name=PayrollEmploymentSalaries * * @property string $ID Primary key + * @property int $AmountType Salary Section: Salary typeValue: 0 - Gross, 1 - Net. + * @property string $AmountTypeDescription Salary Section: Salary type descriptionWhen AmountType value is 0, return 'Gross'When AmountType value 1, return 'Net' * @property float $AverageDaysPerWeek The average number of contract days that an employee works per week * @property float $AverageHoursPerWeek The average number of contract hours that an employee works per week + * @property float $BillabilityTarget Schedule Section: Billability target * @property string $Created Creation date * @property string $Creator User ID of creator * @property string $CreatorFullName Name of creator + * @property string $Description General section: Custom description * @property int $Division Division code * @property string $Employee Employee ID * @property string $EmployeeFullName Name of employee * @property int $EmployeeHID Employee number * @property string $Employment Employment - * @property int $EmploymentHID Employment number + * @property int $EmploymentNumber Employment number * @property int $EmploymentSalaryType Salary type of employment. 1 - Periodical (fixed), 2 - Per hour (variable) * @property string $EmploymentSalaryTypeDescription Salary type description * @property string $EndDate Salary record end date + * @property float $ExternalRate Rate Section: External rate * @property int $Frequency Frequency: 1 - Yearly, 2 - Quarterly, 3 - Monthly, 4 - 4-weekly, 5 - Weekly, 11 - Yearly (Pro forma), 12 - Quarterly (Pro forma), 13 - Monthly (Pro forma), 14 - 4-Weekly (Pro forma), 15 - Weekly (Pro forma) + * @property string $FrequencyDescription Payroll period frequency description * @property float $FulltimeAmount Salary when working fulltime * @property float $HourlyWage Hourly wage + * @property float $IntercompanyRate Rate Section: Intercompany rate * @property float $InternalRate Internal rate for time & billing or professional service user * @property int $JobLevel Employee job level in context of a wage scale * @property string $Modified Last modified date @@ -32,11 +39,16 @@ * @property string $ModifierFullName Name of modifier * @property float $ParttimeAmount Salary when working parttime * @property float $ParttimeFactor Contract hours / Fulltime contract hours + * @property int $SalaryBasedType Salary Section: Salary based on.Value: 0 - Manual entry, 1 - Wagescale, 2 - Minimum wage, 3 - Minimum hourly wage + * @property string $SalaryBasedTypeDescription When SalaryBasedType value is 0, return 'Manual entry'When SalaryBasedType value 1, return 'Wage scale'When SalaryBasedType value 2, return 'Minimum wage'When SalaryBasedType value 3, return 'Minimum hourly wage' * @property string $Scale Employee wage scale * @property string $Schedule Employment schedule * @property string $ScheduleCode Employment schedule code * @property string $ScheduleDescription Description of employment schedule * @property string $StartDate Salary record start date + * @property string $WageScale Salary Section: Wagescale ID + * @property int $WageScalePeriod Salary Section: Period for automatic step increase + * @property string $WageScaleStep Salary Section: Wagescale Step Code */ class EmploymentSalary extends Model { @@ -44,23 +56,30 @@ class EmploymentSalary extends Model protected $fillable = [ 'ID', + 'AmountType', + 'AmountTypeDescription', 'AverageDaysPerWeek', 'AverageHoursPerWeek', + 'BillabilityTarget', 'Created', 'Creator', 'CreatorFullName', + 'Description', 'Division', 'Employee', 'EmployeeFullName', 'EmployeeHID', 'Employment', - 'EmploymentHID', + 'EmploymentNumber', 'EmploymentSalaryType', 'EmploymentSalaryTypeDescription', 'EndDate', + 'ExternalRate', 'Frequency', + 'FrequencyDescription', 'FulltimeAmount', 'HourlyWage', + 'IntercompanyRate', 'InternalRate', 'JobLevel', 'Modified', @@ -68,11 +87,16 @@ class EmploymentSalary extends Model 'ModifierFullName', 'ParttimeAmount', 'ParttimeFactor', + 'SalaryBasedType', + 'SalaryBasedTypeDescription', 'Scale', 'Schedule', 'ScheduleCode', 'ScheduleDescription', 'StartDate', + 'WageScale', + 'WageScalePeriod', + 'WageScaleStep', ]; protected $url = 'payroll/EmploymentSalaries'; diff --git a/src/Picqer/Financials/Exact/EmploymentTaxAuthoritiesGeneral.php b/src/Picqer/Financials/Exact/EmploymentTaxAuthoritiesGeneral.php index c1d506a4..d77d59f5 100644 --- a/src/Picqer/Financials/Exact/EmploymentTaxAuthoritiesGeneral.php +++ b/src/Picqer/Financials/Exact/EmploymentTaxAuthoritiesGeneral.php @@ -17,7 +17,7 @@ * @property string $EmployeeFullName Name of employee * @property int $EmployeeHID Employee number * @property string $Employment Employment - * @property int $EmploymentHID Employment number + * @property int $EmploymentNumber Employment number * @property string $EndDate End date of employment agencies * @property string $InfluenceInsuranceObligation Influence insurance obligation * @property string $InfluenceInsuranceObligationDescription Influence insurance obligation description @@ -46,7 +46,7 @@ class EmploymentTaxAuthoritiesGeneral extends Model 'EmployeeFullName', 'EmployeeHID', 'Employment', - 'EmploymentHID', + 'EmploymentNumber', 'EndDate', 'InfluenceInsuranceObligation', 'InfluenceInsuranceObligationDescription', diff --git a/src/Picqer/Financials/Exact/ProjectTimeTransaction.php b/src/Picqer/Financials/Exact/ProjectTimeTransaction.php index 72be0f6d..bb81f44a 100644 --- a/src/Picqer/Financials/Exact/ProjectTimeTransaction.php +++ b/src/Picqer/Financials/Exact/ProjectTimeTransaction.php @@ -26,7 +26,7 @@ * @property string $EndTime End time of the time transaction * @property int $EntryNumber Number that represents the grouping of time transactions * @property string $ErrorText (Only used by backgroundjobs) To determine which transaction has an error - * @property int $HourStatus Status of the transaction: 1 = Draft, 2 = Rejected, 10 = Submitted, 11 = Failed on approval, 14 = Processing, 16 = Processing, 19 = Failed while undoing approval, 20 = Final + * @property int $HourStatus For POST/PUT: Status of the transaction: 1 = Draft, 2 = Rejected, 10 = Submitted For GET: Status of the transaction: 1 = Draft, 2 = Rejected, 10 = Submitted, 11 = Failed on approval, 14 = Processing, 16 = Processing, 19 = Failed while undoing approval, 20 = Final * @property string $Item Item that is linked to the transaction, which provides the time information * @property string $ItemDescription Description of the item that is linked to the transaction * @property bool $ItemDivisable Indicates if fractional quantities of the item can be used, for example quantity = 0.4 diff --git a/src/Picqer/Financials/Exact/StockSerialNumber.php b/src/Picqer/Financials/Exact/StockSerialNumber.php index 8ecf7e30..8f2c81dc 100644 --- a/src/Picqer/Financials/Exact/StockSerialNumber.php +++ b/src/Picqer/Financials/Exact/StockSerialNumber.php @@ -22,7 +22,7 @@ * @property string $Modified Last modified date * @property string $Modifier User ID of modifier * @property string $ModifierFullName Name of modifier - * @property string $ParentID ID to link part item to assembled item (assembly order and pick order only) + * @property string $ParentID The main item’s serial number ID, which should be linked to the issued part’s item serial number for the shop order. * @property string $PickOrderLine ID of pick order entry in which this serial or batch number was used. * @property string $Remarks Remarks * @property string $SalesOrderLine ID of sales order in which this serial or batch number was reserved. Provided only for the Exact Online Premium users. diff --git a/src/Picqer/Financials/Exact/SyncAccount.php b/src/Picqer/Financials/Exact/SyncAccount.php index 00f0ccc9..e8ce8c8b 100644 --- a/src/Picqer/Financials/Exact/SyncAccount.php +++ b/src/Picqer/Financials/Exact/SyncAccount.php @@ -114,6 +114,8 @@ * @property string $PaymentConditionPurchaseDescription Description of PaymentConditionPurchase * @property string $PaymentConditionSales Code of default payment condition for sales * @property string $PaymentConditionSalesDescription Description of PaymentConditionSales + * @property string $PeppolIdentifier Peppol identifier user entered manually, corresponds to picked peppol adress + * @property int $PeppolIdentifierType Peppol identifier type that user picked manually - GLN, COC, etc * @property string $Phone Phone number * @property string $PhoneExtension Phone number extention * @property string $Postcode Visit address postcode @@ -264,6 +266,8 @@ class SyncAccount extends Model 'PaymentConditionPurchaseDescription', 'PaymentConditionSales', 'PaymentConditionSalesDescription', + 'PeppolIdentifier', + 'PeppolIdentifierType', 'Phone', 'PhoneExtension', 'Postcode', diff --git a/src/Picqer/Financials/Exact/SyncBankAccount.php b/src/Picqer/Financials/Exact/SyncBankAccount.php new file mode 100644 index 00000000..05386e24 --- /dev/null +++ b/src/Picqer/Financials/Exact/SyncBankAccount.php @@ -0,0 +1,53 @@ +