Introduction
The Order Management API provides a comprehensive suite of functionalities designed to streamline and automate the order lifecycle for telecom and other industries. This set of APIs enables efficient handling of customer orders from initiation to fulfillment, ensuring accurate execution and real-time updates across various systems. The APIs are built on a microservices architecture, promoting modularity, scalability, and seamless integration with legacy and modern systems.
Key Features:
- Order Capture: Accepts orders from various channels including web, telemarketing, mobile, in-store, and call centers.
- Order Validation: Ensures orders meet predefined criteria before processing, validating against product catalogs and business rules.
- Order Decomposition: Breaks down complex customer orders into manageable service and resource components for efficient processing.
- Lifecycle Management: Manages the state of orders through stages like new, modify, terminate, suspend, and resume.
- Fulfillment and Monitoring: Executes order fulfillment processes and monitors progress to ensure timely and accurate delivery.
- Real-Time Updates: Provides real-time status updates and notifications to keep stakeholders informed throughout the order lifecycle.
- Seamless Integration: Connects with external systems and services through standardized APIs, ensuring smooth data flow and interoperability.
- Catalog-Driven Processes: Leverages a comprehensive product catalog to drive order configurations, pricing, and validation.
Benefits:
- Efficiency: Automates repetitive tasks and streamlines order processing to reduce manual effort and errors.
- Accuracy: Ensures high order accuracy through stringent validation and decomposition processes.
- Customer Satisfaction: Enhances customer experience by providing timely and transparent order updates.
- Scalability: Supports high volumes of orders with a scalable microservices architecture.
- Flexibility: Adapts to various business models and order scenarios with customizable workflows and business rules.
- Integration: Easily integrates with legacy systems, third-party applications, and modern IT infrastructure.
API Overview
The Order Management API supports various operations to manage the order lifecycle effectively. Key operations include:
- Create Order (POST): Initiates a new order with customer details and product configurations.
- Update Order (PATCH): Modifies existing partial or specific section in orders based on customer requests or business needs.
- Update Order (PUT): Modifies existing full orders based on customer requests or business needs.
- Retrieve Order (GET): Fetches order details, including status and history, for tracking and monitoring.
- Delete Order (DELETE): Cancels an order that is no longer required, updating all relevant systems.
Getting Started:
To start using the Order Management API, follow these steps:
- Authentication: Obtain an API key or access token for secure access.
- API Endpoints: Use the provided endpoints to interact with the API for various order management operations.
- Request and Response Formats: Follow the standard request and response formats, typically JSON, for seamless integration.
- Error Handling: Implement error handling mechanisms to manage API responses and exceptions effectively.
For detailed information on each endpoint, including parameters, request and response examples, and error codes, refer to the specific sections in this documentation.
What made this section unhelpful for you?
Customer Order
The Customer Product Order API enables customers and API integrators to manage product orders seamlessly across various channels including web, telecom, and in-store. It facilitates the acceptance, validation, and initiation of orders for decomposition, supporting a wide range of order scenarios such as new orders, modifications (amendments), terminations, cancellations, suspensions, and resumptions. The Product Ordering API provides a standardized mechanism for placing a product order with all of the necessary order parameters. The API consists of a simple set of operations that interact with CRM/Order Negotiation systems in a consistent manner. A product order is created based on a product offer that is defined in a catalog. The product offer identifies the product or set of products that are available to a customer, and includes characteristics such as pricing, product options and market. This API provide a task based resource to request order cancellation. The product order references the product offer and identifies any specific requests made by the customer. Product Order resource A Product Order is a type of order which can be used to place an order between a customer and a service provider or between a service provider and a partner and vice versa. Main Product Order attributes are its identifier, state, priority category (mass market, Enterprise, etc.) related dates (start, completion, etc.), related billing account, related parties and order items. Main Order Items (aka order lines) attributes are the ordered offering and product characteristics with the related action to be performed (e.g. add or delete the products), state, location information for delivery, order item price and price alteration.
Product Order API performs the following operations on product order :
- Retrieval of a product order or a collection of product orders depending on filter criteria -Partial update of a product order (including updating rules)
- Creation of a product order (including default values and creation rules)
- Deletion of product order (for administration purposes) -Notification of events on product order.
Cancel Product Order
This resource is used to request a product order cancellation.
- Retrieval of a cancel product order or a collection of cancel product orders
- Creation of a cancel product order -Notification of events on cancel product order.
Key Features:
- **Acceptance and Validation: The API allows for the acceptance and validation of orders against catalog offers, ensuring accuracy and compliance with business rules.
- **Order Decomposition: Orders can be initiated for decomposition, streamlining the process for further processing and fulfillment.
- **Order Scenarios: Handles diverse order scenarios including new orders, modifications, terminations, cancellations, suspensions, and resumptions, catering to various customer needs and requests.
- **Data Structure: Utilizes the TMF622 data model for structured order entry and management, enhancing data consistency and interoperability.
- **Order State Management: Manages order states based on order progress, providing visibility and control throughout the order lifecycle.
Usage Guidelines:
Authorization: Access to the API requires a JWT token with appropriate permissions, including the ability to manage orders and access catalog data. Customization: Developers can define business rules within the API for order validation, credit checks, and other customizations, influencing the API's response and behavior. Integration: Seamlessly integrates with external systems as part of the business fulfillment plan, supporting portfolio ID generation and external validations. Performance: The API is optimized for performance, ensuring efficient processing of orders and delivering a seamless user experience across channels.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Service Order
The Customer Service / Resource Order (CSO) API provides a standardized mechanism for managing Service and Resource Orders, enabling seamless integration between internal Customer Order Management systems and Service Order Management systems. This API facilitates actions such as decomposing Customer Orders, validating Service and Resource Orders against catalog definitions, and supporting network activation and CLR creation.
The Service Order API provides a standardized mechanism for managing Service Order, a type of order which can be used to place an order between internal Customer Order management system to service order management system or between a service provider and a partner and vice versa.
Service Order resource: A service order will describe a list of service order items. A service order item references an action on an existing or future service. By service, we designed Customer Facing Service (CFS) as well as Resource Facing Service (RFS). From a component perspective, a service order should be available from:
A Service Orchestration Component (and it could mix CFS and RFS)
An Infrastructure Control & Management component (and it would have only RFS)
Key Feature:
Decompose Customer Orders into Service and Resource Orders.
Validate Service and Resource Orders with catalog definitions.
Support network activation and CLR creation.
Enable actions including ADD, MODIFY, DELETE, CANCEL, and NOCHANGE.
Provide operations such as POST, PATCH, GET, and DELETE for order management.
Require a login token for authorization.
Compare Service and Resource Orders with catalog definitions.
Process applications in real-time.
Support order scenarios like New, Modification, Termination, Amendment, Cancel, Suspend, and Resume.
Integrate Network Operations Center (NOC) functionalities.
Usage Guidelines:
Authorization: Access to the service requires a JWT token with appropriate permissions. Login tokens are necessary for secure authentication and authorization.
Customization: Developers can influence the response of this component by defining business rules within the order creation process and catalog validation.
Performance: The API is optimized for real-time processing, ensuring efficient handling of requests for a seamless user experience.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Customer Product Inventory
The Customer Product Inventory (CPI) API is designed to streamline customer product inventory management across various domains such as self-care, customer management, billing, and order entry systems. It provides a standardized mechanism for creating, updating, and retrieving product representations in the inventory, ensuring real-time updates and integration capabilities with other systems. The Product Inventory Management API provides standardized mechanism for product inventory management such as creation, update and retrieval of the representation of a product in the inventory. It also allows the notification of events related to product lifecycle.
Key Features:
- Real-Time Updates: Maintain accurate and up-to-date customer inventory information through real-time updates.
- Integration Capabilities: Seamlessly integrate with billing, self-care, reporting, and other systems for comprehensive inventory management.
- Search and Filter Options: Utilize search and filter functionalities to easily locate specific products or services within the inventory.
- Support for Change Order Requests: Facilitate the management of change order requests by leveraging real-time updates and integration capabilities.
- Event Notification: Receive notifications for events related to product lifecycle changes, ensuring proactive management of inventory.
- User Token Authorization: Access to the CPI API requires a user token with appropriate permissions, ensuring secure and authorized access.
- Role-Based Access Control: Implement role-based access control to manage user permissions and data security effectively.
- Scalability and Performance: Designed for scalability and optimized performance to handle large volumes of data and transactions efficiently.
Usage Guidelines:
Authorization: Access to the CPI API requires a user token with specific permissions, ensuring secure and authorized access. Integration: Integrate the CPI API with billing, self-care, reporting, and other systems for seamless inventory management across domains. Performance: The API is optimized for performance, enabling efficient processing of requests and delivering a seamless user experience.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Customer Service Inventory
The Customer Service and Resource Inventory (CSI) API is a powerful tool for managing real-time updates to customer inventories across self-care portals, customer interfaces, and network systems. It offers integration capabilities with billing, self-care functionalities, and reporting tools, providing a seamless experience for managing service instances, especially during change order requests. \n" The Service Inventory API can be called by the Service Order Management to create a new service instance/ update an existing service instance in the Service Inventory.\n" Service resource Service is an abstract base class for defining the Service hierarchy. All Services are characterized as either being possibly visible and usable by a Customer or not. This gives rise to the two subclasses of Service: CustomerFacingService and ResourceFacingService.\n" Service Inventory API performs the following operations on service : Retrieve a service or a collection of services depending on filter criteria Partial update of a service (including updating rules) Create a service (including default values and creation rules and for administration users only) Delete a service (for administration users only) Notification of events on service\n"
Key Features:
Real-Time Inventory Updates: Maintain an accurate representation of customer inventories with real-time updates for services and resources.\n" +
Integration Capabilities: Integrate seamlessly with billing, self-care, and reporting systems to ensure data consistency and synchronization.\n" +
Search and Filter Options: Enable users to easily search and filter service instances for efficient inventory management.
Change Order Requests: Facilitate the process of raising change order requests by leveraging real-time updates and integration capabilities.
Event Notifications: Receive notifications for events related to the product lifecycle, enhancing proactive management of inventory changes.
User Token Authorization: Access to the CSI API requires a user token with appropriate permissions, ensuring secure and authorized access.
Scalability and Performance: Designed for scalability to handle large volumes of services and resources, with optimized performance for efficient processing.
Reporting Capabilities: Provide comprehensive reporting functionalities for monitoring inventory levels, trends, and usage patterns.
Usage Guidelines:
Authorization: Access to the CSI API requires a user token with specific permissions, ensuring secure and authorized access. Integration: Integrate the CSI API with billing, self-care, reporting, and other systems for seamless inventory management. Performance: The API is optimized for performance, ensuring efficient processing of requests to deliver a seamless user experience.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Task Management
The Task Management Service provides a comprehensive set of REST APIs designed for effective task and process oversight. These APIs empower users to access vital information, including pending tasks, process instances, attribute details, and checklists. By offering dedicated endpoints for tasks retrieval, completion, attribute fetching, and dynamic updates, users can ensure smooth task execution and flexibility.
Moreover, the service enhances workflow visibility with APIs for task checklist display and management, facilitating organized task handling. Additionally, the ability to fetch flow trace details for the customer order view page provides users with a comprehensive view of order processing, supporting informed decision-making and streamlined order management workflows.
Key Features:
- Task Viewing and Management: Users can view, edit, and complete tasks directly through the API, streamlining task management processes.
- User Access Control: Access to the API is restricted to users with appropriate permissions, ensuring data security and authorized task handling.
- Order Status and Flow Trace: In addition to task management, users can also view order status and flow trace details, gaining insights into order processing stages.
- Manual Task Handling: The API supports manual task management, allowing users to assign tasks based on business rules and complete tasks assigned against orders.
- IDP Integration: User identity and access management are seamlessly integrated, leveraging user IDP details for authentication and authorization.
- Quick Response Time: The API is optimized for quick response times, ensuring a seamless user experience with efficient task handling and data retrieval.
Usage Guidelines:
- Authorization: Access to the Task Management API requires a JWT token with appropriate permissions, ensuring secure and authorized task handling.
- Customization: Developers can customize the API response by defining business rules within the application, enhancing task management capabilities.
- Performance: The API is optimized for performance, delivering quick response times for task viewing, editing, and completion, as well as order status and flow trace retrieval.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Service Request
The Service Request Management API is a powerful tool for managing non-commercial orders and customer requests across self-care portals and customer interfaces. It allows users to create and update requests, integrates seamlessly with external systems, and facilitates the management of change order requests.
The Service Request API provides a standardized client interface to Trouble Ticket Management Systems for creating, tracking, and managing trouble tickets as a result of an issue or problem identified by a customer or another system.
The API supports the ability to send requests to create a new trouble ticket specifying the nature and severity of the trouble or issue as well as all necessary related information.The API also includes mechanisms to search for and update existing trouble tickets. Notifications are defined to provide information when a trouble ticket has been updated, including status changes. A basic set of states of a trouble ticket has been specified(as an example) to handle trouble ticket lifecycle management.
Trouble Ticketing API manages trouble ticket resource: A trouble ticket represents a record, or an issue raised by the requestor that needs to be solved, used for reporting and managing the resolution of problems, incidents, or requests. Main trouble ticket attributes are its description, severity, type, related dates (creation, expected resolution, resolution), state and related information (change reason and change date), related parties (originator, owner, reviser, etc.), related entities (product, product order, customer bill), and notes.
Key Features:
Managing Non-Commercial Orders: The API supports the creation and management of non-commercial orders.
Integration with External Systems: Integrate seamlessly with Northbound and Southbound applications for data synchronization and updates.
Customer and Self-Care Interfaces: Provide a standardized client interface for customers and self-care portals to create and manage service requests.
Change Order Requests: Facilitate the process of raising change order requests and managing their lifecycle.
Business Process Management: Enable the creation and management of different customer requests through customizable business processes.
Real-Time Updates: Capture each customer request in real-time, ensuring accurate and up-to-date information.
Update Notifications: Receive notifications for events such as trouble ticket state changes or updates to keep users informed.
Usage Guidelines:
Authorization: Access to the service requires a login token with specific permissions, ensuring secure and authorized access.
Integration: Integrate the API with Northbound and Southbound applications for data synchronization and updates.
Performance: The API is optimized for performance, ensuring efficient processing of requests to deliver a seamless user experience.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Rule Service
Description:
The Order Rule Service API manages, retrieves, and dynamically loads rules based on criteria, facilitating active rule management and integration with a RuleEngine for effective business logic implementation and decision-making. It enables real-time rule execution based on provided facts, ensuring rules are up to date and dynamically applied.
Key Features:
Rule Definition Input: Allows providing input parameters as per rule definitions.
Dynamic Rule Loading: Loads rules into a rule kia session, returning specific results based on facts.
REST API Access: Deployed rules can be accessed via a REST API.
Rule Engine Integration: Enables updating and deploying rules via the RuleEngine, accessible through the REST API.
Business Rule Types: Supports various rules like Task Allocation, Attribute Restrictions, and Portfolio ID definition.
Rule Versioning: Allows duplication of rules, defaulting to draft versions, and publishing modified rules as Active rules via the REST API.
Access Control: Requires login access for API usage.
Customization: Developers define rules based on business requirements, specifying conditions for rule execution.
Real-time Results: Provides results almost instantly, ensuring efficient decision-making.
Usage Guidelines:
Authorization: Access to the service requires login credentials with appropriate permissions.
Customization: Developers can define, update, and delete rules as needed for business logic customization.
Performance: Optimized for real-time rule execution, delivering efficient processing and quick results.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Communication Management
The Communication Management API is a powerful tool designed to facilitate efficient communication processes within your application. It enables users to define notification templates and send messages via SMS, WhatsApp, and email to both customers and internal teams. By leveraging event-based triggers and templates, users can streamline communication workflows, ensuring timely and targeted messaging.
Key Features:
Notification Template Management: Define and manage notification templates for consistent messaging across different communication channels.
Multi-Channel Messaging: Send messages via email, WhatsApp, and SMS to reach audiences effectively across various platforms.
Template-Based Communication: Utilize predefined templates for communication creation, ensuring standardized and branded messaging.
Event-Based Communication: Trigger communication events based on specific milestones or events, enhancing automation and targeted messaging.
Real-Time Processing: Process communication requests in real time, ensuring timely delivery and responsiveness.\n" +
Integration Capabilities: Integrate the API with other systems and services using event triggers or REST APIs for seamless communication management.
Audience Targeting: Target communications to specific recipients, including customers, internal teams, and user groups, based on predefined criteria.
Automation and Scheduling: Automate communication processes and schedule messages for optimal delivery and engagement.
Reporting and Analytics: Track communication performance metrics, including delivery rates, open rates, and response rates, for analysis and optimization.
Authorization and Security: Access to the API requires JWT token authentication with appropriate permissions, ensuring data security and authorized usage.
Usage Guidelines:
Authorization: Access to the Communication Management API requires a JWT token with appropriate permissions, ensuring secure and authorized communication handling.
Customization: Developers can customize communication templates and rules within the API to align with business requirements and branding guidelines.
Performance: The API is optimized for real-time processing and performance, delivering efficient communication workflows and a seamless user experience.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Project Plan Service
The Project Plan API within the Order Management System enables the definition and communication of important milestones to customers, facilitating transparency, tracking, and timely delivery of complex orders. It integrates with master data configuration, compares flow trace data with major milestones, and generates project plans that can be shared online via email or offline in formats like Excel or PowerPoint.
Key Responsibilities:
Master Data Configuration: Defines project milestones and configurations in the master data setup.
Flow Trace Comparison: Compares Flow Trace data with major milestones to determine start and end times for activities.
Business Process Integration: Supports B2B business processes and allows manual initiation by agents.
Communication Channels: Sends project plans to customers online via email or offline in Excel or PowerPoint formats.
Authorization: Requires valid login permissions for access and usage.
Customization: Allows developers to define business rules and configurations for project planning.
Performance Optimization: Optimized for efficient processing and generation of project plans.
Async Generation: Generates project plans asynchronously, taking input data and generating plans in the background.
Output Formats: Supports output formats such as email, PowerPoint, and online viewing for project plans.
Transparency and Tracking: Enhances transparency and tracking of complex orders by communicating important milestones to customers.
Usage Guidelines:
Authorization: Access requires valid login permissions.
Input and Output Formats: Input data can be processed to generate project plans in various output formats.
Integration: Integrates with master data, flow trace data, and business processes to generate accurate and informative project plans.
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
Fallout Management
Fallout Handling is the process of handling errors / exception occurred during any step / stage of Order Processing within the Order Management system. The Order Management System can encounter errors / exceptions related to systems / services being down or data related issues. The Jeopardy Handling system will handle these errors and allow the users of the Operations team to resubmit the data to finish the Order Processing.
The system is raising red flag in orders if any fallout/jeopardy is raised in the order so that corrective action can be taken up by teams or system to ensure order are not impacted. The system is monitoring below parameters like: System/Process fallout: As application is processing the request and if any fallout happen during processing the request, then the system will be calling jeopardy library to self-heal fallout like - Retry - Set Default value - Repush the event - Reprocess the request. Task Delays: the system will be monitoring the manual/external tasks to ensure timely completion of the activity. If any delay happens then the system raise jeopardy event and send escalation email to respective team to fast track delivery. Requested Due Date / Expected Completion Date: The system is monitory order to be completed within customer requested/expected date. If order is delayed, then the system will raise jeopardy. Hold Order: once order is put on hold then the system will stop processing on this order and the system will raise jeopardy why jeopardy is raised so that respective teams can do needful to resume order back.

