n8n-nodes-n8ndesigner-salla-n8nai 0.3.158 → 0.3.160
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +140 -37
- package/dist/nodes/Actions/SallaActions.node.js +1 -1
- package/dist/nodes/Triggers/SallaTriggers.node.js +2 -1
- package/package.json +15 -28
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 N8NDesigner
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the " Software\), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED \AS IS\, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,37 +1,140 @@
|
|
|
1
|
-
# n8n-nodes-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
##
|
|
6
|
-
|
|
7
|
-
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
1
|
+
# n8n-nodes-salla
|
|
2
|
+
|
|
3
|
+
Community nodes for n8n that integrate Salla stores through the N8NDesigner Actions API. The package delivers two production-ready actions and two webhook triggers aligned with the branding and behaviour requested by N8NDesigner.
|
|
4
|
+
|
|
5
|
+
## Recent Updates
|
|
6
|
+
|
|
7
|
+
- 0.2.4 — Removed the optional webhook path override from **Salla Triggers** so executions always target the default `/salla/<event>` suffix.
|
|
8
|
+
|
|
9
|
+
## Requirements
|
|
10
|
+
|
|
11
|
+
- Node.js 18 or newer
|
|
12
|
+
- n8n 1.0 or newer (self-hosted or desktop)
|
|
13
|
+
- Access to the N8NDesigner backend with a valid mak_... token and Salla merchant ID
|
|
14
|
+
|
|
15
|
+
## Installation & Build
|
|
16
|
+
|
|
17
|
+
`ash
|
|
18
|
+
npm install
|
|
19
|
+
npm run build
|
|
20
|
+
`
|
|
21
|
+
|
|
22
|
+
The build step compiles TypeScript sources into dist/ using sup. Publish with
|
|
23
|
+
pm publish or generate a tarball via
|
|
24
|
+
pm pack.
|
|
25
|
+
|
|
26
|
+
## Credentials Setup
|
|
27
|
+
|
|
28
|
+
Create a credential named **Salla (N8NDesigner Actions)** inside n8n and supply:
|
|
29
|
+
|
|
30
|
+
- **Base URL**: defaults to https://app.n8ndesigner.com
|
|
31
|
+
- **Salla Merchant ID**: e.g. 1596416913
|
|
32
|
+
- **MAK Key**: backend-issued bearer token (mak_...)
|
|
33
|
+
|
|
34
|
+
Every node automatically attaches Authorization: Bearer <makKey> and Content-Type: application/json headers.
|
|
35
|
+
|
|
36
|
+
## Actions
|
|
37
|
+
|
|
38
|
+
### Update Order Status
|
|
39
|
+
|
|
40
|
+
Updates a Salla order workflow state by slug or numeric status ID and supports an optional note (max 500 characters). Either slug or status_id is required; if both are present they are sent together.
|
|
41
|
+
|
|
42
|
+
Example curl equivalent (QA data):
|
|
43
|
+
|
|
44
|
+
`ash
|
|
45
|
+
curl -X PATCH 'https://app.n8ndesigner.com/api/actions/orders/562285006' \
|
|
46
|
+
-H 'Authorization: Bearer mak_xxxxxxxxxx' \
|
|
47
|
+
-H 'Content-Type: application/json' \
|
|
48
|
+
-d '{
|
|
49
|
+
salla_merchant_id: 1596416913,
|
|
50
|
+
slug: under_review,
|
|
51
|
+
note: Order triaged from n8n
|
|
52
|
+
}'
|
|
53
|
+
`
|
|
54
|
+
|
|
55
|
+
### Delete Customer
|
|
56
|
+
|
|
57
|
+
Permanently deletes a customer. The node sends the merchant ID in both the body and query string so it works with the current and future controllers.
|
|
58
|
+
|
|
59
|
+
`ash
|
|
60
|
+
curl -X DELETE 'https://app.n8ndesigner.com/api/actions/customers/1924459692?salla_merchant_id=1596416913' \
|
|
61
|
+
-H 'Authorization: Bearer mak_xxxxxxxxxx' \
|
|
62
|
+
-H 'Content-Type: application/json' \
|
|
63
|
+
-d '{
|
|
64
|
+
salla_merchant_id: 1596416913
|
|
65
|
+
}'
|
|
66
|
+
`
|
|
67
|
+
|
|
68
|
+
Both action nodes return a normalized payload:
|
|
69
|
+
|
|
70
|
+
`json
|
|
71
|
+
{
|
|
72
|
+
ok: true,
|
|
73
|
+
status: 200,
|
|
74
|
+
data: { ... },
|
|
75
|
+
raw: { ... }
|
|
76
|
+
}
|
|
77
|
+
`
|
|
78
|
+
|
|
79
|
+
Failures surface the backend-provided message (including Arabic validation strings) without additional wrapping, and each request times out after 12 seconds with up to two exponential retries on 429, 5xx, or transient network errors.
|
|
80
|
+
|
|
81
|
+
## Triggers
|
|
82
|
+
|
|
83
|
+
### Salla Triggers
|
|
84
|
+
|
|
85
|
+
One unified webhook node that subscribes to the full Salla event catalogue exposed by the merchant proxy. Pick the desired event from the **Trigger On** dropdown (orders, customers, products, shipping, offers, and more) and the node automatically listens on `/webhook/<auto-id>/salla/<event>`. Every delivery emits a normalized payload:
|
|
86
|
+
|
|
87
|
+
```json
|
|
88
|
+
{
|
|
89
|
+
"ok": true,
|
|
90
|
+
"event": "order.status.updated",
|
|
91
|
+
"merchant": "1596416913",
|
|
92
|
+
"created_at": "2025-10-26T17:49:35.000Z",
|
|
93
|
+
"data": { ... original body or body.data ... },
|
|
94
|
+
"raw": {
|
|
95
|
+
"headers": { "X-Salla-Event": "order.status.updated", ... },
|
|
96
|
+
"body": { ...full request body... },
|
|
97
|
+
"query": { ... }
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Incoming notifications are validated against the selected event, de-duplicated by `X-Salla-Event-Id` (10 minute TTL), and acknowledgements for ignored or duplicate payloads return HTTP 200 with a descriptive body.
|
|
103
|
+
|
|
104
|
+
The **Webhook Path** field is optional—leave it blank to keep the default `/salla/<event>` suffix, or provide your own (it will be slugified and appended after `/webhook/<auto-id>/` when the workflow is saved).
|
|
105
|
+
|
|
106
|
+
### Deprecated triggers
|
|
107
|
+
|
|
108
|
+
- Customer Created (Salla) — **Deprecated** (use `Salla Triggers` with `customer.created`)
|
|
109
|
+
- Order Status Updated (Salla) — **Deprecated** (use `Salla Triggers` with `order.status.updated`)
|
|
110
|
+
|
|
111
|
+
Existing workflows keep working, but new automations should migrate to **Salla Triggers**.
|
|
112
|
+
|
|
113
|
+
## Proxy Fallback Helper
|
|
114
|
+
|
|
115
|
+
For QA you can call the legacy merchant proxy through the shared helper:
|
|
116
|
+
|
|
117
|
+
` s
|
|
118
|
+
const proxyResponse = await client.proxy({
|
|
119
|
+
method: 'GET',
|
|
120
|
+
path: '/v2/customers',
|
|
121
|
+
payload: { keyword: 'test@example.com' },
|
|
122
|
+
});
|
|
123
|
+
`
|
|
124
|
+
|
|
125
|
+
The helper automatically targets POST https://app.n8ndesigner.com/api/merchant/salla and reuses the timeout and retry policy.
|
|
126
|
+
|
|
127
|
+
## Testing Notes
|
|
128
|
+
|
|
129
|
+
QA references supplied by N8NDesigner:
|
|
130
|
+
|
|
131
|
+
- SALLA_MID=1596416913
|
|
132
|
+
- ORDER_ID=562285006
|
|
133
|
+
- customer_id=1924459692
|
|
134
|
+
|
|
135
|
+
Use the action nodes to update the order to under_review (expect HTTP 200 within ~2 seconds) and to delete the disposable customer (expect HTTP 204). Trigger payload samples live under ests/Fixtures/salla/*.json (add-ons for future test automation).
|
|
136
|
+
|
|
137
|
+
## Packaging
|
|
138
|
+
|
|
139
|
+
Run
|
|
140
|
+
pm pack to produce an npm tarball suitable for publishing or direct installation inside n8n.
|
|
@@ -7730,7 +7730,7 @@ var SallaActions = class {
|
|
|
7730
7730
|
group: ["transform"],
|
|
7731
7731
|
version: 1,
|
|
7732
7732
|
icon: "file:assets/salla-logo.svg",
|
|
7733
|
-
description: "
|
|
7733
|
+
description: "Execute Salla Merchant API operations through the unified Actions backend.",
|
|
7734
7734
|
codex: {
|
|
7735
7735
|
categories: ["Sales"],
|
|
7736
7736
|
subcategories: {
|
|
@@ -156,7 +156,8 @@ class SallaTriggers {
|
|
|
156
156
|
group: ["trigger"],
|
|
157
157
|
version: 1,
|
|
158
158
|
icon: "file:assets/salla-logo.svg",
|
|
159
|
-
description:
|
|
159
|
+
description:
|
|
160
|
+
"Receive and handle Salla webhook events routed through N8N Designer with support for multi-endpoint workflows and event-based routing",
|
|
160
161
|
subtitle: '={{$parameter["eventName"]}}',
|
|
161
162
|
defaults: {
|
|
162
163
|
name: "Salla Triggers (Legacy)",
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "n8n-nodes-n8ndesigner-salla-n8nai",
|
|
3
|
-
"version": "0.3.
|
|
4
|
-
"description": "
|
|
5
|
-
"license": "MIT",
|
|
3
|
+
"version": "0.3.160",
|
|
4
|
+
"description": "Salla nodes for n8n (Actions + Triggers)",
|
|
5
|
+
"license": "MIT",
|
|
6
6
|
"type": "commonjs",
|
|
7
7
|
"main": "dist/index.js",
|
|
8
8
|
"types": "dist/index.d.ts",
|
|
@@ -12,31 +12,18 @@
|
|
|
12
12
|
"README.md",
|
|
13
13
|
"LICENSE"
|
|
14
14
|
],
|
|
15
|
-
"keywords": [
|
|
16
|
-
"n8n-community-node",
|
|
17
|
-
"n8n",
|
|
18
|
-
"salla",
|
|
19
|
-
"ecommerce"
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
"
|
|
24
|
-
"n8n-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
"repository": {
|
|
28
|
-
"type": "git",
|
|
29
|
-
"url": "https://github.com/alhabir/n8n-nodes-n8ndesigner-salla-n8nai.git"
|
|
30
|
-
},
|
|
31
|
-
"bugs": {
|
|
32
|
-
"url": "https://github.com/alhabir/n8n-nodes-n8ndesigner-salla-n8nai/issues"
|
|
33
|
-
},
|
|
34
|
-
"author": "N8NDesigner",
|
|
35
|
-
"scripts": {
|
|
36
|
-
"build": "echo \"Skipping build; dist already compiled\"",
|
|
37
|
-
"pack:check": "npm pack --dry-run && tar -tf $(ls -1t n8n-nodes-salla-n8nai-*.tgz | head -n1)",
|
|
38
|
-
"publish:public": "npm publish --access public"
|
|
39
|
-
},
|
|
15
|
+
"keywords": [
|
|
16
|
+
"n8n-community-node",
|
|
17
|
+
"n8n",
|
|
18
|
+
"salla",
|
|
19
|
+
"ecommerce"
|
|
20
|
+
],
|
|
21
|
+
"author": "N8NDesigner",
|
|
22
|
+
"scripts": {
|
|
23
|
+
"build": "echo \"Skipping build; dist already compiled\"",
|
|
24
|
+
"pack:check": "npm pack --dry-run && tar -tf $(ls -1t n8n-nodes-salla-n8nai-*.tgz | head -n1)",
|
|
25
|
+
"publish:public": "npm publish --access public"
|
|
26
|
+
},
|
|
40
27
|
"dependencies": {
|
|
41
28
|
"n8n-workflow": "^1.116.0"
|
|
42
29
|
},
|