The STATUSIFACE field and processing

All purchasing and work order documents have a status. The STATUSIFACE field identifies whether related transactions contain new or updated records, or status changes only.

In general, the field STATUSIFACE applies to all object structure subrecords that are created from stateful MBOs, which are MBOs that have a STATUS field and support status change actions. The STATUSIFACE field is provided as a nonpersistent field to those objects where integration supports a status change.

The STATUSIFACE field and outbound processing

While processing an object structure subrecord that has been created from a stateful MBO, the outbound integration processing looks for a STATUS field in the MBO and a STATUSIFACE field in the corresponding object structure subrecord. If both fields exist, the processing sets the value of the STATUSIFACE field to the value of the changed attribute for the corresponding STATUS field. A value of 0 indicates that the status was not changed. A value of 1 indicates that the status was changed.

This processing applies only to event-generated outbound messages, not to messages exported via the data export feature or through a programmatic invocation.

The STATUSIFACE field and inbound processing

When processing an object structure where the primary (top) MBO is stateful, the inbound processing looks for a STATUSIFACE field on the corresponding object structure subrecord to determine if the inbound message is to be processed as both a document update and a status change, or as a status change only.

The following table describes inbound processing using object structures with a stateful primary (top) MBO. It does not apply to any stateful MBO that is included as a child object in an object structure.

Table 1. Actions taken during inbound processing of the STATUSIFACE field
Value of STATUSIFACE Document exists in the database Document does not exist in the database
Not provided, or 0
  • Updates the document in the database
  • If the status of the inbound document is different from the status in the database, updates the status in the database
  • Adds the document to the database
  • Sets the status in the database to the status of the inbound message
1 Updates the status in the database Error