ERCOT External Web Services (EWS)

Table of Contents

1. Document Revisions
2. Introduction
   • 2.1. Purpose
   • 2.2. Scope
   • 2.3. Definitions, Acronyms, and Abbreviations
   • 2.4. References
   • 2.5. Program-level Standards
3. Services Organization
   • 3.1. Common Message Structure
   • 3.2. Message Header
     • 3.2.1 Request Message Structures
     • 3.2.2. Payload Structures
     • 3.2.3. Response Message Structures
4. Common Security Implementation
   • 4.1. Secure the Transport layer
   • 4.2. Secure SOAP messages
5. Modeling and Conventions
   • 5.1. Use of the IEC CIM
   • 5.2. Representation of Time
   • 5.3. Market Products
   • 5.4. Management and Use of Transaction IDs (mRIDs)
   • 5.5. Other Conventions
   • 5.6. Precision
   • 5.7. XML Special Characters
   • 5.5. Delivery Approach
   • 5.6. Technical Interoperability
   • 5.7. Service Level Agreements
   • 5.8. Auditing, Monitoring and Management
   • 5.9. Versioning
   • 5.10. Governance
   • 5.11. Web Service Configuration Standards
   • 5.12. Web Service Design Assumptions and Limitations
6. Market Transaction Service
   • 6.1. Interfaces Provided
   • 6.2. Interfaces Required
   • 6.3. Message Specifications
     • 6.3.1. Three-Part Supply Offer (TPO)
     • 6.3.2. Self-Arranged Ancillary Service Quantities (SAA)
     • 6.3.3. Incremental and Decremental Energy Offer Curves (IDO)
     • 6.3.4. Ancillary Service Offer (ASO)
     • 6.3.5. Ancillary Service Trade (AST)
     • 6.3.6. Availability Plan (AVP)
     • 6.3.7. Capacity Trade (CT)
     • 6.3.8. PTP Obligation w/ Links to Option (CRR)
     • 6.3.9. Current Operating Plan (COP)
     • 6.3.10. DAM Energy Bid (EB)
     • 6.3.11. DAM Energy-Only Offer (EOO)
     • 6.3.12. Energy Trade (ET)
     • 6.3.13. Output Schedule (OS)
     • 6.3.14. PTP Obligation Bid (PTP)
     • 6.3.15. Self-Schedule (SS)
     • 6.3.16. Real-Time Market Energy Bid (REB)
     • 6.3.17. Exceptional Fuel Cost (EFC)
     • 6.3.18. Ancillary Service Only Offer (AOO)
7. Error Handling
8. Usage and XML Samples
   • 8.1. Offer and Bid Set Submission
   • 8.2. Querying Bids, Offers, Trades and Schedules
   • 8.3. Updating Bids, Offers, Trades and Schedules
   • 8.4. Canceling Bids, Offers, Trades and Schedules
9. Market Information
   • 9.1. Interfaces Provided
   • 9.2. Interfaces Required
     • 9.2.1. AwardSet
     • 9.2.2. AwardedAS
     • 9.2.3. AwardedCRR
     • 9.2.4. AwardedEnergyBid
     • 9.2.5. AwardedEnergyOffer
     • 9.2.6. AwardedEnergyOnlyOffer
     • 9.2.7. AwardedPTPObligation
     • 9.2.7. AwardedASOnly
     • 9.2.8. Forecasted Load
     • 9.2.9. System Load - Same as Total ERCOT Load
     • 9.2.10. Market Totals - Same as Total DAM Energy
     • 9.2.11. Market LMPs, SPPs and Price Corrections
     • 9.2.12. Market MCPCs
     • 9.2.13. Binding Constraints
     • 9.2.14. SCED Violated Constraints
     • 9.2.15. Price Corrected SCED Violated Constraints
     • 9.2.16. Ancillary Service Obligation
     • 9.2.17. Dynamic Ratings
     • 9.2.18. Load Ratio Share
     • 9.2.19. Aggregated Ancillary Service Offer Curves
     • 9.2.20. Ancillary Service Plan
     • 9.2.21. Startup and Shutdown Instructions
     • 9.2.22. Total Ancillary Service Offers
     • 9.2.23. Total DAM Energy - Same as Market Totals
     • 9.2.24. Weather Data
     • 9.2.25. Responsive Reserve Capacity - See System Parameters
     • 9.2.26. Non-Spinning Reserve - See System Parameters
     • 9.2.27. Undeployed Reg-Up and Reg-Down - See System Parameters
     • 9.2.28. Available Capacity - See System Parameters
     • 9.2.29. Wind-Powered Generation Resource Production Potential
     • 9.2.30. Short-Term Wind Power Forecast
     • 9.2.31. Total ERCOT Load - Same as System Load
     • 9.2.32. Total ERCOT Generation Operating Reserve - See System Parameters
     • 9.2.33. UnconfirmedTrades
     • 9.2.34. ConfirmedTrades
     • 9.2.35. DAM Ancillary Service Offer Insufficiency Report
     • 9.2.36. End of Adjustment Period Results
     • 9.2.37. Two Hour Warning Results
     • 9.2.38. DAM Phase II Validation Results
     • 9.2.39. System Parameters
     • 9.2.40. RTD Indicative Base Points
     • 9.2.41. RTD Indicative LMPs
     • 9.2.42. SCED ORDC Price Adders
     • 9.2.43. SCED ORDC Price Adders
     • 9.2.44. RT Price Adder ORDC
     • 9.2.45. RTD Indicative ORDC Price Adders
     • 9.2.46. Photovoltaic Generation Resource Production Potential
     • 9.2.47. Short-Term Photovoltaic Power Forecast
     • 9.2.48. Price Corrected SOTG/SODG 15-min Prices
     • 9.2.49. Price Corrected SOTG/SODG LMPs
