Salla icon

Salla

Interact with Salla.sa e-commerce platform API
Join our community

Actions38

Overview

The node integrates with the Salla.sa e-commerce platform API to retrieve shipment data. Specifically, the Shipment - Get All operation fetches multiple shipment records from the platform. It supports filtering shipments by status, date range, and search terms, and allows controlling the number of results returned.

This node is useful in scenarios where you want to automate workflows involving shipment tracking, reporting, or synchronization with other systems. For example, you could use it to:

  • Retrieve all active shipments created within a specific date range for monitoring delivery progress.
  • Fetch a limited number of recent shipments matching certain criteria for batch processing.
  • Search shipments by keywords to find specific orders or customers.

Properties

Name Meaning
Return All Whether to return all shipment results or limit the number of results returned.
Limit Maximum number of shipment results to return (applicable only if "Return All" is false).
Filters Collection of filters to narrow down the shipments retrieved:
   Status Filter shipments by one or more statuses: Active, Inactive, Draft, Pending, Completed, Cancelled.
   Date From Filter shipments created on or after this date/time.
   Date To Filter shipments created on or before this date/time.
   Search Search term to filter shipments by relevant text fields.

Output

The output is a JSON array where each element represents a shipment object as returned by the Salla API. Each shipment object contains details such as shipment ID, status, creation date, and other shipment-specific information.

If the "Return All" option is enabled, the node returns all matching shipments; otherwise, it returns up to the specified limit.

The node does not output binary data.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Salla API.
  • Relies on the sallaApiRequest and sallaApiRequestAllItems helper functions to make authenticated HTTP requests to the Salla API endpoints.
  • The node expects network connectivity to the Salla.sa platform.

Troubleshooting

  • Common issues:

    • Authentication errors due to missing or invalid API credentials.
    • Network connectivity problems preventing API calls.
    • Invalid filter values causing API request failures.

  • Error messages:

    • "The operation "getAll" is not supported for shipments!" — This indicates an internal logic error; ensure the operation parameter is correctly set to "getAll".
    • API errors returned from Salla (e.g., 401 Unauthorized, 400 Bad Request) will be surfaced as node execution errors. Verify credentials and input parameters.

  • Resolutions:

    • Double-check that the API key or OAuth2 token is correctly configured in n8n credentials.
    • Validate filter inputs, especially date formats and allowed status values.
    • Use the "Return All" option carefully to avoid large data loads that may impact performance.

Links and References

Discussion