Parceldaily icon

Parceldaily

Custom operations
Join our community

Actions2

Overview

This node integrates with the Parceldaily API to perform custom operations related to parcel and shipping services. Specifically, for the "Action" resource and the "Check Postcode State" operation, it verifies the state or region associated with a given postcode within a specified country. This can be useful in logistics workflows where validating address details is necessary before processing shipments.

Practical examples include:

  • Validating customer shipping addresses during order processing.
  • Ensuring that postcodes correspond to correct states for tax or regulatory compliance.
  • Automating address verification in e-commerce fulfillment pipelines.

Properties

Name Meaning
CJ Token The CJ token used for authenticating requests to the Parceldaily API.
Postcode The postcode (postal code) to check or validate.
Country The country corresponding to the postcode being checked.
Token An additional authentication token required by the API.
Merchant ID The merchant identifier associated with the API account or request context.

Output

The node outputs a JSON object containing the response from the Parceldaily API endpoint pd-check-postcode.php. This response typically includes information about the state or region corresponding to the provided postcode and country.

The output structure is:

{
  "json": {
    // API response fields indicating postcode validation results,
    // such as state name, status, or error messages.
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires access to the Parceldaily API at https://api.customje.com.
  • Needs valid authentication credentials: a CJ token, an authentication token, and a merchant ID.
  • The node uses a helper function (appCustomApiRequest) to make HTTP POST requests with JSON payloads.
  • No additional external dependencies beyond standard HTTP connectivity.

Troubleshooting

  • Common issues:

    • Invalid or expired tokens may cause authentication failures.
    • Incorrect or unsupported country/postcode combinations might result in errors or empty responses.
    • Network connectivity problems could prevent successful API calls.

  • Error messages:

    • "The operation \"check-postcode-state\" is not supported!" indicates the operation parameter was incorrect.
    • "The resource \"actions\" is not known!" means the resource parameter was invalid.
    • API errors returned from Parceldaily will be included in the node's output if "Continue On Fail" is enabled.

  • Resolutions:

    • Verify all tokens and merchant IDs are correct and active.
    • Confirm the postcode and country values conform to expected formats.
    • Check network access to https://api.customje.com.

Links and References

Discussion