Skip to main content
Challenge

Build an Open Network Logistics Accessibility and Drop-Off Coordinator

Coordinate mock last-mile courier assignments across decentralized delivery networks using Beckn protocol schemas. Match specialized recipient accessibility requirements with courier physical mobility parameters.

Workflow AutomationHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Coordinate mock last-mile courier assignments across decentralized delivery networks using Beckn protocol schemas. Match specialized recipient accessibility requirements with courier physical mobility parameters.

Delivery hub operations coordinator managing accessible parcel dispatch for elderly and mobility-impaired recipients.

Parse incoming Beckn fulfillment requests containing recipient accessibility constraints and landmark directions.

Cross-reference courier equipment capabilities and delivery vehicle access constraints against recipient physical barriers.

Synthesize a validated Beckn on_confirm fulfillment packet containing step-by-step accessible drop-off instructions.

Simulate asynchronous callback telemetry and generate exception manifests when courier parameters do not meet accessibility needs.

Dispatcher workspace showing pending fulfillment orders, courier constraint filters, and generated Beckn protocol callback logs.

Generate 30 synthetic Beckn fulfillment payloads containing varying accessibility profiles (staircase-only, elevator outage, landmark drop-off) stored in local JSON format. Starter examples below are synthetic. They are not downloaded records.

Beckn protocol specifications Uses Beckn protocol core transaction packet structure with context and message separation and asynchronous server-to-server callback conventions.

langgraph, fastapi, pydantic. LangGraph manages stateful multi-step routing logic between incoming Beckn order intents, constraint matching, and callback generation. Local or hosted LLM with multi-step reasoning capabilities and JSON mode output.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Validates incoming Beckn context headers including domain, action, and transaction_id.

Correctly matches courier vehicle and physical capacity against building barrier profiles.

Outputs compliant Beckn on_confirm message payloads with complete fulfillment metadata.

Generates a structured exception notice when accessibility criteria cannot be fulfilled.

```json [ { "input": { "context": { "domain": "nic2004:55204", "action": "confirm", "transaction_id": "tx_logistics_101", "bap_id": "mock_buyer_app.org", "bpp_id": "mock_logistics_pp.org" }, "message": { "order": { "id": "ord_9901", "fulfillment": { "end": { "location": { "address": "Flat 302, Green Heights, Pune", "accessibility_flags": [ "elevator_available", "wheelchair_ramp" ] } } } }, "courier_profile": { "courier_id": "c_44", "transport_mode": "two_wheeler", "max_carry_weight_kg": 15 } } }, "expected_output": { "context": { "domain": "nic2004:55204", "action": "on_confirm", "transaction_id": "tx_logistics_101" }, "message": { "order": { "id": "ord_9901", "status": "ACCEPTED", "fulfillment": { "state": "ASSIGNED", "assigned_courier_id": "c_44", "dropoff_instructions": "Use ground ramp and take elevator directly to floor 3." } } }, "accessibility_matched": true } }, { "input": { "context": { "domain": "nic2004:55204", "action": "confirm", "transaction_id": "tx_logistics_102", "bap_id": "mock_buyer_app.org", "bpp_id": "mock_logistics_pp.org" }, "message": { "order": { "id": "ord_9902", "fulfillment": { "end": { "location": { "address": "Floor 4, Old Chawl, Girgaon, Mumbai", "accessibility_flags": [ "staircase_only", "narrow_corridor", "weight_heavy_25kg" ] } } } }, "courier_profile": { "courier_id": "c_12", "transport_mode": "bicycle", "max_carry_weight_kg": 10 } } }, "expected_output": { "context": { "domain": "nic2004:55204", "action": "on_confirm", "transaction_id": "tx_logistics_102" }, "message": { "order": { "id": "ord_9902", "status": "REJECTED", "fulfillment": { "state": "UNASSIGNED", "assigned_courier_id": null, "dropoff_instructions": null } } }, "accessibility_matched": false, "rejection_reason": "courier_weight_and_staircase_limit_exceeded" } } ] ```

All carrier allocations and status callbacks are executed in a simulated sandbox environment without actual financial or delivery liabilities. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

All carrier allocations and status callbacks are executed in a simulated sandbox environment without actual financial or delivery liabilities. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Validates incoming Beckn context headers including domain, action, and transaction_id. Correctly matches courier vehicle and physical capacity against building barrier profiles. Outputs compliant Beckn on_confirm message payloads with complete fulfillment metadata. Generates a structured exception notice when accessibility criteria cannot be fulfilled.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Parse incoming Beckn fulfillment requests containing recipient accessibility constraints and landmark directions. Cross-reference courier equipment capabilities and delivery vehicle access constraints against recipient physical barriers. Synthesize a validated Beckn on_confirm fulfillment packet containing step-by-step accessible drop-off instructions. Simulate asynchronous callback telemetry and generate exception manifests when courier parameters do not meet accessibility needs.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Validates incoming Beckn context headers including domain, action, and transaction_id. Correctly matches courier vehicle and physical capacity against building barrier profiles. Outputs compliant Beckn on_confirm message payloads with complete fulfillment metadata. Generates a structured exception notice when accessibility criteria cannot be fulfilled.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Dispatcher workspace showing pending fulfillment orders, courier constraint filters, and generated Beckn protocol callback logs.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

All carrier allocations and status callbacks are executed in a simulated sandbox environment without actual financial or delivery liabilities.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Parse incoming Beckn fulfillment requests containing recipient accessibility constraints and landmark directions.

  • Cross-reference courier equipment capabilities and delivery vehicle access constraints against recipient physical barriers.

  • Synthesize a validated Beckn on_confirm fulfillment packet containing step-by-step accessible drop-off instructions.

  • Simulate asynchronous callback telemetry and generate exception manifests when courier parameters do not meet accessibility needs.

Resources and assets

Reference links and supporting material

Dataset notes

Generate 30 synthetic Beckn fulfillment payloads containing varying accessibility profiles (staircase-only, elevator outage, landmark drop-off) stored in local JSON format. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

LangGraph

Runtime for stateful agent workflows.

Evaluated output

No output checks are configured.

Evaluation checks
  • Parse incoming Beckn fulfillment requests containing recipient accessibility constraints and landmark direc...
  • Validates incoming Beckn context headers including domain, action, and transaction_id. Correctly matches co...
  • Dispatcher workspace showing pending fulfillment orders, courier constraint filters, and generated Beckn pr...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • LangGraph · Optional
Orchestration
  • LangGraph · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build an Open Network Logistics Accessibility and Drop-Off Coordinator