{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The NorthScope Web Services API exposes a single endpoint for developers to issue automated requests against the NorthScope system and receive information about the current state of the system. NorthScope exposes several Request Types (listed below), each accepting their own request information and returning their own request-specific response document. The endpoint is exposed at the same location as the NorthScope web application (will vary from environment to environment), in the services folder.","type":"text"}]},{"type":"paragraph","content":[{"text":"If your NorthScope installation is accessible at ","type":"text"},{"text":"NorthScope.example.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://NorthScope.example.com"}}]},{"text":", the endpoint would be located at: ","type":"text"},{"text":"NorthScope.example.com/services/ActionCommand.svc/APIExecute","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"http://NorthScope.example.com/services/ActionCommand.svc/APIExecute"}}]}]},{"type":"paragraph","content":[{"text":"From a high level, the process flow is as follows:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":450,"id":"22743de0-621c-495e-a557-8271e10e6e89","collection":"contentId-1253441544","type":"file","height":182}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Anatomy of a Request","type":"text"}]},{"type":"paragraph","content":[{"text":"NorthScope accepts requests in either JSON or XML formats. The Web Services API will respond to a request with a document in the same format as it was requested. For example, if you make a request with a JSON document you will receive a JSON response.","type":"text"}]},{"type":"paragraph","content":[{"text":"Independent of format, the HTTP POST body will contain the document outlining both which request is being called and any parameters being supplied for. All requests have a root element named ","type":"text"},{"text":"NSRequest","type":"text","marks":[{"type":"strong"}]},{"text":", which has two child elements: ","type":"text"},{"text":"RequestName","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"RequestContent","type":"text","marks":[{"type":"strong"}]},{"text":". The value of RequestName defines which action is being requested. The value of RequestContent will vary from request to request and will contain the request-specific parameters (if necessary). Some requests do not accept any parameters and in those cases RequestContent can either be omitted or left as an empty element.","type":"text"}]},{"type":"paragraph","content":[{"text":"All requests will return with a basic set of information and will include request-specific return information. Much like the request body, the response body will consist of a root element named ","type":"text"},{"text":"NSResponse","type":"text","marks":[{"type":"strong"}]},{"text":", which will always include two children elements: ","type":"text"},{"text":"Timestamp","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Success","type":"text","marks":[{"type":"strong"}]},{"text":". Timestamp will indicate the time at which the NorthScope Web Services API responded to the request and Success will be a Boolean indicating whether the request itself succeed or not.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Obtaining a Token","type":"text"}]},{"type":"paragraph","content":[{"text":"Authentication to the NorthScope Data Service can be accomplished by one of two means: static or session-based tokens. By supporting these two methods, NorthScope can accommodate the authentication requirements for many integration partners.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using a static token","type":"text"}]},{"type":"paragraph","content":[{"text":"To use a static token, you must have a user configured in NorthScope that contains the API Key (token). Go to System > Users & Security > Users and either add a new user or edit an existing user that will be used for the API. On the Properties tab of the user, set the ‘API Authentication Mode’ to “Static Token’ and click the Save icon in the toolbar. When the page refreshes a new ‘API Key’ property will be visible, click the ‘Generate API Key’ icon in the toolbar to generate the token id. Once this is set, pass this information along to the party you are integrating with so they can use this value when using the API.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: It is recommended that you add a unique user for this process rather than using an existing user as this process is session specific so more than one process cannot be using NorthScope at the same time.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Requesting a session token","type":"text"}]},{"type":"paragraph","content":[{"text":"The request to obtain a token is made using the GenerateSessionToken request. This is the ","type":"text"},{"text":"only request ","type":"text","marks":[{"type":"strong"}]},{"text":"in the NorthScope Web Services API that does not require authentication information in the HTTP headers. The purpose of this request it to accept authentication information to be used in subsequent API calls.","type":"text"}]},{"type":"paragraph","content":[{"text":"When calling the GenerateSessionToken process to create a new token for use in subsequent requests, these headers may be omitted (they will ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" be used if supplied).","type":"text"}]},{"type":"paragraph","content":[{"text":"The token created from the GenerateSessionToken process will be tied to both the specific user that generated it as well as the IP address of the machine that issued the request. One user can only be authenticated from one location at a time (including the website itself) which means if a user attempts to both authenticate via the NorthScope Web Services API and log in to NorthScope itself, the earlier authentication will be invalidated.","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[79.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"RequestName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[79.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"GenerateSessionToken","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"LoginEmail","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[79.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"The email address of the NorthScope User for whom the token is being generated.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.0]},"content":[{"type":"paragraph","content":[{"text":"Password","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[79.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[545.0]},"content":[{"type":"paragraph","content":[{"text":"The password to authenticate that user.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"GenerateSessionToken: JSON Example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\n\n{\n \"NSRequest\": {\n \"RequestName\": \"GenerateSessionToken\",\n \"RequestContent\": {\n \"LoginEmail\": \"TestAPIUser@NorthScope.example.com\",\n \"Password\": \"StrongPassword\"\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"GenerateSessionToken: XML Example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\n\n\n GenerateSessionToken\n \n TestAPIUser@NorthScope.example.com\n StrongPassword\n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If the request was valid, a response will be sent as follows:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"GenerateSessionToken Response: JSON Example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"NSResponse\": {\n \"Timestamp\": \"2018-09-20T15:21:23.425\",\n \"Success\": \"true\",\n \"ResponseContent\": {\n \"SessionToken\": \"00000000-0000-0000-0000-000000000000\"\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"GenerateSessionToken Response: XML Example","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2018-09-20T15:21:23.425\n true\n \n 00000000-0000-0000-0000-000000000000\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"If an invalid authentication request is made, the following result will be generated:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Validation failure in JSON","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"NSResponse\": {\n \"Timestamp\": \"2018-09-20T14:57:51.830\",\n \"Success\": \"false\",\n \"Error\": \"The login information that was provided was invalid.\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Validation failure in XML","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2018-09-20T14:57:51.830\n false\n The login information that was provided was invalid.\n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Authenticating a Request","type":"text"}]},{"type":"paragraph","content":[{"text":"Except the request GenerateSessionToken, all other requests issued against the NorthScope Web Services API require authentication information. This information is supplied as headers in the HTTP request. The two headers required to be supplied are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NSLogin:","type":"text","marks":[{"type":"strong"}]},{"text":" This will house the email address of the user being authenticated.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NSAPISession:","type":"text","marks":[{"type":"strong"}]},{"text":" This will house the token returned from a previous GenerateSessionToken request.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When calling the GenerateSessionToken process to create a new token for use in subsequent requests, these headers may be omitted (they will ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" be used if supplied).","type":"text"}]},{"type":"paragraph","content":[{"text":"The token created from the GenerateSessionToken process will be tied to both the specific user that generated it as well as the IP address of the machine that issued the request. One user can only be authenticated from one location at a time (including the website itself) which means if a user attempts to both authenticate via the NorthScope Web Services API and log in to NorthScope itself, the earlier authentication will be invalidated.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the event the incorrect information is supplied, either when generating a new session token or when using a previously fetched token, you will receive an error from the web service of the following structure:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Validation failure in JSON","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"NSResponse\": {\n \"Timestamp\": \"2018-09-20T14:57:51.830\",\n \"Success\": \"false\",\n \"Error\": \"The login information that was provided was invalid.\"\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: Validation failure in XML","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2018-09-20T14:57:51.830\n false\n The login information that was provided was invalid.\n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Using a Static or Session token to make subsequent requests","type":"text"}]},{"type":"paragraph","content":[{"text":" Once you have generated an API Session Token or are assigned a static token, you can then supply it, along with the login email, in subsequent requests like so:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n\tListCompanies\n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Testing the Web Service API via Postman","type":"text"}]},{"type":"paragraph","content":[{"text":"Postman is a free tool for developers and can be used to test web service requests. You can find it at: ","type":"text"},{"text":"https://www.getpostman.com/","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.getpostman.com/"}}]},{"text":". ","type":"text"}]},{"type":"paragraph","content":[{"text":"With this tool, it’s easy to test web service requests. Follow these instructions to test your first command. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"How to test your first command","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Part 1. Obtain a token","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: This is only necessary if you are using a user that is not setup to use a static token. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Referencing the two screenshots below, set the following information","type":"text"}]},{"type":"paragraph","content":[{"text":"0. Download and install Postman. ","type":"text"}]},{"type":"paragraph","content":[{"text":"1. Set the URL of the web service request. This is usually the NorthScope URL + '/services/ActionCommand.svc/APIExecute'.","type":"text"}]},{"type":"paragraph","content":[{"text":"2. Set the request type to ","type":"text"},{"text":"POST","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"3. Set the message format to ","type":"text"},{"text":"Text","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"4. Enter the login request XML into the bottom left pane.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1129,"id":"76de2688-e096-4733-af55-ac50030512cd","collection":"contentId-1253441544","type":"file","height":823}}]},{"type":"paragraph","content":[{"text":"5. Verify in the headers tab that no other other headers have been set, other than those shown in the screenshot below","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1129,"id":"f29b46fc-0346-4e2b-8c93-65457861b78c","collection":"contentId-1253441544","type":"file","height":823}}]},{"type":"paragraph","content":[{"text":"6. Click the send button to issue the request. The pane in the bottom right should show true and have a valid session token you can use for step 2.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Part 2. Send a request for data","type":"text"}]},{"type":"paragraph","content":[{"text":"1. Modify the bottom left pane to use the ListCompanies request XML.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1129,"id":"40392639-9222-4fd0-8f4b-d9f0f9fad18c","collection":"contentId-1253441544","type":"file","height":823}}]},{"type":"paragraph","content":[{"text":"2. In the headers tab, add a header for NSLogin. Set this to equal the email address used in part 1","type":"text"}]},{"type":"paragraph","content":[{"text":"3. Add another header for NSAPISession. Set this to equal the token retrieved from part 1.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1129,"id":"8289e4be-af71-43c0-a8e9-d64559412a44","collection":"contentId-1253441544","type":"file","height":823}}]},{"type":"paragraph","content":[{"text":"Click the send button to issue the ListCompanies request. If the system is working properly, you will see a response in the lower right pane with a list of companies from the instance of NorthScope. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Now you’re able to test any of the web service requests listed below. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Available Requests","type":"text"}]},{"type":"paragraph","content":[{"text":"The NorthScope Web Services API exposes the following requests to perform automated functionality within the NorthScope system.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListCompanies","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will provide a list of NorthScope companies your user has access to along with the numeric identifier, DataEntityCompanySK, which may be required by other API requests. This information is not likely to change so it usually would only need to be called once (to fetch and store known companies).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"paragraph","content":[{"text":"This request accepts no parameters, the RequestContent node could be omitted entirely (or left empty).","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Requests","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com \nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n{\n \"NSRequest\": {\n \"RequestName\": \"ListCompanies\"\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n ListCompanies\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Responses","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"NSResponse\": {\n \"Timestamp\": \"2018-09-20T15:58:07.367\",\n \"Success\": \"true\",\n \"Companies\": {\n \"Company\": [\n {\n \"DataEntityCompanySK\": \"1\",\n \"CompanyID\": \"WESTTEST\",\n \"CompanyName\": \"West Coast Testing Company\"\n },\n {\n \"DataEntityCompanySK\": \"2\",\n \"CompanyID\": \"EASTTEST\",\n \"CompanyName\": \"East Coast Testing Company\"\n }\n ]\n }\n }\n}\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2018-09-20T15:58:07.367\n true\n \n \n 1\n WESTTEST\n West Coast Testing Company\n \n \n 2\n EASTTEST\n East Coast Testing Company\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListSalesOrders","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will generate a list of Sales Orders in a given NorthScope company that match the supplied filtering criteria. Except for the DataEntityCompanySK, all criteria are not required, and you could provide multiple of any other criteria. The Sales Orders returned must match any of the provided criteria of a type. For instance, if you supply criteria of multiple sites and multiple order date ranges, any sales order that both matches one of the provided sites and one of the provided ranges will be returned.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull Sales Orders.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"Status","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The desired status for returned Sales Orders. Available values are: New, Released, In Process, Staging, Loading, Shipped, Approved, Ready To Post, Posted, or Void.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"OrderDateFrom","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The lower bound for an acceptable date range for Sales Orders’ Order Date, inclusive.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"OrderDateTo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The upper bound for an acceptable date range for Sales Orders’ Order Date, inclusive.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"ScheduledShipDateFrom","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The lower bound for an acceptable date range for Sales Orders’ Scheduled Ship Date, inclusive.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"ScheduledShipDateTo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The upper bound for an acceptable date range for Sales Orders’ Scheduled Ship Date, inclusive.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"LineItemSite","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The desired Site for any Sales Orders’ Line Items. If this is provided the returned Line Items may not reflect all items on a returned Sales Order, if it has items that span Sites.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"LineItemCarrier","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The desired Carrier for any Sales Orders’ Line Items. If this is provided the returned Line Items may not reflect all items on a returned Sales Order, if it has items that span Carriers.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[170.0]},"content":[{"type":"paragraph","content":[{"text":"LoadID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[76.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[514.0]},"content":[{"type":"paragraph","content":[{"text":"The desired LoadID’s for any Sales Orders’ Line Items. If this is provided the returned Line Items may not reflect all items on a returned Sales Order, if it has items that span Loads.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Requests","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com \nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n{\n \"NSRequest\": {\n \"RequestName\": \"ListSalesOrders\",\n \"RequestContent\": {\n \"DataEntityCompanySK\": \"1\",\n \"Statuses\": {\n \"Status\": [\n \"New\",\n \"Released\"\n ]\n },\n \"OrderDateRanges\": {\n \"OrderDateRange\": [\n { \"OrderDateTo\": \"2016-01-01\" },\n {\n \"OrderDateFrom\": \"2017-01-01\",\n \"OrderDateTo\": \"2018-01-01\"\n },\n { \"OrderDateFrom\": \"2019-01-01\" }\n ]\n },\n \"ScheduledShipDateRanges\": {\n \"ScheduledShipDateRange\": [\n { \"ScheduledShipDateTo\": \"2016-01-01\" },\n {\n \"ScheduledShipDateFrom\": \"2017-01-01\",\n \"ScheduledShipDateTo\": \"2018-01-01\"\n },\n { \"ScheduledShipDateFrom\": \"2019-01-01\" }\n ]\n },\n \"LineItemSites\": {\n \"LineItemSite\": [\n \"PRIMARY\",\n \"SECONDARY\"\n ]\n },\n \"LineItemCarriers\": {\n \"LineItemCarrier\": [\n \"Our Truck\",\n \"3rd Party\"\n ]\n },\n \"LoadIDs\": {\n \"LoadID\": [\n \"12345\",\n \"54321\"\n ]\n }\n }\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n ListSalesOrders\n \n 1\n \n New\n Released\n \n \n \n 2016-01-01\n \n \n 2017-01-01\n 2018-01-01\n \n \n 2019-01-01\n \n \n \n \n 2016-01-01\n \n \n 2017-01-01\n 2018-01-01\n \n \n 2019-01-01\n \n \n \n PRIMARY\n SECONDARY\n \n \n Our Truck\n 3rd Party\n \n \n 12345\n 54321\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Responses","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"NSResponse\": {\n \"Timestamp\": \"2018-09-21T09:30:35.137\",\n \"Success\": \"true\",\n \"SalesOrders\": {\n \"SalesOrder\": [\n {\n \"OrderHeaderSK\": \"1\",\n \"OrderID\": \"ORD180920001\",\n \"OrderStatus\": \"New\",\n \"Customer\": \"TESTCUST\",\n \"OrderDate\": \"2018-09-21T00:00:00\",\n \"ScheduledShipDate\": \"2018-09-21T00:00:00\",\n \"ScheduledDeliveryDate\": \"2018-09-21T00:00:00\",\n \"LineItems\": {\n \"LineItem\": {\n \"OrderItemSK\": \"1\",\n \"Site\": \"PRIMARY\",\n \"ItemSort\": \"1\",\n \"ItemID\": \"ITEM1\",\n \"OrderedUnits\": \"5.00000\",\n \"AllocatedUnits\": \"0.00000\",\n \"UnitsUOM\": \"Case\",\n \"OrderedWeight\": \"113.40000\",\n \"AllocatedWeight\": \"0.00000\",\n \"WeightUOM\": \"kg\",\n \"PriceOption\": \"Units\",\n \"ItemPrice\": \"3.00000\",\n \"LoadID\": \"54321\"\n }\n }\n },\n {\n \"OrderHeaderSK\": \"2\",\n \"OrderID\": \"ORD180920002\",\n \"OrderStatus\": \"New\",\n \"Customer\": \"TESTCUST\",\n \"OrderDate\": \"2018-09-21T00:00:00\",\n \"ScheduledShipDate\": \"2018-09-21T00:00:00\",\n \"ScheduledDeliveryDate\": \"2018-09-21T00:00:00\",\n \"LineItems\": {\n \"LineItem\": [\n {\n \"OrderItemSK\": \"2\",\n \"Site\": \"SECONDARY\",\n \"ItemSort\": \"1\",\n \"ItemID\": \"ITEM1\",\n \"OrderedUnits\": \"5.00000\",\n \"AllocatedUnits\": \"0.00000\",\n \"UnitsUOM\": \"Case\",\n \"OrderedWeight\": \"113.40000\",\n \"AllocatedWeight\": \"0.00000\",\n \"WeightUOM\": \"kg\",\n \"PriceOption\": \"Units\",\n \"ItemPrice\": \"2.00000\",\n \"Carrier\": \"Our Truck\",\n \"LoadID\": \"12345\"\n },\n {\n \"OrderItemSK\": \"3\",\n \"Site\": \"SECONDARY\",\n \"ItemSort\": \"2\",\n \"ItemID\": \"ITEM2\",\n \"OrderedUnits\": \"5.00000\",\n \"AllocatedUnits\": \"0.00000\",\n \"UnitsUOM\": \"Case\",\n \"OrderedWeight\": \"113.40000\",\n \"AllocatedWeight\": \"0.00000\",\n \"WeightUOM\": \"kg\",\n \"PriceOption\": \"Units\",\n \"ItemPrice\": \"3.00000\",\n \"Carrier\": \"Our Truck\",\n \"LoadID\": \"12345\"\n }\n ]\n }\n }\n ]\n }\n }\n}\n","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2018-09-21T09:30:35.137\n true\n \n \n 1\n ORD180920001\n New\n TESTCUST\n 2018-09-21T00:00:00\n 2018-09-21T00:00:00\n 2018-09-21T00:00:00\n \n \n 1\n PRIMARY\n 1\n ITEM1\n 5.00000\n 0.00000\n Case\n 113.40000\n 0.00000\n kg\n Units\n 3.00000\n 54321\n \n \n \n \n 2\n ORD180920002\n New\n TESTCUST\n 2018-09-21T00:00:00\n 2018-09-21T00:00:00\n 2018-09-21T00:00:00\n \n \n 2\n SECONDARY\n 1\n ITEM1\n 5.00000\n 0.00000\n Case\n 113.40000\n 0.00000\n kg\n Units\n 2.00000\n Our Truck\n 12345\n \n \n 3\n SECONDARY\n 2\n ITEM2\n 5.00000\n 0.00000\n Case\n 113.40000\n 0.00000\n kg\n Units\n 3.00000\n Our Truck\n 12345\n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListInventoryLots","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will generate a list of Inventory Lots in a given NorthScope company that match the supplied filtering criteria. Except for the DataEntityCompanySK, all criteria are not required, and you could provide multiple of any other criteria. The Lots returned must match any of the provided criteria of a type. For instance, if you supply criteria of multiple sites and multiple items, any Lot that both matches one of the provided sites and one of the provided items will be returned. Any empty element can be included to indicate filtering on a value being not set.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull Inventory Lots.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"Item","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The desired ItemID for the Inventory Lot.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"Site","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The site in which the Inventory Lot resides.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"ProductionLot","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The Production Lot ID for the desired Inventory Lot. Can supply an empty value to indicate filtering for lots where this is not defined.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"WarehouseLot","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The Warehouse Lot ID for the desired Inventory Lot. Can supply an empty value to indicate filtering for lots where this is not defined.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[159.0]},"content":[{"type":"paragraph","content":[{"text":"Owner","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[520.0]},"content":[{"type":"paragraph","content":[{"text":"The Owner Name of the desired Lot.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Requests","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com \nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n{\n \"NSRequest\": {\n \"RequestName\": \"ListInventoryLots\",\n \"RequestContent\": {\n \"DataEntityCompanySK\": \"1\",\n \"Items\": {\n \"Item\": [\n \"ITEM1\",\n \"ITEM2\"\n ]\n },\n \"Sites\": {\n \"Site\": [\n \"PRIMARY\",\n \"SECONDARY\"\n ]\n },\n \"ProductionLots\": {\n \"ProductionLot\": [\n \"\",\n \"LOT1\"\n ]\n },\n \"WarehouseLots\": {\n \"WarehouseLot\": [\n \"\",\n \"WHLOT1\"\n ]\n },\n \"Owners\": { \"Owner\": \"Default Owner\" }\n }\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com \nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n ListInventoryLots\n \n 1\n \n ITEM1\n ITEM2\n \n \n PRIMARY\n SECONDARY\n \n \n \n LOT1\n \n \n \n WHLOT1\n \n \n Default Owner\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Responses","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"NSResponse\": {\n \"Timestamp\": \"2018-09-21T10:20:41.636\",\n \"Success\": \"true\",\n \"InventoryLots\": {\n \"InventoryLot\": [\n {\n \"LotSK\": \"1\",\n \"LotStatus\": \"Open\",\n \"ItemID\": \"ITEM1\",\n \"Site\": \"PRIMARY\",\n \"ProductionLot\": \"LOT1\",\n \"WarehouseLot\": \"WHLOT1\",\n \"Owner\": \"Default Owner\",\n \"OnHandUnits\": \"1000.00000\",\n \"AllocatedUnits\": \"0.00000\",\n \"HoldUnits\": \"0.00000\",\n \"AvailableUnits\": \"1000.00000\",\n \"UnitsUOM\": \"Case\",\n \"OnHandWeight\": \"22680.00000\",\n \"AllocatedWeight\": \"0.00000\",\n \"HoldWeight\": \"0.00000\",\n \"AvailableWeight\": \"22680.00000\",\n \"WeightUOM\": \"kg\",\n \"ActualCost\": \"0.00000\",\n \"MarketCost\": \"0.00000\",\n \"StandardCost\": \"0.00000\"\n },\n {\n \"LotSK\": \"2\",\n \"LotStatus\": \"Open\",\n \"ItemID\": \"ITEM2\",\n \"Site\": \"SECONDARY\",\n \"Owner\": \"Default Owner\",\n \"OnHandUnits\": \"1000.00000\",\n \"AllocatedUnits\": \"0.00000\",\n \"HoldUnits\": \"0.00000\",\n \"AvailableUnits\": \"1000.00000\",\n \"UnitsUOM\": \"Case\",\n \"OnHandWeight\": \"22680.00000\",\n \"AllocatedWeight\": \"0.00000\",\n \"HoldWeight\": \"0.00000\",\n \"AvailableWeight\": \"22680.00000\",\n \"WeightUOM\": \"kg\",\n \"ActualCost\": \"0.00000\",\n \"MarketCost\": \"0.00000\",\n \"StandardCost\": \"0.00000\"\n }\n ]\n }\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2018-09-21T10:20:41.636\n true\n \n \n 1\n Open\n ITEM1\n PRIMARY\n LOT1\n WHLOT1\n Default Owner\n 1000.00000\n 0.00000\n 0.00000\n 1000.00000\n Case\n 22680.00000\n 0.00000\n 0.00000\n 22680.00000\n kg\n 0.00000\n 0.00000\n 0.00000\n \n \n 2\n Open\n ITEM2\n SECONDARY\n Default Owner\n 1000.00000\n 0.00000\n 0.00000\n 1000.00000\n Case\n 22680.00000\n 0.00000\n 0.00000\n 22680.00000\n kg\n 0.00000\n 0.00000\n 0.00000\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"AllocateSalesOrders","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will accept a list of allocations to perform, verify they are valid and then allocate the inventory from a given LotSK to a given OrderItemSK. Both LotSK and OrderItemSK can be retrieved from the ListInventoryLots and ListSalesOrders requests, respectively.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"OrderItemSK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the Sales Order Line Item being allocated.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"LotSK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the Inventory Lot from which the inventory will be drawn.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"AllocateUnits","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"The number of Units (in the supplied Unit of Measure) to allocate. Not required if the item is managed by Weight only.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"UnitsUOM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"The Unit of Measure ID for the units in which the inventory is being allocated.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"AllocateWeight","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"The amount of Weight (in the supplied Unit of Measure) to allocate. Not required if the item is managed by Units only.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"WeightUOM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[77.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[552.0]},"content":[{"type":"paragraph","content":[{"text":"The Unit of Measure ID for the weight in which the inventory is being allocated.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Requests","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n{\n \"NSRequest\": {\n \"RequestName\": \"AllocateSalesOrders\",\n \"RequestContent\": {\n \"Allocation\": [\n {\n \"OrderItemSK\": \"100\",\n \"LotSK\": \"1\",\n \"AllocateUnits\": \"5\",\n \"UnitsUOM\": \"Case\",\n \"AllocateWeight\": \"113.4\",\n \"WeightUOM\": \"kg\"\n },\n {\n \"OrderItemSK\": \"101\",\n \"LotSK\": \"1\",\n \"AllocateUnits\": \"5\",\n \"UnitsUOM\": \"Case\",\n \"AllocateWeight\": \"113.4\",\n \"WeightUOM\": \"kg\"\n }\n ]\n }\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n AllocateSalesOrders\n \n \n 100\n 1\n 5\n Case\n 113.4\n kg\n \n \n 101\n 1\n 5\n Case\n 113.4\n kg\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"paragraph","content":[{"text":"This request has no specific response, instead you would receive a generic success or failure with a timestamp and error (assuming the request failed).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"InsertInboundIntegration","type":"text"}]},{"type":"paragraph","content":[{"text":"This request provides a way to leverage NorthScope’s existing mechanism for 3rd party integrations. Using the InsertInboundIntegration web request, data can be inserted into a NorthScope instance’s inbound queue. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Everything in the section is what will be placed into the inbound queue. For more information on the inbound queue and what to send there, see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://northlakeconfluence.atlassian.net/wiki/spaces/HELP/pages/198311950"}},{"text":" as an example. The code below sends a fake transaction ‘TransactionABC’ of type ‘IMTransferXYZ’. To send a different kind of transaction to the inbound queue, simply replace the XML inside the section.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n InsertInboundIntegration\n \n \n 2019-12-2\n NS Test\n TransactionABC\n IMTransferXYZ\n \n \n Adjustment\n Default\n A123456\n Ready To Post\n ABC\n 2017-12-19\n \n Integrated\n XYZ\n \n \n 1234321\n 5.00000\n CASE\n 150.5500\n LB\n 18001\n NLP\n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2019-12-02T14:15:11.539\n true\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListUOMSchedules","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will retrieve a list of UOM schedules.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull sites.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"WhereClause","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Filtering parameter for returned data.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The WhereClause parameter enables only a selection of data to be sent back in the reply, based on filter criteria written with SQL syntax. Any of the UOM schedule properties can be referenced.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n NorthPacificUOMScheduleMaster\n \n 1\n \n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2019-12-02T14:15:10.148\n true\n \n \n 1\n Each\n Each\n 1.00000\n \n \n 2\n Each\n Bag\n 1.00000\n \n \n 3\n Bag\n kg\n 18.14369\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListSites","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will retrieve a list of sites.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull sites.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"WhereClause","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Filtering parameter for returned data.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The WhereClause parameter enables only a selection of data to be sent back in the reply, based on filter criteria written with SQL syntax. Any of the site properties can be referenced.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n\tListSites\n\t\n\t\t1\n\t\tState = 'WA' OR SiteName LIKE '%a%'\n\t\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: JSON is not supported for this command.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\t2019-12-02T10:00:10.405\n\ttrue\n\t\n\t\t\n\t\t\t1\n\t\t\tABC\n\t\t\tSite Name 1\n\t\t\tCompany ID 1\n\t\t\t1\n\t\t\t1234 NE Street\n\t\t\t\n\t\t\tSeattle\n\t\t\tWA\n\t\t\t99999\n\t\t\tUSA\n\t\t\t123-456-7890\n\t\t\t123-456-7891\n\t\t\n\t\t\n\t\t\t2\n\t\t\tABD\n\t\t\tSite Name 2\n\t\t\tCompany ID 1\n\t\t\t1\n\t\t\t1234 SE Street\n\t\t\t\n\t\t\tHouston\n\t\t\tTX\n\t\t\t99999\n\t\t\tUSA\n\t\t\t123-000-7890\n\t\t\t123-000-7891\n\t\t\n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListSalesOrders","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will retrieve a list of sales orders and sales order details.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull sites.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"WhereClause","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Filtering parameter for returned data.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The WhereClause parameter enables only a selection of data to be sent back in the reply, based on filter criteria written with SQL syntax. Any of the sales order (not detail) properties can be referenced.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n NorthPacificSalesOrder\n \n 1\n SiteID = '400'\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: JSON is not supported for this request.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2019-12-02T14:15:06.265\n true\n \n \n Acme\n 123\n PO500\n BrownCo\n 889\n BrownCoPPT1\n 2019-11-20T00:00:00\n 2019-11-29T00:00:00\n Good Old Shipping Company\n 2019-11-13T00:00:00\n 7878\n 9090\n 2\n 2\n \n \n 400\n 9090\n 8998\n 3\n Lbs\n Each\n Pudding 6-10 Lbs. Fresh\n 22\n 220\n 2\n \n \n 900\n 9090\n 2359\n 3\n Lbs\n Case\n Flakes Cereal #2\n 15.00000\n 150.00000\n 1\n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListItems","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will retrieve a list of items.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull sites.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"WhereClause","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Filtering parameter for returned data.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The WhereClause parameter enables only a selection of data to be sent back in the reply, based on filter criteria written with SQL syntax. Any of the Item properties can be referenced.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"codeBlock","content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n NorthPacificItemMaster\n \n 1\n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: JSON is not supported for this command.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2019-12-02T14:15:04.574\n true\n \n \n 4010\n 1\n A do-dad\n Acme\n 3\n 3\n 1\n Wholesale\n Each\n Lbs\n Lbs\n 999\n 58\n 1\n \n \n 5050\n 2\n A thingamajig\n Acme\n 3\n 3\n 1\n Wholesale\n Each\n Lbs\n Lbs\n 999\n 57\n 0\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ListCustomerAddresses","type":"text"}]},{"type":"paragraph","content":[{"text":"This request will retrieve a list of customer addresses.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Accepted Information","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"DataEntityCompanySK","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"The identifier for the company from which to pull sites.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"WhereClause","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[516.0]},"content":[{"type":"paragraph","content":[{"text":"Filtering parameter for returned data.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The WhereClause parameter enables only a selection of data to be sent back in the reply, based on filter criteria written with SQL syntax. Any of the customer address properties can be referenced.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /services/ActionCommand.svc/APIExecute HTTP/1.1\nHost: NorthScope.example.com\nNSLogin: TestAPIUser@NorthScope.example.com\nNSAPISession: 00000000-0000-0000-0000-000000000000\n\n\n NorthPacificCustomer\n \n 1\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: JSON is not supported for this web request.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n 2019-12-02T14:15:07.058\n true\n \n \n 8001\n CustomerID1\n Acme Company\n ACMEADDR1\n Acme Building A\n 1234 SE StreetName BLD A\n \n Seattle\n WA\n 98125\n USA\n 3\n CompanyID\n \n \n 8001\n CustomerID1\n Acme Company\n ACMEADDR2\n Acme Building B\n 1234 SE StreetName BLD A\n \n Seattle\n WA\n 98125\n USA\n 4\n CompanyID\n \n \n","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Powershell Client Example","type":"text"}]},{"type":"paragraph","content":[{"text":"This document would not be complete without at least one example of how a client might access the web service. Below is an example client program that can obtain a token and request a list of companies from a NorthScope web service. Powershell may not be the best tool for your situation, but the client steps will remain the same, as implemented below.","type":"text"}]},{"type":"paragraph","content":[{"text":"To run this example, be sure to use the correct username and password, and the URL for your NorthScope server. Save as a ps1 file and run via the Windows Powershell application.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"$user=\"sh@thenlp.com\"\n$password=\"admin\"\n$url=\"http://doug/test/services/ActionCommand.svc/APIExecute\"\n\n#Constructs XML for a login request of the NS web service handler\n$loginReq = \"\n GenerateSessionToken\n \n \"+$user+\"\n \"+$password+\"\n \n \"\n\n$webReq = \"\n ListCompanies\n \n \n \"\n\n#region Login and obtain token\n$Body = [byte[]][char[]]$loginReq #convert login request to byte array\n\n#build web request login packet\n$Request = [System.Net.WebRequest]::Create($url);\n$Request.Method = 'POST';\n$Request.Accept = \"text/html\"\n$Request.AllowAutoRedirect = $false\n$Request.ContentType = \"applications/text\"\n$Request.ContentLength = $Body.length\n$Request.TimeOut = 5000000\n$Request.KeepAlive = $true\n$Request.Headers.Add(\"Keep-Alive: 300\");\n$reqst = $Request.getRequestStream()\n$reqst.write($Body, 0, $Body.length)\n$reqst.flush()\n$reqst.close()\n\n#send request and wait for response\n[net.httpWebResponse] $res = $Request.getResponse()\n$resst = $res.getResponseStream()\n$sr = new-object IO.StreamReader($resst)\n$result = $sr.ReadToEnd()\n$res.close()\n$tokenReply = [xml]$result #parse response to xml\n#endregion\n\n#region Send web service request\n#build the main web request content packet\n$Body = [byte[]][char[]]$webReq #convert web request to byte array\n$Request = [System.Net.WebRequest]::Create($url);\n$Request.Method = 'POST';\n$Request.Accept = \"text/html\"\n$Request.AllowAutoRedirect = $false\n$Request.ContentType = \"applications/text\"\n$Request.ContentLength = $Body.length\n$Request.TimeOut = 5000000\n$Request.KeepAlive = $true\n\n#Insert the login and token into the header\n$h1 = \"NSLogin:\"+$user\n$h2 = \"NSAPISession:\"+$tokenReply.NSResponse.ResponseContent.SessionToken\n$Request.Headers.Add($h1)\n$Request.Headers.Add($h2)\n\n$reqst = $Request.getRequestStream()\n$reqst.write($Body, 0, $Body.length)\n$reqst.flush()\n$reqst.close()\n\n#send request and wait for response\n[net.httpWebResponse] $res = $Request.getResponse()\n$resst = $res.getResponseStream()\n$sr = new-object IO.StreamReader($resst)\n$result = $sr.ReadToEnd()\n$res.close()\n$rep = [xml]$result #parse response to xml\n#endregion\n\n$Error = $rep.NSResponse.Error\n$ResponseXML = $rep.NSResponse.OuterXml\n\n$Companies = $rep.NSResponse.Companies.Company\n$Companies #print retrieved company list","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported