{"info":{"_postman_id":"6ee64b8d-2db3-4154-be02-e47a938089aa","name":"MT PASA Offer API","description":"<html><head></head><body><p>The MT PASA Offers API allows Scheduled Generators, Market Customers, Market Network Service Providers, and Integrated Resource Providers to submit their MT PASA Offers for Bi-directional Units (BDU), Scheduled Generation Units (SGU), Scheduled Load Units (SLU), and Scheduled Network Services (SNS).</p>\n<p>MT PASA Offers are input into the <a href=\"https://aemo.com.au/en/energy-systems/electricity/national-electricity-market-nem/nem-forecasting-and-planning/forecasting-and-reliability/projected-assessment-of-system-adequacy\">MT PASA process</a>.</p>\n<h1 id=\"api-status\">API status</h1>\n<p>Draft for review. The design is not ready for participants’ builds</p>\n<h1 id=\"assumed-knowledge\">Assumed knowledge</h1>\n<ol><li><p>API and JSON or YAML basics.</p></li><li><p><a href=\"https://portal.aemo.com.au/help/Content/API\">AEMO's API Reference</a></p></li><li><p><a href=\"https://portal.prod.nemnet.net.au/help/Content/InformationSystems/Electricity/Interfaces.htm?TocPath=Connecting%20to%20Market%20Systems|_____0\">Connecting to AEMO's Electricity IT systems</a>.</p></li></ol>\n\n<h1 id=\"prerequisites\">Prerequisites</h1>\n<p>Before you can use the MT PASA Offer API you must:</p>\n<ul>\n<li>Have a Participant ID. If your company is a Registered Participant, it is set up during the registration process.Have a Participant ID with an effective date of registration.</li>\n<li>Have a user ID and password with access rights provided by your company's participant administrator. For details, see user rights access below.</li>\n<li>Understand the procedures governing the operation of the market relating to<br>  wholesale trading of electricity and the provision of ancillary services. For<br>  details, see the NER Chapter 3, Introduction to Market Rules.</li>\n<li>Have an API gateway and a <a href=\"https://dev.aemo.com.au/tls-certificates\">TLS certificate.</a></li>\n<li>Know your Dispatchable Unit Identifier (DUID).</li>\n<li>Test your submission in the pre-production environment before submitting to production. AEMO encourages participants to use the pre-production environment to test procedures and train staff.</li>\n<li>Know the Participant File Server address (see <a href=\"https://portal.prod.nemnet.net.au/help/Content/Guide_to_Information_Systems/Content/Electricity/Interfaces.htm?TocPath=Connecting\">Connecting to AEMO's Market Systems</a>) to retrieve the:<ul>\n<li>Offer acknowledgement (ack or cpt) to your ParticipantID\\Import\\MasterBids folder.</li>\n<li>MTPASA_OFFERFILETRK file to your ParticipantID\\Import\\CSV\\Reports. This report conforms to the Electricity Data Model. For details about the tables in this report, see Electricity Data Model below.</li>\n</ul>\n</li>\n</ul>\n<h1 id=\"submission-gateway-addresses\">Submission gateway addresses</h1>\n<h2 id=\"marketnet\">MarketNet</h2>\n<p>Prod: <a href=\"https://apis.prod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers\">https://apis.prod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers</a></p>\n<p>Pre-production: <a href=\"https://apis.preprod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers\">https://apis.preprod.marketnet.net.au:9319/NEMWholesale/v1/</a><a href=\"https://apis.prod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers\">MTPASAOffers</a></p>\n<h1 id=\"api-portal\">API portal</h1>\n<p><a href=\"https://dev.aemo.com.au\">API specification</a> in progress.</p>\n<h1 id=\"related-rules-and-procedures\">Related rules and procedures</h1>\n<ul>\n<li><a href=\"https://aemo.com.au/energy-systems/electricity/national-electricity-market-nem/nem-forecasting-and-planning/forecasting-and-reliability/reliability-standard-implementation-guidelines\">Reliability Standard Implementation Guideline</a></li>\n<li><a href=\"https://aemo.com.au/energy-systems/electricity/national-electricity-market-nem/nem-forecasting-and-planning/forecasting-and-reliability/projected-assessment-of-system-adequacy\">MT PASA Process Description</a></li>\n<li><a href=\"https://aemo.com.au/energy-systems/electricity/national-electricity-market-nem/nem-forecasting-and-planning/forecasting-and-reliability/energy-adequacy-assessment-projection-eaap\">Energy Adequacy Assessment Projection (EAAP) guidelines</a></li>\n<li><a href=\"https://aemo.com.au/energy-systems/electricity/national-electricity-market-nem/nem-forecasting-and-planning/forecasting-and-reliability/nem-electricity-statement-of-opportunities-esoo\">ESOO and Reliability Forecast Methodology</a></li>\n<li><a href=\"https://aemo.com.au/consultations/current-and-closed-consultations/generation-information-guidelines\">Generation Information Guidelines</a></li>\n<li><a href=\"https://energy-rules.aemc.gov.au/ner/440\">National Electricity Rules (NER)</a>: 3.7.1, 3.7.2, 11.151, 11.151.1, 11.151.2, 11.151.3</li>\n</ul>\n<h1 id=\"user-rights-access\">User rights access</h1>\n<p>Participant administrators provide access to the MT PASA Offer API using the following entities:</p>\n<ul>\n<li>Create Offers: EMMS - Offers and Submissions - MTPASA Offers - Create</li>\n<li>View Offers: EMMS - Offers and Submissions - MTPASA Offers - View Data</li>\n</ul>\n<p>Participants Users provide the base-64 encoded URM credentials in the Basic Auth header.</p>\n<h1 id=\"compression\">Compression</h1>\n<p>You can submit your API compressed or uncompressed. Compression protocols are gzip or deflate.</p>\n<h1 id=\"throttling\">Throttling</h1>\n<p>To control traffic, AEMO implements Throttling on API Endpoint requests. If Participant ID requests exceed the Throttling limit a HTTP 429 or 422 response returns. For more details, see Response codes below.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Endpoint</th>\n<th>Limits</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>submission  <br>  <br></td>\n<td>1 request per second per participantId.  <br>  <br>The participantId is identified from the X-initiatingParticipantID request header parameter.  <br>  <br>Participants systems must manage this Throttling limit because if you submit multiple JSON requests for the same participantId at the same time, AEMO may reject some.</td>\n</tr>\n</tbody>\n</table>\n</div><h1 id=\"response-codes\">Response codes</h1>\n<p>For details, see (<a href=\"https://portal.aemo.com.au/help/Content/API%20Reference/HTTP%20response.html?TocPath=API\">API Reference &gt; HTTP response</a>)</p>\n<h1 id=\"about-offer-submission\">About offer submission</h1>\n<p>The submission endpoint allows participants to submit one or more MTPASA Offers.</p>\n<p>You provide the Offer details in the Offers array in the JSON schema. Every Submission must supply all required submission level information otherwise AEMO rejects the submission.</p>\n<p>This endpoint has payload parameters only (no query parameters).</p>\n<h1 id=\"submission-rules\">Submission rules</h1>\n<p>• The weekly energy limit is in MWh.<br>• The first date must be a future Sunday.<br>• One Offer File can have many Generating Units (DUIDs).<br>• Each data line is for one week, notifying the weekly Energy limit and capacity for each day in the week.<br>• Successive data lines are for the same unit at weekly intervals for the period of the projection (usually two years).<br>• Rules for use of Reason Codes and Recall Times: TBC</p>\n<h1 id=\"csv-payloads\">CSV Payloads</h1>\n<p>For details, see <a href=\"https://aemo.com.au/energy-systems/market-portals-directory/markets-portal-help\">MT PASA Offers csv Paylod Fields</a>.</p>\n<h1 id=\"participant-categories-unit-states-and-recall-times\">Participant categories, unit states, and recall times</h1>\n<p>For details, see <a href=\"https://aemo.com.au/energy-systems/market-portals-directory/markets-portal-help\">Participant categories, unit states, and recall times</a>.</p>\n<h1 id=\"submission-interfaces\">Submission interfaces</h1>\n<p>As well as API, you can use the following interfaces to submit Dispatch Bids ad Offers.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Interface</strong></th>\n<th><strong>Description</strong></th>\n<th><strong>Reference</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>FTP</td>\n<td>Submit MT PASA Offer CSV Payload over FTP to the Participant File Server</td>\n<td><a href=\"https://portal.prod.nemnet.net.au/help/Content/MarketsPortal/MTPASAoffers.htm?TocPath=EMMS\">MT PASA Offers</a></td>\n</tr>\n<tr>\n<td>Markets Portal</td>\n<td>Submit MT PASA Offers CSV Payload and view existing offers in the Markets Portal MT PASA Offer interface</td>\n<td><a href=\"https://portal.prod.nemnet.net.au/help/Content/MarketsPortal/MTPASAoffers.htm?TocPath=EMMS\">MT PASA Offers</a></td>\n</tr>\n</tbody>\n</table>\n</div><h1 id=\"submission-size\">Submission size</h1>\n<p>A submission request or response has a payload limit of 10 MB (compressed or uncompressed).</p>\n<h1 id=\"submission-processing\">Submission processing</h1>\n<p>Submissions are processed in the order AEMO receives them. You must ensure the correct submission order so your latest Offer is the Effective Offer Submission acknowledged by AEMO’s systems.</p>\n<h1 id=\"submission-response\">Submission response</h1>\n<p>If the entire submission is valid you receive a response 200 with transaction ID and other metadata related to the Submission.</p>\n<p>If your submission has multiple Units and multiple Trading Days in a single request, and one has an error, AEMO rejects the whole submission.</p>\n<p>If your submission has an error AEMO rejects it with a response code, displaying the source of the problem so you can identify its location. Rectify the issue by updating the values appropriately and resubmitting.</p>\n<h1 id=\"submission-details\">Submission details</h1>\n<p>Immediately after submission, on the Participant File Server &gt; ParticipantID\\Import\\CSV\\Reports folder, you receive a private MTPASA_OFFERFILETRK file with your submission information. For details, see Electricity Data Model, below.</p>\n<h1 id=\"electricity-data-model\">Electricity data model</h1>\n<p>Your submission populates the Data Model tables and files mentioned in this section.</p>\n<p>For help with:</p>\n<ul>\n<li>The relationships between tables, see the <a href=\"https://nemweb.com.au/Reports/Current/MMSDataModelReport/Electricity/MMS\">MMS Data Model Report</a>.</li>\n<li>The relationships between tables and files, see Markets Portal &gt; Data Subscriptions &gt; Data Subscriptions</li>\n<li>For help with the Data Model and Data Interchange, see <a href=\"https://www.aemo.com.au/energy-systems/electricity/national-electricity-market-nem/data-nem/nemweb-help\">Data Interchange Online Help.</a></li>\n</ul>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Table</th>\n<th>Purpose</th>\n<th>File</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>MTPASA_OFFERDATA</td>\n<td>Participant submitted Offers for the MTPASA process</td>\n<td>MTPASA_OFFERFILETRK</td>\n</tr>\n<tr>\n<td>MTPASA_DUIDAVAILABILITY</td>\n<td>Offered PASA Availability of the scheduled generator (DUID) for each day over the Medium Term PASA period. The data in this table is input data to the MT PASA process. It is not part of the MTPASA solution. The availability does not reflect any energy limitations in the MT PASA offers</td>\n<td>MTPASADUIDAVAILABILITY</td>\n</tr>\n</tbody>\n</table>\n</div><h1 id=\"glossary\">Glossary</h1>\n<p>For help with terms see:</p>\n<ul>\n<li><a href=\"https://www.aemc.gov.au/sites/default/files/2021-06/NER\">National Electricity Rules Glossary</a></li>\n<li><a href=\"https://aemo.com.au/learn/industry-terminology\">Industry Terminology</a></li>\n</ul>\n<h1 id=\"endpoints\">Endpoints</h1>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"API status","slug":"api-status"},{"content":"Assumed knowledge","slug":"assumed-knowledge"},{"content":"Prerequisites","slug":"prerequisites"},{"content":"Submission gateway addresses","slug":"submission-gateway-addresses"},{"content":"API portal","slug":"api-portal"},{"content":"Related rules and procedures","slug":"related-rules-and-procedures"},{"content":"User rights access","slug":"user-rights-access"},{"content":"Compression","slug":"compression"},{"content":"Throttling","slug":"throttling"},{"content":"Response codes","slug":"response-codes"},{"content":"About offer submission","slug":"about-offer-submission"},{"content":"Submission rules","slug":"submission-rules"},{"content":"CSV Payloads","slug":"csv-payloads"},{"content":"Participant categories, unit states, and recall times","slug":"participant-categories-unit-states-and-recall-times"},{"content":"Submission interfaces","slug":"submission-interfaces"},{"content":"Submission size","slug":"submission-size"},{"content":"Submission processing","slug":"submission-processing"},{"content":"Submission response","slug":"submission-response"},{"content":"Submission details","slug":"submission-details"},{"content":"Electricity data model","slug":"electricity-data-model"},{"content":"Glossary","slug":"glossary"},{"content":"Endpoints","slug":"endpoints"}],"owner":"10032049","collectionId":"6ee64b8d-2db3-4154-be02-e47a938089aa","publishedId":"2s9Xy6qqAU","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-08-16T03:47:42.000Z"},"item":[{"name":"Submission","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"d0bdfcf8-0ee2-43a4-a4e5-9d2784214dd6"}}],"id":"302e528d-5855-49d4-9362-6cdf88c04860","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-initiatingParticipantID","value":"","type":"text"},{"key":"X-market","value":"NEM","type":"text","description":""}],"body":{"mode":"raw","raw":""},"url":"https://apis.preprod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers/submission","auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"<username>"},{"key":"password","value":"<password>"}]},"isInherited":true,"source":{"_postman_id":"6ee64b8d-2db3-4154-be02-e47a938089aa","id":"6ee64b8d-2db3-4154-be02-e47a938089aa","name":"MT PASA Offer API","type":"collection"}},"urlObject":{"path":["submission"],"host":["https://apis.preprod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers"],"query":[],"variable":[]}},"response":[],"_postman_id":"302e528d-5855-49d4-9362-6cdf88c04860"}],"auth":{"type":"basic","basic":{"basicConfig":[{"key":"username","value":"<username>"},{"key":"password","value":"<password>"}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"4b5fb570-da92-4d81-817a-a73979c5ed40"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"6fcf3053-29fa-4c59-9877-ed092d131758"}}],"variable":[{"key":"preprodMarketnetUrl","value":"https://apis.preprod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers","type":"string"},{"key":"preprodInternetUrl","value":"https://apis.preprod.aemo.com.au:9319/NEMWholesale/v1/MTPASAOffers","type":"string"},{"key":"preprodLocalUrl","value":"https://apis.preprod.aemo.com.au:9319/NEMWholesale/v1/MTPASAOffers","type":"string"},{"key":"prodMarketnetUrl","value":"https://apis.prod.marketnet.net.au:9319/NEMWholesale/v1/MTPASAOffers","type":"string"},{"key":"prodInternetUrl","value":"https://apis.prod.aemo.com.au:9319/NEMWholesale/v1/MTPASAOffers","type":"string"},{"key":"prodLocalUrl","value":"https://apis-prd.aemo.com.au:9319/NEMWholesale/v1/MTPASAOffers","type":"string"}]}