Xero is well known Cloud based Accounting Software. In this post you will learn how to implement Xero API Integration with SQL Server or any other RDBMS (e.g. Oracle, MySQL, Postgresql) using SSIS in few clicks. We will use SSIS JSON Source to Read data from Xero and Load into SQL Server / other target (Using OAuth Connection). We will also discuss reverse scenario to Write data to Xero (API POST for Insert or Update in Xero) using SSIS Web API Destination and SSIS JSON Generator Transform

Prerequisites

Before we look into Step-By-Step section to extract and load data from Xero to SQL Server let’s make sure you met following requirements.

1. SSIS designer installed. Sometimes it is referred as BIDS or SSDT (download it from Microsoft site).
2. Basic knowledge of SSIS package development using Microsoft SQL Server Integration Services.
3. ZappySys SSIS PowerPack installed. Click on the link to download FREE trial.
4. You have basic familiarity with REST API concepts and Xero API.

Concepts of Xero REST API

API Authorization

Before you can access Xero API you must register account and App. There are 3 types of Apps to access Xero API.

1. Private App (X509 Certificate used to sign requests)
2. Public App (Use 3-legged OAuth. Token expires in 30 mins and then you have to authorize again from UI)
3. Partner App (Use 3-legged OAuth. Token expires in 30 mins.. but refresh token supported to get new token for unlimited times without Authorization via Login UI)
4. OAuth2.0 Authentication (Recommended) 

In this article we will use Private App to access your company data in Xero.

Data formats

Xero API supports Xml and JSON both formats over the same URL (endpoints). If you want data in JSON format then you have to pass following Header (else data in Xml format will be returned). If you are using SSIS JSON Source then make sure following header is added. For SSIS XML Source no need to add this header.

Accept : application/json

Step-By-Step : Xero API Integration in SSIS

Now lets look at steps needed to fetch data from Xero and load into SQL Server.

Configure OAuth2.0 Connection for Xero API (Recommended)

So let’s how to create the Xero OAuth2.0 connection. For more on OAuth2.0 refer to this article.

1. Right-click inside the Connection Managers area again and click “New Connection…”
2. From the connection type list select “ZS-OAUTH” connection type.
   

   Create new SSIS OAuth API Connection Manager

3. Select OAuth Provider which Custom, enter the CleintID and Secret and set the URLs as below and desired scopes that are required for the API Call.
   Auth URL:
   

   https://login.xero.com/identity/connect/authorize

   Token URL:
   

   https://identity.xero.com/connect/token

   Scopes: Add your desired scopes based on your API call requirements.
   
   Note: To get a refresh token, you must request the offline_access scope. A refresh token allows you to refresh your access token and maintain an offline connection.
   offline_access

   https://developer.xero.com/documentation/guides/oauth2/scopes/#offline-access

   

   OAuth2.0 Connection

4.  Now go to the Advanced tab and set the redirect URL as below and also you need to set the same URL in the Xero API App.
   

   https://zappysys.com/oauth2

   

   Set Callback/Return Url in OAuth Connection

5. Now Click on the Generate Token Button and logged in with Xero username and password and grant permission.
6. That’s it your token is generated. If you got the blank Screen like this after following all the steps. Close that window.
   

   OAuth2.0 connection : Blank Window at last

7. And it will ask you to use the Different Method to generate the Token using system default browser click on YES.
   

   Different Method to generate the Token using system default browser

8. It will open the URL in the browser there you need to log in and grant the permission.
9. After that, you will able to view the access token in the browser. you can copy from there also.
   

   Generated Token

10. At the last, it will again focus on the connection and there it will ask you to save the token if you want to store it. if not then you can manually copy and paste that token.
    

    OAuth Connection : Store the Tokens

11. That’s it now click on the Test Connection button to test it.
    

    Generate Token and Test Connection

Register OAuth App Private for Xero (Private App) OAuth Connection (Depreciated)

Here is how to configure Xero to use Private App (click on below link).

https://developer.xero.com/documentation/auth-and-limits/private-applications

