Add Magento 2 node (#2048)

*  Magento 2 node

*  Improvements

*  Small improvement

*  Improvements

* a

*  Improvements

*  Improvements

*  Minor improvements

*  Improvements

* 🐛 Fix issue when parsing extension attributes with operation customer:update

*  Improvements

*  Improvements

Co-authored-by: Jan Oberhauser <jan.oberhauser@gmail.com>
This commit is contained in:
Ricardo Espinoza 2021-09-15 04:07:02 -04:00 committed by GitHub
parent eb89b219f3
commit ef14b41a16
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
10 changed files with 2666 additions and 0 deletions

View file

@ -0,0 +1,23 @@
import {
ICredentialType,
NodePropertyTypes,
} from 'n8n-workflow';
export class Magento2Api implements ICredentialType {
name = 'magento2Api';
displayName = 'Magento 2 API';
properties = [
{
displayName: 'Host',
name: 'host',
type: 'string' as NodePropertyTypes,
default: '',
},
{
displayName: 'Access Token',
name: 'accessToken',
type: 'string' as NodePropertyTypes,
default: '',
},
];
}

View file

@ -0,0 +1,313 @@
import {
INodeProperties,
} from 'n8n-workflow';
import {
getCustomerOptionalFields,
getSearchFilters,
} from './GenericFunctions';
export const customerOperations = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
displayOptions: {
show: {
resource: [
'customer',
],
},
},
options: [
{
name: 'Create',
value: 'create',
description: 'Create a new customer',
},
{
name: 'Delete',
value: 'delete',
description: 'Delete a customer',
},
{
name: 'Get',
value: 'get',
description: 'Get a customer',
},
{
name: 'Get All',
value: 'getAll',
description: 'Get all customers',
},
{
name: 'Update',
value: 'update',
description: 'Update a customer',
},
],
default: 'create',
description: 'The operation to perform',
},
] as INodeProperties[];
export const customerFields = [
/* -------------------------------------------------------------------------- */
/* customer:create */
/* -------------------------------------------------------------------------- */
{
displayName: 'Email',
name: 'email',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'create',
],
},
},
description: 'Email address of the user to create',
},
{
displayName: 'First Name',
name: 'firstname',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'create',
],
},
},
description: 'First name of the user to create',
},
{
displayName: 'Last Name',
name: 'lastname',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'create',
],
},
},
description: 'Last name of the user to create',
},
{
displayName: 'Additional Fields',
name: 'additionalFields',
type: 'collection',
placeholder: 'Add Field',
default: {},
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'create',
],
},
},
options: [
...getCustomerOptionalFields(),
],
},
/* -------------------------------------------------------------------------- */
/* customer:update */
/* -------------------------------------------------------------------------- */
{
displayName: 'Customer ID',
name: 'customerId',
type: 'string',
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'update',
],
},
},
description: 'ID of the customer to update',
},
{
displayName: 'Email',
name: 'email',
type: 'string',
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'update',
],
},
},
},
{
displayName: 'First Name',
name: 'firstName',
type: 'string',
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'update',
],
},
},
},
{
displayName: 'Last Name',
name: 'lastName',
type: 'string',
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'update',
],
},
},
},
{
displayName: 'Website Name/ID',
name: 'website_id',
type: 'options',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'update',
],
},
},
typeOptions: {
loadOptionsMethod: 'getWebsites',
},
default: '',
},
{
displayName: 'Update Fields',
name: 'updateFields',
type: 'collection',
placeholder: 'Add Field',
default: {},
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'update',
],
},
},
options: [
...getCustomerOptionalFields(),
],
},
/* -------------------------------------------------------------------------- */
/* customer:delete */
/* -------------------------------------------------------------------------- */
{
displayName: 'Customer ID',
name: 'customerId',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'delete',
'get',
],
},
},
},
/* -------------------------------------------------------------------------- */
/* customer:getAll */
/* -------------------------------------------------------------------------- */
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'getAll',
],
},
},
default: false,
description: 'Whether all results should be returned or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: [
'customer',
],
operation: [
'getAll',
],
returnAll: [
false,
],
},
},
typeOptions: {
minValue: 1,
maxValue: 10,
},
default: 5,
description: 'How many results to return',
},
...getSearchFilters(
'customer',
'getSystemAttributes',
'getSystemAttributes',
),
] as INodeProperties[];

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,51 @@
import {
INodeProperties,
} from 'n8n-workflow';
export const invoiceOperations = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
displayOptions: {
show: {
resource: [
'invoice',
],
},
},
options: [
{
name: 'Create',
value: 'create',
description: 'Create an invoice',
},
],
default: 'create',
description: 'The operation to perform',
},
] as INodeProperties[];
export const invoiceFields = [
/* -------------------------------------------------------------------------- */
/* invoice:create */
/* -------------------------------------------------------------------------- */
{
displayName: 'Order ID',
name: 'orderId',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'invoice',
],
operation: [
'create',
],
},
},
},
] as INodeProperties[];

