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
In this repository22 other files it gives its agents.
- bhagavad-gitaSkill
- cashfreeSkill
- covid-indiaSkill
- gurbaniSkill
- ifsc-apiSkill
- indian-constitutionSkill
- indian-newsSkill
- railradarSkill
- mutual-fundSkill
- namma-yatriSkill
- ondc-buyerSkill
- phonepeSkill
- pincodeSkill
- rapidoSkill
- razorpaySkill
- sarvam-aiSkill
- shiprocketSkill
- thirukkuralSkill
- uber-indiaSkill
- vedic-astrologySkill
- vedic-textsSkill
- zohoSkill
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
- Distinctive: line 35
Before using this skill, ensure you have:
- Distinctive: line 219
Verify signing keys are generated correctly
- Distinctive: line 220
Ensure domain is publicly accessible
- Distinctive: line 221
Check ONDC registry payload format
- Distinctive: line 227
Verify protocol layer is running
- Distinctive: line 229
Check S3 bucket permissions for images
- Very specific: line 234
Never commit .env files to version control
- Distinctive: line 236
Use HTTPS for all endpoints
- Distinctive: line 257
Use this skill when you need to:
≈ “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.
Files
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:
- Docker & Docker Compose installed
- Git with submodule support
- Domain name or ngrok for public endpoint
- Required service accounts:
- Firebase (authentication)
- SMTP server (email notifications)
- AWS S3 (asset storage)
- Map My India (location services)
- 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 update2. Generate Cryptographic Keys
bun /home/workspace/Skills/ondc-seller/scripts/generate-keys.tsThis 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 -d5. 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.tsShows 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 trueView 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:
| Feature | Status |
| 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-appRegistration 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_searchwebhook responses - Check S3 bucket permissions for images
Security Notes
- Store all secrets in Zo's Settings > Advanced
- Never commit
.envfiles 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
- ONDC Documentation: https://docs.ondc.org
- Seller App Repo: https://github.com/ONDC-Official/seller-app-sdk
- ONDC Slack: https://witsinnovationlab.slack.com/archives/C0280AR5CUQ
- Registry Form: https://forms.gle/registrationform
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
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
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.

