CyberStore Ecommerce 2023 Documentation
The Process Punch Out Invoices Operation
In This Topic

The Process Punch Out Invoices  operation is used to process PunchOut sales orders for invoicing.

Command ProcessPunchOutInvoices

Remarks

When the operation runs, it process any pending Punch Out invoices and sends them to the originating procurement system. 

When the ProcessPunchOutInvoices Operation Command is executed by the Opeartion Agent, it will determine the list of sales orders in scope using the configured agent parameters (if any). The agent will then spawn a new Operation Transaction and process through each item, one at a time and do the following:

  1. Query SYSPRO Accounts Receivable to retrieve any invoices tied to sales orders that were previously created by the CyberStore PunchOut Add On - Order Intake Module (PO1). 
  2. Transform the invoice data returned from SYSPRO into the appropriate PunchOut cXML using the configured XSLT file.
  3. Transmit the invoice cXML document to the configured invoice location linked to the procurement system of the Customer.
  4. Add the invoice number to a list of sent invoices tied to each sales order (or each invoiced dispatch note tied to each sales order)
  5. Determine if the sales order is considered closed (fully shipped) or not, and mark the sales order as "fully invoiced" if so, and as a "partial invoice" if not.
  6. Repeat for all returned invoices.
  7. Record any issues during each Transaction Cycle    
  8. Complete the transaction, log the operation details with information about any Items that may have caused error, and send emails as configured in the Operation Center settings.

Available Agent Parameters

When setting up an ProcessPunchOutInvoices operation in the operation center, you can limit the scope of the sales orders and invoices to process using the arguments in the Settings tab.

Arguments can be used together or individually in a single operation.

Parameter Description Example

Clear

Clears all punchout invoice history in CyberStore related a list of specified sales order numbers. Doing so will effectively result in re-processing invoices tied to the orders that were cleared.

Note:  If invoices are re-sent through punch out, it will likely result in errors from the remote procurement system due to duplicate invoice numbers. When using the clear attribute, after running the clearing action, the operation will end without processing any sales orders. If no sales orders are specified, the operation will not clear any sales order and will process sales orders as normal. 

 

clear:4140, 4142

Orders

Limits the scope of sales orders to process based an the specified list of sales order numbers.

Orders:4140, 4142

OrderStartDate

OrderEndDate

Limits the scope of sales orders to process based on start and/or end order dates in M/D/YYYY or MM/DD/YYYY format.

If the start date is include without and end date, then today's date is used for the end of the range. If an end date is included without a start date then the date January 1, 2000 (01/01/2000) is used for the start of the range.

OrderStartDate: 1/1/2021 OrderEndDate: 03/1/2021

InvoiceStartDate

InvoiceEndDate

Limits the scope of invoices that will be sent based on start and/or end invoice dates in M/D/YYYY or MM/DD/YYYY format.

If the start date is include without and end date, then today's date is used for the end of the range. If an end date is included without a start date then the date January 1, 2000 (01/01/2000) is used for the start of the range.

InvoiceStartDate: 1/1/2021 InvoiceEndDate: 03/1/2021
TestMode Causes the process of the operation to not send the invoices to the specified endpoint, but rather handle as though a success had been achieved and then processing of the orders linked to the invoices ocurrs TestMode: true
See Also

User's Guide

Tools