View file

@ -0,0 +1,681 @@
import {
IExecuteFunctions,
} from 'n8n-core';
import {
IDataObject,
ILoadOptionsFunctions,
INodeExecutionData,
INodePropertyOptions,
INodeType,
INodeTypeDescription,
NodeApiError,
} from 'n8n-workflow';
import {
adjustAddresses,
getFilterQuery,
getOrderFields,
getProductAttributes,
magentoApiRequest,
magentoApiRequestAllItems,
sort,
validateJSON,
} from './GenericFunctions';
import {
customerFields,
customerOperations,
} from './CustomerDescription';
import {
orderFields,
orderOperations,
} from './OrderDescription';
import {
productFields,
productOperations,
} from './ProductDescription';
import {
invoiceFields,
invoiceOperations,
} from './InvoiceDescription';
import {
CustomAttribute,
CustomerAttributeMetadata,
Filter,
NewCustomer,
NewProduct,
Search,
} from './Types';
import {
capitalCase,
} from 'change-case';
export class Magento2 implements INodeType {
description: INodeTypeDescription = {
displayName: 'Magento 2',
name: 'magento2',
icon: 'file:magento.svg',
group: ['input'],
version: 1,
subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
description: 'Consume Magento API',
defaults: {
name: 'Magento 2',
color: '#ec6737',
},
inputs: ['main'],
outputs: ['main'],
credentials: [
{
name: 'magento2Api',
required: true,
},
],
properties: [
{
displayName: 'Resource',
name: 'resource',
type: 'options',
options: [
{
name: 'Customer',
value: 'customer',
},
{
name: 'Invoice',
value: 'invoice',
},
{
name: 'Order',
value: 'order',
},
{
name: 'Product',
value: 'product',
},
],
default: 'customer',
description: 'The resource to operate on',
},
...customerOperations,
...customerFields,
...invoiceOperations,
...invoiceFields,
...orderOperations,
...orderFields,
...productOperations,
...productFields,
],
};
methods = {
loadOptions: {
async getCountries(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/directorycountries
const countries = await magentoApiRequest.call(this, 'GET', '/rest/default/V1/directory/countries');
const returnData: INodePropertyOptions[] = [];
for (const country of countries) {
returnData.push({
name: country.full_name_english,
value: country.id,
});
}
returnData.sort(sort);
return returnData;
},
async getGroups(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/customerGroupsdefault#operation/customerGroupManagementV1GetDefaultGroupGet
const group = await magentoApiRequest.call(this, 'GET', '/rest/default/V1/customerGroups/default');
const returnData: INodePropertyOptions[] = [];
returnData.push({
name: group.code,
value: group.id,
});
returnData.sort(sort);
return returnData;
},
async getStores(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/storestoreConfigs
const stores = await magentoApiRequest.call(this, 'GET', '/rest/default/V1/store/storeConfigs');
const returnData: INodePropertyOptions[] = [];
for (const store of stores) {
returnData.push({
name: store.base_url,
value: store.id,
});
}
returnData.sort(sort);
return returnData;
},
async getWebsites(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/storewebsites
const websites = await magentoApiRequest.call(this, 'GET', '/rest/default/V1/store/websites');
const returnData: INodePropertyOptions[] = [];
for (const website of websites) {
returnData.push({
name: website.name,
value: website.id,
});
}
returnData.sort(sort);
return returnData;
},
async getCustomAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/attributeMetadatacustomer#operation/customerCustomerMetadataV1GetAllAttributesMetadataGet
const resource = this.getCurrentNodeParameter('resource') as string;
const attributes = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/attributeMetadata/${resource}`) as CustomerAttributeMetadata[];
const returnData: INodePropertyOptions[] = [];
for (const attribute of attributes) {
if (attribute.system === false && attribute.frontend_label !== '') {
returnData.push({
name: attribute.frontend_label as string,
value: attribute.attribute_code as string,
});
}
}
returnData.sort(sort);
return returnData;
},
async getSystemAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/attributeMetadatacustomer#operation/customerCustomerMetadataV1GetAllAttributesMetadataGet
const resource = this.getCurrentNodeParameter('resource') as string;
const attributes = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/attributeMetadata/${resource}`) as CustomerAttributeMetadata[];
const returnData: INodePropertyOptions[] = [];
for (const attribute of attributes) {
if (attribute.system === true && attribute.frontend_label !== null) {
returnData.push({
name: attribute.frontend_label as string,
value: attribute.attribute_code as string,
});
}
}
returnData.sort(sort);
return returnData;
},
async getProductTypes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/productslinkstypes
const types = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/products/types`) as IDataObject[];
const returnData: INodePropertyOptions[] = [];
for (const type of types) {
returnData.push({
name: type.label as string,
value: type.name as string,
});
}
returnData.sort(sort);
return returnData;
},
async getCategories(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/categories#operation/catalogCategoryManagementV1GetTreeGet
const { items: categories } = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/categories/list`, {}, {
search_criteria: {
filter_groups: [
{
filters: [
{
field: 'is_active',
condition_type: 'eq',
value: 1,
},
],
},
],
},
}) as { items: IDataObject[] };
const returnData: INodePropertyOptions[] = [];
for (const category of categories) {
returnData.push({
name: category.name as string,
value: category.id as string,
});
}
returnData.sort(sort);
return returnData;
},
async getAttributeSets(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
//https://magento.redoc.ly/2.3.7-admin/tag/productsattribute-setssetslist#operation/catalogAttributeSetRepositoryV1GetListGet
const { items: attributeSets } = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/products/attribute-sets/sets/list`, {}, {
search_criteria: 0,
}) as { items: IDataObject[] };
const returnData: INodePropertyOptions[] = [];
for (const attributeSet of attributeSets) {
returnData.push({
name: attributeSet.attribute_set_name as string,
value: attributeSet.attribute_set_id as string,
});
}
returnData.sort(sort);
return returnData;
},
async getFilterableCustomerAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
return getProductAttributes.call(this, (attribute) => attribute.is_filterable === true);
},
async getProductAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
return getProductAttributes.call(this);
},
// async getProductAttributesFields(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
// return getProductAttributes.call(this, undefined, { name: '*', value: '*', description: 'All properties' });
// },
async getFilterableProductAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
return getProductAttributes.call(this, (attribute) => attribute.is_searchable === '1');
},
async getSortableProductAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
return getProductAttributes.call(this, (attribute) => attribute.used_for_sort_by === true);
},
async getOrderAttributes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]> {
return getOrderFields().map(field => ({ name: capitalCase(field), value: field })).sort(sort);
},
},
};
async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
const items = this.getInputData();
const returnData: IDataObject[] = [];
const length = (items.length as unknown) as number;
const timezone = this.getTimezone();
let responseData;
const resource = this.getNodeParameter('resource', 0) as string;
const operation = this.getNodeParameter('operation', 0) as string;
for (let i = 0; i < length; i++) {
try {
if (resource === 'customer') {
if (operation === 'create') {
// https://magento.redoc.ly/2.3.7-admin/tag/customerscustomerId#operation/customerCustomerRepositoryV1SavePut
const email = this.getNodeParameter('email', i) as string;
const firstname = this.getNodeParameter('firstname', i) as string;
const lastname = this.getNodeParameter('lastname', i) as string;
const {
addresses,
customAttributes,
password,
...rest
} = this.getNodeParameter('additionalFields', i) as {
addresses: {
address: [{
street: string,
}]
};
customAttributes: {
customAttribute: CustomAttribute[],
},
password: string,
};
const body: NewCustomer = {
customer: {
email,
firstname,
lastname,
},
};
body.customer!.addresses = adjustAddresses(addresses?.address || []);
body.customer!.custom_attributes = customAttributes?.customAttribute || {};
body.customer!.extension_attributes = ['amazon_id', 'is_subscribed', 'vertex_customer_code', 'vertex_customer_country']
// tslint:disable-next-line: no-any
.reduce((obj, value: string): any => {
if ((rest as IDataObject).hasOwnProperty(value)) {
const data = Object.assign(obj, { [value]: (rest as IDataObject)[value] });
delete (rest as IDataObject)[value];
return data;
} else {
return obj;
}
}, {});
if (password) {
body.password = password;
}
Object.assign(body.customer, rest);
responseData = await magentoApiRequest.call(this, 'POST', '/rest/V1/customers', body);
}
if (operation === 'delete') {
//https://magento.redoc.ly/2.3.7-admin/tag/customerscustomerId#operation/customerCustomerRepositoryV1SavePut
const customerId = this.getNodeParameter('customerId', i) as string;
responseData = await magentoApiRequest.call(this, 'DELETE', `/rest/default/V1/customers/${customerId}`);
responseData = { success: true };
}
if (operation === 'get') {
//https://magento.redoc.ly/2.3.7-admin/tag/customerscustomerId#operation/customerCustomerRepositoryV1GetByIdGet
const customerId = this.getNodeParameter('customerId', i) as string;
responseData = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/customers/${customerId}`);
}
if (operation === 'getAll') {
//https://magento.redoc.ly/2.3.7-admin/tag/customerssearch
const filterType = this.getNodeParameter('filterType', i) as string;
const sort = this.getNodeParameter('options.sort', i, {}) as { sort: [{ direction: string, field: string }] };
const returnAll = this.getNodeParameter('returnAll', 0) as boolean;
let qs: Search = {};
if (filterType === 'manual') {
const filters = this.getNodeParameter('filters', i) as { conditions: Filter[] };
const matchType = this.getNodeParameter('matchType', i) as string;
qs = getFilterQuery(Object.assign(filters, { matchType }, sort));
} else if (filterType === 'json') {
const filterJson = this.getNodeParameter('filterJson', i) as string;
if (validateJSON(filterJson) !== undefined) {
qs = JSON.parse(filterJson);
} else {
throw new NodeApiError(this.getNode(), { message: 'Filter (JSON) must be a valid json' });
}
} else {
qs = {
search_criteria: {},
};
if (Object.keys(sort).length !== 0) {
qs.search_criteria = {
sort_orders: sort.sort,
};
}
}
if (returnAll === true) {
qs.search_criteria!.page_size = 100;
responseData = await magentoApiRequestAllItems.call(this, 'items', 'GET', `/rest/default/V1/customers/search`, {}, qs as unknown as IDataObject);
} else {
const limit = this.getNodeParameter('limit', 0) as number;
qs.search_criteria!.page_size = limit;
responseData = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/customers/search`, {}, qs as unknown as IDataObject);
responseData = responseData.items;
}
}
if (operation === 'update') {
//https://magento.redoc.ly/2.3.7-admin/tag/customerscustomerId#operation/customerCustomerRepositoryV1SavePut
const customerId = this.getNodeParameter('customerId', i) as string;
const firstName = this.getNodeParameter('firstName', i) as string;
const lastName = this.getNodeParameter('lastName', i) as string;
const email = this.getNodeParameter('email', i) as string;
const {
addresses,
customAttributes,
password,
...rest
} = this.getNodeParameter('updateFields', i) as {
addresses: {
address: [{
street: string,
}]
};
customAttributes: {
customAttribute: CustomAttribute[],
},
password: string,
};
const body: NewCustomer = {
customer: {
email,
firstname: firstName,
lastname: lastName,
id: parseInt(customerId, 10),
website_id: 0,
},
};
body.customer!.addresses = adjustAddresses(addresses?.address || []);
body.customer!.custom_attributes = customAttributes?.customAttribute || {};
body.customer!.extension_attributes = ['amazon_id', 'is_subscribed', 'vertex_customer_code', 'vertex_customer_country']
// tslint:disable-next-line: no-any
.reduce((obj, value: string): any => {
if ((rest as IDataObject).hasOwnProperty(value)) {
const data = Object.assign(obj, { [value]: (rest as IDataObject)[value] });
delete (rest as IDataObject)[value];
return data;
} else {
return obj;
}
}, {});
if (password) {
body.password = password;
}
Object.assign(body.customer, rest);
responseData = await magentoApiRequest.call(this, 'PUT', `/rest/V1/customers/${customerId}`, body);
}
}
if (resource === 'invoice') {
if (operation === 'create') {
///https://magento.redoc.ly/2.3.7-admin/tag/orderorderIdinvoice
const orderId = this.getNodeParameter('orderId', i) as string;
responseData = await magentoApiRequest.call(this, 'POST', `/rest/default/V1/order/${orderId}/invoice`);
responseData = { success: true };
}
}
if (resource === 'order') {
if (operation === 'cancel') {
//https://magento.redoc.ly/2.3.7-admin/tag/ordersidcancel
const orderId = this.getNodeParameter('orderId', i) as string;
responseData = await magentoApiRequest.call(this, 'POST', `/rest/default/V1/orders/${orderId}/cancel`);
responseData = { success: true };
}
if (operation === 'get') {
//https://magento.redoc.ly/2.3.7-admin/tag/ordersid#operation/salesOrderRepositoryV1GetGet
const orderId = this.getNodeParameter('orderId', i) as string;
responseData = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/orders/${orderId}`);
}
if (operation === 'ship') {
///https://magento.redoc.ly/2.3.7-admin/tag/orderorderIdship#operation/salesShipOrderV1ExecutePost
const orderId = this.getNodeParameter('orderId', i) as string;
responseData = await magentoApiRequest.call(this, 'POST', `/rest/default/V1/order/${orderId}/ship`);
responseData = { success: true };
}
if (operation === 'getAll') {
//https://magento.redoc.ly/2.3.7-admin/tag/orders#operation/salesOrderRepositoryV1GetListGet
const filterType = this.getNodeParameter('filterType', i) as string;
const sort = this.getNodeParameter('options.sort', i, {}) as { sort: [{ direction: string, field: string }] };
const returnAll = this.getNodeParameter('returnAll', 0) as boolean;
let qs: Search = {};
if (filterType === 'manual') {
const filters = this.getNodeParameter('filters', i) as { conditions: Filter[] };
const matchType = this.getNodeParameter('matchType', i) as string;
qs = getFilterQuery(Object.assign(filters, { matchType }, sort));
} else if (filterType === 'json') {
const filterJson = this.getNodeParameter('filterJson', i) as string;
if (validateJSON(filterJson) !== undefined) {
qs = JSON.parse(filterJson);
} else {
throw new NodeApiError(this.getNode(), { message: 'Filter (JSON) must be a valid json' });
}
} else {
qs = {
search_criteria: {},
};
if (Object.keys(sort).length !== 0) {
qs.search_criteria = {
sort_orders: sort.sort,
};
}
}
if (returnAll === true) {
qs.search_criteria!.page_size = 100;
responseData = await magentoApiRequestAllItems.call(this, 'items', 'GET', `/rest/default/V1/orders`, {}, qs as unknown as IDataObject);
} else {
const limit = this.getNodeParameter('limit', 0) as number;
qs.search_criteria!.page_size = limit;
responseData = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/orders`, {}, qs as unknown as IDataObject);
responseData = responseData.items;
}
}
}
if (resource === 'product') {
if (operation === 'create') {
// https://magento.redoc.ly/2.3.7-admin/tag/products#operation/catalogProductRepositoryV1SavePost
const sku = this.getNodeParameter('sku', i) as string;
const name = this.getNodeParameter('name', i) as string;
const attributeSetId = this.getNodeParameter('attributeSetId', i) as string;
const price = this.getNodeParameter('price', i) as number;
const {
customAttributes,
category,
...rest
} = this.getNodeParameter('additionalFields', i) as {
customAttributes: {
customAttribute: CustomAttribute[],
},
category: string,
};
const body: NewProduct = {
product: {
sku,
name,
attribute_set_id: parseInt(attributeSetId, 10),
price,
},
};
body.product!.custom_attributes = customAttributes?.customAttribute || {};
Object.assign(body.product, rest);
responseData = await magentoApiRequest.call(this, 'POST', '/rest/default/V1/products', body);
}
if (operation === 'delete') {
//https://magento.redoc.ly/2.3.7-admin/tag/productssku#operation/catalogProductRepositoryV1DeleteByIdDelete
const sku = this.getNodeParameter('sku', i) as string;
responseData = await magentoApiRequest.call(this, 'DELETE', `/rest/default/V1/products/${sku}`);
responseData = { success: true };
}
if (operation === 'get') {
//https://magento.redoc.ly/2.3.7-admin/tag/productssku#operation/catalogProductRepositoryV1GetGet
const sku = this.getNodeParameter('sku', i) as string;
responseData = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/products/${sku}`);
}
if (operation === 'getAll') {
//https://magento.redoc.ly/2.3.7-admin/tag/customerssearch
const filterType = this.getNodeParameter('filterType', i) as string;
const sort = this.getNodeParameter('options.sort', i, {}) as { sort: [{ direction: string, field: string }] };
const returnAll = this.getNodeParameter('returnAll', 0) as boolean;
let qs: Search = {};
if (filterType === 'manual') {
const filters = this.getNodeParameter('filters', i) as { conditions: Filter[] };
const matchType = this.getNodeParameter('matchType', i) as string;
qs = getFilterQuery(Object.assign(filters, { matchType }, sort));
} else if (filterType === 'json') {
const filterJson = this.getNodeParameter('filterJson', i) as string;
if (validateJSON(filterJson) !== undefined) {
qs = JSON.parse(filterJson);
} else {
throw new NodeApiError(this.getNode(), { message: 'Filter (JSON) must be a valid json' });
}
} else {
qs = {
search_criteria: {},
};
if (Object.keys(sort).length !== 0) {
qs.search_criteria = {
sort_orders: sort.sort,
};
}
}
if (returnAll === true) {
qs.search_criteria!.page_size = 100;
responseData = await magentoApiRequestAllItems.call(this, 'items', 'GET', `/rest/default/V1/products`, {}, qs as unknown as IDataObject);
} else {
const limit = this.getNodeParameter('limit', 0) as number;
qs.search_criteria!.page_size = limit;
responseData = await magentoApiRequest.call(this, 'GET', `/rest/default/V1/products`, {}, qs as unknown as IDataObject);
responseData = responseData.items;
}
}
if (operation === 'update') {
//https://magento.redoc.ly/2.3.7-admin/tag/productssku#operation/catalogProductRepositoryV1SavePut
const sku = this.getNodeParameter('sku', i) as string;
const {
customAttributes,
...rest
} = this.getNodeParameter('updateFields', i) as {
customAttributes: {
customAttribute: CustomAttribute[],
},
};
if (!Object.keys(rest).length) {
throw new NodeApiError(this.getNode(), { message: 'At least one parameter has to be updated' });
}
const body: NewProduct = {
product: {
sku,
},
};
body.product!.custom_attributes = customAttributes?.customAttribute || {};
Object.assign(body.product, rest);
responseData = await magentoApiRequest.call(this, 'PUT', `/rest/default/V1/products/${sku}`, body);
}
}
Array.isArray(responseData)
? returnData.push(...responseData)
: returnData.push(responseData);
} catch (error) {
if (this.continueOnFail()) {
returnData.push({ error: error.message });
continue;
}
throw error;
}
}
return [this.helpers.returnJsonArray(returnData)];
}
}

