Purchase Order

From PhpCOIN Documentation

Jump to: navigation, search

A Purchase Order is basically an invoice with no payment ~ you have not received any money yet. You could set up an Invoice paylink and ask the client to provide their PO# as per the example below. Or you could create a fully automated Purchase Order paylink ~ albeit with some code writing and database manipulation.

Creating a Purchase Order paylink requires capturing the PO#. You need to know the PO# so it can be reconciled against an order within phpCOIN, and an invoice sent with the Purchase Order Number (PO#) on it.

Also it should be noted that most companies that use Purchase Orders generally will not send out a payment without first receiving an invoice with their PO# on it. Currently to capture the PO# you would have to edit the database to add a field to the invoice, and also edit code to work with the new field.

If you do not want to write custom code for your version of phpCOIN, the following paylink example will most likely do for now.

  1. Log into phpCOIN on your website as an admin
  2. Add the vendor
  3. Add paylinks

Admin -> Vendors

If Purchase Order exists in the list of available vendors, you can simply edit the existing record. If it does not exist, then click [Add New] to add Purchase Order as a payment method that you will accept. The info should look like the following:

Vendor ID:  	(will be auto-completed by phpCOIN)
Status:  	On (Off if you wish to stop accepting this payment method)
Vendor Name:  	Invoice/Purchase Order (for the drop-down lists)
Buy Return Param Name:  	po
Buy Return Param Value:  	1
URL / Website:  	http://my.phpcoin.com/mod.php?mod=orders&mode=return
Use IPN:  	YES (We do NOT want phpCOIN to mark the invoice as
               paid if the user clicks the confirm button)

Admin -> PayLinks

Select the PayLink you want to edit, or click [Create New] to create a new one. Paste the following code into the order link, changing the parameters shown in bold:

 Vendor Product Id:  	(Auto-created by phpCOIN)
 Vendor ID:  	(From the drop-down, choose "Purchase Order")
 Product ID:  	(From the drop-down, choose the product that this
                paylink applies to)
 Description:  Purchase Order Product x (for listing)
 Order Link:  	Insert your instructions or form link, similar
               to the following:
 code of a FORM with a text box for the PO# and a submit button
   that e-mails your billing department and/or updates the database.

In the above link, the <> tells phpCOIN that it should replace the tag name with the actual value at run-time. For example, leaving <return_link_buy> means that phpCOIN will enter the actual return URL when it displays an order paylink. It also means that you could move your site to another URL entirely but would not need to adjust your paylinks.

Lather, Rinse, Repeat

Repeat the above steps as many times as necessary, so that you end up with one PayLink for each product or service that will allow Purchase Order as a payment method.

Personal tools

Inscrita el Registro Mercantil de Mallorca Tomo 2140, Hoja No. PM-51034, Folio 135
This website owned and operated by: Technology Services RPVW S.L. CIF# B57345084
Avda Constitucion 48 Bajos Alaro 07340 Baleares SPAIN
Tel:+34 971518362    Fax: +34 971518368    eMail: support@phpcoin.com