Returns

[LM-andreas]

Hur ska vi hantera dessa?

[MichaelaVesterlund]

Är det samma sak som returer?

[LM-andreas]

Ja, det tycker jag väl man kan säga.

[MichaelaVesterlund]

Suggestion on how we can handle returns and some scenarios that we as a reseller see us having.

Return of digital items to the supplier.
The reseller(RS) creates a return by calling the supplier and receives a direct response back whether it went well or not. RS may need to help the customer make an unassignment of the licenses in order to be able to make a return if the supplier requires it.
*Unassign:post
*Return:post

Return of hybrids
RS prepares the return of the hybrid by reserving the items, i.e. they are not available for use by the customer. If the reservation does not go well, RS must be able to see why. Either everything goes well or bad, to avoid having multiple types of calls, it only goes through if all go well.
*Reserve: post.
After the books have been reviewed, RS may need to update or remove the reservation. I suggest doing so by delete and put on the same endpoint.

Return to pot - RS sells from its own warehouse.
RS wants to resell the articles and needs to disconnect the license from the school. Therefore, a call is made to the return endpoint with attribute ’toSupplier’ set to no.
*Return
-toSupplier:no
When RS then wants to resell the license, an assignment call is later made.

Return to supplier
RS registers a return with the supplier, who responds with no or 'yes but waiting for books'. RS sends the books to the supplier. Once the supplier has reviewed the books, they reply to the replyTo url if it went well or not. If it has gone well, articles will not be available to RS and its customer. If things have gone badly, the books are sent back to RS. RS then chooses itself whether it wants to remove the reservation and send the books back to the customer or whether it wants to make a return-to-pot and resell the articles.
*Return
-toSupplier:yes

API calls required:
Return
-quantity
-isbn
-order line number/reference
-license key (no unassignment required if license key is unique)
-replyToUrl: 'For hybrids when you want to send multiple answers'
-toSupplier: Yes/No
Return reply
-response : enum OK/Not Ok/Waiting for books
-reason (for Not Ok): enum Not sufficiently unassigned, Unable because they are used (for suppliers who do not allow returns after use)
-quantity that can be returned
Unassignment
Same field as when assigning?
-licensekey
-user:id
Unassign - answer
-response: OK/Not ok
-reason: reason if response is not ok.
Reserve
-quantity
-isbn
-order line number/reference
-license key
-if the license key is not unique, is information about the school required?
Reserve answer
-response: OK/Not ok
-reason: reason if response is not ok.

[oskarsjoberg-sl]

• "Return to pot" and "Return to supplier" should be 2 separate endpoints.
• Should the return api call body include both "quantity"/"isbn" and "license keys" or is "license keys" enough?
• Return policy rules for the reseller and specific customer needs to be communicated to the supplier at some point. Either in the order or at least when the reseller checks if a return is possible.
• When the reseller makes the reservation, a reservationID should be sent back from the supplier. This reservationID needs to be used in all subsequent calls to update/remove/return the reservation.

[MichaelaVesterlund]

Suppliers who have other return policys/rules should add them on here to be discussed in next meeting.

[hekdahl]

@MichaelaVesterlund I think not all suppliers can support all types of returns. I see three different types:
Return an entire order
Return licenses
Return quantity on order lines

I am sketching a proposal that supports all three options. Thought I'd check with our developers first but can share it with you after that. What do you think about that?

Gleerups can return entire orders
Gleerups does not have licenses with a license key so cannot return at the license level
Gleerups does not save your orderRowId, which means that we are currently unable to return order rows

[MichaelaVesterlund]

We have to be able to return a single quantity/license but it does not have to be a specific licensekey, because not everyone is using licensekeys. We suggest using a combination of ordernumber and articlenumber. Yes we would like to see your suggestion as well =)

[hekdahl]

To inform the rest of you, I have sent a proposal for an alternative solution for order returns to Michaela. I'm starting to look at it together with Michaela and if we think it's a better solution, you'll all get to look at it later. I have vacation next week (w.13).