About the POST ClosePOs API

The ClosePOs API is a POST Endpoint used to close the TMT PO after the final PO Invoice record has been posted successfully using the POInvoice POST.

Required values
- PONUMBER
- VENDORID
- POAMOUNT
- SHOPID

The POInvoice POST Endpoint will only allow the PO to be closed automatically if there is an exact match for the PO Amount and the total of the Received Receipt amounts. WorkOptima has provided an option to allow TMT users to define the Variance threshold. You can define the Variance threshold in WorkOptima as a percentage (+/- x%) of the total mismatch or a fixed dollar amount.

When you set this threshold the configuration option is enabled, the variable amount allows the PO to be closed automatically without requiring an exact match between the Invoice Amount and the total received amount.

ClosePOs API Error Use Case Guide

ClosePOs API Error Message	Explanation	Corrective Action
"Order is Closed/ Exported"	The PO was closed successfully	Task: The PO was closed as expected. Correct the PO Number on the invoice. TMT User: Request the vendor to resubmit with the correct PO Number. Image Integration User: User should delete the original erroneous invoice.
"Po Number Does Not Exist"	PO Number was not found in TMT	Task: Correct the PO Number on the invoice. TMT User: Request the vendor to resubmit with the correct PO Number. Image Integration User: User should delete the original erroneous invoice.
"Po Number Amount Does Not Match"	PO Amount doesn’t match Invoice	Task: Correct PO or Invoice amount. TMT User: Request the vendor to resubmit with the correct PO Number and/or amount. Image Integration User: User should delete the original erroneous invoice.
"Po Number Exists More Than Once. Need Shopid"	PO Number is not unique	Task: Provide the Shop Number for this PO and retry. TMT User/Image Integration User: Provide the Shop Number and retry.
"Po Number Not Received"	The PO must be in Received status.	Task: The PO has not been completely received. The PO must be completely received in order to close it. TMT User: Verify all items have been received or remaining items have been canceled and try again. Image Integration User: Retry again after all items have been received or canceled.
"Vendor Ro Number Not In Complete Status"	The selected Vendor RO must be in Completed status.	Task: Review the VRO and determine if it is ready to change to COMPLETE status in TMT. TMT User/Image Integration User: Change the VRO status to COMPLETE and retry.
"Vendorid Not Found In Vendors"	Vendor ID is invalid or missing	Task: Correct the Vendor ID in the API call. TMT User: Look up the vendor number on the TMT Purchase Order or add the Vendor in TMT if needed. Image Integration User: Provide the correct Vendor ID in the API and retry.
"ShopID must have a valid value"	Shop ID is invalid or missing	Task: Correct the Shop ID in the API call. TMT User: Look up the Shop number on the TMT Purchase Order. Image Integration User: Provide the correct Shop ID in the API and retry.
"Po Number Amount Does Not Match"	The PO Amount does not match the amount on the PO	Task: Correct the PO Amount in the API call. TMT User: Look up the PO Amount on the TMT Purchase Order. Image Integration User: Provide the correct PO Amount in the API and retry.

ClosePOs API Error Message

Explanation

Corrective Action

"Order is Closed/
Exported"

The PO was closed successfully

Task: The PO was closed as expected. Correct the PO Number on the invoice.

TMT User: Request the vendor to resubmit with the correct PO Number.

Image Integration User: User should delete the original erroneous invoice.

"Po Number Does Not Exist"

PO Number was not found in TMT

Task: Correct the PO Number on the invoice.

TMT User: Request the vendor to resubmit with the correct PO Number.

Image Integration User: User should delete the original erroneous invoice.

"Po Number Amount Does Not Match"

PO Amount doesn’t match Invoice

Task: Correct PO or Invoice amount.

TMT User: Request the vendor to resubmit with the correct PO Number and/or amount.

Image Integration User: User should delete the original erroneous invoice.

"Po Number Exists More Than Once. Need Shopid"

PO Number is not unique

Task: Provide the Shop Number for this PO and retry.

TMT User/Image Integration User: Provide the Shop Number and retry.

"Po Number Not Received"

The PO must be in Received status.

Task: The PO has not been completely received. The PO must be completely received in order to close it.

TMT User: Verify all items have been received or remaining items have been canceled and try again.

Image Integration User: Retry again after all items have been received or canceled.

"Vendor Ro Number Not In Complete Status"

The selected Vendor RO must be in Completed status.

Task: Review the VRO and determine if it is ready to change to COMPLETE status in TMT.

TMT User/Image Integration User: Change the VRO status to COMPLETE and retry.

"Vendorid Not Found In Vendors"

Vendor ID is invalid or missing

Task: Correct the Vendor ID in the API call.

TMT User: Look up the vendor number on the TMT Purchase Order or add the Vendor in TMT if needed.

Image Integration User: Provide the correct Vendor ID in the API and retry.

"ShopID must have a valid value"

Shop ID is invalid or missing

Task: Correct the Shop ID in the API call.

TMT User: Look up the Shop number on the TMT Purchase Order.

Image Integration User: Provide the correct Shop ID in the API and retry.

"Po Number Amount Does Not Match"

The PO Amount does not match the amount on the PO

Task: Correct the PO Amount in the API call.

TMT User: Look up the PO Amount on the TMT Purchase Order.

Image Integration User: Provide the correct PO Amount in the API and retry.