Hexbit (SA: RET 10, 12, 13) — compliance checks

[NishthaMonga]

Flow 1

on_search_full_catalog_refresh

• /message/catalog/bpp~1providers/0/items/0/category_id Invalid category ID found for item for on_search
• STD code does not match with correct area_code on /on_search
• /message/catalog/bpp/providers/loc0/time/schedule/holidays": "Holidays cannot be past 2024-01-29
• @ondc/org/contact_details_consumer_care contactno should consist of 10 or 11 digits without any spaces or special characters in /bpp/providers[0]/items

Flow 2

on_init,on_confirm

• parent_item_id missing, Key length mismatch for breakup.0.item

on_status_pending

• Transaction Id should be same from /select onwards
• Timestamp for /on_confirm api cannot be greater than or equal to /on_status_pending api

Logs for on_status_packed missing

on_status_out_for_delivery

• Message_id cannot be same for on_status.packed and on_status.out_for_delivery
• fulfillments/state Should be out-for-delivery for /on_status_Out-for-delivery

Flow 3

on_select_out_of_stock

• quote.price.value 540.00 does not match with the price breakup 341.00

on_init,on_confirm

• parent_item_id missing, Key length mismatch for breakup.0.item

Flow 4

on_cancel

• /message/order must have required property 'payment'
• /message/order must have required property 'created_at'
• /message/order must have required property 'updated_at'
• /message/order/fulfillments/0 must have required property 'tags'
• Invalid Item Id provided in quote object /on_cancel: undefined
• Item count should be 0 for /on_cancel in forward shipment
• Item count can't be 0 for /on_cancel in cancel shipment
• Total item count in message/order/items doesn't match with item count of /on_select
• Invalid CancellationID 018 or not allowed for BNP
• Provider Id mismatches in /on_select and /on_cancel
• provider.locations[0].id mismatches in /on_search and /on_cancel
• reason_id is different in cancellation object of /on_cancel from /cancel

Flow 5

on_cancel Same as Flow 4

NOTE

Logs for on_status_packed missing

@TheDa21crj

[TheDa21crj]

We have made the required changes in pr#1102

kindly check once

@NishthaMonga

[Jagannath-wits]

Hexabit

Flow 1

On Search Full Catalog Refresh

• provider/item/price: item.price.value should be greater than 0
• category in serviceability construct should be one of the category ids in bpp/providers/items/category_id

Flow 2

Select

• LongGpsErr: fulfillments location.gps is not as per the API contract as there is an extra space(latitude, longitude) which should be (latitude,longitude)

On Select

• priceErr: Warning: Quoted Price in /on_select INR 431 does not match with the total price of items in /select INR 200 i.e price for the item mismatch in on_search and on_select

Init

• item_FFErr0: Item Id 652bc2f0c74738e1e91d26b0 does not exist in /on_select
• item_FFErr1: Item Id 64f37f1847c6e1683c9644d6 does not exist in /on_select

On Init

• schemaErr0: /message/order/provider must have required property 'locations'

Confirm

• schemaErr0: /message/order/id Should be alphanumeric upto 32 letters max
• tmpstmp: Timestamp for /on_init api cannot be greater than or equal to /confirm api
• item_FFErr0: Item Id 652bc2f0c74738e1e91d26b0 does not exist in /on_select
• item_FFErr1: Item Id 64f37f1847c6e1683c9644d6 does not exist in /on_select
• sttlmntdtls: payment settlement_details mismatch in /on_init & /confirm
• quoteErr0: Mismatch found for item with item_id 6596b1113affdbaf0d33ebb5 while comparing quote object of on_select and confirm
• quoteErr1: Mismatch found for item with item_id 6596b1113affdbaf0d33ebb4 while comparing quote object of on_select and confirm

On Confirm

