Questions

Do you have a single web service and single URI for multiple business documents, or can there be multiple based on business document?

How do you exchange public keys and passphrases? (e-mail, phone, or letter)?

What type of certificate will be used (CA or other third party)?

Will there be any specific error handling response?

What type of encryption will be used, and in what order (encryption or signature first)?

Will the messages be encrypted?

Is there only one WSLD for all business documents

Does your web service event drive synchronous response or is the request and response asynchronous?

Will the messages be signed?

Will there be only a generic SOAP envelope response or will it vary based on business document?

Does Nutrien support non standard ports?

Are there any SNI (Server Name Indication) requirements for these APIs?

Do you have a single web service and single URI for multiple business documents, or can there be multiple based on business document?

We are implementing an API Marketplace.  There will be multiple APIs based upon the business process requested. 

Back to top
How do you exchange public keys and passphrases? (e-mail, phone, or letter)?

The keys are obtained using the API marketplace and through User registration/approval of the Products in the Marketplace.

Back to top
What type of certificate will be used (CA or other third party)?

CA is the type of certificate.  Our certificates, including the intermediate and root CA are signed by DigiCert

Back to top
Will there be any specific error handling response?

Valid responses for each API are listed with each Product specification on the API Marketplace.

Back to top
What type of encryption will be used, and in what order (encryption or signature first)?

Authentication is based upon oAuth and enforced using API-Keys, Consumer Secret Keys and Bearer Tokens.

Back to top
Will the messages be encrypted?

TLS (Transport Layer Security, whose predecessor is SSL) is the standard security technology for establishing an encrypted link between a web server and a web client, such as a browser or an app. An encrypted link ensures that all data passing between the server and the client remains private.

Back to top
Is there only one WSLD for all business documents

The concept of WSDL is not applicable in the API Marketplace.  Instead, APIs are grouped by Business Function within a Developer Portal.  The Developer Portal displays different types of APIs, grouped by functions called Products. With specific APIs, users can then subscribe to the Products, create Apps and test the API calls.  Using AgGateway standards, either XML or JSON inputs are accepted.

Back to top
Will the messages be signed?

Authentication is based upon oAuth and enforced using API-Keys, Consumer Secret Keys and Bearer Tokens.

Back to top
Will there be only a generic SOAP envelope response or will it vary based on business document?

There are separate APIs per business function.  The responses will vary based upon function, but the format should be consistent.

Back to top
Does Nutrien support non standard ports?

Nutrien can support requests for ports other than 80/443. 

If your organization requires connectivity through a non standard port, please reach out to ITSupportB2B@nutrien.com for our Non Standard Port Request Questionnaire.  Once provided, it will be reviewed and actioned internally by our Network Security team. 

Back to top
Are there any SNI (Server Name Indication) requirements for these APIs?

Our APIs served via “api.nutrien.com” require inbound connections to use SNI (Server Name Indication).   If your configuration does not support SNI, you must instead connect using our API provider’s default certificate, available at “https://nutrien-prod-prod.apigee.net”.  This default certificate is rotated periodically; to be notified when this occurs, please subscribe to the status page at https://status.apigee.com and click on the [Subscribe to Updates] button.

Back to top