View file

@ -0,0 +1,123 @@
import {
INodeProperties,
} from 'n8n-workflow';
import {
getSearchFilters,
} from './GenericFunctions';
export const orderOperations = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
displayOptions: {
show: {
resource: [
'order',
],
},
},
options: [
{
name: 'Cancel',
value: 'cancel',
description: 'Cancel an order',
},
{
name: 'Get',
value: 'get',
description: 'Get an order',
},
{
name: 'Get All',
value: 'getAll',
description: 'Get all orders',
},
{
name: 'Ship',
value: 'ship',
description: 'Ship an order',
},
],
default: 'cancel',
description: 'The operation to perform',
},
] as INodeProperties[];
export const orderFields = [
/* -------------------------------------------------------------------------- */
/* order:cancel */
/* -------------------------------------------------------------------------- */
{
displayName: 'Order ID',
name: 'orderId',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'order',
],
operation: [
'cancel',
'get',
'ship',
],
},
},
},
/* -------------------------------------------------------------------------- */
/* order:getAll */
/* -------------------------------------------------------------------------- */
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: [
'order',
],
operation: [
'getAll',
],
},
},
default: false,
description: 'Whether all results should be returned or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: [
'order',
],
operation: [
'getAll',
],
returnAll: [
false,
],
},
},
typeOptions: {
minValue: 1,
maxValue: 10,
},
default: 5,
description: 'How many results to return',
},
...getSearchFilters(
'order',
'getOrderAttributes',
'getOrderAttributes',
),
] as INodeProperties[];

