# Create record action

Use the Create record action to create a record in Orderful, such as a Transaction or Acknowledgment.

SUPPORTED TRANSACTION FORMATS

The Create record action supports creating transactions in both X12 and JSON formats. However, it supports creating an acknowledgment for JSON transactions only.

Acknowledgments for X12 transactions should be sent as 997 Functional Acknowledgments by the backend system that ingests the X12 file.

Orderful is configured to automatically acknowledge transactions by default, though this setting can be modified at the account and relationship level. You do not need to create an acknowledgment using the Create record action when automatic acknowledgments are enabled.

Refer to Orderful's documentation for more information about acknowledging a transaction (opens new window).

# Input

Input fields Description
Object Use the Object drop-down to select the record you plan to create. Available options include Transaction and Acknowledgment. You must be the recipient of a Transaction to create an Acknowledgment.
Transaction type Select a transaction type from the list of available EDI transaction types.
This field is available when you select Transaction as the object to create.
Refer to Orderful's documentation for more information about available transaction types (opens new window).
Stream Specify the stream that the transaction belongs to. For example, test refers to your testing environment and live refers to your production environment.
This field is available when you select Transaction as the object to create.
Sender Select an ISA ID from your organization's EDI accounts.
Receiver Enter the trading partner's ISA ID. This identifies the organization you're sending the EDI transaction to.
This field is available when you select Transaction as the object to create.
Message Provide the transaction document using the structure defined by the transaction type. Must be provided in JSON format.
This field is available when you select Transaction as the object to create.
Transaction ID Provide the ID of the transaction to acknowledge.
This field is available when you select Acknowledgment as the object to create.
Status Select an acknowledgment status, such as ACCEPTED or REJECTED.
This field is available when you select Acknowledgment as the object to create.
Refer to Orderful's documentation for more information about transaction statuses (opens new window).
Errors Input a list datapill.
This field is available when you select Acknowledgment as the object to create.
Path Input the error path.
This field is available when you select Acknowledgment as the object to create.
Code Input the error code.
This field is available when you select Acknowledgment as the object to create.
Message Input the error message.
This field is available when you select Acknowledgment as the object to create.

# Output

The output for this action is dynamic and depends on the object created in Orderful.

# Transaction object output

Output field Description
Transaction ID Unique identifier of the transaction.

# Acknowledgment object output

Output field Description
Status Indicates whether the acknowledgment was created successfully.


Last updated: 9/30/2025, 9:31:24 PM