In the above link during these steps openssl command may throw error about openssl.cnf is missing or cannot load. If you face such error then don’t worry just refer to following workaround.

https://stackoverflow.com/questions/14459078/unable-to-load-config-info-from-usr-local-ssl-openssl-cnf

Basically you can either supply config file path in each command OR set path by issuing SET command before any other command. See below examples (Assuming you installed OpenSSL to c:\OpenSSL-Win64 folder)

c:\OpenSSL-Win64>openssl req -x509 -config "C:\OpenSSL-Win64\bin\openssl.cnf"

— OR —  type before command before any other openssl commands

c:\OpenSSL-Win64>set OPENSSL_CONF=c:\OpenSSL-Win64\bin\openssl.cnf

c:\OpenSSL-Win64>openssl req -x509 -config "C:\OpenSSL-Win64\bin\openssl.cnf"

Once you generate public key, private key and, pfx file we are ready to call Xero API in SSIS

Configure Xero (Private App) OAuth Connection

Once you generate certificate using openssl and register Private App for Xero we are ready to move to SSIS piece. Lets see how to do that.

1. Open Visual Studio
2. Open existing SSIS Project or create new using File > New > Project > Choose “Integration Services Project” Type under Business Intelligence template category
3. Open Package
4. Right click inside Connection Managers area and click “New Connection…”
5. From the connection type list select “ZS-OAUTH” connection type.

   

   Create new SSIS OAuth API Connection Manager

6. On the connection select “Xero (Private App)” from Service Provider Dropdown
7. Enter Client ID (Obtain this from App created in Previous section) App Selection leave “Use Default OAuth App” selected. If you created custom OAuth App then select “Use Custom OAuth App” Option
8. Enter some fake value in Client Secret (not needed when you use Private App). Secret will come from certificate file like below.
   

   SSIS OAuth Connection – Configure Xero API Connectivity using Private App (Certificate File Approach)

9. Now go to Certificate tab and Check Use Certificate Enter, Enter certificate location and password like below.
   

   SSIS OAuth Connection – Configure X509 Certificate File Option for Xero Private App (Select PFX file)

10. Click OK to save OAuth connection manager

So in the next section from the upper connections, we need to use any of the one connection only for Xero API now let’s try to read data from Xero using SSIS JSON Source.

Xero recently added OAuth 2.0 support so that now recommended way to use as Connection.

Configure JSON / REST API Source – Read data from Xero

Now let’s look at how to configure SSIS JSON Source to read data from Xero API

1. In the control flow ssis toolbox Drag and drop data flow task
2. Double click Data flow
3. Drag ZS JSON Source (REST API or File) from SSIS Toolbox and drop on Data flow designer
4. Double click ZS JSON Source to configure it.
5. Set the following properties
   1. Enter URL
      

      https://api.xero.com/api.xro/2.0/Invoices

   2. Check Use Credentials and select OAuth connection we created in the previous section
   3. For Headers grid. Click on Raw Edit button and remove enter following (remove default headers)
      

      Accept: application/json

   4. Click on Select filter and select an array node as below to generate filter expression (e.g. $.Invoices[*] )

Configure SSIS JSON /REST API Source – Read Xero Invoices

Also, add following header in case of multiple tenants are being used in XERO environment –

xero-tenant-id: <TENANT ID FROM XERO>

Configure Xero REST API Pagination in SSIS JSON Source

By default, Xero may not send you all records and you may have to setup pagination to read more data after the first response.

For example, you like to read LineItems from Invoices. For that make sure you use below URL and include page=1 to start with. If you do not include page=1 then Line items are not returned (Yes its ODD but clearly documented here).

1. Enter URL as
   

   https://api.xero.com/api.xro/2.0/Invoices?page=1

2. Select Filter as

   $.Invoices[*].LineItems[*]

3. Go to Pagination tab
4. Select Pagination by URL Parameter
5. Enter page as pagination parameter name like below
   

   REST API Looping/Pagination via URL Page Number Parameter (Loop until last page detected)

6. Click OK to save

Now when you run package you will see all LineItems for each Invoice will be returned.

Loading Xero data to SQL Server