Holiday Calendar Service
The Holiday Service provides functionality related to holiday calendars, allowing users to manage, retrieve, and interact with holiday data for various organizations and regions. It categorizes holidays based on different criteria, such as national holidays, religious holidays, or observances, providing accurate and up-to-date holiday information for applications and systems.
Key Features:
- Define Holiday Calendars: Define holiday calendars based on organization, region, and weekend offs.
- Retrieve Holiday Calendars: Get holiday calendar details based on organization and region.
- Calculate End Date: Calculate end dates based on start dates and business Turnaround Time (TAT).
- Delete Holiday Calendars: Remove holiday calendars as needed.
Usage Guidelines:
- Authorization: Access requires a valid login token with appropriate permissions.
- Customization: Developers can define holiday calendars and configure parameters such as TAT and holiday types within the API.
- Performance: Optimized for efficient processing of requests, ensuring accurate calculation of end dates based on holiday calendars and TAT.
What made this section unhelpful for you?
Base URL
Production:
https://int-spring25.comviva.com/
https://int-spring25.comviva.com/OrderGenerator/v4
https://int-spring25.comviva.com/customerOrder/management/v4
https://int-spring25.comviva.com/serviceOrdering/management/v4
https://int-spring25.comviva.com/om-som-adapter/v4
https://int-spring25.comviva.com/productInventory/management/v4
https://int-spring25.comviva.com/serviceInventory/management/v4
https://int-spring25.comviva.com/task-management/v4
https://int-spring25.comviva.com/troubleTicket/query/v4
https://int-spring25.comviva.com/rules/v4
https://int-spring25.comviva.com/communicationManagement/v4
https://int-spring25.comviva.com/project-plan/v4
https://int-spring25.comviva.com/jeopardyApi/v4
https://int-spring25.comviva.com/holidayService/v4
Sandbox:
https://int-spring25.comviva.com/
What made this section unhelpful for you?
Create Holiday Calendar
This API is an interface that enables users or systems to programmatically create and customize holiday calendars.
Header Parameters
Unique identifier for tracking the transaction.
Identifier for correlating related requests and responses.
Source channel or origin of the request.
Identifier of the associated tenant or customer.
Body Parameters
Specifies the country for which the holiday is being requested.
Represents the date of the holiday. OffsetDateTime is used to store date and time information.
Indicates the type of holiday (e.g., national, regional, etc.).
Specifies the region within the country where the holiday applies.
Identifies the user or entity that created the holiday request.
Identifies the user or entity that last modified the holiday request.
Response
Response Attributes
Unique identifier for the organizational holiday.
Name or identifier of the organization associated with the holiday.
Name of the country where the holiday is observed.
Date and time of the holiday.
Type of the holiday (e.g., national, regional, etc.).
Region or area within the country where the holiday is observed.
User who created the holiday record.
Date and time when the holiday record was created.
User who last modified the holiday record.
Date and time when the holiday record was last modified.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A numeric or alphanumeric code that represents a specific error or issue encountered during an operation.
A human-readable message that provides additional details about the error. It offers context and information to help users or developers understand what went wrong
A timestamp indicating when the error occurred, typically in a standardized format such as ISO 8601. It helps with debugging and tracking issues over time
An HTTP status code that indicates the outcome of the request or operation. Common examples include 200 (OK), 404 (Not Found), or 500 (Internal Server Error).
The URL or endpoint that was accessed when the error occurred. It specifies the location of the request that led to the error.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
What made this section unhelpful for you?
Response
{
"id": "",
"organization": "",
"country": "",
"holidayDate": "",
"holidayType": "",
"region": "",
"createdBy": "",
"createdDateTime": "",
"lastModifiedBy": "",
"lastModifiedDateTime": ""
}
What made this section unhelpful for you?
Create Weekend Calendar
This API is an interface designed to allow users or systems to programmatically create and customize weekend calendars using POST operation,
Header Parameters
Unique identifier for tracking the transaction.
Identifier for correlating related requests and responses.
Source channel or origin of the request.
Identifier of the associated tenant or customer.
Body Parameters
Represents the organization for which the week-off calendar request is being made.
Specifies the country for which the week-off calendar request is being made.
Indicates the type of week-off (e.g., weekends, specified days, etc.).
Represents the start date of the week-off period. OffsetDateTime is used to store date and time information.
Represents the end date of the week-off period. OffsetDateTime is used to store date and time information.
Indicates the type of week-off (e.g., public holidays, company-specific holidays, etc.).
Identifies the user or entity that created the week-off calendar request.
Identifies the user or entity that last modified the week-off calendar request.
Response
Response Attributes
Unique identifier for the organizational holiday.
Name or identifier of the organization associated with the holiday.
Name of the country where the holiday is observed.
Date and time of the holiday.
Type of the holiday (e.g., national, regional, etc.).
Region or area within the country where the holiday is observed.
User who created the holiday record.
Date and time when the holiday record was created.
User who last modified the holiday record.
Date and time when the holiday record was last modified.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A numeric or alphanumeric code that represents a specific error or issue encountered during an operation.
A human-readable message that provides additional details about the error. It offers context and information to help users or developers understand what went wrong
A timestamp indicating when the error occurred, typically in a standardized format such as ISO 8601. It helps with debugging and tracking issues over time
An HTTP status code that indicates the outcome of the request or operation. Common examples include 200 (OK), 404 (Not Found), or 500 (Internal Server Error).
The URL or endpoint that was accessed when the error occurred. It specifies the location of the request that led to the error.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
What made this section unhelpful for you?
Response
{
"id": "",
"organization": "",
"country": "",
"holidayDate": "",
"holidayType": "",
"region": "",
"createdBy": "",
"createdDateTime": "",
"lastModifiedBy": "",
"lastModifiedDateTime": ""
}
What made this section unhelpful for you?
Get End Date
This API serves as an interface tailored to fetch comprehensive details regarding turnaround times within a system or application.
Header Parameters
Unique identifier for tracking the transaction.
Identifier for correlating related requests and responses.
Source channel or origin of the request.
Identifier of the associated tenant or customer.
Query Parameters
Response
Response Attributes
Specifies the country for which the holiday is being requested.
Represents the start date of the week-off period. OffsetDateTime is used to store date and time information.
Represents Date when event got Terminated
Represents the organization for which the holiday is being requested.
Specifies the region within the country where the holiday applies.
The time duration associated with the workflow or an appointment
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A numeric or alphanumeric code that represents a specific error or issue encountered during an operation.
A human-readable message that provides additional details about the error. It offers context and information to help users or developers understand what went wrong
A timestamp indicating when the error occurred, typically in a standardized format such as ISO 8601. It helps with debugging and tracking issues over time
An HTTP status code that indicates the outcome of the request or operation. Common examples include 200 (OK), 404 (Not Found), or 500 (Internal Server Error).
The URL or endpoint that was accessed when the error occurred. It specifies the location of the request that led to the error.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
What made this section unhelpful for you?
Response
{
"country": "INDIA",
"fromDate": "",
"endDate": "",
"organization": "COMVIVA",
"region": "",
"duration": "12.0"
}
What made this section unhelpful for you?
Get Calendar
This API serves as an interface crafted to retrieve comprehensive information about a holiday calendar from a system or application.
Header Parameters
Unique identifier for tracking the transaction.
Identifier for correlating related requests and responses.
Source channel or origin of the request.
Identifier of the associated tenant or customer.
Query Parameters
Response
Response Attributes
The "totalHolidays" attribute likely represents the total number of holidays within a given context, such as a holiday calendar for a specific country, region, or organization.
"mandatoryHoliday" likely refers to a specific type of holiday that is mandatory or required to be observed.
The "regionalHolidays" attribute likely indicates the number or details of holidays that are specific to a particular region within a country.
"listOfHolidays" is likely a collection or array that provides a detailed list of individual holidays within a given context.
Show child attributes
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A numeric or alphanumeric code that represents a specific error or issue encountered during an operation.
A human-readable message that provides additional details about the error. It offers context and information to help users or developers understand what went wrong
A timestamp indicating when the error occurred, typically in a standardized format such as ISO 8601. It helps with debugging and tracking issues over time
An HTTP status code that indicates the outcome of the request or operation. Common examples include 200 (OK), 404 (Not Found), or 500 (Internal Server Error).
The URL or endpoint that was accessed when the error occurred. It specifies the location of the request that led to the error.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
What made this section unhelpful for you?
Response
{
"totalHolidays": 30,
"mandatoryHolidays": 11,
"regionalHolidays": 10,
"listOfHolidays": [
{
"id": "",
"organization": "COMVIVA",
"country": "INDIA",
"holidayDate": "",
"holidayType": "Public Holiday",
"region": "",
"createdBy": "admin",
"createdDateTime": "2023-10-19T10:42:41.257Z",
"lastModifiedBy": "system",
"lastModifiedDateTime": "2023-10-19T10:42:41.257Z"
}
]
}
What made this section unhelpful for you?
Delete Calendar
The "Delete Calendar API" is an interface crafted to enable users or systems to eliminate a holiday calendar or specific calendar configurations from a system or application.
Header Parameters
Unique identifier for tracking the transaction.
Identifier for correlating related requests and responses.
Source channel or origin of the request.
Identifier of the associated tenant or customer.
Path Parameters
Response
Response Attributes
Response of a holiday-related operation within a communication domain.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A numeric or alphanumeric code that represents a specific error or issue encountered during an operation.
A human-readable message that provides additional details about the error. It offers context and information to help users or developers understand what went wrong
A timestamp indicating when the error occurred, typically in a standardized format such as ISO 8601. It helps with debugging and tracking issues over time
An HTTP status code that indicates the outcome of the request or operation. Common examples include 200 (OK), 404 (Not Found), or 500 (Internal Server Error).
The URL or endpoint that was accessed when the error occurred. It specifies the location of the request that led to the error.
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
Response Attributes
A Date,Error creation date and time
A String,A error code provides specific error code which occurred
A error,A error reason provides the specific reason why error occurred
Error message,A error message provides the specific message which occurred
Error stacktrace,A error stacktrace provides the stacktrace for error occurred
What made this section unhelpful for you?
Response
{
"response": ""
}