service
Returns API

Returns API

Public API customers use to start a return. Validates the request against the original order and records it.

Service

Overview

The Returns API receives Request ReturnRequest ReturnCommandv1.0.0Command sent by a customer to return one or more items from a delivered order. Ownerfulfilment-platformSchemaMapView docs from customers, stores the request in the Returns DatabaseReturns DatabaseContainerv1.0.0PostgreSQL database that is the system of record for return requests and their status.Ownerfulfilment-platformMapView docs and publishes Return RequestedReturn RequestedEventv1.0.0Published when a customer has requested to return items from an order. Ownerfulfilment-platformSchemaMapView docs for the Returns ProcessorReturns ProcessorServicev1.0.0Applies the returns policy to new requests and tracks returned parcels until they arrive back at the warehouse. Publishesreturn-approved, return-receivedSubscribesreturn-requestedOwnerfulfilment-platformMapRepoView docs.

Responsibilities

AreaDescription
IntakeHandles Request ReturnRequest ReturnCommandv1.0.0Command sent by a customer to return one or more items from a delivered order. Ownerfulfilment-platformSchemaMapView docs and validates the order and items.
PersistenceWrites new return requests to the Returns DatabaseReturns DatabaseContainerv1.0.0PostgreSQL database that is the system of record for return requests and their status.Ownerfulfilment-platformMapView docs.
Event publishingEmits Return RequestedReturn RequestedEventv1.0.0Published when a customer has requested to return items from an order. Ownerfulfilment-platformSchemaMapView docs.

Architecture diagram

Messages for this service

Sends messages (1)

Quickly find the message you need by searching for the name, type, or summary.
NameVersionTypeSummary
Return Requested
v1.0.0eventPublished when a customer has requested to return items from an order.

Receives messages (1)

Quickly find the message you need by searching for the name, type, or summary.
NameVersionTypeSummary
Request Return
v1.0.0commandCommand sent by a customer to return one or more items from a delivered order.
Event-driven architecture documentation: Acme Inc