agentleFS
ankitjh4ankitjh4/indic-ai-skills/skills/ondc-seller/SKILL.md

ondc-seller

Skill65 starsChanged 7 months agoMITView on GitHub

Deploy and manage ONDC seller applications. Set up seller reference apps with catalog management, order fulfillment, IGM support, and logistics integration. Handle provider registration, store operations, and ONDC protocol compliance for retail sellers.

  • Reads credentials

The file

We split this skill into the rules it gives an agent

9 rules. About 0 are common, 8 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Distinctive:

    Before using this skill, ensure you have:

    line 35
  2. Distinctive:

    Verify signing keys are generated correctly

    line 219
  3. Distinctive:

    Ensure domain is publicly accessible

    line 220
  4. Distinctive:

    Check ONDC registry payload format

    line 221
  5. Distinctive:

    Verify protocol layer is running

    line 227
  6. Distinctive:

    Check S3 bucket permissions for images

    line 229
  7. Very specific:

    Never commit .env files to version control

    line 234
  8. Distinctive:

    Use HTTPS for all endpoints

    line 236
  9. Distinctive:

    Use this skill when you need to:

    line 257

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

ONDC Seller Skill

This skill helps you deploy and manage ONDC (Open Network for Digital Commerce) seller applications. ONDC is India's digital commerce network enabling sellers to reach buyers across multiple platforms.

What This Skill Does

  • Deploy ONDC Seller Apps: Set up the complete seller reference application
  • Catalog Management: Manage products, stores, inventory, and pricing
  • Order Processing: Handle search, select, init, confirm, status, update, and cancel flows
  • Logistics Integration: Connect with logistics providers for fulfillment
  • IGM Support: Manage Issue & Grievance Management for customer complaints
  • Registry Operations: Register with ONDC staging/production networks

Architecture Overview

The ONDC Seller App uses microservice architecture:

  • seller-app: Node.js backend API layer
  • seller-app-frontend: React web application (served via nginx)
  • seller-app-protocol: Python protocol layer for ONDC communication
  • seller-app-igm: Node.js IGM service for issue management
  • seller-bugzilla-service: Bugzilla integration for ticket management

Prerequisites

Before using this skill, ensure you have:

  1. Docker & Docker Compose installed
  2. Git with submodule support
  3. Domain name or ngrok for public endpoint
  4. Required service accounts:
    • Firebase (authentication)
    • SMTP server (email notifications)
    • AWS S3 (asset storage)
    • Map My India (location services)
  5. ONDC Registry Access (for production deployment)

Quick Start

1. Clone and Initialize

cd /home/workspace
git clone https://github.com/ONDC-Official/seller-app-sdk.git ondc-seller-app
cd ondc-seller-app
git submodule init
git submodule update

2. Generate Cryptographic Keys

bun /home/workspace/Skills/ondc-seller/scripts/generate-keys.ts

This creates signing and encryption keys required for ONDC registration.

3. Configure Environment

bun /home/workspace/Skills/ondc-seller/scripts/setup-env.ts \
  --domain "https://yourdomain.com" \
  --firebase-key "YOUR_KEY" \
  --smtp-host "smtp.example.com" \
  --s3-bucket "your-bucket"

4. Deploy Locally (Development)

cd /home/workspace/ondc-seller-app
docker-compose -f docker-compose-for-local.yaml --env-file .env-local up -d

5. Register with ONDC

Once deployed, use the registration helper:

bun /home/workspace/Skills/ondc-seller/scripts/register.ts \
  --subscriber-url "https://yourdomain.com" \
  --signing-key "path/to/signing_public.pem" \
  --crypto-key "path/to/crypto_public.pem"

Common Operations

Check Application Status

bun /home/workspace/Skills/ondc-seller/scripts/check-status.ts

Shows the status of all services (seller-app, frontend, protocol, IGM).

Manage Catalog

# View catalog summary
bun /home/workspace/Skills/ondc-seller/scripts/manage-catalog.ts --action list

# Enable/disable store
bun /home/workspace/Skills/ondc-seller/scripts/manage-catalog.ts --action toggle-store --store-id "STORE123"

