Releases

This change is completely backward compatible and simply adds additional attributes and objects.

New APIs

• Added Assortment Management APIs
  • List all Assortments
    Lists the assortments created
  • Create an Assortment
    Create a new assortment
  • Delete Assortment
    Delete an assortment
  • Find Assortment
    Find an assortment by its ID
  • Update Assortment
    Update an existing assortment
  • Remove Item From Assortment
    Remove an item from an existing assortment
  • Remove Items From Assortment
    Remove a list of items from an existing assortment
  • Add Item To Assortment
    Add an item to an existing assortment
  • Add Items To Assortment
    Adds a list of items to an existing assortment

New Objects

• DscoItemIdOrItemKey
   unique ID for an item
• DscoItemIdsOrItemKeys
  A list of unique IDs for a set of items
• Assortment
  An assortment object
• ItemKey
  Specifies the key to identify an item

This change is completely backward compatible and simply adds additional attributes and objects.

Modified Api

• Create Webhook
  Added a new attribute customHttpHeaders
• Update Webhook
  Added a new attribute customHttpHeaders
• List Webhooks
  Added a new attribute customHttpHeaders
• Get Webhook By ID
  Added a new attribute customHttpHeaders

New Object

• HttpHeader
  Represents an http header to be sent with a webhook callback.

This change is completely backward compatible and simpy adds additional attributes and objects.

Modified API

• Find Item Inventory
  New attributes "fastMode" and "lastId" have been added that enable faster responses with large data sets.

Modified Object

• PagedItemInventory
  A new attribute "lastId" has been added to enable paging through results in a more performant manner.

This change is completely backward compatible and simply adds additional attributes and objects.

New API

• Get All Item Inventory

New Object

• AllItemInventoryResult

Modified Object

• Webhook
  • Added quantityChangeOnly attribute to allow the creation of an InventoryUpdate webhook that only triggers when quantity changes

This change is completely backward compatible and simply adds additional attributes and objects.

Modified APIs

• Update Order Status: added lineItems attribute allowing for updating line item status and quantity statuses

New JSON Objects

• OrderStatusLineItem

Modified JSON Objects

• ItemInventory (new attributes added)
  • brand
• OrderLineItem (new attributes added)
  • status
  • statusReason
  • cancelledQuantity
  • cancelledReason
  • acceptedQuantity
  • acceptedReason
  • rejectedQuantity
  • rejectedReason
• OrderStatus (new attributes added)
  • items

This change is completely backward compatible and simply adds additional fields to the ItemInventory JSON object.

Modified JSON Objects

• ItemInventory
  • Added tradingPartnerId and tradingPartnerName

This change is completely backward compatible and simply adds additional fields to the Order JSON object.

 Modified JSON Objects

• Order
  • Added shipByDate, acknowledgeByDate and invoiceByDate

This change is completely backward compatible and simply adds additional fields and functionality.

 This change adds new invoice APIs and adds additional attributes to ItemInventory.

 New APIs

• Create Invoice API
• Find Invoices API
• Update Invoice API

 Modified APIs

• Find Item Inventory: added ability to search by upc, ean, mpn, isbn and gtin

 New JSON Objects

• Invoice
• InvoiceLineItem
• InvoiceShipFromTo
• InvoiceShipInfo
• InvoiceTerms
• InvoiceCharge
• ItemWarehouse
• PagedInvoiceResult

 Modified JSONObjects

• ItemInventory
  • Added upc, ean, mpn, isbn, gtin and warehouses attributes

This change is completely backward compatible and simply adds additional fields and functionality.

 Modified JSON Objects

• Webhook JSON Object
  • Added the applyToPartners attribute allowing a webhook to be created by a retailer for inventory updates and applied to all suppliers.
  • Added the quantityStateChangeOnly attribute allowing a webook created for inventory updates to only fire when the quantity changes from less than 1 to more than zero and vice versa

 Modified APIs

• Modified the webhook API calls to a partner's endpoint to include the Content-MD5 hash of the payload of the API so partner's can verify the identity and correctness of the request

Dsco is adding additional server capacity to the Dscopublic API infrastructure effective 8/13/2016. This is purely an infrastructure release. No APIs have changed.

 This change should not affect api.dropship.com nor its IP address. However, we are making api.dropship.com point to a load balancer. You will want to work with your IT team to ensure any firewall rules continue to work after the switchover for any incoming Webhook API calls from that server as the incoming IP address may appear to be different to your firewall.

 IP address of api.dropship.com: 52.72.74.224

 Further, we are deprecating the api.dropship.com endpoint in favor of our new endpoint which is: api.dsco.io

 The IP address of the api.dsco.io endpoint is: 52.1.219.81

 We will continue to support the api.dropship.com endpoint until the end of Q1 2017 (March 31, 2017) after which it will be shut down, so please plan accordingly.

Modified JSON Objects

• Order JSON Object
  Added a new attribute to identify the status of an order as shipment pending.

Modified APIs

• POST /v2/order
  The create order API now returns an array of orders instead of a single order to allow an order to be fulfilled by multiple suppliers.

Modified JSON Objects

• Order JSON Object
  • testFlag - new attribute that marks the order as a test order that will only be used for testing purposes
  • currencyCode - new attribute to specify the currerncy of the order
  • cancelAfterDate - new attribute specifying that the order should be cancelled after this date
  • consumerOrderNumber - new attribute providing a consumer order number
  • shippingServiceLevelCode - new attribute specifying the shipping service of the order
• OrderLineItem JSON Object
  • warehouseCode - new attribute to specify the warehouse of the line item
• Shipment JSON Object
  • currencyCode - new attribute to specify the currency of the order
  • shipCarrier - new attribute specifiying ship carrier
  • shipMethod - new attribute specifiying ship method
  • shippingServiceLevelCode - new attribute specifying shipping service level
• Package JSON Object
  • currencyCode - new attribute to specify the currency of the order
  • shippingServiceLevelCode - new attribute specifying shipping service level

The initial release of the APIs.