XML Data Feed: Item List

Use the item-list function to result a file url that contains a list of all active items in DC or filtered items by your API key. The primary use of this function would be to quickly get a list of every SupplierItemGUID to use in subsequent calls to other APIs such as Product Information. 


Product file returned contains 3 fields; CompanyName (name of supplier), CompanyAccountGuid (unique supplier identifier), and SupplierItemGuid (unique supplier item identifier)

URL: https://prod-api.distributorcentral.com/xml/item-list?

Parameters Required
acctwebguid
filterbycollections
 yes
no

filterbycollections Parameter (optional):

This parameter is used to optionally filter the product results by any product collection filters you may have defined on your API key. 

Note: The response will contain a link to a file which could take up to 10 minutes to become available. The file url will respond with "access denied" until the file is available. This is because this kind of request takes extra time to process.


Sample Response

<products>
	<totalproducts>341403</totalproducts>
	<fileurl>
		https://s3.distributorcentral.com/productExports/6b9467e3-d951-4a81-a19e-1733bddb546b.txt
	</fileurl>
	<message></message>
	<total>385000</total>
</products>

Product File Example

<?xml version="1.0" encoding="UTF-8"?>
<products>
    <totalproducts>123</totalproducts>
        <product>
            <COMPANYNAME><![CDATA[Test Company]]></COMPANYNAME>
            <COMPANYACCOUNTGUID>00000000-0000-0000-0000-000000000000</COMPANYACCOUNTGUID>
            <SUPPLIERITEMGUID>00000000-0000-0000-0000-000000000000</SUPPLIERITEMGUID>
        </product>
</products>

Related Articles