# Update item availability
bun /home/workspace/Skills/ondc-seller/scripts/manage-catalog.ts --action update-item --item-id "ITEM456" --available true

View Orders

# List recent orders
bun /home/workspace/Skills/ondc-seller/scripts/view-orders.ts --limit 10

# Get order details
bun /home/workspace/Skills/ondc-seller/scripts/view-orders.ts --order-id "ORDER123"

# Filter by status
bun /home/workspace/Skills/ondc-seller/scripts/view-orders.ts --status "Pending"

Handle IGM Issues

# List open issues
bun /home/workspace/Skills/ondc-seller/scripts/manage-igm.ts --action list

# View issue details
bun /home/workspace/Skills/ondc-seller/scripts/manage-igm.ts --action view --issue-id "IGM123"

# Update issue status
bun /home/workspace/Skills/ondc-seller/scripts/manage-igm.ts --action update --issue-id "IGM123" --status "Resolved"

Environment Variables

Key environment variables required (store in Settings > Advanced):

# ONDC Registry
BAP_URL="https://yourdomain.com"
BAP_ID="yourdomain.com"
BAP_PRIVATE_KEY="signing_private_key"
BAP_PUBLIC_KEY="signing_public_key"
BAP_UNIQUE_KEY_ID="unique_key_id_from_registry"

# Firebase Auth
REACT_APP_FIREBASE_API_KEY="firebase_api_key"
REACT_APP_FIREBASE_AUTH_DOMAIN="yourdomain.com"

# SMTP
SMTP_HOST="smtp.example.com"
SMTP_PORT="587"
SMTP_AUTH_USERNAME="user"
SMTP_AUTH_PASSWORD="pass"
SMTP_EMAIL_SENDER="noreply@yourdomain.com"

# AWS S3
AWS_ACCESS_KEY_ID="aws_key"
AWS_SECRET_ACCESS_KEY="aws_secret"
S3_REGION="ap-south-1"
S3_BUCKET="your-bucket"

# Map My India
MMI_CLIENT_SECRET="mmi_secret"
MMI_CLIENT_ID="mmi_client_id"
MMI_ADVANCE_API_KEY="mmi_api_key"

Feature Support Matrix

The ONDC Seller App implements ONDC Retail v1.2 specification:

FeatureStatus
Incremental catalog refresh✅ Available
Full catalog refresh✅ Available
Order tracking (hyperlocal GPS)✅ Available
Order tracking (inter-city)✅ Available
Search, Select, Init, Confirm✅ Available
Return with liquidation✅ Available
Merchant partial cancel✅ Available
RTO (Return to Origin)✅ Available
Customization (selection)✅ Available
Variants support✅ Available
Custom menu✅ Available
Off-network logistics🚧 Under Development
Self-pickup🚧 Under Development
Slotted delivery🚧 Under Development
Customization (free text)📅 Future scope
Static terms📅 Future scope
BNP + logistics integration📅 Future scope

Troubleshooting

Services Not Starting

# Check logs
docker logs ondc-seller-app
docker logs ondc-seller-frontend
docker logs ondc-seller-protocol

# Restart specific service
docker-compose restart seller-app

Registration Issues

  • Verify signing keys are generated correctly
  • Ensure domain is publicly accessible
  • Check ONDC registry payload format
  • Confirm all required fields in registration payload

Catalog Not Syncing

  • Check MongoDB connection
  • Verify protocol layer is running
  • Review /on_search webhook responses
  • Check S3 bucket permissions for images

Security Notes

  • Store all secrets in Zo's Settings > Advanced
  • Never commit .env files to version control
  • Rotate signing keys periodically
  • Use HTTPS for all endpoints
  • Implement rate limiting on public APIs
  • Regular security audits of dependencies

References

See the references/ folder for:

  • ONDC API Contract v1.2 documentation
  • Seller app user manual
  • Feature implementation guide
  • Integration requirements

Support

When to Use This Skill

Use this skill when you need to:

  • Deploy an ONDC-compliant seller application
  • Integrate your inventory with ONDC network
  • Manage multi-store retail operations on ONDC
  • Handle orders, returns, and cancellations
  • Troubleshoot ONDC protocol issues
  • Scale seller operations across India

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.