• schemaErr0: /context/timestamp must match format "date-time"
• timestamp_err: Timestamp should be in date-time format
• updtdtmstmp: order.updated_at timestamp should be updated as per the context.timestamp (since default fulfillment state is added)
• invldUpdtdTmstp: updated_at timestamp should be equal to context timestamp for /on_confirm
• quoteErr0: Mismatch found for item with item_id 6596b1113affdbaf0d33ebb5 while comparing quote object of on_confirm and confirm
• quoteErr1: Mismatch found for item with item_id 6596b1113affdbaf0d33ebb4 while comparing quote object of on_confirm and confirm
• pymntObj: payment object mismatches in /confirm & /on_confirm
• message/order/tags/bpp_terms/np_type: np_type is missing in message/order/tags/bpp_terms for ON_CONFIRM

On Status Pending

• schemaErr0: /message/order/id Should be alphanumeric upto 32 letters max
• tmpstmp: Created At timestamp for /on_status_pending should be equal to context timestamp at confirm
• tmpstmp1: Timestamp for /on_confirm api cannot be greater than or equal to /on_status_pending api

On Status Packed

• schemaErr0: /message/order/id Should be alphanumeric upto 32 letters max
• tmpstmp: Created At timestamp for /on_status_packed.message.order should be equal to context timestamp at confirm
• tmpstmp1: Timestamp for /on_confirm api cannot be greater than or equal to /on_status_packed api

On Status Picked

• schemaErr0: /message/order/id Should be alphanumeric upto 32 letters max
• tmpstmp1: Timestamp for /on_confirm api cannot be greater than or equal to /on_status_picked api
• tmpstmp: Created At timestamp for /on_status_picked should be equal to context timestamp at confirm
• updatedAt: order/updated_at timestamp can't be less than the pickup time

On Status Out For Delivery

• schemaErr0: /message/order/id Should be alphanumeric upto 32 letters max
• tmpstmp1: Timestamp for /on_confirm api cannot be greater than or equal to /on_status_out-for-delivery api
• tmpstmp: Created At timestamp for /on_status_out-for-delivery should be equal to context timestamp at confirm
• updatedAt: order/updated_at timestamp can't be less than the Out_for_delivery time

On Status Delivered

• schemaErr0: /message/order/id Should be alphanumeric upto 32 letters max
• tmpstmp1: Timestamp for /on_confirm api cannot be greater than or equal to /on_status_delivered api
• tmpstmp: Created At timestamp for /on_status_delivered should be equal to context timestamp at confirm
• delPickTime: delivery timestamp (/end/time/timestamp) can't be less than or equal to the pickup timestamp (start/time/timestamp)
• updatedAt: order/updated_at timestamp can't be less than the delivery time

Flow 3

• Only provided select and on_select calls

Select Out of Stock

• schemaErr0: /message/order/items/0 must have required property 'quantity'
• schemaErr1: /message/order/items/1 must have required property 'quantity'
• LongGpsErr: fulfillments location.gps is not as per the API contract
• quantity missing in items

On Select Out of Stock

• inVldItemId[0]: Invalid Item Id provided in /on_select: 6596b1113affdbaf0d33ebb4
• inVldItemId[1]: Invalid Item Id provided in /on_select: 6596b1113affdbaf0d33ebb5
• quantity missing in items

Select

• txnId: Transaction Id should be same as in previous APIs

Flow 4

cancel

• cancelOrdrId: Order Id in /cancel and /confirm do not match

On Cancel

• schemaErr0: /message/order must NOT have additional properties (tags)
• schemaErr1: /message/order/id Should be alphanumeric upto 32 letters max
• schemaErr2: /message/order/fulfillments/0/end must have required property 'time'
• city: City code mismatch in /search and /on_cancel
• txnId: Transaction Id should be same from /select onwards
• itemCount[0]: Item count should be 0 for /on_cancel in forward shipment
• itemCount[1]: Item count should be 0 for /on_cancel in forward shipment
• invldQuoteTrailPrices: quote_trail price and item quote price sum for on_cancel should be equal to the price as in on_confirm
• invalidItemID[I1]: Item ID [I1] not present in items array
• orderID: Order Id mismatches in /on_cancel and /on_confirm
• Fulfillment_mismatch: The count of cancellation fulfillments is not equal to the count of forward fulfillments or invalid fulfillment id.
• billingErr0: Key 'created_at' mismatch: 2024-01-30T07:09:41.531Z !== 2024-03-13T08:27:32.213Z when compared with init billing object
• billingErr1: Key 'updated_at' mismatch: 2024-01-30T07:09:41.531Z !== 2024-03-13T08:27:32.213Z when compared with init billing object
• ffID 2024-01-16-140301: fulfillment id 2024-01-16-140301 does not exist in /on_cancel items.fulfillment_id
• ordrupdtd: order.updated_at timestamp should be greater than order.created_at timestamp
• orderCrtd: order.created_at timestamp should match context.timestamp of confirm

