The Update Document Order Item service is used to update the information stored in a existing Document Order Item that is on a Document Order that has a status of Ordered (Order Status).

This service can be accessed by systems with the PASI System User role.

The following information is provided when using this service (* denotes mandatory information):

• Document Order Identifier*
• Document Order Item Number*
• Document Order Item Status*
• Status Change Reason
• Amount Collected
• Control Schedule Identifier
• Document Delivery Method*
• Document Language*
• Number of Copies*
• Recipient Is Student*
• Recipient Name*
• Recipient Address Details including:
  • Street
  • City
  • Province
  • Postal Code
  • Country
• Recipient Fax Number
• Reorder Reason
• Special Handling Status*
• Document Processing Timeframe*
• Document Order Item Is Deleted*

Optionally, Transcript Order Item Specifics data attributes:

• Document Order Item Recipient Client Identifier
• Recipient Institution Identifier
• Recipient Digital Official Document Consumer
• Provided Consent for School Release

Optionally, Credential Order Item Specifics data attributes:

• Credential Number

The following rules are used to validate the information provided in the request:

• Rule 9014 - PASI Core Out of Date
• Rule 9023 - Empty Update
• Rule 60101 - Invalid Control Schedule
• Rule 60102 - Control Schedule Must Be In Future
• Rule 60105 - Re-Order Not Fully Specified
• Rule 60107 - Invalid Delivery Method
• Rule 60108 - Missing Recipient
• Rule 60109 - Order Item Specifics Don’t Match Document Type
• Rule 60110 - Credential Number Invalid
• Rule 60115 - Invalid Document Order Item
• Rule 60116 - Invalid Delivery Method
• Rule 60118 - Missing Status Change Reason
• Rule 60120 - Incorrect Service Used
• Rule 60121 - Invalid Document Order Item Modification
• Rule 60123 - Document Order Item Cannot Be Under Construction
• Rule 60126 - Order item amount exceeds maximum value
• Rule 60128 - Missing Credential Number
• Rule 60129 - Missing Control Schedule ID
• Rule 60131 - Incomplete Recipient Client Information
• Rule 60133 - Invalid Control Schedule Identifier
• Rule 60315 - Transcript Order for Empty Transcript
• Rule 60316 - Unable to order transcript
• Rule 60319 - Invalid Delivery Method
• Rule 82007 – Invalid Digital Document Consumer for Transcript

Note: All recipient mailing address validations are the responsibility of the service caller.
Note: Validation around the deleted flag are the responsibility of the service caller.

Once the request information has been validated the service will update the referenced document order item. The service does not perform any validations of content that might end up on the resulting document. A change in the Number of Copies will not affect the value in the Document Order Item’s Total amount. When a Document Order Item status is set to “Ordered”, any Document File and Document Generation Errors would be logically deleted (if they exist) from the Document Order Item to prepare it for re-processing.

When a Document Order Items status is set to “Cancelled” the following conditions exist:

• Document Type is Transcript (Document Type)
• Order Received Method is Integrated (Order Received Method)
• Order Item Status is being set to Cancelled (Order Item Status)
• The Document Order Item has no recorded Document Errors

If all of these conditions exist, then the service will:

• if the Delivery method is Electronic (Document Delivery Method), then add Rule 70008 - Transcript Request Cancelled error as a new Document Error to the Document Order Item along with the code text of the Status Change Reason.
• otherwise add Rule 60311 error as a new Document Error to the Document Order Item along with the code text of the Status Change Reason.

The usage of this service is audited using Service Auditing including the auditing of Caller Information.

A successful response to this service will include one Document Order Item containing:

• PASI Core Version