View file

@ -0,0 +1,244 @@
import {
INodeProperties,
} from 'n8n-workflow';
import {
getProductOptionalFields,
getSearchFilters,
} from './GenericFunctions';
export const productOperations = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
displayOptions: {
show: {
resource: [
'product',
],
},
},
options: [
{
name: 'Create',
value: 'create',
description: 'Create a product',
},
{
name: 'Delete',
value: 'delete',
description: 'Delete a product',
},
{
name: 'Get',
value: 'get',
description: 'Get a product',
},
{
name: 'Get All',
value: 'getAll',
description: 'Get all producs',
},
{
name: 'Update',
value: 'update',
description: 'Update a product',
},
],
default: 'create',
description: 'The operation to perform',
},
] as INodeProperties[];
export const productFields = [
/* -------------------------------------------------------------------------- */
/* product:create */
/* -------------------------------------------------------------------------- */
{
displayName: 'SKU',
name: 'sku',
type: 'string',
default: '',
required: true,
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'create',
'update',
],
},
},
description: 'Stock-keeping unit of the product',
},
{
displayName: 'Name',
name: 'name',
type: 'string',
required: true,
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'create',
],
},
},
default: '',
},
{
displayName: 'Attribute Set Name/ID',
name: 'attributeSetId',
type: 'options',
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'create',
],
},
},
typeOptions: {
loadOptionsMethod: 'getAttributeSets',
},
default: '',
},
{
displayName: 'Price',
name: 'price',
type: 'number',
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'create',
],
},
},
default: 0,
},
{
displayName: 'Additional Fields',
name: 'additionalFields',
type: 'collection',
placeholder: 'Add Field',
default: {},
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'create',
],
},
},
options: [
...getProductOptionalFields(),
],
},
{
displayName: 'Update Fields',
name: 'updateFields',
type: 'collection',
placeholder: 'Add Field',
default: {},
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'update',
],
},
},
options: [
...getProductOptionalFields(),
],
},
/* -------------------------------------------------------------------------- */
/* product:delete */
/* -------------------------------------------------------------------------- */
{
displayName: 'SKU',
name: 'sku',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'delete',
'get',
],
},
},
description: 'Stock-keeping unit of the product',
},
/* -------------------------------------------------------------------------- */
/* product:getAll */
/* -------------------------------------------------------------------------- */
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'getAll',
],
},
},
default: false,
description: 'Whether all results should be returned or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: [
'product',
],
operation: [
'getAll',
],
returnAll: [
false,
],
},
},
typeOptions: {
minValue: 1,
maxValue: 10,
},
default: 5,
description: 'How many results to return',
},
...getSearchFilters(
'product',
//'getProductAttributesFields',
'getFilterableProductAttributes',
'getSortableProductAttributes'),
] as INodeProperties[];