Now last step is loading Xero data to SQL Server. For example purpose we will load data into SQL Server but you can load into any Target (e.g. Flat file, Oracle, Excel) using Microsoft or ZappySys Destination connectors

To load Xero data into SQL Server perform following steps

1. Drag OLEDB destination on Data Flow surface
2. Connect ZS JSON Source to Destination
3. On OLEDB destination select / create new SQL Connection and then Click “New Table”
4. Click on Mappings tab and click OK to save
5. Execute Package

Configure SSIS OLEDB Destination – Loading Xero Data into SQL Server Table

Xero to SQL Server Column Mappings for OLEDB Destination

Loading Xero data to SQL Server in SSIS

POST data to Xero (Insert or Update)

So far we have seen how to read data from Xero. Now let’s look at how to write data to Xero.

There are two ways you can achieve this.

1. Use Web API Destination in Data Flow
2. Use REST API Task in Control Flow

Read this article to learn more about API POST using SSIS

Using SSIS Web API Task (Write data from SQL Server to Xero)

Using REST API Task to POST data to Xero

If you have JSON/XML data already prepared and if you like to POST it to Xero API then REST API Task would be easy to use.

REST API Task Body can be direct string, variable (e.g. {{User::varSomeData}} or Body can come from File 

SSIS REST API Task – POST data to Xero (Create contacts)

Read data from Xero Report API

In previous examples we saw how to read data from various Xero API endpoints but now lets look at how to call Xero Report API. For example if you like to extract data displayed in below then you can extract it in Xml or JSON format. Below report is in HTML format but we will show you how to get similar information in JSON format and load into SQL Server Table.

Xero Report Example – View Profit and Loss Report in Xero Portal

To extract above information you can call below API Endpoint (e.g. Profit & Loss Report)

GET 
https://api.xero.com/api.xro/2.0/Reports/ProfitAndLoss?fromDate=2017-02-01&toDate=2017-02-28

You can use Variables to make above URL dynamic in JSON Source as below

https://api.xero.com/api.xro/2.0/Reports/ProfitAndLoss?fromDate={{User::StartDate,yyyy-MM-dd}}&toDate={{User::EndDate,yyyy-MM-dd}}

Each report has its own API URL so make sure you refer to the connect URL for calling different report.

Here is sample response from API

{
  "Reports": [
    {
      "ReportID": "ProfitAndLoss",
      "ReportName": "Profit and Loss",
      "ReportType": "ProfitAndLoss",
      "ReportTitles": [
        "Profit & Loss",
        "Demo Company (AU)",
        "1 February 2018 to 28 February 2018"
      ],
      "ReportDate": "25 February 2018",
      "UpdatedDateUTC": "\/Date(1519593468971)\/",
      "Rows": [
        {
          "RowType": "Header",
          "Cells": [
            { "Value": "" },
            { "Value": "28 Feb 18" },
            { "Value": "28 Jan 18" }
          ]
        },
        {
          "RowType": "Section",
          "Title": " Income",
          "Rows": [
            {
              "RowType": "Row",
              "Cells": [
                {
                  "Value": "Sales",
                  "Attributes": [
                    {
                      "Value": "e2bacdc6-2006-43c2-a5da-3c0e5f43b452",
                      "Id": "account"
                    }
                  ]
                },{
                  "Value": "9220.05",
                  "Attributes": [
                    {
                      "Value": "e2bacdc6-2006-43c2-a5da-3c0e5f43b452",
                      "Id": "account"
                    }
                  ]
                },{
                  "Value": "5120.05",
                  "Attributes": [
                    {
                      "Value": "e2bacdc6-2006-43c2-a5da-3c0e5f43b452",
                      "Id": "account"
                    }
                  ]
                }
              ]
            },
            {
              "RowType": "SummaryRow",
              "Cells": [
                { "Value": "Total Income" },
                { "Value": "9220.05" },
                { "Value": "1250.09" }
              ]
            }
          ]
        },{
          "RowType": "Section",
          "Rows": [
            {
              "RowType": "Row",
              "Cells": [
                { "Value": "NET PROFIT" },
                { "Value": "-6250.09" },
                { "Value": "-7250.09" }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Now lets look at steps to configure JSON Source to extract your Xero Report Data.

1. Drag new JSON Source from SSIS Toolbox
2. Double click JSON Source to configure it
3. In the Path / Web URL, enter API Report URL to call desired Report Start / End Date or any other expected Parameter by report (Refer to API Documentation). For our example we will enter below URL
   

   https://api.xero.com/api.xro/2.0/Reports/ProfitAndLoss?fromDate=2017-02-01&toDate=2017-02-28

4. Check Use Credentials and Select Connection we created in the Previous Section
5. In the Filter enter

   $.Reports[*].Rows[*].Rows[*]

6. Now go to 2D Array Transform Tab and configure like below. If your UI varies then use Properties window to edit property manually.
   Basically you need to edit
   Transformation Type:

   2-dimensional array

   Column Name Filter:

   $.Reports[0].Rows[*].Cells[*].Value

   Row Values Filter:

   $.Cells[*].Value

7. Now Click Preview Data. If you get error Column ” does not belong to table nosqldata. Then most likely you using old version with Known Issue (i.e. v2.9.7.10822 or older). Get latest version for fix. For workaround of this issue you must follow next section to specify columns manually. Columns must match count.

Here is how it will look like.

Configure Transform Options for Xero Report API (Dynamic Column Title)

Read from Xero Report API using JSON Source in SSIS (Dynamic Columns Example)

Fixing Dynamic Columns Problem in for Xero Report API

Now let’s look at one common scenario which you have to think. SSIS data flow has fixed metadata so if your Report is generating Dynamic Columns each time based on Date Range then it will be trouble for you because all your columns may come as null if initial date range changes.

To address this issue you have to use Static Column Names as below.

Account (or sometimes blank) | Oct 08 | Sep 08 | Aug 08 | Jul 08 | YTD

NOTE: Use REST API Task to obtain Raw JSON and review First Row which contains Number of columns
For example if your API return some thing like below then you can use 5 columns (one Blank header + 4 Months)

"Rows": [
        {
          "RowType": "Header",
          "Cells": [
            { "Value": "" },
            { "Value": "28 Feb 18" }
            { "Value": "28 Mar 18" }
            { "Value": "28 Apr 18" }
            { "Value": "28 May 18" }
          ]
        },

Once we know how many columns we should expect from API response, we can perform following steps. We will now configure our JSON Source component to use Static Columns.

1. Drag new JSON Source from SSIS Toolbox
2. Right click JSON Source > Click on Properties (You can do below using UI too but in old version no option for that – See below this section)
3. Enter following values for property
   1. Filter: 

      $.Reports[*].Rows[*].Rows[*]

   2. ArrayTransformationType:

      TransformComplexTwoDimensionalArray

   3. ArrayTransCustomColumns:

      Col1,Col2,Col3,Col4,Col5,Col6,Col7,Col8,Col9,Col10,Col11,Col12,Col13

          (Assuming you have 12 months to compare)
   4. ArrayEnableCustomColumn:

      True

   5. ArrayTransRowValueFilter:

      $.Cells[*].Value

4. Now double click JSON Source to configure
5. In the Path / Web URL, enter API Report URL to call desired Report Start / End Date or any other expected Parameter by report (Refer to API Documentation). For our example we will enter below URL
   

   https://api.xero.com/api.xro/2.0/Reports/ProfitAndLoss?fromDate=2017-02-01&toDate=2017-02-28

6. Check Use Credentials and Select Connection we created in the Previous Section
7. In the Filter enter

   $.Reports[*].Rows[*].Rows[*]

8. Now click Preview.

For Old Version use Properties Grid

Configure Xero Report Data Extract using SSIS Property Grid (For Older Version)

For New Version Use UI (It has Specify Columns Manually Option)

Read from Xero Report API using parameters in JSON Source in SSIS (Static Columns Example)

Common Errors

Deployment to Production

Conclusion. What’s next?

In this article we have learned how to load data from Xero to SQL Server using SSIS ( drag and drop approach without coding). We used SSIS JSON / REST API Connector to extract data from Xero REST API using OAuth. JSON Source makes it super simple to parsing complex / large JSON Files or any Web API Response into rows and column so you can load into database like SQL Server. Download SSIS PowerPack to try many other automation scenarios not discussed in this article.

Keywords:

Xero Integration with SQL Server | How to extract data from Xero in SSIS? | How to read data from Xero API? | Loading Xero Data into SQL Server. | Xero to SQL Server | SQL Server to Xero | SSIS Xero Integration

The post How to read/load data in Xero using SSIS appeared first on ZappySys Blog.

eBay recently launched brand new REST API with OAuth 2.0 support. This article will explain you how to call eBay REST API using SSIS to automate eBay operations (e.g. Buy/Sell) using SSIS REST API Integration Connectors / OAuth Connection Manager.

This article assumes that you have basic knowledge of SSIS (SQL Server Integration Services). We will use drag and drop approach without coding to do eBay REST API integration. We will use following custom tasks/connectors from SSIS PowerPack

SSIS PowerPack REST API Connectors can be used to consume/manage eBay data using API calls. Following connectors will be used in this article.

	REST API Task
	OAuth Connection Manager
	JSON Source (File, REST, OData)

Test Ebay API using Online API Testing Tool

Before you can dig deep down we suggest you to try few API calls using ebay online testing tool. Here is an example api call using their Online Testing Tool.

For example visit below URL to try sample Search API call.

https://developer.ebay.com/my/api_test_tool?index=0&env=production&api=browse&call=item_summary_search__GET&variation=json

Testing Ebay REST API using Online Tool

Call eBay API using SSIS – Create new inventory item

Now lets look at how to make simple eBay REST API call using SSIS. For demo purpose we will use Sandbox API rather than production.

1. First download and install SSIS PowerPack from here.
2. Create new SSIS Project and open SSIS Package
3. Drag new ZS REST API Task from SSIS Toolbox on control flow designer
4. Rename ZS REST API Task to Create eBay inventory item-1. Double click the task to configure it.
5. Select Request mode to [Url from Connection]
6. Select ZS-OAUTH connection type from connection dropdown.
7. On OAuth connection. Select eBay Sandbox from provider dropdown.
8. Enter App ID in Client ID field (Obtained from here)
9. Enter Cert ID in Client Secret field  (Obtained from here)
10. Select desired Scopes or leave it blank to use default scopes. For this example we need following two scopes
    https://api.ebay.com/oauth/api_scope/sell.inventory
    https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
11. Click on Advanced Tab. Enter RuName in the Return URL field. Don’t worry if your RuName doesn’t look like URL 🙂 (Click here to learn how to get RuName – Scroll to Getting the RuName value)
12. Now click on first tab again. Click Generate token button. When prompted login using Sandbox User Account (Click here to create test user for Sandbox).
    NOTE: Production account or developer account wont work when you login for eBay Sandbox API Token
13. Click Accept button after login. If everything goes well you will see two tokens populated on your main screen (Access Token and Refresh Token). You will get prompt to save tokens to some backup file… Do that so same tokens can be used if you wish to deploy JOB to another machine.
14. Click Test to validate connection. Click OK to save.
    

    SSIS OAuth Connection Manager – Connect to eBay Sandbox API

15. Now once you close connection you are back to REST API Task
16. Enter following URL to create or new eBay inventory item using PUT. Last part of following URL is ID we want to create
    

    https://api.sandbox.ebay.com/sell/inventory/v1/inventory_item/GP-Cam-01

17. Select Method PUT from dropdown
18. Click Edit for Request Body. Enter following data for our sample product
    

    {
    	"availability" : {
    		"shipToLocationAvailability" : {
    			"quantity" : 50
    		}
    	},
    	"condition" : "NEW",
    	"product" : {
    		"title" : "GoPro Hero4 Helmet Cam",
    		"description" : "New GoPro Hero4 Helmet Cam. Unopened box.",
    		"aspects" : {
    			"Brand" : ["GoPro"],
    			"Type" : ["Helmet/Action"],
    			"Storage Type" : ["Removable"],
    			"Recording Definition" : ["High Definition"],
    			"Media Format" : ["Flash Drive (SSD)"],
    			"Optical Zoom" : ["10x"]
    		},
    		"imageUrls" : [
    			"http://i.ebayimg.com/images/i/182196556219-0-1/s-l1000.jpg",
    			"http://i.ebayimg.com/images/i/182196556219-0-1/s-l1001.jpg",
    			"http://i.ebayimg.com/images/i/182196556219-0-1/s-l1002.jpg"
    		]
    	}
    }

19. Change Body content type to JSON from dropdown
20. Click on [Raw Edit] button in Headers grid toolbar. Enter following headers and click OK.
    

    Content-Language: en-US
    Accept: application/json

     
21. Click Test Request/Response – If you get success that means product got created.
22. You can create more products by simply changing SKU in URL and name/description in Body. Click Test to execute API call.

Read data from eBay and load into SQL Server using SSIS JSON Source

Now lets look at how to consume eBay REST API and load data into SQL Server. For this you can use JSON Source (File, REST API). For this demo we will Call eBay Search API . If you want to explore other API then check this page. Here is

1. Go to Data flow tab
2. Drag and drop ZS JSON Source from SSIS Toolbox
3. Double click to configure it.
4. Enter API URL like below. We added Search parameter and limit parameter (Max rows per response). Refer to API Help page to know more about other available parameters.
   

   https://api.sandbox.ebay.com/buy/browse/v1/item_summary/search?q=phone&limit=100

5. Check Use Credentials option.
6. Select ZS-OAUTH connection or Create New (See previous section to create new one)
7. Select Filter (Look for Array Icon and select that node). For example if you calling search API then  enter or select 

   $.itemSummaries[*]

     like below.
   

   SSIS JSON Source – Get data from eBay REST API (Use OAuth Connection)

8. Now click on pagination tab and enter

   $.next

     expression for next link attribute as below. This will enable pagination (It will keep reading in 100 rows per page until last page reached – Empty  recordset)
   

   Ebay REST API Pagination (Search API Example)

9. That’s it, now click Preview to see data
10. Once all looking good you can click OK to save JSON Source.
11. In Next Section we will see how to load Ebay Data into SQL Server.

Loading eBay data into SQL Server

ZappySys SSIS PowerPack makes it easy to load data from various sources such as REST, SOAP, JSON, XML, CSV or from other source into SQL Server, or PostgreSQL, or Amazon Redshift, or other targets. The Upsert Destination component allows you to automatically insert new records and update existing ones based on key columns. Below are the detailed steps to configure it.

Step 1: Add Upsert Destination to Data Flow

1. Drag and drop the Upsert Destination component from the SSIS Toolbox.
2. Connect your source component (e.g., JSON / REST / Other Source) to the Upsert Destination.

SSIS - Data Flow - Drang and Drop Upsert Destination Component

Step 2: Configure Target Connection

1. Double-click the Upsert Destination component to open the configuration window.
2. Under Connection, select an existing target connection or click NEW to create a new connection.
   • Example: SQL Server, or PostgreSQL, or Amazon Redshift.

Step 3: Select or Create Target Table

1. In the Target Table dropdown, select the table where you want to load data.
2. Optionally, click NEW to create a new table based on the source columns.

Configure SSIS Upsert Destination Connection - Loading data (REST / SOAP / JSON / XML /CSV) into SQL Server or other target using SSIS

Step 4: Map Columns

1. Go to the Mappings tab.
2. Click Auto Map to map source columns to target columns by name.
3. Ensure you check the Primary key column(s) that will determine whether a record is inserted or updated.
4. You can manually adjust the mappings if necessary.

SSIS Upsert Destination - Columns Mappings

Step 5: Save Settings

• Click OK to save the Upsert Destination configuration.

Step 6: Optional: Add Logging or Analysis

• You may add extra destination components to log the number of inserted vs. updated records for monitoring or auditing purposes.

Step 7: Execute the Package

• Run your SSIS package and verify that the data is correctly inserted and updated in the target table.

SSIS Upsert Destination Execution

Pagination for eBay REST API Calls

In previous example we saw REST API Pagination using Next Link approach but some API may not use same approach in that case refer to this link.  We looked at Next Link approach in previous section, you can also use Method #2 (URL parameter  – Offset) but Next Link approach is more simpler.

Calling eBay XML format API – Finding / Trading / Shopping API

eBay converted most of their APIs to JSON format to use OAuth 2.0 standard but there few APIs still there which are not OAuth 2.0 standard. These includes eBay Trading API, eBay Finding API, eBay Shopping API. They all are still in XML format. Below section describe how to call these API. Use eBay API Test tool here to generate desired Request Body and Headers.

Now let’s look at an example to call eBay XML API (GetItem from Trading API). To support special case like eBay API ZappySys introduced OAuth connection property called CustomAuthHeader in v2.6.7 or higher (Only found in Properties grid view).

1. Right click on OAuth connection manager icon > Click Properties > Set CustomAuthHeader to X-EBAY-API-IAF-TOKEN
   
2. Now drag ZS REST API Task from Control flow SSIS Toolbox
3. Set Properties like below
   1. Set URL as below (Sandbox Url is different than Production)
      

      https://api.sandbox.ebay.com/ws/api.dll

   2. Set Body As (this was obtained from  eBay API Test tool here )
      

      <?xml version="1.0" encoding="utf-8"?>
      <GetItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
      	<ErrorLanguage>en_US</ErrorLanguage>
      	<WarningLevel>High</WarningLevel>
            <!--Enter an ItemID-->
        <ItemID>1234</ItemID>
      </GetItemRequest>

   3. Set Headers as below (Click on Raw Edit Button and paste below heades). Again these header were also copied from eBay API Test tool here . Notice that API function name is included in the header. Also site id and compatibility level required.
      

      X-EBAY-API-CALL-NAME: GetItem
      X-EBAY-API-SITEID: 0
      X-EBAY-API-COMPATIBILITY-LEVEL: 967

   4. Now click OK to get response. If things working you will see some valid XML.
      

      Call eBay XML API using SSIS REST API Task (eBay Trading API, Shopping API, Finding API using OAuth Token)

User Token vs Application Token

Any time you call eBay API you have to supply token. eBay OAuth supports two types of token. In this article we used User Token. If you wish to use Application Token then you have to use OAuth Client Credentials grant. See this article

Difference between eBay Application Token vs User Token

1. Application Token
   – Do not require user login
   – Use this token if you need to perform basic operations which are supported by following permission   https://api.ebay.com/oauth/api_scope
2. User Token
   – Requires one time user login to create token and then refreshes automatically without login prompt (if you using SSIS PowerPack)
   – Use this token if you need higher privileges behalf of actual use for update/write data using API call

Use Application token when you want to perform readonly operations and you don’t need higher privileges (such as admin access). Certain eBay API calls only possible if you supply user token.

POST data to Ebay (Insert or Update)

In previous section we have seen how to read data from ebay. Now let’s look at how to write data to ebay.

There are two ways you can achieve this.

1. Use Web API Destination in Data Flow
2. Use REST API Task in Control Flow

Read this article to learn more about API POST using SSIS

Using SSIS Web API Task (Write data from SQL Server to ebay)

Using REST API Task to POST data to ebay

If you have JSON/XML data already prepared and if you like to POST it to ebay API then REST API Task would be easy to use.

REST API Task Body can be direct string, variable (e.g. {{User::varSomeData}} or Body can come from File 

Common Errors

Deployment to Production

Conclusion

REST API integration typically requires coding and good understanding of protocol such as OAuth. SSIS PowerPack REST API connectors and OAuth Connection provides easy to use interface with many options to integrate virtually any API including eBay REST API inside your SQL Server Environment without any coding. Try SSIS PowerPack yourself see what is possible.

The post How to call eBay REST API in SQL Server with SSIS appeared first on ZappySys Blog.