About the POST POInvoice API

The POInvoice API is a POST Endpoint used to update the Invoice Number, Invoice Date, and Invoice Amount to the TMT PO that was read from the invoice image.

Required Values
1. INVOICENUMBER
2. INVOICEAMOUNT
3. INVOICEDATE
4. PONUMBER
5. PAYMETHOD
Optional Values
1. Check Number
2. Check Date
3. Amount Paid
4. Packing Slip Number Standard PO: The API will populate these values if the PO has a status of Open, Received, or Closed. Vendor RO/PO: The API will populate these values if the VRO PO has a status of Open, Complete, or Closed. Notes:
  - If the POInvoice API is used with a new Invoice Number, a new POINVOICE record will be created.
  - If the POInvoice API is used with an existing Invoice Number, the existing record for the POINVOICE record will be updated.

POInvoice API Error Use Case Guide

POInvoice API Error Message	Description	Corrective Action
PO Invoice is Inserted/Updated	The PO Invoice information was successfully updated.	Task: The PO was inserted (if it didn’t already exist), or it was updated with the PO Invoice information on the PO Invoice tab of the PO. TMT User: No action required. Optional: Confirm the expected PO Invoice tab information was updated. Image Integration User: No action required.
Required parameters: InvoiceNumber, InvoiceAmount, InvoiceDate, PONumber, Pay Method.	Some or all four of these parameters are missing.	Task: Identify the missing parameter or parameters, include them in the API call and re-submit. TMT User: Research TMT to identify the correct PO Number. Image Integration User: Review the Invoice to identify the correct Invoice Number, Amount, and/or Date.
Multiple records found for the provided PO Number.	More than one PO Number exists for the PO Number that was submitted.	Task: Identify which PO Number belongs to the Invoice. TMT User: Research TMT to find the matching PO Number for the Invoice that was submitted. Image integration User: Provide the correct PO Number and Shop Number and retry.
PONumber is not found	The PO Number parameter is missing.	Task: Identify the missing PO Number and include it in the API call and re-submit. TMT User: Research TMT to identify the correct PO Number. Image Integration User: No action required.
PO Number is not valid.	The PO Number provided is not a valid PO Number in TMT.	Task: Identify the invalid PO Number and include it in the API call and re-submit. TMT User: Research TMT to identify the correct PO Number. Image Integration User: No action required.
Payment Method Is Not Found In Tmtcodes.	The Payment Method is Invalid or missing.	Task: Identify the correct and valid Payment Method, include it in the API call and re-submit. TMT User: Research TMT Setup > Payment Method to identify the correct Payment Method for the Vendor on the PO. Image Integration User: No action required.
More than one Receipt exists. Please assign the Receipt Number.	There is more than one Receipt received for the PO.	Task: Identify which Receipt belongs to the Invoice. TMT User: Research TMT to find the matching PO Number and Receipt for the Invoice that was submitted. Image integration User: Provide the correct PO Number and Receipt and retry. Note: You may need to manually select and link the Invoice record in the PO to correctly link the Invoice and Receipt Number.

POInvoice API Error Message

Description

Corrective Action

PO Invoice is Inserted/Updated

The PO Invoice information was successfully updated.

Task: The PO was inserted (if it didn’t already exist), or it was updated with the PO Invoice information on the PO Invoice tab of the PO.

TMT User: No action required. Optional: Confirm the expected PO Invoice tab information was updated.

Image Integration User: No action required.

Required parameters: InvoiceNumber, InvoiceAmount, InvoiceDate, PONumber, Pay Method.

Some or all four of these parameters are missing.

Task: Identify the missing parameter or parameters, include them in the API call and re-submit.

TMT User: Research TMT to identify the correct PO Number.

Image Integration User: Review the Invoice to identify the correct Invoice Number, Amount, and/or Date.

Multiple records found for the provided PO Number.

More than one PO Number exists for the PO Number that was submitted.

Task: Identify which PO Number belongs to the Invoice.

TMT User: Research TMT to find the matching PO Number for the Invoice that was submitted.

Image integration User: Provide the correct PO Number and Shop Number and retry.

PONumber is not found

The PO Number parameter is missing.

Task: Identify the missing PO Number and include it in the API call and re-submit.

TMT User: Research TMT to identify the correct PO Number.

Image Integration User: No action required.

PO Number is not valid.

The PO Number provided is not a valid PO Number in TMT.

Task: Identify the invalid PO Number and include it in the API call and re-submit.

TMT User: Research TMT to identify the correct PO Number.

Image Integration User: No action required.

Payment Method Is Not Found In Tmtcodes.

The Payment Method is Invalid or missing.

Task: Identify the correct and valid Payment Method, include it in the API call and re-submit.

TMT User: Research TMT Setup > Payment Method to identify the correct Payment Method for the Vendor on the PO.

Image Integration User: No action required.

More than one Receipt exists. Please assign the Receipt Number.

There is more than one Receipt received for the PO.

Task: Identify which Receipt belongs to the Invoice.

TMT User: Research TMT to find the matching PO Number and Receipt for the Invoice that was submitted.

Image integration User: Provide the correct PO Number and Receipt and retry.

Note: You may need to manually select and link the Invoice record in the PO to correctly link the Invoice and Receipt Number.