View file

@ -0,0 +1,192 @@
export interface NewCustomer {
customer?: Customer;
password?: string;
redirectUrl?: string;
}
export interface Customer {
id?: number;
group_id?: number;
default_billing?: string;
default_shipping?: string;
confirmation?: string;
created_at?: string;
updated_at?: string;
created_in?: string;
dob?: string;
email?: string;
firstname?: string;
lastname?: string;
middlename?: string;
prefix?: string;
suffix?: string;
gender?: number;
store_id?: number;
taxvat?: string;
website_id?: number;
addresses?: Address[];
disable_auto_group_change?: number;
extension_attributes?: CustomerExtensionAttributes;
custom_attributes?: CustomAttribute[];
}
export interface Address {
id?: number;
customer_id?: number;
region?: Region;
region_id?: number;
country_id?: string;
street?: string[];
company?: string;
telephone?: string;
fax?: string;
postcode?: string;
city?: string;
firstname?: string;
lastname?: string;
middlename?: string;
prefix?: string;
suffix?: string;
vat_id?: string;
default_shipping?: boolean;
default_billing?: boolean;
extension_attributes?: AddressExtensionAttributes;
custom_attributes?: CustomAttribute[];
}
export interface CustomAttribute {
attribute_code?: string;
value?: string;
}
export interface AddressExtensionAttributes {
amazon_id?: string;
is_subscribed?: boolean;
vertex_customer_role?: string;
vertex_customer_country?: string;
}
export interface Region {
region_code?: string;
region?: string;
region_id?: number;
extension_attributes?: AddressExtensionAttributes;
}
export interface CustomerExtensionAttributes {
company_attributes?: CompanyAttributes;
is_subscribed?: boolean;
amazon_id?: string;
vertex_customer_code?: string;
vertex_customer_country?: string;
}
export interface CompanyAttributes {
customer_id?: number;
company_id?: number;
job_title?: string;
status?: number;
telephone?: string;
extension_attributes?: AddressExtensionAttributes;
}
export interface CustomerAttributeMetadata {
frontend_input?: string;
input_filter?: string;
store_label?: string;
validation_rules?: ValidationRule[];
multiline_count?: number;
visible?: boolean;
required?: boolean;
data_model?: string;
options?: CustomerAttributeMetadataOption[];
frontend_class?: string;
user_defined?: boolean;
sort_order?: number;
frontend_label?: string;
note?: string;
system?: boolean;
backend_type?: string;
is_used_in_grid?: boolean;
is_visible_in_grid?: boolean;
is_filterable_in_grid?: boolean;
is_searchable_in_grid?: boolean;
attribute_code?: string;
}
export interface CustomerAttributeMetadataOption {
label?: string;
value?: string;
options?: OptionOption[];
}
export interface OptionOption {
}
export interface ValidationRule {
name?: string;
value?: string;
}
export interface Search {
search_criteria?: SearchCriteria;
total_count?: number;
}
export interface SearchCriteria {
filter_groups?: FilterGroup[];
sort_orders?: SortOrder[];
page_size?: number;
current_page?: number;
}
export interface FilterGroup {
filters?: Filter[];
}
export interface Filter {
field?: string;
value?: string;
condition_type?: string;
}
export interface SortOrder {
field?: string;
direction?: string;
}
export interface NewProduct {
product?: Product;
saveOptions?: boolean;
}
export interface Product {
id?: number;
sku?: string;
name?: string;
attribute_set_id?: number;
price?: number;
status?: number;
visibility?: number;
type_id?: string;
created_at?: string;
updated_at?: string;
weight?: number;
extension_attributes?: {
category_links?: [{
category_id?: string,
}]
}
custom_attributes?: CustomAttribute[];
}
export interface ProductAttribute {
is_filterable_in_search: boolean,
default_frontend_label: string;
attribute_id: string;
is_filterable: boolean;
used_for_sort_by: boolean;
is_searchable: string,
attribute_code: string,
}

