Physical fulfillment

Integrating the Commerce Platform with a new fulfillment source.

Physical fulfillment connects a commerce site to logistics partners who drop-ship products to the shopper. Physical fulfillment also enables a commerce site to smart-source orders through one or more of its partners, in the pre-integrated distribution partner network, who fulfill products globally based on configurable rules. Use this documentation to connect new fulfillment partners and their warehouses with the Digital River ecosystem for order and return management.

Event

Type

Sales Catalog

Inbound

Inventory Advice

Inbound

Fulfillment Order Request

Webhook

Fulfillment Order Response

Inbound

Shipment Notification

Inbound

Return Notification

Webhook

Return Response

Inbound

Return Receipt

Inbound

Physical Fulfillment

Sales catalog

The Sales Catalog integration loads the fulfillment partner’s catalog of products into the Digital River Physical Fulfillment system. This feed typically contains the following data:

  • The following table displays the supported formats and data interchange modes from the fulfillment partner to Digital River.

  • SKU of the fulfillment partner

  • Manufacturer’s part number for the product

  • Weight and dimension data of the product

For clients and fulfillers using a Distribution Model, Digital River also requires the unit cost of the product. This detail is included in the unit cost segment. Please note that the unit cost is the amount the fulfiller/distributor is selling the product for to Digital River (that is, not the amount they charge the shopper).

JSON
JSON
<unitCost>
<c:amount>5.00</c:amount>
<c:currencyCode>USD</c:curencyCode>
</unitCost>

This feed is not a Site Catalog that provides content and assets to the commerce site hosted at Digital River Global Commerce.

Supported formats and data interchange modes

Format

AS2

FTP/SFTP

Web Service Post to Digital River

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (832)

Supported (Best Practice)

Supported

Not Supported

  • Full file (Weekly/On-demand)

  • Delta daily

XML specification

See the EDI X12 832 definition data elements for more information.

Inventory advice

The Inventory Advice integration imports inventory information from a fulfillment partner's warehouse into the Digital River Physical Fulfillment system.

Supported formats and data interchange modes

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (846)

Supported (Best Practice)

Supported

Not Supported

  • Full file or delta—hourly

XML specification

See the EDI X12 846 definition data elements for more information.

Fulfillment order request

Digital River sends the purchase order request to the fulfillment partner who will ship the order directly to the customer. The purchase order contains information such as products ordered, quantity ordered, shipping, and shipping address.

Supported formats

The following table displays the supported formats and data interchange modes from the fulfillment partner to Digital River.

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (850)

Supported (Best Practice)

Supported

Not Supported

  • Real-time or Batch at a scheduled interval

XML specification

EDI X12 850 specification

  • Filename format: OrderRequest_YYYYMMDD_HHMISS.xml

  • EDI X12 850 supported version: 00401

See the EDI X12 850 definition of data elements for more information.

Fulfillment order response

The fulfillment partner sends a response for each order request indicating whether the order was accepted or rejected/cancelled due to errors. If a product is not available, and if the order request allowed the option to hold the backorder by the fulfillment partner, the fulfillment partner uses this feed to notify backorder status. The system sends the purchase order request to the fulfillment partner who will ship the order directly to the customer. The purchase order contains information such as products ordered, quantity ordered, shipping, and shipping address.

Supported formats

The following table displays the supported formats and data interchange modes from the fulfillment partner to Digital River.

  • Real-time or Batch at a scheduled interval

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (855)

Supported (Best Practice)

Supported

Not Supported

XML specification

EDI X12 855 specification

  • Filename format: EDI855_YYYYMMDD_HHMISS.edi

  • EDI X12 855 supported version: 00401

See the EDI X12 855 definition of data elements for more information.

Cancel fulfillment order request

Digital River sends the cancel order request to the fulfillment partner so the fulfillment partner can cancel the order at fulfillment. The cancel order contains information such as purchase order number, products cancelled, and quantity cancelled.

Supported formats and data interchange modes (Digital River to fulfillment partner)

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Not Supported

  • Batch at a scheduled interval

XML specification

Cancel fulfillment order response

The fulfillment partner sends a response for each cancel order request. The response indicates whether the system accepted or rejected the cancellation of the order.

Supported formats and data interchange modes (fulfillment partner to Digital River)

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Not Supported

  • Batch at a scheduled interval

XML specification

Shipment notification

