Punchout Prerequisites
Before you are able to start building your punchout implementation, you must obtain / provide the following items:
- Provide Seller with Shipping Addresses
- Obtain / Provide Punch Out Credentials
Shipping Addresses
As an enterprise buyer, you may have multiple shipping addresses where you may need the goods to be shipped too.
Such requirements need to be communicated with your seller.
Address Data Requirements
Most sellers would require you to give them data that contains these information.
| Property | Description | Type |
|---|---|---|
| addressId | The unique identifier for the address | String |
| full address | The address spelled in full | String |
| city | The city for the address | String |
| isoCountryCode | The Alpha-2 ISO country code "SG" || "US" || "AU" || "JP" | String |
| postalCode | The postal code of the address | String |
Sample Address Data
Below is a sample excel sheet that your supplier may ask for.
| addressId | full address | city | isoCountryCode | postalCode |
|---|---|---|---|---|
| AMK1 | Block 4010, Ang Mo Kio Ave 10, #04-03 techplace 1 | Singapore | SG | 569626 |
| SJI | 61 Seraya Avenue, Seraya Plant, Jurong Island | Singapore | SG | 627879 |
| EZ | 802 French Rd, #01-61 | Singapore | SG | 200802 |
Punch Out Credentials
These credentials are used to identify and verify an incoming punchout request.
Usually, buyers will be providing the credentials because they are using a procurement system (SAP, Oracle & Workday) that has predefined credentials when it was designed.
If your system does not have predefined requirements, you may seek these details from your seller. If you are trying to implement punchout with eezee, you may request for credentials at our help page.
NOTE: Except for the Punch Out Url, Both parties( buyers & suppliers ) are able to issue these credentials.
1. Punchout Buyer Id
The identification number / username for the buyer.
2. Punchout Seller Id
The identification number / username for the seller.
3. Punchout Network Id
The field that identifies the network that is sending the request.
Possible Values are: "Ariba" || "Oracle" || "Workday"
4. Punchout Shared Secret
The shared secret between a buyer and a seller. This value is used to verify the party that is trying to punchout into the seller's punchout catalog.
5. Seller Punch Out Url
Also referred to as the API endpoint for punchout. This URL should be served using HTTPS to prevent hackers from stealing your information.
NOTE: Please request your seller to use HTTPS if they do not already do so.
Summary
With the administrative work out of the way, we may proceed with implementing the first step of the punchout spec.
The Punch Out Setup Request (POSReq).