j1.1.28
API ä»æ§æžã®ããŠã³ããŒã
APIã®æŠèŠ
Inventory Impex API ã䜿çšãããšãOmnichannel Inventory (OCI) ã®åšåº«ã®å ¥æå¯èœæ§ã®ã€ã³ããŒããšãšã¯ã¹ããŒãã管çã§ããŸãã
ãã® API ã¯ã次ã®æ©èœã«ããŽãªã«åé¡ã§ããŸãã
| ã«ããŽãª | ãšã³ããã€ã³ãã®èª¬æ |
|---|---|
| åšåº«ã®ã€ã³ããŒããšãšã¯ã¹ããŒã | åšåº«ã®å ¥æå¯èœæ§ããŒã¿ãã€ã³ããŒãããã³ãšã¯ã¹ããŒãããããã® API ãšã³ããã€ã³ãã |
泚: Omnichannel Inventory ã§ã¯ãçµç¹ ID ã®ä»£ããã«ããã³ãã°ã«ãŒã ID ã䜿çšããŸãã詳现ã«ã€ããŠã¯ãCommerce API æ§æå€ãåç §ããŠãã ããã
ã¬ãŒãå¶é
ããŒãã·ã§ãã£ã³ã°ãšã¬ãŒãå¶éã®è©³çŽ°ã«ã€ããŠã¯ãããŒãã·ã§ãã£ã³ã°ãšã¬ãŒãå¶éãåç §ããŠãã ããã
ãã¹ããã©ã¯ãã£ã¹
ãã¹ããã©ã¯ãã£ã¹ã«ã€ããŠã¯ãInventory Impex ãã¹ããã©ã¯ãã£ã¹ãåç §ããŠãã ããã
èªèšŒãšèªå¯
Omnichannel Inventory ãåŒã³åºãã¯ã©ã€ã¢ã³ãã¯ã次㮠2 ã€ã®ããããã®æ¹æ³ã§èªèšŒã§ããŸãã
- B2C Commerce ã®èªèšŒæ å ±ã䜿çšããŠãAccount Manager ã§èªèšŒããŸãã
- Salesforce org ã®èªèšŒæ å ±ã䜿çšããŠèªèšŒããŸãã
B2C Commerce ãš Salesforce Order Management ã®äž¡æ¹ã䜿çšããŠããå Žåã¯ãã©ã¡ãã®èªèšŒã¢ãããŒãã䜿çšã§ããŸãããã ããçµ±åå šäœã§ã¢ãããŒããæ··åšããã®ãé¿ãããããã©ã¡ãã 1 ã€ã®ã¿ãéžæããããšãæšå¥šããŸãã
èªèšŒã¢ãããŒããç°ãªã£ãŠããŠããAPI ã®çšéãããã©ãŒãã³ã¹ã«ã¯åœ±é¿ããŸããã
åèªèšŒã¢ãããŒãã§ã¯ãããããåºæã®ã¹ã³ãŒãã»ããã䜿çšããŸãã
| Account Manager èªèšŒã®ã¹ã³ãŒã | Salesforce org èªèšŒã®ã¹ã³ãŒã |
|---|---|
| sfcc.inventory.impex-graphs | sfcc_inventory_impex_graphs |
| sfcc.inventory.impex-inventory.rw | sfcc_inventory_impex_inventory_rw |
| sfcc.inventory.impex-inventory | sfcc_inventory_impex_inventory |
| sfcc.inventory.availability | sfcc_inventory_availability |
| sfcc.inventory.availability.rw | sfcc_inventory_availability_rw |
| sfcc.inventory.reservations | sfcc_inventory_reservations |
| sfcc.inventory.reservations.rw | sfcc_inventory_reservations_rw |
API ã²ãŒããŠã§ã€çµç±ã§ Omnichannel Inventory ãåŒã³åºãå Žåã¯ãæå¹ãª OAuth ãã¢ã©ãŒããŒã¯ã³ãå¿ èŠã§ããOmnichannel Inventory ã§äœ¿çšãããããã³ãèå¥åã¯ãããŒã¯ã³ã®ããããŒã§æå®ãããŸãã
ãã¹ãŠã®ãªã¯ãšã¹ãããã£ããã³ã¬ã¹ãã³ã¹ããã£ã®ãšã³ãã£ãã£ã¯ãJSON ã§æ§æãããŸãã
ãŠãŒã¹ã±ãŒã¹
åšåº«ã®å ¥æå¯èœæ§ã®ã€ã³ããŒã / ãšã¯ã¹ããŒã
ãããã® API ãšã³ããã€ã³ãã䜿çšãããšãåç®ã®å ¥æå¯èœæ§ããŒã¿ãã€ã³ããŒãããã³ãšã¯ã¹ããŒãããå·®å (å€æŽ) ãèªã¿åãããšãã§ããŸãã
Omnichannel Inventory ã¯ãSKU ããšã«åç®ãä¿æãã次ã®åç®ã®å ¥æå¯èœæ§ããããã£ã®éèšã管çããŸãã
| å ¥æå¯èœæ§ãããã㣠| 説æ |
|---|---|
Available to Fulfill |
çŸæç¹ã§ãã«ãã£ã«ã¡ã³ãå¯èœãªåšåº« (Quantity on Hand - Quantity Reserved)ã |
Available to Order |
泚æå¯èœãªåšåº« ((Quantity on Hand + Future Inventory) - Quantity Reserved)ã |
Quantity on Hand |
å©çšå¯èœãªåšåº«æ°éãFuture Inventory ãš Quantity Reserved ã¯å«ã¿ãŸããã |
Quantity Reserved |
ãã«ãã£ã«ã¡ã³ãçšã«äºçŽãããŠããåšåº«æ°éã |
Safety Stock Count |
æå³çã«ç¢ºä¿ãããAvailable to Order ãŸã㯠Available to Fulfill ã®åšåº«æ°ã«å«ãŸããªãåšåº«æ°éã |
Future Inventory |
äºçŽè²©å£²ãŸãã¯åãå¯ã泚æã«ã®ã¿äœ¿çšã§ããåšåº«ãçŸåšã¯å©çšã§ãããå ¥è·äºå®æ¥ãå«ã¿ãŸãã |
Attribute Set |
åç®ã«é©çšã§ããåšåº«å±æ§ (äŸ:groupEligibilityExclusion)ã |
availability-records imports POST ãšã³ããã€ã³ãã䜿çšããŠãåšåº«ã®å ¥æå¯èœæ§ããŒã¿ã Omnichannel Inventory ã«èªã¿èŸŒãåŠçãéå§ããŸããã€ã³ããŒãããããŒã¿ã®è©³çŽ°ã¯ãPOST ãªã¯ãšã¹ãã®ããã£ã«å«ãŸããŸãã
éå§åŒã³åºãã®ã¬ã¹ãã³ã¹ããã£ã«ã¯ãå®éã®ã€ã³ããŒãçšããŒã¿ã¹ããªãŒã /ãã¡ã€ã«ãéä¿¡ããããã®ãªã³ã¯ãå«ãŸããŸããã·ã¹ãã ã«ã¢ããããŒããããã¡ã€ã«ã 100 MB ãè¶ ããå Žåããã¡ã€ã«ã gzip ã§å§çž®ãã _å¿ èŠããããŸã_ã
ãã¡ã€ã«ã OCI ã·ã¹ãã ã«æ£åžžã«ã¢ããããŒããããããavailability-records imports status ãšã³ããã€ã³ããåŒã³åºããŠãã€ã³ããŒãã®ã¹ããŒã¿ã¹ã確èªã§ããŸãããã®ãšã³ããã€ã³ããããã¡ã€ã«ã¢ããããŒãã§äœ¿çšãã importId ãšçµã¿åãããŠäœ¿çšãããšãã€ã³ããŒãåŠçããŸã å®äºããŠããªããã©ããã確èªã§ããŸãã
ãã¡ã€ã«ãOCIã«ãã£ãŠæ£åžžã«åŠçããããšãã¬ã¹ãã³ã¹ããã£ã«ã¯ COMPLETED ã¹ããŒã¿ã¹ãå«ãŸããŸããã€ã³ããŒãã«é¢ãããã®ä»ã®ã¡ããªã¯ã¹ãå«ãŸããŠãããããã㯠status åŒã³åºãã®ããã¥ã¡ã³ãã«èšèŒãããŠããŸãã
ãŸããCOMPLETED ã¹ããŒã¿ã¹ã«ã¯ãfullResults href ãå«ãŸããŸãããã® URI ã䜿çšãããšãå®äºããã€ã³ããŒãåŠçã®è©³çŽ°ãªçµæãååŸã§ããŸãã
åç®ã®å ¥æå¯èœæ§ã¬ã³ãŒãã®ã€ã³ããŒããå®è¡ããå Žåã¯ã次ã®ãšã³ããã€ã³ãããã®é åºã§äœ¿çšããŸãã
- imports POST URI ãåŒã³åºããŠã€ã³ããŒããéå§ããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/availability-records/imports - æé 1 ã®ã¬ã¹ãã³ã¹ããã£ã«å«ãŸãã uploadLink ã䜿çšããŠãæäŸããããšã³ããã€ã³ãã« POST åŒã³åºããè¡ããããŒã¿ã¹ããªãŒã /ãã¡ã€ã«ã OCI ã«ã¢ããããŒãããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/availability-records/imports/uploadlink/{uploadLinkId} - ãã¡ã€ã«ã OCI ã«ã¢ããããŒããããããéå§åŒã³åºã (æé 1 ) ã®ã¬ã¹ãã³ã¹ããã£ã§æäŸããã importStatusLink ã«å¯Ÿã㊠GET åŒã³åºããè¡ããã€ã³ããŒãããŒã¿ã®åŠçã¹ããŒã¿ã¹ã確èªã§ããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/availability-records/imports/{importId}/status - æé 3 ããè¿ãããã¬ã¹ãã³ã¹ããã£ã®ã¹ããŒã¿ã¹ãã£ãŒã«ãã COMPLETED ã«ãªã£ãããOCI ãžã®å
¥æå¯èœæ§ã¬ã³ãŒãããŒã¿ã®ã€ã³ããŒãã¯å®äºã§ããã¹ããŒã¿ã¹ã¬ã¹ãã³ã¹ã«ã¯ãå®äºããã€ã³ããŒãåŠçã®è©³çŽ°ãååŸããããã® URI ãå«ã fullResults href ãã£ãŒã«ããå«ãŸããŸãããã®æ
å ±ã¯ãæäŸããã URI ã«å¯Ÿãã GET åŒã³åºãã§ååŸããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/availability-records/imports/{importId}/file-content
瀺ããããšã³ããã€ã³ãã䜿çšããŠãã®é åºã§æé ãå®è¡ããããšã§ãå ¥æå¯èœæ§ã¬ã³ãŒãã OCI ã«æ£åžžã«ã€ã³ããŒãã§ããŸãã
ãã±ãŒã·ã§ã³åšåº«ã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠã - é«æ§èœç
ãã¹ãŠã®æ°èŠå®è£ ã§ããã®ã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠãã䜿çšããããšã匷ãæšå¥šããŸããã¬ã¬ã·ãŒã¬ã€ã¢ãŠãã䜿çšããŠããæ¢åã®å®è£ ã«ã€ããŠããããã©ãŒãã³ã¹åäžã®ã¡ãªãããåŸãããããããã®æ°ããã¬ã€ã¢ãŠãã«ç§»è¡ããããšãæšå¥šããŸãããã®ã¬ã€ã¢ãŠãã§ã¯ãå ã®ä»æ§ã® Location Header ãš Location Inventory ãªããžã§ã¯ã ã 1 ã€ã®ãšã³ãã£ãã£ã«çµ±åããŠããŸããã·ã¹ãã ã§ã¯ãå ã®ã¬ã€ã¢ãŠãã®ã³ã³ãã³ããšæ°ããã¬ã€ã¢ãŠãã®ã³ã³ãã³ããæ··åšããŠäœ¿çšããããšã¯ã§ããŸãããã€ã³ããŒããã¡ã€ã«ã¯ãé«æ§èœã¬ã€ã¢ãŠããŸãã¯ã¬ã¬ã·ãŒã¬ã€ã¢ãŠãã®ããããäžæ¹ã®ã¿ã䜿çšããŠãå šäœãæ§æããå¿ èŠããããŸãã
éèŠ: ããã©ãŒãã³ã¹ã®åäžãå®çŸããã«ã¯ã次ã®äŸã®ããã«ãSKU ããšã«ã°ã«ãŒãåããŠãã¡ã€ã«ãæ§æããå¿ èŠããããŸãã
泚: çŸåšãµããŒããããŠããã®ã¯ UPDATE ã®ã¿ã§ãããããmode 㯠UPDATE ãšèŠãªãããŸãã
{"recordId":"0a87539d-f3dd-47bc-91c7-9c752e39dbe0","onHand":10,"sku":"sku1","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0,"attributeSet":{"groupEligibilityExclusion":["GroupA","GroupB"]},"locationId":"wickenburg"}
{"recordId":"3127e2ad-748b-459a-917c-78bef741602c","onHand":10,"sku":"sku1","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0,"attributeSet":{"groupEligibilityExclusion":["GroupA","GroupB"]},"locationId":"prescott"}
{"recordId":"b709e7a8-7d4f-4458-be0c-a88f1e594f1d","onHand":10,"sku":"sku2","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0,"attributeSet":{"groupEligibilityExclusion":["GroupA","GroupB"]},"locationId":"wickenburg"}
{"recordId":"b34c99ea-e659-40f7-bcb4-2a3fdc4a80b0","onHand":10,"sku":"sku2","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0,"attributeSet":{"groupEligibilityExclusion":["GroupA","GroupB"]},"locationId":"prescott"}
{"recordId":"4bf7b40b-c965-485c-afa0-cc56a8ea70eb","onHand":10,"sku":"sku3","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0,"locationId":"wickenburg"}
{"recordId":"539d41b7-5f05-4908-831b-3dd0461794fc","onHand":10,"sku":"sku3","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0,"locationId":"prescott"}
é«æ§èœã¬ã€ã¢ãŠãã䜿çšããŠããããšã瀺ãããã®ããã以å€ã®èŠä»¶ã¯ãããŸãããã·ã¹ãã ã¯ãã¡ã€ã«ãèªã¿åããåŠçæ¹æ³ãèªåçã«å€æããŸãã
ãã£ãŒã«ãã®å 容ã«ã€ããŠã¯ã以äžã®ã€ã³ããŒããã£ãŒã«ãå®çŸ©ãåç §ããŠãã ããã
ãã±ãŒã·ã§ã³åšåº«ã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠã - CSV
CSV ãã¡ã€ã«ã®ã€ã³ããŒãããµããŒããããŠããŸããCSV ãã¡ã€ã«ãéä¿¡ããã«ã¯ãã€ã³ããŒãéå§åŒã³åºã㧠fileType ãã£ãŒã«ãã CSV ã«èšå®ããå¿ èŠããããŸããããã«ããã次ã®åœ¢åŒã§ãã¡ã€ã«ãéä¿¡ã§ããŸãã
CSV 圢åŒã®ã€ã³ããŒããã¡ã€ã«ã§æ³šç®ãã¹ãç¹ã¯ãããããŒè¡ãšãå°æ¥åšåº«ãå«ããæ¹æ³ã§ããCSV ãã¡ã€ã«ã¯ JSON ãã¡ã€ã«ã®ãããªãã¹ãæ§é ã®åŠçã«ã¯é©ããŠããªããããå°æ¥åšåº«ã¯æ¬¡ã«ç€ºãæ¹æ³ã§è¡šçŸããå¿ èŠããããŸãããã®åœ¢åŒã䜿çšãããšãã€ã³ããŒãåŠçäžã«ååç®ã«å¯Ÿã㊠2 件ã®å°æ¥åšåº«ãé©çšã§ããŸãã
Location ID,SKU,Quantity On Hand,Safety Stock,Effective Date,Future Date 1,Future Quantity 1,Future Date 2,Future Quantity 2,Group Eligibility Exclusion warehouse,red_shirt,10,1,2020-04-08T14:05:22.790896-07:00,2020-04-18T14:05:22.781-07:00,10,2020-05-18T14:05:22.781-07:00,100,"[G1, G2]" warehouse-2,white_shirt,200,10,2020-04-08T14:05:22.790896-07:00,,,,,
ãã±ãŒã·ã§ã³åšåº«ã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠã - ã¬ã¬ã·ãŒ
泚: ã·ã¹ãã ã§ã¯çŸåšããã®ã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠãããµããŒãããŠããŸãããããã©ãŒãã³ã¹ãäœãããããã®ã¬ã€ã¢ãŠããã移è¡ããããšãæšå¥šããŸãã詳现ã«ã€ããŠã¯ãã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠã - é«æ§èœçã»ã¯ã·ã§ã³ãåç §ããŠãã ããã
ã€ã³ããŒãããŒã¿ã¹ããªãŒã ã§ã¯ããã±ãŒã·ã§ã³ããšã®åšåº«ã®å
¥æå¯èœæ§ããŒã¿ãšãOmnichannel Inventory ãå®è¡ããã€ã³ããŒãæäœã®çš®é¡ (ããšãã°ãUPDATEãDELETEãREPLACE) ãæå®ããŸããã¹ããªãŒã ã¯ãæ¹è¡ã§åºåããã 2 çš®é¡ã® JSON ãšã³ãã£ã㣠(Location Header ãš Location Inventory) ã§æ§æãããŸãã
ãã£ãŒã«ãã®å 容ã«ã€ããŠã¯ãã€ã³ããŒããã£ãŒã«ãå®çŸ©ã»ã¯ã·ã§ã³ãåç §ããŠãã ããã
éèŠ: Location Header ãšã³ãã£ãã£ãš Location Inventory ãšã³ãã£ãã£ã¯ 1 察å€ã®é¢ä¿ã«ãããŸããå Location Header ã®åŸã«ã¯ãåããã±ãŒã·ã§ã³ã«å¯Ÿå¿ãã 1 ã€ä»¥äžã® Location Inventory ãšã³ãã£ãã£ãç¶ããå¿ èŠããããŸããå Location Inventory ãšã³ãã£ãã£ã®äžã« Location Header ãšã³ãã£ãã£ãé 眮ããããšãå¯èœã§ãããã€ã³ããŒãåŠçã _å€§å¹ ã«é ããªããŸã_ã
{"location":"wickenburg","mode":"UPDATE"}
{"recordId":"0a87539d-f3dd-47bc-91c7-9c752e39dbe0","onHand":10,"sku":"sku1","effectiveDate":"2020-04-08T14:05:22.790896-07:00","futures":[{"quantity":1,"expectedDate":"2020-04-18T14:05:22.781-07:00"}],"safetyStockCount":0}
{"recordId":"f4bf981e-321e-42bd-851f-3573a3263ab1","onHand":5,"sku":"sku2","effectiveDate":"2020-04-08T14:05:22.790896-07:00","safetyStockCount":1}
ã€ã³ããŒããã£ãŒã«ãå®çŸ©
ãã±ãŒã·ã§ã³ããããŒ:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
location |
åšåº«ãä¿ç®¡ãããŠããç©çãã±ãŒã·ã§ã³ã | TRUE |
mode |
å®è¡ããã·ã¹ãã æäœã®çš®é¡ãçŸåšãµããŒããããŠããã®ã¯ UPDATEã®ã¿ã§ãã |
TRUE |
ãã±ãŒã·ã§ã³åšåº«:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
recordId |
åšåº«ã¬ã³ãŒãã®äžæã®èå¥åã | TRUE |
sku |
åç®ã®äžæã®èå¥åã: \ < > ; % / ãã¹ããŒã¹ãã¿ããæ¹è¡ã¯äœ¿çšã§ããŸããã | TRUE |
onHand |
çŸåšã®ææåšåº«æ°éã | FALSE |
effectiveDate |
onHand ã®æå¹æ¥ (ISO 圢åŒ)ã |
FALSEã詳现ã¯ã以äžã®è¿œå 説æãåç
§ããŠãã ããã |
futures |
åç®ã®å°æ¥æ°éæ
å ±ã®ã³ã¬ã¯ã·ã§ã³ã(以äžã®ãå°æ¥æ°éããåç
§ããŠãã ããã)泚: Inventory Availability API ã§ã¯ãfutures 㯠futureStock ãšããååã®ã³ã¬ã¯ã·ã§ã³ã§åç
§ãããŸãããããã¯åããã®ã§ãã |
FALSEãæå®ããå Žåã¯ã以äžã®å¿
é ãã£ãŒã«ããåç
§ããŠãã ããã |
attributeSet |
åç®ã«é©çšã§ããå±æ§ã(å©çšå¯èœãªå±æ§ã«ã€ããŠã¯ã以äžã®ãå±æ§ã»ããããåç §ããŠãã ããã) | FALSEãæå®ããå Žåã¯ã以äžã®å¿
é ãã£ãŒã«ããåç
§ããŠãã ããã |
safetyStockCount |
å®å šåšåº«æ°ã | FALSE |
å°æ¥æ°é:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
quantity |
ä»åŸå ¥è·äºå®ã®æ°éãå€ã¯ 0 ãã倧ããå¿ èŠããããŸãã | TRUE |
expectedDate |
å°æ¥æ°éã®å°çäºå®æ¥ (ISO 圢åŒ)ã | TRUE |
å±æ§ã»ãã:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
groupEligibilityExclusion |
location/sku ã®éèšããé€å€ãããã°ã«ãŒãã | FALSE |
éä¿¡åŒã³åºãã®ã¬ã¹ãã³ã¹ã«ã¯ãã€ã³ããŒãã®ã¹ããŒã¿ã¹ãšé²è¡ç¶æ³ã確èªããããã®ã«ã¹ã¿ã ãšã³ããã€ã³ããå«ãŸããŸããã¹ããŒã¿ã¹ã¬ã¹ãã³ã¹ã«ã¯ãèªã¿èŸŒã¿ã«å€±æããã¬ã³ãŒããååšããå Žåããããã®å®å šãªçµæãã¡ã€ã«ã® URI ãå«ãŸããŸããOmnichannel Inventory ã«ã¯ãã€ã³ããŒããžã§ãã®ã¯ãšãªãšåé€ã®ããã®ãšã³ããã€ã³ããçšæãããŠããŸãã
å ¥æå¯èœæ§ã®æå¹æ¥:
effectiveDate ãã£ãŒã«ãã¯ãç©çãã±ãŒã·ã§ã³ã§ onHand å€ãæ£ç¢ºã§ãã£ãæç¹ãè¡šããŸãããã®ãã£ãŒã«ãã¯ãäºçŽãã«ãã£ã«ã¡ã³ããã£ãŒã«ã fulfillmentTime ãšçµã¿åãããŠäœ¿çšãããonHand ãç©çãã±ãŒã·ã§ã³ãšåæããç¶æ
ã«ä¿ã¡ãŸããããšãã°ããã±ãŒã·ã§ã³ã¬ã³ãŒã㧠effectiveDate ãæå®ãããŠããå ŽåãäºçŽãã«ãã£ã«ã¡ã³ããå®è¡ããããšãã·ã¹ãã ã¯ä»»æ㧠onHand ã®å€ãæžç®ããŸããäºçŽãã«ãã£ã«ã¡ã³ãã®åäœã®è©³çŽ°ã«ã€ããŠã¯ãInventory Reservation API ãåç
§ããŠãã ããã
äŸ:
SKU abcããã±ãŒã·ã§ã³ 123 ã«å¯ŸããŠã€ã³ããŒããå®è¡ãããonHand ã®å€ã«ã¯ãOCI ã§ãŸã åŠçãããŠããªãäºçŽãã«ãã£ã«ã¡ã³ããåæ ãããŠããŸãã
泚: ããã§ã¯ JSON ãæŽåœ¢ããŠè¡šç€ºããŠããŸãããå®éã®ã€ã³ããŒããã¡ã€ã«ã§ã¯ããã¹ãŠ 1 è¡ã§èšè¿°ãã _å¿ èŠããããŸã_ã
{
"recordId":"a26fe1fd-c413-4b74-8570-1ec185ca7192",
"onHand":10,
"sku":"abc",
"effectiveDate":"2021-03-09T00:00:00.000000-07:00"
}
SKU abcããã±ãŒã·ã§ã³ 123 ã«å¯Ÿããã€ã³ããŒãã®åŸã§äºçŽãã«ãã£ã«ã¡ã³ããªã¯ãšã¹ããçºçããŸãã
{
"records": [
{
"id": "82251928-8863-488e-840b-2aebd10b57ba",
"location": "123",
"sku": "abc",
"fulfillmentTime":"2021-03-08T00:00:00.000000-07:00"
"quantity": 1
}
]
}
ã·ã¹ãã ã¯ãeffectiveDate ãš fulfillmentTime ã®å€ãæ¯èŒããŸããfulfillmentTime 㯠effectiveDate ãã å ã§ãããããonHand ã®å€ã¯ _æžç®ãããŸãã_ãäºçŽãã«ãã£ã«ã¡ã³ããå
ã«çºçããŠããå Žåã¯ãonHand ã¯æžç®ãããŸã (ãã®åã® effectiveDate ã®å€ã fulfillmentTime ããåã§ããããšãåæã§ã)ããã®åŸãã·ã¹ãã ãåšåº«ã®ã€ã³ããŒããå®è¡ãããšãonHand ã®å€ã§ä»¥åã®å€ã眮ãæããããŸãã
ãã±ãŒã·ã§ã³åšåº«ã€ã³ããŒãçµæãã¡ã€ã«ã¬ã€ã¢ãŠã
çµæãã¡ã€ã«ã¯ãã¹ããŒã¿ã¹è¡ã¬ã³ãŒãã§å§ãŸããŸãã
{"status": "COMPLETED_WITHOUT_ERRORS"}
| çµæã¹ããŒã¿ã¹ | 説æ |
|---|---|
COMPLETED_WITHOUT_ERRORS |
ãšã©ãŒãªãã§ã€ã³ããŒããå®äºããŸããã |
COMPLETED_WITH_PARTIAL_FAILURES |
äžéšã®ã¬ã³ãŒãã®èªã¿èŸŒã¿ã«å€±æããŸããã |
FAILED |
ãã¹ãŠã®ã¬ã³ãŒãã®èªã¿èŸŒã¿ã«å€±æããŸããã |
ã¹ããŒã¿ã¹è¡ã«ç¶ãåè¡ã¯ããšã©ãŒã¬ã³ãŒããè¡šããŸãã
{"recordId": "2a3e769c-c981-4d96-ba6a-e0b821a5bbbb","locationId":"location1","sku": "sku1", "message": "Unknown"}
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
recordId |
ã€ã³ããŒããã¡ã€ã«ã§éä¿¡ãããåšåº«ã¬ã³ãŒãã®äžæã®èå¥åã | TRUE |
locationId |
ãã±ãŒã·ã§ã³èå¥åã | TRUE |
sku |
åç®ã®äžæã®èå¥åã: \ < > ; % / ãã¹ããŒã¹ãã¿ããæ¹è¡ã¯äœ¿çšã§ããŸããã | TRUE |
message |
倱æã®è©³çŽ°ã瀺ãã¡ãã»ãŒãžã | TRUE |
ååã»ã°ã¡ã³ããŒã·ã§ã³ã®ã€ã³ããŒã
ãããã® API ãšã³ããã€ã³ãã䜿çšããŠãååã»ã°ã¡ã³ããŒã·ã§ã³ããŒã¿ãã€ã³ããŒãããŸãããã®ããŒã¿ã«ãããSKU ããã±ãŒã·ã§ã³ã°ã«ãŒãããé€å€ã§ãããããç¹å®ã®è²©å£²ãã£ãã«ããç¹å®ã® SKU ãé€å€ã§ããŸãã
product-segmentation imports POST ãšã³ããã€ã³ãã䜿çšããŠãååã»ã°ã¡ã³ããŒã·ã§ã³ããŒã¿ã Omnichannel Inventory ã«èªã¿èŸŒãåŠçãéå§ããŸããã€ã³ããŒãããããŒã¿ã®è©³çŽ°ã¯ãPOST ãªã¯ãšã¹ãã®ããã£ã«å«ãŸããŸãã
éå§åŒã³åºãã®ã¬ã¹ãã³ã¹ããã£ã«ã¯ãå®éã®ã€ã³ããŒãçšããŒã¿ã¹ããªãŒã /ãã¡ã€ã«ãéä¿¡ããããã®ãªã³ã¯ãå«ãŸããŸããã·ã¹ãã ã«ã¢ããããŒããããã¡ã€ã«ã 100 MB ãè¶ ããå Žåããã¡ã€ã«ã gzip ã§å§çž®ãã _å¿ èŠããããŸã_ã
ãã¡ã€ã«ã OCI ã·ã¹ãã ã«æ£åžžã«ã¢ããããŒããããããproduct-segmentation imports status ãšã³ããã€ã³ããåŒã³åºããŠãã€ã³ããŒãã®ã¹ããŒã¿ã¹ã確èªã§ããŸãããã®ãšã³ããã€ã³ããããã¡ã€ã«ã¢ããããŒãã§äœ¿çšãã importId ãšçµã¿åãããŠäœ¿çšãããšãã€ã³ããŒãåŠçããŸã å®äºããŠããªããã©ããã確èªã§ããŸãã
ãã¡ã€ã«ãOCIã«ãã£ãŠæ£åžžã«åŠçããããšãã¬ã¹ãã³ã¹ããã£ã«ã¯ COMPLETED ã¹ããŒã¿ã¹ãå«ãŸããŸããã€ã³ããŒãã«é¢ãããã®ä»ã®ã¡ããªã¯ã¹ãå«ãŸããŠãããããã㯠status åŒã³åºãã®ããã¥ã¡ã³ãã«èšèŒãããŠããŸãã
ãŸããCOMPLETED ã¹ããŒã¿ã¹ã«ã¯ã_fullResults href _ ãå«ãŸããŸãããã® URI ã䜿çšãããšãå®äºããã€ã³ããŒãåŠçã®è©³çŽ°ãªçµæãååŸã§ããŸãã
ååã»ã°ã¡ã³ããŒã·ã§ã³ããŒã¿ã®ã€ã³ããŒããå®è¡ããå Žåã¯ã次ã®ãšã³ããã€ã³ãããã®é åºã§äœ¿çšããŸãã
- imports POST URI ãåŒã³åºããŠã€ã³ããŒããéå§ããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/product-segmentation/imports - æé 1 ã®ã¬ã¹ãã³ã¹ããã£ã«å«ãŸãã uploadLink ã䜿çšããŠãæäŸããããšã³ããã€ã³ãã« POST åŒã³åºããè¡ããããŒã¿ã¹ããªãŒã /ãã¡ã€ã«ã OCI ã«ã¢ããããŒãããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/product-segmentation/imports/uploadlink/{uploadLinkId} - ãã¡ã€ã«ã OCI ã«å®å
šã«ã¢ããããŒããããåŸãåŒã³åºãéå§ (æé 1 ) ã«å¯ŸããŠã¬ã¹ãã³ã¹ããã£ã§æäŸããã importStatusLink ãžã® GET åŒã³åºãã䜿çšããŠãããŒã¿ã®åŠçã¹ããŒã¿ã¹ã確èªã§ããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/product-segmentation/imports/{importId}/status - æé 3 ããè¿ãããã¬ã¹ãã³ã¹ããã£ã®ã¹ããŒã¿ã¹ãã£ãŒã«ãã COMPLETED (å®äº) ã«ãªããšãOCI ãžã®ååã»ã°ã¡ã³ããŒã·ã§ã³ããŒã¿ã®ã€ã³ããŒããå®äºããŸããã¹ããŒã¿ã¹ã¬ã¹ãã³ã¹ã«ã¯ãå®äºããã€ã³ããŒãåŠçã®è©³çŽ°ãååŸããããã® URI ãå«ã fullResults href ãã£ãŒã«ããå«ãŸããŸãããã®æ
å ±ã¯ãæäŸããã URI ã«å¯Ÿãã GET åŒã³åºãã§ååŸããŸãã
https://{shortCode}.api.commercecloud.salesforce.com/inventory/impex/v1/organizations/{organizationId}/product-segmentation/exports/{exportId}/file-content
瀺ããããšã³ããã€ã³ãã䜿çšããŠãã®é åºã§æé ãå®è¡ããããšã§ãååã»ã°ã¡ã³ããŒã·ã§ã³ã¬ã³ãŒãã OCI ã«æ£åžžã«ã€ã³ããŒãã§ããŸãã
ååã»ã°ã¡ã³ããŒã·ã§ã³é€å€ã€ã³ããŒããã¡ã€ã«ã¬ã€ã¢ãŠã
ã€ã³ããŒãããŒã¿ã¹ããªãŒã ã§ã¯ããã®ããŒã¿ã®å¯Ÿè±¡ãšãªãã°ã«ãŒããšãOmnichannel Inventory ãé€å€ã«å¯ŸããŠå®è¡ããã€ã³ããŒãæäœã®çš®é¡ (ããšãã°ãREPLACEãAPPENDãREMOVE) ãæå®ããŸããã¹ããªãŒã ã¯ãæ¹è¡ã§åºåããã 2 çš®é¡ã® JSON ãšã³ãã£ã㣠(Group Header ãš SKU Data) ã§æ§æãããŸãã
éèŠ: ** Group Header ãšã³ãã£ãã£ãš SKU Data ãšã³ãã£ãã£ã¯ 1 察å€ã®é¢ä¿ ã«ãããŸããã€ãŸããå Group Header ã®åŸã«ã¯ãåãã°ã«ãŒãã«å¯Ÿå¿ãã 1 ã€ä»¥äžã® SKU Data ãšã³ãã£ãã£ãç¶ããå¿ èŠããããŸããå SKU Data ãšã³ãã£ãã£ã®äžã« Group Header ãšã³ãã£ãã£ãé 眮ããããšãå¯èœã§ãããã€ã³ããŒãåŠçãå€§å¹ ã«é ããªããŸã**ã
{"groupId":"G1","mode":"REPLACE"}
{"sku":"sku1"}
{"sku":"sku2"}
{"groupId":"G1","mode":"APPEND"}
{"sku":"sku37"}
é€å€ã€ã³ããŒããã£ãŒã«ãå®çŸ©
Group Header:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
groupId |
é€å€ãèšå®ãã察象ã®ã°ã«ãŒãã | TRUE |
mode |
ã°ã«ãŒãã«å¯ŸããŠå®è¡ããã·ã¹ãã æäœã®çš®é¡ãã°ã«ãŒãã®ãã¹ãŠã®ãšã³ããªãŒã眮ãæãã REPLACEãã°ã«ãŒãã«æ°ãããšã³ããªãŒãè¿œå ãã APPENDããŸãã¯ã°ã«ãŒãé€å€ããäžé£ã® SKU ãåé€ããREMOVEã |
TRUE |
SKU Data:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
sku |
é€å€å¯Ÿè±¡ãšãªããã°ã«ãŒãå ã®åç®ã®äžæã®èå¥åã: \ < > ; % / ãã¹ããŒã¹ãã¿ããæ¹è¡ã¯äœ¿çšã§ããŸããã | TRUE |
ååã»ã°ã¡ã³ããŒã·ã§ã³ã®ãšã¯ã¹ããŒã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãååã»ã°ã¡ã³ããŒã·ã§ã³ããŒã¿ãå«ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ããã1 è¡ã«ã€ã 1 ã€ã®å®å šãªãšã³ããªã§æ§æãããŸãã
ãã®ãšã³ããã€ã³ãã䜿çšããŠãçŸåšã®ååã»ã°ã¡ã³ããŒã·ã§ã³é€å€ã®ã¹ãããã·ã§ããããªã¯ãšã¹ãããŸãã"*" ãã°ã«ãŒããšããŠäœ¿çšããããšã§ãã°ã«ãŒãã®ãªã¹ããŸãã¯ãã¹ãŠã®ã°ã«ãŒãã®ã¹ãããã·ã§ããããªã¯ãšã¹ãã§ããŸããOmnichannel Inventory ã«ã¯ããã®åŠçã®ã¹ããŒã¿ã¹ãšé²è¡ç¶æ³ã確èªããããã®å¥ã®ãšã³ããã€ã³ããçšæãããŠããŸãã
å®äºãããšã¯ã¹ããŒãã¯ãã¹ããŒã¿ã¹ç¢ºèªã¬ã¹ãã³ã¹ã§æäŸããããªã³ã¯ã䜿çšããŠååŸããŸãã ä»»æã®ãšã¯ã¹ããŒããŸãã¯ã€ã³ããŒãããã»ã¹ã®ã¹ããŒã¿ã¹ãååŸããéã¯ã次ã®ã¬ã¹ãã³ã¹ãå©çšã§ããŸãã
| ãšã¯ã¹ããŒãã¹ããŒã¿ã¹ | 説æ |
|---|---|
STAGING |
ãªã¯ãšã¹ããäœæäžã§ãã |
WAITING |
ã€ã³ããŒãã®å Žå - ãã¡ã€ã«ã®ã¢ããããŒããåŸ æ©äžã§ãã |
EXPIRED |
ãªã¯ãšã¹ãã®æå¹æéãåããŠããŸãã |
SUBMITTED |
åŠçã®ããã«ãªã¯ãšã¹ããéä¿¡ãããŸãã - ãŸã ãã¥ãŒã«ã¯ç»é²ãããŠããŸããã |
PENDING |
ãªã¯ãšã¹ãã¯åŠçãã¥ãŒã«ç»é²ãããŠããŸã - ãŸã éå§ãããŠããŸããã |
RUNNING |
ãªã¯ãšã¹ãã¯å®è¡äžã§ã - ãŸã å®äºããŠããŸããã |
COMPLETED |
ãªã¯ãšã¹ãã¯å®äºããŸãã - ã¬ã¹ãã³ã¹ã«çµæãã¡ã€ã«ã®å Žæãå«ãŸããŸãã |
FAILED |
ãªã¯ãšã¹ãã¯å€±æããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
STOPPED |
ãªã¯ãšã¹ãã¯åæ¢ãããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
ãšã¯ã¹ããŒãããŠã³ããŒããã¡ã€ã«ã®ã¬ã€ã¢ãŠã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ããã1 è¡ã«ã€ã 1 ã€ã®å®å šãªèŠçŽ ãå«ã¿ãŸãã
ã°ã«ãŒãè¡
{"groupId":"UnitedStates"}
| ã°ã«ãŒãèå¥è¡ | 説æ |
|---|---|
groupId |
åŸç¶ã®è©³çŽ°ã¬ã³ãŒããå±ããã°ã«ãŒãã |
SKU è¡
{"sku":"sku121"}
| ã°ã«ãŒãèå¥è¡ | 説æ |
|---|---|
sku |
ãã®ååã»ã°ã¡ã³ããŒã·ã§ã³é€å€ã°ã«ãŒãã®ã¡ã³ããŒã§ãã SKU èå¥åã |
å ¥æå¯èœæ§ã®ãšã¯ã¹ããŒã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ããã1 è¡ã«ã€ã 1 ã€ã®å®å šãªèŠçŽ ãå«ã¿ãŸãã
ãã®ãšã³ããã€ã³ãã䜿çšããŠããªã¯ãšã¹ãããã£ã§æå®ããæ¡ä»¶ (ããšãã°ãåäžã®ã°ã«ãŒãããã¹ãŠã®ã°ã«ãŒããåäžã®ãã±ãŒã·ã§ã³ããŸãã¯ãã¹ãŠã®ãã±ãŒã·ã§ã³) ã«åºã¥ããçŸåšã®åšåº«ã®å ¥æå¯èœæ§ã®ã¹ãããã·ã§ããããªã¯ãšã¹ãããŸããOmnichannel Inventory ã«ã¯ããã®åŠçã®ã¹ããŒã¿ã¹ãšé²è¡ç¶æ³ã確èªããããã®å¥ã®ãšã³ããã€ã³ããçšæãããŠããŸãã
å®äºãããšã¯ã¹ããŒãã¯ãã¹ããŒã¿ã¹ç¢ºèªã¬ã¹ãã³ã¹ã§æäŸããããªã³ã¯ã䜿çšããŠååŸããŸãããšã¯ã¹ããŒããããããŒã¿ã«ã¯ããã®ãšã¯ã¹ããŒã以éã®å€æŽãååŸããããã®å·®åããŒã¯ã³ãå«ãŸããŸãã
ä»»æã®ãšã¯ã¹ããŒããŸãã¯ã€ã³ããŒãããã»ã¹ã®ã¹ããŒã¿ã¹ãååŸããéã¯ã次ã®ã¬ã¹ãã³ã¹ãå©çšã§ããŸãã
| ãšã¯ã¹ããŒãã¹ããŒã¿ã¹ | 説æ |
|---|---|
STAGING |
ãªã¯ãšã¹ããäœæäžã§ãã |
WAITING |
ã€ã³ããŒãã®å Žå - ãã¡ã€ã«ã®ã¢ããããŒããåŸ æ©äžã§ãã |
EXPIRED |
ãªã¯ãšã¹ãã®æå¹æéãåããŠããŸãã |
SUBMITTED |
åŠçã®ããã«ãªã¯ãšã¹ããéä¿¡ãããŸãã - ãŸã ãã¥ãŒã«ã¯ç»é²ãããŠããŸããã |
PENDING |
ãªã¯ãšã¹ãã¯åŠçãã¥ãŒã«ç»é²ãããŠããŸã - ãŸã éå§ãããŠããŸããã |
RUNNING |
ãªã¯ãšã¹ãã¯å®è¡äžã§ã - ãŸã å®äºããŠããŸããã |
COMPLETED |
ãªã¯ãšã¹ãã¯å®äºããŸãã - ã¬ã¹ãã³ã¹ã«çµæãã¡ã€ã«ã®å Žæãå«ãŸããŸãã |
FAILED |
ãªã¯ãšã¹ãã¯å€±æããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
STOPPED |
ãªã¯ãšã¹ãã¯åæ¢ãããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
ãšã¯ã¹ããŒãããŠã³ããŒããã¡ã€ã«ã®ã¬ã€ã¢ãŠã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ããã1 è¡ã«ã€ã 1 ã€ã®å®å šãªèŠçŽ ãå«ã¿ãŸãã
泚: å ¥æå¯èœæ§ã®ãšã¯ã¹ããŒãã§ã¯ããšã¯ã¹ããŒã察象ãšããŠã°ã«ãŒããŸãã¯ãã±ãŒã·ã§ã³ã®ããããäžæ¹ã®ã¿ããµããŒãããŠãããäž¡æ¹ãåæã«ãšã¯ã¹ããŒãããããšã¯ã§ããŸããã
ã°ã«ãŒãè¡
{"groupId":"UnitedStates"}
| ã°ã«ãŒãèå¥è¡ | 説æ |
|---|---|
groupId |
åŸç¶ã®è©³çŽ°ã¬ã³ãŒããå±ããã°ã«ãŒãã |
ãã±ãŒã·ã§ã³è¡
{"locationId":"phoenix"}
| ã°ã«ãŒãèå¥è¡ | 説æ |
|---|---|
locationId |
åŸç¶ã®è©³çŽ°ã¬ã³ãŒããå±ãããã±ãŒã·ã§ã³ã |
åç®ã¬ã³ãŒãè¡ - 1 è¡ã« 1 ã€ã®å®å šãª JSON ãšã³ããª:
{"sku":"123","onHand":10,"reserved":6,"groupReserved":6,"sharedGroupReserved":0,"atf":4,"ato":24,"safetyStockCount":1,"effectiveDate":"2019-07-20T11:04:02Z","futures":[{"quantity":20,"expectedDate":"2019-07-24T21:13:00Z"}]}
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
sku |
åç®ã®äžæã®èå¥åã: \ < > ; % / ãã¹ããŒã¹ãã¿ããæ¹è¡ã¯äœ¿çšã§ããŸããã | TRUE |
onHand |
çŸåšã®ææåšåº«æ°éã | TRUE |
reserved |
çŸåšã®äºçŽæžã¿æ°éã | TRUE |
atf |
çŸåšã®ãã«ãã£ã«ã¡ã³ãå¯èœæ°éã | TRUE |
ato |
çŸåšã®å泚å¯èœæ°éã | TRUE |
effectiveDate |
æå¹æ¥ (ISO 圢åŒ)ã | FALSE |
groupReserved |
å ±æåãå«ãŸãªãããã®ã°ã«ãŒãã®ã°ã«ãŒãäºçŽç·æ°ããã®ãã£ãŒã«ãã¯ããšã¯ã¹ããŒãå ã® GROUP è¡ã«ã®ã¿å«ãŸããŸãã | FALSE |
sharedGroupReserved |
ä»ã®ã°ã«ãŒãã«ç±æ¥ãããœããäºçŽæ°ããã®ãã£ãŒã«ãã¯ããšã¯ã¹ããŒãå ã® GROUP è¡ã«ã®ã¿å«ãŸããŸãã | FALSE |
safetyStockCount |
å®å šåšåº«æ°ã | TRUE |
futures |
åç®ã®å°æ¥æ°éæ
å ±ã®ã³ã¬ã¯ã·ã§ã³ (以äžã§èª¬æ)ãInventory Availability API ã¯ãfutures ã futureStock ãšããã³ã¬ã¯ã·ã§ã³ã§åç
§ããŠããŸãããã® 2 ã€ã¯åãã§ãã |
TRUE |
attributeSet |
åç®ã«é©çšã§ããåšåº«å±æ§ (äŸ: groupEligibilityExclusion)ã |
FALSE |
å°æ¥æ°é:
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
quantity |
ä»åŸå ¥è·äºå®ã®æ°éã | TRUE |
expectedDate |
å°æ¥æ°éã®å°çäºå®æ¥ (ISO 圢åŒ)ã | TRUE |
ãã«ã¿ããŒã¯ã³è¡:
{"deltaToken": "dsfljasdflkjasdfkj2381238"}
ãã®å€ã¯ãå·®åãååŸããåŒã³åºãã§äœ¿çšãããŸãããã®ãã«ã¿ããŒã¯ã³ã®æå¹æé㯠23.5 æéã§ããã®åŸã¯æéåããšãªããããå¥ã®ãšã¯ã¹ããŒãã§æ°ããããŒã¯ã³ãååŸããå¿ èŠããããŸãã詳现ã«ã€ããŠã¯ãInventory Availability API ãåç §ããŠãã ããã
ã€ãã³ããã°ã®ãšã¯ã¹ããŒã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ããã1 è¡ã«ã€ã 1 ã€ã®å®å šãªèŠçŽ ãå«ã¿ãŸãã
ãã®ãšã³ããã€ã³ãã䜿çšããŠãæå®ãããã±ãŒã·ã§ã³ããã³ã°ã«ãŒãã®ã»ããã«å«ãŸãã SKU ã®ã€ãã³ããã°ããªã¯ãšã¹ãããŸããOmnichannel Inventory ã«ã¯ããã®åŠçã®ã¹ããŒã¿ã¹ãšé²è¡ç¶æ³ã確èªããããã®å¥ã®ãšã³ããã€ã³ããçšæãããŠããŸãã
å®äºãããšã¯ã¹ããŒãã¯ãã¹ããŒã¿ã¹ç¢ºèªã¬ã¹ãã³ã¹ã§æäŸããããªã³ã¯ã䜿çšããŠååŸããŸãã
ä»»æã®ãšã¯ã¹ããŒããŸãã¯ã€ã³ããŒãããã»ã¹ã®ã¹ããŒã¿ã¹ãååŸããéã¯ã次ã®ã¬ã¹ãã³ã¹ãå©çšã§ããŸãã
| ãšã¯ã¹ããŒãã¹ããŒã¿ã¹ | 説æ |
|---|---|
STAGING |
ãªã¯ãšã¹ããäœæäžã§ãã |
WAITING |
ã€ã³ããŒãã®å Žå - ãã¡ã€ã«ã®ã¢ããããŒããåŸ æ©äžã§ãã |
EXPIRED |
ãªã¯ãšã¹ãã®æå¹æéãåããŠããŸãã |
SUBMITTED |
åŠçã®ããã«ãªã¯ãšã¹ããéä¿¡ãããŸãã - ãŸã ãã¥ãŒã«ã¯ç»é²ãããŠããŸããã |
PENDING |
ãªã¯ãšã¹ãã¯åŠçãã¥ãŒã«ç»é²ãããŠããŸã - ãŸã éå§ãããŠããŸããã |
RUNNING |
ãªã¯ãšã¹ãã¯å®è¡äžã§ã - ãŸã å®äºããŠããŸããã |
COMPLETED |
ãªã¯ãšã¹ãã¯å®äºããŸãã - ã¬ã¹ãã³ã¹ã«çµæãã¡ã€ã«ã®å Žæãå«ãŸããŸãã |
FAILED |
ãªã¯ãšã¹ãã¯å€±æããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
STOPPED |
ãªã¯ãšã¹ãã¯åæ¢ãããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
ãšã¯ã¹ããŒãããŠã³ããŒããã¡ã€ã«ã®ã¬ã€ã¢ãŠã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ããã1 è¡ã«ã€ã 1 ã€ã®å®å šãªèŠçŽ ãå«ã¿ãŸãã
ã°ã«ãŒãè¡
{"groupId":"UnitedStates"}
| ã°ã«ãŒãèå¥è¡ | 説æ |
|---|---|
groupId |
åŸç¶ã®è©³çŽ°ã¬ã³ãŒããå±ããã°ã«ãŒãã |
ãã±ãŒã·ã§ã³è¡
{"locationId":"phoenix"}
| ã°ã«ãŒãèå¥è¡ | 説æ |
|---|---|
locationId |
åŸç¶ã®è©³çŽ°ã¬ã³ãŒããå±ãããã±ãŒã·ã§ã³ã |
åç®ã¬ã³ãŒãè¡ - 1 è¡ã« 1 ã€ã®å®å šãª JSON ãšã³ããª:
{"locationId":"newbraunfels"}{"eventType":"location_import","location":"newbraunfels","sequenceNumber":0,"quantity":10.0,"newReserved":0.0,
"newAto":11.0,"newOnHand":10.0,"newAtf":10.0,"newSoftReserved":0.0,"futureQuantity":1.0,"oldReserved":0.0,
"oldAto":0.0,"oldOnHand":0.0,"oldAtf":0.0,"oldSoftReserved":0.0,"createdTime":"2022-01-18T15:58:40.443Z",
"effectiveTime":"2020-04-08T14:05:22.795243-07:00","safetyStockCount":0.0}
| ãã£ãŒã«ã | 説æ | å¿ é ãã£ãŒã«ã |
|---|---|---|
eventType |
ã€ãã³ãã¿ã€ãã | TRUE |
location |
ãã®ã€ãã³ãã«é¢é£ä»ãããããã±ãŒã·ã§ã³ã | TRUE |
sequenceNumber |
ãã®ã€ãã³ãã«é¢é£ä»ããããå éšã·ãŒã±ã³ã¹çªå·ã | TRUE |
quantity |
åç®æ°éã | TRUE |
newReserved |
SKU ããã³ãã±ãŒã·ã§ã³ã«å¯Ÿããæ°ããäºçŽæ°éã | TRUE |
newAto |
åç®ã®æ°ãã ATO (泚æå¯èœæ°é)ã | TRUE |
newOnHand |
åç®ã®æ°ããææåšåº«æ°éã | TRUE |
newAtf |
åç®ã®æ°ãã ATF (ãã«ãã£ã«ã¡ã³ãå¯èœæ°é)ã | TRUE |
newSoftReserved |
åç®ã®æ°ãããœããäºçŽæ°éã | TRUE |
futureQuantity |
åç®ã®å°æ¥æ°éã | TRUE |
oldReserved |
ã€ãã³ãçºçåã®ãåç®ã®äºçŽæ°éã | TRUE |
oldAto |
ã€ãã³ãçºçåã®ãåç®ã® ATOã | TRUE |
oldOnHand |
ã€ãã³ãçºçåã®ãåç®ã®ææåšåº«æ°éã | TRUE |
oldAtf |
ã€ãã³ãçºçåã®ãåç®ã® ATFã | TRUE |
oldSoftReserved |
ã€ãã³ãçºçåã®ããœããäºçŽæ°éã | TRUE |
createdTime |
ã€ãã³ãã®äœææå»ã | TRUE |
effectiveTime |
ã€ãã³ãã®æå¹æå»ã | TRUE |
safetyStockCount |
åç®ã®å®å šåšåº«æ°å€ã | TRUE |
äºçŽã®ãšã¯ã¹ããŒã
ãã®ãšã³ããã€ã³ãã䜿çšããŠãç¹å®ã®æéããã³äºçŽã¹ããŒã¿ã¹å€ã®ã»ããã«å«ãŸããäºçŽããã¥ã¡ã³ãããªã¯ãšã¹ãããŸããçŸåšãµããŒããããŠããäºçŽã®ã¹ããŒã¿ã¹å€ã¯ "open" ãš "closed" ã§ããOmnichannel Inventory ã«ã¯ããšã¯ã¹ããŒããéå§ããããã®ãšã³ããã€ã³ãããšã¯ã¹ããŒãã®ã¹ããŒã¿ã¹ãšé²è¡ç¶æ³ã確èªããããã®ãšã³ããã€ã³ããããã³å®äºåŸã«å®éã®ãšã¯ã¹ããŒããã¡ã€ã«ãããŠã³ããŒãããããã®ãšã³ããã€ã³ããçšæãããŠããŸãã
å®äºãããšã¯ã¹ããŒãã¯ãã¹ããŒã¿ã¹ç¢ºèªã¬ã¹ãã³ã¹ã§æäŸããããªã³ã¯ã䜿çšããŠååŸããŸãã
ä»»æã®ãšã¯ã¹ããŒããŸãã¯ã€ã³ããŒãããã»ã¹ã®ã¹ããŒã¿ã¹ãååŸããéã¯ã次ã®ã¬ã¹ãã³ã¹ãå©çšã§ããŸãã
| ãšã¯ã¹ããŒãã¹ããŒã¿ã¹ | 説æ |
|---|---|
STAGING |
ãªã¯ãšã¹ããäœæäžã§ãã |
WAITING |
ã€ã³ããŒãã®å Žå - ãã¡ã€ã«ã®ã¢ããããŒããåŸ æ©äžã§ãã |
EXPIRED |
ãªã¯ãšã¹ãã®æå¹æéãåããŠããŸãã |
SUBMITTED |
åŠçã®ããã«ãªã¯ãšã¹ããéä¿¡ãããŸãã - ãŸã ãã¥ãŒã«ã¯ç»é²ãããŠããŸããã |
PENDING |
ãªã¯ãšã¹ãã¯åŠçãã¥ãŒã«ç»é²ãããŠããŸã - ãŸã éå§ãããŠããŸããã |
RUNNING |
ãªã¯ãšã¹ãã¯å®è¡äžã§ã - ãŸã å®äºããŠããŸããã |
COMPLETED |
ãªã¯ãšã¹ãã¯å®äºããŸãã - ã¬ã¹ãã³ã¹ã«çµæãã¡ã€ã«ã®å Žæãå«ãŸããŸãã |
FAILED |
ãªã¯ãšã¹ãã¯å€±æããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
STOPPED |
ãªã¯ãšã¹ãã¯åæ¢ãããŸãã - åè©Šè¡ããã«ã¯æ°ãããªã¯ãšã¹ããåéä¿¡ããŸãã |
ãšã¯ã¹ããŒãããŠã³ããŒããã¡ã€ã«ã®ã¬ã€ã¢ãŠã
ãšã¯ã¹ããŒããã¡ã€ã«ã¯ãå®å šãª JSON ã¬ã³ãŒãã®éåã§ãããreservationId ããšã« 1 ã€ã®äºçŽã¬ã³ãŒããå«ã¿ãŸãã
ããããŒæ å ±
{
"reservationId" : "5baf4a87-1841-4311-9ca9-601e5d32885b",
"externalRefId" : "OCI-1234567",
"reservationTime" : 1648718653000,
"reservationState" : "CLOSED",
"reservationDetails" : []
}
| ããããŒãã£ãŒã«ãæ å ± | 説æ |
|---|---|
reservationId |
ãšã¯ã¹ããŒããããäºçŽã® reservationIdã |
externalRefId |
ãšã¯ã¹ããŒããããäºçŽã®å€éšåç §èå¥åããã®å€ã¯ãå€éšã®æ³šæã·ã¹ãã å ã®å€ã«å¯Ÿå¿ããŸãã |
reservationTime |
äºçŽäœææã«ãã®äºçŽã«é©çšãããæå»ã |
reservationState |
äºçŽã®çŸåšã®ç¶æ ãçŸåšãµããŒããããŠããå€ã¯ "open" ãš "closed" ã§ãã |
reservationDetails |
察象ã®äºçŽã®è©³çŽ°ãå«ãé åã |
äºçŽã®è©³çŽ°
reservationDetails ãã£ãŒã«ãã«ã¯ããšã¯ã¹ããŒããããäºçŽã«é¢é£ããæ å ±ã®é åãå«ãŸããŸãã
"reservationDetails" : {
"group": "ACME_US",
"sku" : "white-shirt-40",
"quantity" : 5,
"reservationDetailActions" []
}
| äºçŽè©³çŽ°æ å ± | 説æ |
|---|---|
group or location |
ãã®è©³çŽ°é ç®ããã°ã«ãŒããšãã±ãŒã·ã§ã³ã®ã©ã¡ãã«é¢é£ä»ããããŠãããã |
sku |
ãã®è©³çŽ°è¡ã«é¢é£ä»ãããã SKU èå¥åã |
quantity |
äºçŽã©ã€ã³ã¢ã€ãã ã«é©çšãããæ°éã |
reservationDetailActions |
ãã®äºçŽå ã§ãã®ã©ã€ã³ã¢ã€ãã ã«å¯ŸããŠå®è¡ãããã¢ã¯ã·ã§ã³ã®é åã |
äºçŽè©³çŽ°ã¢ã¯ã·ã§ã³
reservationDetailActions ã¯ãç¹å®ã®äºçŽããã¥ã¡ã³ãã«å¯ŸããŠå®è¡ãããã¢ã¯ã·ã§ã³ã远跡ãããšã³ããªã®é
åã§ãã
"reservationDetailActions" : [
{
"requestId" : "3678-23456-3456-4567-9999-1232",
"externalRefId" : "1234561-4949-2345",
"quantity" : 5,
"action" : Reserverd,
timestamp : "16487200010000"
}
]
| äºçŽã¢ã¯ã·ã§ã³è©³çŽ° | 説æ |
|---|---|
requestId |
ãã®äºçŽã¢ã¯ã·ã§ã³ã«é¢é£ä»ãããããªã¯ãšã¹ã IDã |
externalRefId |
ãšã¯ã¹ããŒããããã¢ã¯ã·ã§ã³ã®å€éšåç §èå¥åããã®å€ã¯ãå€éšã®æ³šæã·ã¹ãã å ã®å€ã«å¯Ÿå¿ããŸãã |
quantity |
ãã®äºçŽã¢ã¯ã·ã§ã³ã«é¢é£ä»ããããæ°éã |
action |
ãã®ã©ã€ã³ã¢ã€ãã ã«å¯ŸããŠå®è¡ãããã¢ã¯ã·ã§ã³ã |
timestamp |
ã¢ã¯ã·ã§ã³ãå®è¡ãããæå»ã |
å ±éã¬ã¹ãã³ã¹ã³ãŒã
次ã®ãšã©ãŒã³ãŒãã¯ããã¹ãŠã® API ãšã³ããã€ã³ãã«é©çšãããŸããåãšã³ããã€ã³ãã§æ³å®ããããšã©ãŒã³ãŒããšã¬ã¹ãã³ã¹ããã£ã®å®å šãªäžèŠ§ã«ã€ããŠã¯ãAPI ããã¥ã¡ã³ããåç §ããŠãã ããã
- 401 - OATH ãã¢ã©ãŒããŒã¯ã³ããã®ããã³ãã«å¯ŸããŠæå¹ã§ã¯ãªããããŸãã¯ãã§ã«ç¡å¹ã«ãªã£ãŠããŸãã詳现ã¯ã¬ã¹ãã³ã¹ããã£ã«å«ãŸããŸãã
- 403 - ããã³ãã¯ã·ã¹ãã ã§ããããžã§ãã³ã°ãããŠããŸããã
- 5XX - ãµãŒããŒãšã©ãŒãçºçããŸããã詳现ã¯ã¬ã¹ãã³ã¹ããã£ã«å«ãŸããŸãã
- Unknown - Unknown ãšã©ãŒã¿ã€ããè¿ãããå Žåã¯ãäžæãªå éšãšã©ãŒãçºçããããšã瀺ããŸãã
å€éšåç §èå¥å
çŸåšãã³ã³ã·ã¥ãŒããŒããªã¯ãšã¹ããšãšãã« ExternalRefId ãéä¿¡ã§ããç®æãããã€ããããŸããããã¯ãã³ã³ã·ã¥ãŒããŒããä»ã®å€éšã·ã¹ãã ã®ããŒã¿ãšé¢é£ä»ããããã®ãªã³ã¯ãšããŠããŠãŒã¶ãŒçæããŒã¿ããªã¯ãšã¹ããšãšãã«éä¿¡ã§ããããã«ããããã§ããããšãã°ã泚æ ID ãæã€æ³šæããããŒã¿ãååŸããŠããå Žåããã®æ³šæ ID ãäºçŽãªã¯ãšã¹ããšãšãã« externalRefId ãšããŠéä¿¡ã§ããŸããããã«ãããäºçŽã«åé¡ãçºçããå Žåã«ããã®ãšã©ãŒãŸãã¯åé¡ãçæããå€éšã·ã¹ãã å
ã®æ³šæã«é¢é£ä»ããããšãã§ããŸããããã¯ãSalesforce Core ããã®ä»ã®ãµãŒãã¹ã§äœ¿çšãããŠãã externalRefId ãšæ··åããªãã§ãã ããããã®çšé㯠OCI å°çšã§ãããä»ã§ã¯äœ¿çšãããŸããã
Correlation-ID
OCI ã§ã®åŠçã®è¿œè·¡ã容æã«ããããã顧客㯠Correlation-ID ãšããååã®ããããŒã«å€ãèšå®ããå¿ èŠããããŸãããã®å€ã¯ CDN ãçµç±ããŠããªã¯ãšã¹ããšãšãã« OCI ã«éä¿¡ãããŸããããã«ããããªã¯ãšã¹ãããµãŒãã¹å ã移åããéã®è¿œè·¡ã«åœ¹ç«ã¡ãŸããåãå ¥ããããã«ã¯ãcorrelation-id ã¯æå¹ãª UUIDv2 ã§ããå¿ èŠããããŸããããã§ãªãå Žåã¯ç¡èŠãããŸãã
Web ãªã¯ãšã¹ãã CDN ãçµç±ããå Žåã¯ãCDN ã® x-correlation-id ããããŒå€ (ããã¯ãã® ray-id ã«ç±æ¥ããŸã) ãé¢ä¿ããŸãããã®å Žåãæå®ããã correlation-id 㯠CDN ã® x-correlation-id ã®åã«ä»å ãããäž¡æ¹ã®å€ãã³ã³ãåºåãã§æž¡ãããŸãã
äžéšã®ãµãŒãã¹ã§ã¯ãX-Correlation-ID ããããŒã䜿çšããŸããOCI ã§ã¯ããã®ããããŒã䜿çšãããš CDN ã«ãã£ãŠæ°ããå€ã§äžæžãããããããããããŒæ¬æ¥ã®ç®çãæãããªããªããŸããäžè²«ããçµæãåŸãã«ã¯ã代ããã« Correlation-ID ã䜿çšããŠãã ããã
NoOp åšåº«ã¬ã³ãŒã
次ã®ãããã«ãå€æŽããªãã€ã³ããŒãã¬ã³ãŒãã¯ãNoOp ãŸã㯠NoOperation ã¬ã³ãŒããšèŠãªãããŸãã
- onHand
- SafetyStockCount
- Futures (ããããã®å€)
- AttributeSet (ããããã®å€)
ãã®ãããNoOp åšåº«ã¬ã³ãŒãã¯ã¹ããããããã€ãã³ããã°ã«ã¯åæ ãããŸããã
Let us know so we can improve!