10. Notifications
    • 10.1. Interfaces Provided
    • 10.2. Interfaces Required
    • 10.3. Message Specifications
      • 10.3.1. Offer and Bid Set Acceptance
      • 10.3.2. Offer and Bid Set Errors
      • 10.3.3. Confirmed and Unconfirmed Trades
      • 10.3.4. Energy Offer Awards
      • 10.3.5. DAM Energy-Only Offer Awards
      • 10.3.6. DAM Energy Bid Awards
      • 10.3.7. Ancillary Service Awards
      • 10.3.8. CRR Awards
      • 10.3.9. PTP Obligation Awards
      • 10.3.10. Ancillary Service Obligations
      • 10.3.11. Outage Notifications
      • 10.3.12. Startup/Shutdown Instructions
      • 10.3.13. Wind Generation Forecast
      • 10.3.14. DAM Ancillary Service Offer Insufficiency Report
      • 10.3.15. End of Adjustment Period Results
      • 10.3.16. Two Hour Warning Results
      • 10.3.17. DAM Phase II Validation Results
      • 10.3.18. Solar Generation Forecast
11. Notices and Alerts
    • 11.1. MMS System-Generated Notices
    • 11.2. EMS System-Generated Notices
    • 11.3. NMMS System-Generated Notices
    • 11.4. Operator Notices
12. Outage Scheduling Interfaces
    • 12.1. Interfaces Provided
    • 12.2. Message Specifications
      • 12.2.1. Outage Creation
      • 12.2.2. Outage Query
      • 12.2.3. Outage Update
      • 12.2.4. Outage Cancellation
13. Utility Interfaces
    • 13.1. Interfaces Provided
      • 13.1.1. Get mRID
      • 13.1.2. System Status
      • 13.1.3. Request Test Notification
      • 13.1.4. Change Active Notification URL
      • 13.1.5. Get SASM ID List
14. Reports
    • 14.1. GetReports
15. Resource Parameter Transaction Service
    • 15.1. Interfaces Provided
      • 15.1.1. Querying for Resource Parameters Set
      • 15.1.2. Updating Resource Parameters Set
      • 15.1.3. Canceling Resource Parameters Set
16. Message Specifications
    • 16.1. Generator Resource Parameters
    • 16.2. Controllable Load Resource Parameters
    • 16.3. Non Controllable Load Resource Parameters
    • 16.4. Resource Parameters
17. Verbal Dispatch Instructions
    • 17.1. Interfaces Provided
    • 17.2. Interfaces Required
    • 17.3. Message Specifications
      • 17.3.1. Verbal Dispatch Instructions Structure
18. Get Notifications
    • 18.1. Message Specification
19. Appendices
    • 19.1. Appendix A: WS-Notifications
    • 19.2. Appendix B: WSDL for Market Requests
    • 19.3. Appendix C: XML Schemas for Message and Payload Definitions
    • 19.4. Appendix D: Annotated SOAP Message
    • 19.5. Appendix E: SOAP Examples
    • 19.6. Appendix F: XSL Examples
    • 19.7. Appendix G: Payload Compression Example
    • 19.8. Appendix H: DST XML Examples