The fulfiller ships the product to the customer and sends a notification to Digital River Global Fulfillment with package details and tracking numbers. Global Fulfillment imports this information and notifies the customer. You can also use this feed to send backorders notifications.

If Digital River has a distribution relationship with the Fulfillment Partner, send the invoice amounts to this feed.

Note: This information applies only to distribution relationships.

In a distribution model where the fulfiller invoices Digital River for the shipping, unit cost (× quantity) and tax, you must call out the following:

EDI 856 / shipment notification

  • The file must include the lineItem segment

  • You must include the shipping amount and the subtotal amount in the segment

    • The fulfiller/distributor invoices Digital River for the shipping amount and should be charged to the customer

    • The subtotal amount is the unit cost (same unit cost as noted in the Sales Catalog) multiplied by the quantity

XML
XML
<lineItems>
<lineItem>
<rowId>1</rowId>
<sku>FULFILLE PART NUMBER</sku>
<warehouseId>AB01</warehouseId>
<orderQuantity>2</orderQuantity>
<shippedQuantity>2</shippedQuantity>
<invoicePricing>
<c:shipping>
<c:amount>5.00</c:amount>
<c:currencyCode>USD</c:currencyCode>
</c:shipping>
<c:handling>
<c:amount>0.00</c:amount>
<c:curencyCode>USD</c:currencyCode>
</c:handling>
<c:tax>
<c:amount>1.00<c:amount>
<c:currencyCode>USD</c:currencyCode>
</c:tax>
<c:fee>
<c:amount>0.00</c:amount>
<c:currencyCode>USD</c:currencyCode>
</c:fee>
<c:discount>
<c:amount>0.0</c:amount>
<c:currencyCode>USD</c:currencyCode>
<c:discount>
<c:subTotal>
<c:amount>5.00</c:amount>
<c:currencyCode>USD</c:currencyCode>
</c:subTotal>
<c:total>
<c:amount>11.00</c:amount>
<c:currencyCode>USD</c:currencyCode>
</c:total>
</invoicePricing>
</lineItem>
</lineItems>

Supported formats

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (856)

Supported (Best Practice)

Supported

Not Supported

  • Batch—Daily at scheduled one or more scheduled times

XML specification

EDI X12 856 specification

  • Filename format: EDI856_YYYYMMDD_HHMISS.edi

  • EDI X12 856 supported version: 00401

See the EDI X12 856 definition of data elements for more information.

Return notification

If a customer initiates the return of products in an order, Digital River sends the return pre-advice to the fulfillment partner.

Supported formats

The following table displays the supported formats and data interchange modes from the fulfillment partner to Digital River.

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (180-1)

Supported (Best Practice)

Supported

Not Supported

  • Batch at scheduled intervals

XML specification

EDI X12 180-1 specification

  • Filename format: EDI180-1_YYYYMMDD_HHMISS.edi

  • EDI X12 832 supported version: 00401

See EDI X12 180-1 definition of data elements for more information.

Return response

The fulfillment partner sends a response with warehouse RMA ID and optionally a return warehouse address to Digital River. The response is based on the return notification pre-advice send to the fulfillment partner.

Supported formats

The following table displays the supported formats and data interchange modes from the fulfillment partner to Digital River.

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (180-2)

Supported (Best Practice)

Supported

Not Supported

  • Batch at scheduled intervals

XML specification

EDI X12 180-2 specification

  • Filename format: EDI180-2_YYYYMMDD_HHMISS.edi

  • EDI X12 180-2 supported version: 00401

See EDI X12 180-2 definition of data elements for more information.

Return receipt

When returned packages arrive at the warehouse, the Fulfillment partner notifies Digital River Physical Fulfillment to complete the return with a credit payment. This integration notifies Digital River of any returns without a valid return pre-advice from Digital River. This includes shipments refused by the customer or shipments that the fulfillment partner could not deliver to the customer.

Supported formats

Format

AS2

FTP/SFTP

Web Service Post to Fulfiller

XML

Supported

Recommended (Best Practice)

Supported (Custom Implementation)

EDI X12 (180-3)

Supported (Best Practice)

Supported

Not Supported

  • Batch at scheduled intervals

XML specification

EDI X12 180-3 specification

  • Filename format: EDI180-3_YYYYMMDD_HHMISS.edi

  • EDI X12 180-3 supported version: 00401

See EDI X12 180-3 definition of data elements for more information.