You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Raley PO exposes HTTP REST endpoints which you can use to facilitate B2B integration with your own system(s).

Authorization

The authorization is implemented via HTTP header "Authorization". Every time you execute a method call on our API you have to provide a valid value in this header. 

To get the value of Authorization header, navigate to Raley Apps configuration page and then click on API & Integrations tab. Then copy the value from API Key and use in in your application(s) to retrieve and modify data in Raley PO.

You can always regenerate the Auhtorization header, however, make sure that you've updated your systems which are making use of it.


Available APIs

The following table lists available REST API methods that a third party service can invoke. URL's must start with https://po.raleyapps.com/ and end with the URL suffix as indicated in the table below


MethodURL suffixDescriptionExample Response
GET
api/v1/external/get-suppliers
Returns list of suppliers configured for given installation of Raley PO. Archived suppliers are not returned

[
{
"id": 291,
"name": "Test supplier",
"phone": "555 5555",
"email": "contact@supplier.com",
"address": "Address of supplier",
"notes": "",
"paymentDetails": "DE72392732643627",
"taxNo": "DE8473273",
"contact": "",
"terms": "NET30",
"archived": false
}
]

GET
api/v1/external/get-taxes
Returns list of taxes configured for given installation of Raley PO. Archived taxes are not returned

[
{
"id": 120,
"name": "Default tax",
"value": "20.0",
"isDefault": true,
"archived": false,
"companyId": 217
}
]

GET
api/v1/external/find-products-by-sku?sku=SKU_VALUE

Finds and returns list of product that match by given SKU identifier SKU_VALUE. Both, active and archived products can be returned.

This methods returns HTTP 404 if no products are found. 

[
 {
   "id": 1413,
   "sku": "abc",
   "description": "Mazutka",
   "unitPrice": 5323.0,
   "supplierId": 291,
   "taxRate": {
   "id": 120,
   "name": "Default tax",
   "value": "20.0",
   "isDefault": true,
   "archived": false,
   "companyId": 217
 },
 "active": true,
 "approved": true,
 "productApprovalType": null
}
]

POST
api/v1/external/create-product


PUT
api/v1/external/update-product