View file

@ -0,0 +1,6 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg width="256px" height="303px" viewBox="0 0 256 303" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" preserveAspectRatio="xMidYMid">
<g>
<path d="M144.852,90.67 L144.852,262.862 L127.919,273.211 L110.973,262.807 L110.973,90.803 L67.095,117.819 L67.095,265.074 L127.919,302.291 L189.258,264.809 L189.258,117.725 L144.852,90.67 L144.852,90.67 Z M127.919,0 L0,77.502 L0,224.776 L33.223,244.348 L33.223,97.06 L127.945,39.464 L222.755,96.976 L223.146,97.199 L223.104,244.128 L256,224.776 L256,77.502 L127.919,0 L127.919,0 Z" fill="#EC6737"></path>
</g>
</svg>

After

Width:  |  Height:  |  Size: 673 B

View file

@ -153,6 +153,7 @@
"dist/credentials/LineNotifyOAuth2Api.credentials.js",
"dist/credentials/LingvaNexApi.credentials.js",
"dist/credentials/LinkedInOAuth2Api.credentials.js",
"dist/credentials/Magento2Api.credentials.js",
"dist/credentials/MailerLiteApi.credentials.js",
"dist/credentials/MailcheckApi.credentials.js",
"dist/credentials/MailchimpApi.credentials.js",
@ -456,6 +457,7 @@
"dist/nodes/Line/Line.node.js",
"dist/nodes/LingvaNex/LingvaNex.node.js",
"dist/nodes/LinkedIn/LinkedIn.node.js",
"dist/nodes/Magento/Magento2.node.js",
"dist/nodes/MailerLite/MailerLite.node.js",
"dist/nodes/MailerLite/MailerLiteTrigger.node.js",
"dist/nodes/Mailcheck/Mailcheck.node.js",