Service - Sell Offer Standard: Difference between revisions

From Izara Wiki
Jump to navigation Jump to search
(Created page with "= Overview = Handler service for the standard sell offer type. = Repository = XXXX = DynamoDB tables = == Standard Config Table Per Service == === Configuration tags...")
 
No edit summary
 
(26 intermediate revisions by the same user not shown)
Line 5: Line 5:
= Repository =
= Repository =


XXXX
https://bitbucket.org/izara-market-products/izara-market-products-sell-offer-standard/src/master/


= DynamoDB tables =
= Object Schemas =
; Additional Information: [[Per Service Schemas]]


== [[Standard Config Table Per Service]] ==
== objType ==


=== Configuration tags ===
=== sellOfferStandard ===


<syntaxhighlight lang="JavaScript">
<syntaxhighlight lang="JavaScript">
{
{
configTag: "SellOfferServiceNameTag"
objectType: "sellOfferStandard",
configKey: "SellOfferServiceNameTag"
extendObjType: {
configValue: xxx // this own services ServiceNameTag, eg "SellOfferStandard"
serviceTag: "sellOfferManager",
}
objectType: "sellOffer"
</syntaxhighlight>
},
 
storageResources: {
<syntaxhighlight lang="JavaScript">
myGraph: {
{
storageType: "graph",
configTag: "ProductsGraphServiceName"
graphServerTag: "GraphHandler"
configKey: "ProductsGraphServiceName"
}
configValue: xxx // eg: "ProductsGraph"
    },
}
    fieldNames: {
</syntaxhighlight>
currencyId: {
 
type: "currency",
<syntaxhighlight lang="JavaScript">
storageResourceTags: ['myGraph']
{
},
configTag: "SellOfferManagerServiceName"
    },
configKey: "SellOfferManagerServiceName"
configValue: xxx // eg: "SellOfferManager"
}
}
</syntaxhighlight>
</syntaxhighlight>


== Object Relationships ==


= Graph database =  
= SellOffer currency =


== [[Service - Products Graph]]==
* When creating a sellOffer it's currency will be set to the same as the sellOfferPlan chosen
* sellOfferPrices is not linked to a set currency, this allows the pricing structure to be used across sellOffers with different currencies (eg USD equivalent currencies)


=== Nodes ===
== Carts ==


==== variant ====
* a Cart chooses one deliveryMethod, any sellOffers(actually the sellOffer's sellOfferPlan) added to the cart that are not the same currency as the selected deliveryMethod will be invalid when validating cart


Is an origin/home/top-level node, one per sell offer.
== Delivery Method Links ==


* NodeIdentifierLabels: selloffer
* when adding a deliveryMethod to a sellOfferPlan the currencies must match
* NodeIdentifierProperties: sellofferId (random uuid)
* because we expect deliveryMethods to have a rate returned, a shipping price, so expect to be able to combine that to the sellOffer's price without any conversion
* perhaps not allow changing of a deliveryMethod and sellOfferPlan's currency, if want to change need to create new


Properties:
== Payment Method Links ==


# ..
* paymentMethod does not need to match the sellOfferPlan currency, seller can have sellOfferTerms to explain currency conversion when making payment
* however if the paymentMethod has a oneTimeAmount setting, that will make calculating the price invalid if it does not match the deliveryMethod/Cart's currency (maybe not store currency in paymentMethod, apply as is to whatever currency the sellOfferPlan is)
* oneTimePercentage can be set even if currencies do not match


= Working documents =
= Working documents =

Latest revision as of 23:18, 16 August 2025

Overview

Handler service for the standard sell offer type.

Repository

https://bitbucket.org/izara-market-products/izara-market-products-sell-offer-standard/src/master/

Object Schemas

Additional Information
Per Service Schemas

objType

sellOfferStandard

{
	objectType: "sellOfferStandard",
	extendObjType: {
		serviceTag: "sellOfferManager",
		objectType: "sellOffer"
	},
	storageResources: {
		myGraph: {
			storageType: "graph",
			graphServerTag: "GraphHandler"
		}
    },
    fieldNames: {
		currencyId: {
			type: "currency",
			storageResourceTags: ['myGraph']
		},
    },
}

Object Relationships

SellOffer currency

  • When creating a sellOffer it's currency will be set to the same as the sellOfferPlan chosen
  • sellOfferPrices is not linked to a set currency, this allows the pricing structure to be used across sellOffers with different currencies (eg USD equivalent currencies)

Carts

  • a Cart chooses one deliveryMethod, any sellOffers(actually the sellOffer's sellOfferPlan) added to the cart that are not the same currency as the selected deliveryMethod will be invalid when validating cart

Delivery Method Links

  • when adding a deliveryMethod to a sellOfferPlan the currencies must match
  • because we expect deliveryMethods to have a rate returned, a shipping price, so expect to be able to combine that to the sellOffer's price without any conversion
  • perhaps not allow changing of a deliveryMethod and sellOfferPlan's currency, if want to change need to create new

Payment Method Links

  • paymentMethod does not need to match the sellOfferPlan currency, seller can have sellOfferTerms to explain currency conversion when making payment
  • however if the paymentMethod has a oneTimeAmount setting, that will make calculating the price invalid if it does not match the deliveryMethod/Cart's currency (maybe not store currency in paymentMethod, apply as is to whatever currency the sellOfferPlan is)
  • oneTimePercentage can be set even if currencies do not match

Working documents

Sell Offer Standard