Product
...
Now
The new version of the Onetrail Product API Now service allows for much faster and more efficient connection to the Onetrail services. It has been developed in order to reduce our footprint and maximize efficiency. Here are the ins and outs of this new Product API Now version.
Benefits
These are advantages of using the PnA5Product Now:
- RESTful services have a smaller footprint than SOAP, Parsing JSON is less computationally heavy and memory intensive then XML, however we can still support XML as well.
- Improved efficiency allows us to support bulk requests as well as single requests, this will allow buyers to retrieve multiple items with 1 request rather than multiple single requests.
- The health check will allow you to monitor the availability and uptime of the service.
Syntax
https://$base_url/pde/rest/v5/products?{SellerGLN}&{PDINumber}&{SellerVPN}&{GTIN}&{Quantity}&{BidID}
Example: httphttps://prd-tpn-pna-5.cloudrest.onetrail.net:8088/pdeproductApi/restv1/v5/products?SellerGLN=8714253023236&PDINumber=C7978A
- base_url:
- ACC: https://acc-rest.onetrail.net/productApi/v1/products
- PRD: https://restprd-tpn-pna-5.cloud.onetrail.net:8088/productApi/v1/products
- Variables:
- SellerGLN (multiple ; separated)= provide the GLN from the Seller
- PDINumber = Onetrail TPN™ PDI number
- SellerVPN = Seller Vendor part number
- GTIN = Seller Global Trade Item Number (EAN)
- Quantity = Quantity for which you want the price and availability
- BidID = Contract ID for the price of a contract product
- Remarks:
- At least one of the product numbers is mandatory;
Can now handle bulk requests as well as the usual single requests. (For bulk requests the URL is: https://rest.onetrail.net/productApi/v1/products/bulk)
Uses basic authentication and user managed in the TPN Manager.
It's now RESTful, no longer SOAP.
- Request Types:
In previous versions of Onetrail PnAProduct Now, HTTP-GET, REST and SOAP requests were all valid request types. With the current version we've streamlined to accept REST requests only. There are many reasons why, but the main benefits of REST over other request types are as mentioned above: It has a smaller footprint that SOAP, can handle JSON and XML as well as other data types, it's also generally faster, more efficient and requires less bandwidth.
...
- Method: GET
- Body: JSON/XML content. To set the content type you can use the following in your HTTP header:
- application/json
- application/xml
Authentication:
With our update to PnA5 Product Now, it also comes new improved authentication and user management. Every buyer and seller who is set up in the Onetrail TPN Manager will automatically have the rights to submit PnA requests. Previously Onetrail required Buyer credentials for a specific seller, but now it's not necessary.
Downloads
You'll need to load use a OpenAPI/Swagger file, this is only for JSON. Here's an example of what it should be like.
Download: ProductNow-OpenApiSample