Flow 5

On Cancel

• schemaErr0: /message/order must have required property 'payment'
• schemaErr1: /message/order must have required property 'created_at'
• schemaErr2: /message/order must have required property 'updated_at'
• schemaErr3: /message/order must NOT have additional properties (tags)
• schemaErr4: /message/order/id Should be alphanumeric upto 32 letters max
• schemaErr5: /message/order/fulfillments/0 must have required property 'tags'
• invldQuoteTrailPrices: quote_trail price and item quote price sum for on_cancel should be equal to the price as in on_confirm
• prvdrId: Provider Id mismatches in /on_select and /on_cancel
• prvdrLoc: provider.locations[0].id mismatches in /on_search and /on_cancel
• billingErr0: Key 'created_at' mismatch: 2024-01-30T07:09:41.531Z !== 2024-01-30T11:33:58.119Z when compared with init billing object
• billingErr1: Key 'updated_at' mismatch: 2024-01-30T07:09:41.531Z !== 2024-01-30T11:33:58.119Z when compared with init billing object
• missingReasonID: Reason ID is mandatory field for on_cancel
• missingRTOvalues: RTO Id is mandatory field for on_cancel
• missingInitiatedBy: Initiated_by is mandatory field for on_cancel

Flow 6-c (liquidated)

On Update Interim

• schemaErr1: /message/order/items/0/quantity/count must be integer
• schemaErr2: /message/order/fulfillments/0/start/location must have required property 'address'
• city: City code mismatch in /search and /on_update
• txnId: Transaction Id should be same from /select onwards
• prvdrId: provider.id mismatches in /on_update and /on_select
• prvdrLoc: provider.locations[0].id mismatches in /on_select and /on_update

On Update Liquidated

• city: City code mismatch in /search and /on_update
• tmpstmp: Timestamp for /on_init api cannot be greater than or equal to /on_update api
• txnId: Transaction Id should be same from /select onwards
• prvdrId: provider.id mismatches in /on_update and /on_select
• prvdrLoc: provider.locations[0].id mismatches in /on_select and /on_update
• invldCancellationID: Invalid CancellationID 002 or not allowed for BNP
• invldQuoteTrailPrices: quote_trail price and item quote price sum for on_update should be equal to the price as in on_confirm

Flow 6-a(Part cancel) and Flow 6-b(Reverse QC) is missing

@TheDa21crj

[sandeepshahi]

catalog rejection framework must be supported

RET 10

• Please submit the latest set of logs; recently submitted logs are dated: 13/03
• The feedback on the issue board is dated 20/03, so how can the submitted logs be from 13/03?

Flow 1

/on_search

• "accept_bap_terms" = "Y" in tags/bpp_terms should not be provided until static terms are received and accepted by the seller app
• invalid tag block "collect_payment144"; check the contract for all the valid blocks
• categories/id should be 12 digits alphanumeric
• variant groups are defined but no variant are linked; variants must be supported properly
• invalid value of fssai license no in "@ondc/org/fssai_license_no"
• invalid store address; gps is of bengaluru, state is jharkhand while locality = maharashtra and street= Andheri; How?
• invalid store timing in /locations/time/schedule; timing provided in bpp/providers/tags/timing shows different range; range should be provided instead of schedule/frequency and schedule/times
• invalid item mapped in grocery domain; Addidas Shoe HEXBit.io is mapped to masala and seasoning. Why?
• placeholder values of EAN code should not be provided in item.descriptor.code
• "@ondc/org/contact_details_consumer_care" is not in valid format; should be in the format name, email, contact no.
• statutory reqs mapping must be correct as per the category id; refer to the doc here
• placeholder values of statutory reqs should be avoided;
• invalid attributes "net_quantity_or_measure_of_commodity_in_pkg" and "imported_product_country_of_origin" in statutory reqs objects; refer to the contract for all the valid attributes
• placeholder value of back image in tags/image/back_image should not be provided
• veg and non veg categorization should be correct;
• invalid attribute start in bpp/providers/fulfillments

