Sapo Thực Hiện Đơn Hàng icon

Sapo Thực Hiện Đơn Hàng

Quản lý thực hiện đơn hàng trên Sapo

Actions8

Overview

This node manages order fulfillments on the Sapo platform, allowing users to create, retrieve, update, cancel, and track fulfillment details for orders. It is useful in e-commerce workflows where automating order shipment processing and tracking is needed. For example, you can use it to automatically update tracking information when a package ships or to fetch detailed fulfillment status for customer service.

Common scenarios include:

  • Creating a new fulfillment record when an order is shipped.
  • Retrieving fulfillment details to check shipping status.
  • Updating tracking numbers and carrier information.
  • Canceling a fulfillment if an order is canceled.
  • Managing fulfillment events such as shipment updates or delivery notifications.

Properties

Name Meaning
Thao Tác The operation to perform: cancel, create, createEvent, deleteEvent, get, getCarriers, getMany, listEvents, updateTracking
ID Đơn Hàng The numeric ID of the order related to the fulfillment (required for most operations)
ID Thực Hiện The numeric ID of the fulfillment record (required for operations that target a specific fulfillment)
Trả Về Tất Cả Boolean flag to return all results or limit the number of results when listing multiple fulfillments
Giới Hạn Maximum number of results to return when not returning all (used with getMany operation)
Thông Tin Bổ Sung Additional optional filters for listing fulfillments, including status (cancelled, error, failure, open, pending, success), created_at_min/max, updated_at_min/max
ID Sự Kiện Numeric ID of a fulfillment event to delete (required for deleteEvent operation)
Dữ Liệu Thực Hiện JSON data for creating a new fulfillment (location_id, tracking_number, tracking_company, shipping_method, notify_customer)
Dữ Liệu Tracking JSON data for updating tracking info (tracking_number, tracking_company, tracking_url)
Dữ Liệu Sự Kiện JSON data for creating a fulfillment event (status, message, location)

Output

The node outputs a single JSON object containing the result of the requested operation:

  • For create, get, updateTracking, cancel, createEvent, deleteEvent: returns the fulfillment or event data or a success confirmation.
  • For getMany: returns a list of fulfillments, optionally filtered and limited.
  • For listEvents: returns an object with an events array containing fulfillment event details.
  • For getCarriers: returns an object with a carriers array listing available shipping carriers.

If an error occurs and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Sapo platform.
  • Depends on the internal SapoApiBase class to interact with the Sapo API endpoints.
  • No additional external services beyond Sapo's API are required.

Troubleshooting

  • Common issues:
    • Invalid or missing order or fulfillment IDs will cause API errors.
    • Incorrect JSON format in the data fields may lead to request failures.
    • Network or authentication errors if the API key is invalid or expired.
  • Error messages:
    • Errors from the Sapo API are propagated with their message; ensure correct parameters and valid credentials.
    • If the node throws a NodeApiError, check the stack trace and verify input parameters.
  • To resolve errors, verify all required fields are provided, JSON inputs are well-formed, and API credentials are correctly configured.

Links and References

Discussion