Smarter Sorting API Options

Product Catalog API - 

Tell Smarter Sorting about products we should know about.

This API allows a retailer to submit and update their active item catalog to Smarter Sorting, indicating which products require registration by Suppliers as being potentially hazardous versus which are non-hazardous and only eligible for donation or disposal. Products submitted via this API form the base data set for results from the separate BOSS Recommendation API.

Usage:

1. POST your ingest batch job

2. Retain the id from the response

3. Poll your job status at the GET /ingest/product/batch/{batch_job_id} endpoint

4. Note success_count and error_count: once their sum matches item_count the job is complete

The batch job will be validated immediately for required fields, data types, etc. If this validation doesn't succeed a 400 will result and error messages will be returned.

Error messages may also be noted later in the job status output. If you see error messages of the form: "unable to update product, currently in X state (422)", this may occur if a product update is sent too quickly after the previous update, and the product is still going through automated processing. This condition is expected to be rare and temporary, and typically retrying the failed product update later (not the entire batch) should succeed. If it does not, contact support.

For more information: Product Catalog API
 

Back of Store System (BOSS) Reporting API - 

Report on and manage the real world handling of products.

This API receives the final decision taken by a user of the BOSS Recommendation API to power reporting provided by Smarter Sorting via Tableau on various business and ESG related metrics around diversion paths and weights by location.

URIs are relative to https://api-staging.smartersorting.com/v1, unless otherwise noted.

For more information: BOSS Reporting API

Back of Store System (BOSS) Recommendation API - 

Get recommendations on how to handle products through donations, recycling, disposal, and more!

Primary API endpoint to provide retail users with location-specific recommended disposal/diversion instructions for all items in a retailer’s catalog submitted via the Product Ingestion API and registered by Suppliers via the Smarter Sorting Product Intelligence Platform for display in Client’s own back of store interface.

For more information: BOSS Recommendations

Back of Store System (BOSS) Management API -

Manage locations for the Back of Store System, including available disposal, recycling, and donation options

For more information: BOSS Management