/on_search (inc)

• similar issues as above
• EAN code should be used for RET10 domain in item.descriptor.code
• invalid value of category_id; follow the taxonomy
• /fulfillments and /tags in bpp/providers need not be provided in incremental; in case of addition of new category_id or serviceability, use full catalog

Flow 2

/on_select

• tags/type in /items and quote/breakup need not be provided for standalone SKUs; check contract for correct schema
• How can the delivery TAT be 60 minutes for a delivery between the given buyer and seller locations?
• tax line item need not be provided in quote/breakup for grocery; item prices should be tax inclusive
• how can item: 65a648f9c5a7f79e0e4fee19 which was Tomato in /on_search turned to Nike jacket in /on_select?

/on_init

• "@ondc/org/settlement_basis", "@ondc/org/settlement_window" and "@ondc/org/withholding_amount" are provided by the collector; should not be provided in /on_init when buyer app is collecting
• "settlement_timestamp" in "@ondc/org/settlement_details" should only be provided once the amount has been settled
• only tax_number, provider_tax_number and np_type should be provided in tags/bpp_terms

/on_confirm

• prepaid order flow should be submitted for verification
• isn't context/timestamp precise upto milliseconds level? confirm and on_confirm has same milliseconds value ie. "366"
• how can estimated pickup and delivery time ranges be past dated?
• store details such as address, name, gps in fulfillments/start/location should not change; must remain the same as provided in the catalog
• PCC and DCC in fulfillments/start/instructions and fulfillments/end/instructions resp. should be provided in packed and out-for-delvery state resp. and should flow in subsequent APIs later
• for above point, PCC and DCC are optional if not available; no need to provide placeholder or invalid values

/on_status (accepted)

• why is the order state reverted to "Created" when it was auto accepted in /on_confirm?
• vehicle info should only be provided for kerb side pickup
• tags/state should only be provided when buyer app is procuring logistics
• tracking in /tags should not be provided when tracking is false; why is the gps tracking still enabled?
• for above point, url enabled is false but the url is provided. why?
• agent info should only be provided once the agent is assigned; placeholder values should not be provided
• why is the fulfillment_delay info provided?
• why is the quote value getting changed?
• for above point, payment/params/amount is also changed completely;
• order/updated_at is not captured correctly; how can it be past dated?

/on_status (packed)

• message_id should be unique for every unsolicited call
• why is the fulfillment state marked as Order-picked-up when the filename is depicting packed state?
• invoice should only be provided once the order is picked and thereafter; also actual invoice should be provided; placeholder image is not accepted

/on_status (picked)

• order/updated_at is not captured correctly; applicable for all the APIs
• actual order pickup timestamp should be provided in fulfillments/start/time/timestamp

/on_status (delivered)

• actual delivery timestamp should be provided in /fulfillments/end/time/timestamp

Flow 3

• invalid flow; flow must be continued with the remaining items in the cart; why are flow 2 logs submitted here?
• similar issues as above

Flow 4

• invalid flow; how can the already delivered order in Flow 2 be cancelled in flow 4 (same txn id)
• proper logs must be submitted with no manipulation;
• flow will be checked once correct logs are submitted

Flow 5 and 6

• invalid flows; txn id is same as in flow 2;
• logs seem to be manufactured and not system generated
• flows will be checked once correct logs are submitted

/on_select

• missing /select and /on_select APIs

---

RET 12, 13

• similar issues as above
• Please submit the latest set of logs; recently submitted logs are dated: 13/03

Fix all the mentioned issues and perform a sanity before resubmitting the logs

@TheDa21crj