@memberjunction/actions-bizapps-accounting
Version:
Accounting system integration actions for MemberJunction
191 lines • 7.72 kB
JavaScript
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
return c > 3 && r && Object.defineProperty(target, key, r), r;
};
import { RegisterClass } from '@memberjunction/global';
import { QuickBooksBaseAction } from '../quickbooks-base.action.js';
import { BaseAction } from '@memberjunction/actions';
/**
* Action to create a journal entry in QuickBooks Online
*/
let CreateQuickBooksJournalEntryAction = class CreateQuickBooksJournalEntryAction extends QuickBooksBaseAction {
/**
* Description of the action
*/
get Description() {
return 'Creates a journal entry in QuickBooks Online with automatic validation';
}
/**
* Main execution method
*/
async InternalRunAction(params) {
try {
const contextUser = params.ContextUser;
if (!contextUser) {
throw new Error('Context user is required for QuickBooks API calls');
}
// Store params for use in other methods
this._params = params.Params;
// Get parameter values
const entryDate = this.getParamValue(params.Params, 'EntryDate') || new Date();
const docNumber = this.getParamValue(params.Params, 'DocNumber');
const privateNote = this.getParamValue(params.Params, 'PrivateNote');
const linesData = this.getParamValue(params.Params, 'Lines');
const adjustmentEntry = this.getParamValue(params.Params, 'AdjustmentEntry') || false;
// Validate and parse lines
const lines = this.parseAndValidateLines(linesData);
// Validate journal entry balance
if (!this.validateJournalEntryBalance(lines)) {
return {
Success: false,
ResultCode: 'VALIDATION_ERROR',
Message: 'Journal entry is not balanced. Total debits must equal total credits.',
Params: params.Params
};
}
// Build the journal entry object for QuickBooks
const journalEntry = {
DocNumber: docNumber,
TxnDate: this.formatQBODate(entryDate instanceof Date ? entryDate : new Date(entryDate)),
PrivateNote: privateNote,
Adjustment: adjustmentEntry,
Line: lines.map((line, index) => this.mapToQBOJournalLine(line, index + 1))
};
// Create the journal entry in QuickBooks
const response = await this.makeQBORequest('journalentry', 'POST', journalEntry, contextUser);
const createdEntry = response.JournalEntry;
// Set output parameters
const outputParams = [
{
Name: 'JournalEntryID',
Value: createdEntry.Id,
Type: 'Output'
},
{
Name: 'DocNumber',
Value: createdEntry.DocNumber,
Type: 'Output'
},
{
Name: 'TotalAmount',
Value: createdEntry.TotalAmt,
Type: 'Output'
},
{
Name: 'CreatedDate',
Value: createdEntry.MetaData.CreateTime,
Type: 'Output'
}
];
return {
Success: true,
ResultCode: 'SUCCESS',
Params: [...params.Params, ...outputParams],
Message: `Journal entry ${createdEntry.DocNumber} created successfully`
};
}
catch (error) {
const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
return {
Success: false,
ResultCode: 'ERROR',
Message: errorMessage,
Params: params.Params
};
}
}
/**
* Parse and validate journal entry lines
*/
parseAndValidateLines(linesParam) {
if (!linesParam) {
throw new Error('Lines parameter is required');
}
let lines;
// Handle if lines is a JSON string
if (typeof linesParam === 'string') {
try {
lines = JSON.parse(linesParam);
}
catch (error) {
throw new Error('Invalid JSON format for Lines parameter');
}
}
else {
lines = linesParam;
}
if (!Array.isArray(lines)) {
throw new Error('Lines must be an array');
}
if (lines.length < 2) {
throw new Error('Journal entry must have at least 2 lines');
}
// Validate each line
lines.forEach((line, index) => {
if (!line.accountId) {
throw new Error(`Line ${index + 1}: accountId is required`);
}
if (line.debit === undefined && line.credit === undefined) {
throw new Error(`Line ${index + 1}: either debit or credit amount is required`);
}
if (line.debit !== undefined && line.credit !== undefined) {
throw new Error(`Line ${index + 1}: cannot have both debit and credit on the same line`);
}
if (line.debit !== undefined && line.debit < 0) {
throw new Error(`Line ${index + 1}: debit amount cannot be negative`);
}
if (line.credit !== undefined && line.credit < 0) {
throw new Error(`Line ${index + 1}: credit amount cannot be negative`);
}
});
return lines;
}
/**
* Map journal entry line to QuickBooks format
*/
mapToQBOJournalLine(line, lineNumber) {
const qbLine = {
DetailType: 'JournalEntryLineDetail',
Amount: line.debit || line.credit || 0,
JournalEntryLineDetail: {
PostingType: line.debit ? 'Debit' : 'Credit',
AccountRef: {
value: line.accountId
}
}
};
// Add description if provided
if (line.description) {
qbLine.Description = line.description;
}
// Add entity reference if provided
if (line.entityType && line.entityId) {
qbLine.JournalEntryLineDetail.Entity = {
Type: line.entityType,
EntityRef: {
value: line.entityId
}
};
}
// Add class reference if provided
if (line.classId) {
qbLine.JournalEntryLineDetail.ClassRef = {
value: line.classId
};
}
// Add department reference if provided
if (line.departmentId) {
qbLine.JournalEntryLineDetail.DepartmentRef = {
value: line.departmentId
};
}
return qbLine;
}
};
CreateQuickBooksJournalEntryAction = __decorate([
RegisterClass(BaseAction, 'CreateQuickBooksJournalEntryAction')
], CreateQuickBooksJournalEntryAction);
export { CreateQuickBooksJournalEntryAction };
//# sourceMappingURL=create-journal-entry.action.js.map