|
| 1 | +# BECKN-000: Terminology |
| 2 | + |
| 3 | +## License: |
| 4 | +This document is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/). |
| 5 | + |
| 6 | + |
| 7 | + |
| 8 | +## Category: |
| 9 | +Terminology |
| 10 | + |
| 11 | +## Published on: |
| 12 | +Sept 9th, 2025 |
| 13 | + |
| 14 | +## Last Updated on: |
| 15 | +Sept 16th, 2025 |
| 16 | + |
| 17 | +## History: |
| 18 | +Click on this [link](https://github.com/beckn/protocol-specifications/commits/core-1.2-release/docs/BECKN-000-Terminology.md) to view the history of changes to this document |
| 19 | + |
| 20 | +## Issues: |
| 21 | +To view issues related to this document, click on this [link](https://github.com/beckn/protocol-specifications/issues?q=is%3Aissue+label%3ABECKN-000) |
| 22 | + |
| 23 | +## Discussions: |
| 24 | +To view discussions related to this document, click on this [link](https://github.com/beckn/protocol-specifications/discussions?discussions_q=label%3ABECKN-000) |
| 25 | + |
| 26 | +## Authors: |
| 27 | +1. [Ravi Prakash](https://github.com/ravi-prakash-v) |
| 28 | + |
| 29 | +## Reviewers: |
| 30 | +1. [Sujith Nair](https://github.com/sjthnrk) |
| 31 | +2. [Pramod Varma](https://github.com/pramodkvarma) |
| 32 | +3. [Venkatraman Mahadevan](https://github.com/venkatramanm) |
| 33 | + |
| 34 | +# Abstract |
| 35 | + |
| 36 | +This document provides a comprehensive glossary of terms and definitions used across the Beckn Protocol specifications. It serves as a reference for network participants, implementers, and stakeholders to ensure consistent understanding of key concepts and terminology. |
| 37 | + |
| 38 | +# Scope |
| 39 | + |
| 40 | +This document defines the standard terminology used across all Beckn Protocol specifications and related documents. It is intended for: |
| 41 | + |
| 42 | +1. Network participants implementing Beckn Protocol |
| 43 | +2. Developers building on Beckn-enabled networks |
| 44 | +3. Policy makers and governance bodies |
| 45 | +4. Technical writers and documentation maintainers |
| 46 | + |
| 47 | +## Prerequisites |
| 48 | + |
| 49 | +Readers of this document should have: |
| 50 | + |
| 51 | +1. Basic understanding of distributed systems and API protocols |
| 52 | +2. Familiarity with commerce and transaction terminology |
| 53 | +3. Knowledge of the Beckn Protocol architecture |
| 54 | + |
| 55 | +# Introduction |
| 56 | + |
| 57 | +The Beckn Protocol ecosystem involves multiple stakeholders, technical concepts, and domain-specific terminology. This document establishes a common vocabulary to ensure clear communication and consistent implementation across all Beckn-enabled networks. |
| 58 | + |
| 59 | +# Terminology |
| 60 | + |
| 61 | +1. **Network :** In the context of beckn protocol, a network refers to an open commerce network formed by the instantiation of beckn protocol specification with a standard network policy |
| 62 | +2. **Network Participant:** Any platform that has implemented beckn protocol specification and is part of an open commerce network |
| 63 | +3. **Schema:** These are JSON Schema objects with properties as defined in the core specification |
| 64 | +4. **Action:** These are specific events that occur during the lifecycle of a typical commerce transaction |
| 65 | +5. **Network Policy**: These are specific rules that apply to the implementers of a network while developing the protocol API middleware |
| 66 | +6. **BAP (Beckn Application Platform)**: A platform that enables buyers to discover and transact with sellers on a Beckn-enabled network |
| 67 | +7. **BPP (Beckn Provider Platform)**: A platform that enables sellers to list their services and fulfill orders on a Beckn-enabled network |
| 68 | +8. **BG (Beckn Gateway)**: A network infrastructure component used for provider discovery; it routes discovery requests from BAPs to relevant BPPs and enforces basic routing and validation policies |
| 69 | +9. **Registry**: A centralized directory service that maintains information about network participants, their capabilities, and network policies |
| 70 | + |
| 71 | +# Examples |
| 72 | + |
| 73 | +## Common Usage Examples |
| 74 | + |
| 75 | +- **Network**: "The mobility network in Bangalore uses Beckn Protocol with specific policies for ride-sharing and public transport" |
| 76 | +- **Network Participant**: "Uber and Ola are both network participants in the mobility network" |
| 77 | +- **Schema**: "The Order schema defines the structure for transaction data" |
| 78 | +- **Action**: "The search action initiates the discovery of available services" |
| 79 | +- **Network Policy**: "The network policy requires all transactions to include location data" |
| 80 | +- **BAP**: "The Swiggy app acts as a BAP, allowing users to discover and order food from restaurants" |
| 81 | +- **BPP**: "Restaurant partners use a BPP platform to list their menus and manage orders" |
| 82 | +- **BG**: "The beckn gateway is used for provider discovery and routes search requests from BAPs to relevant BPPs in the food delivery network" |
| 83 | +- **Registry**: "The registry maintains a directory of all food delivery BPPs and their service capabilities" |
| 84 | + |
| 85 | +# Recommendations |
| 86 | + |
| 87 | +- Use terminology consistently across all documentation and implementations |
| 88 | +- Refer to this document when introducing new terms or concepts |
| 89 | +- Update this document when new terminology is introduced in the protocol |
| 90 | +- Cross-reference related terms to maintain clarity |
| 91 | + |
| 92 | +# Acknowledgements |
| 93 | + |
| 94 | +The authors would like to thank the following people for their support and contributions to this document. |
| 95 | + |
| 96 | +* Pramod Varma (Beckn Foundation) |
| 97 | +* Sujith Nair (Beckn Foundation) |
| 98 | +* Venkataramanan Mahadevan (Humbhionline) |
0 commit comments