# Get your Petronect opportunities through an API

> Read the Aberto para Propostas list, an opportunity's items, and the ranked Propostas of a concluded tender from Petronect with one API call each. A workflow checks the list each morning for your keywords and emails you the new opportunities.

Page: https://fous.com/automate/petronect
Updated: 2026-11-12

Works with your own Petronect account. Fous is an independent product.

## What you can build on Petronect

### Get open public opportunities

Reads the Aberto para Propostas list of public tenders, filtered by Abrangência, Local de entrega and Classificação, and optionally by a keyword in the Objeto.

- Takes: Keyword (optional), Abrangência, Local de entrega, Classificação (Bens or Serviços)
- Returns: Número, Objeto, Sub-status, Empresa, Abrangência, Data início, Data fim

### Read an opportunity's details and items

Opens one opportunity by its Número and reads its general fields and its table of items.

- Takes: Opportunity Número
- Returns: Objeto da Contratação, Descrição do Objeto, Status, Data de Início, Data Fim, Data de Início da Disputa, Fuso Horário, Moeda, Condição de Pagamento, items with Item, Descrição, NM, Família, Qtd, UM

### Get a concluded opportunity's ranking

Reads a tender in the Concluídas list: the Propostas in ranked order, the Lances and the Datas Relevantes from Ata e Histórico.

- Takes: Opportunity Número
- Returns: Rank, CNPJ/CPF, Fornecedor, Porte ME/EPP, Valor Global Equalizado, Lances with Valor Lance and Data/Hora Registro, Divulgação de Resultado date, Período Recursal

### Check your access fee subscription

Reads Minha Assinatura: when the Taxa de Acesso subscription for your CNPJ expires and which payment options are offered.

- Takes: Nothing
- Returns: CNPJ, subscription expiry date, payment options

## Automate Petronect with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### New Aberto para Propostas opportunities for your keywords

Starts: Every weekday at 7:00, Brasília time

1. For each keyword you name, get the open public opportunities in Aberto para Propostas.
2. Keep the opportunities that were not there on the last run.
3. For each one, read the details and items, then email you Número, Objeto, Empresa, Data fim and the items.

### Results of the tenders you follow, to your CRM

Starts: Every Monday at 8:00, Brasília time

1. For each opportunity Número on your list, get the concluded opportunity's ranking.
2. Keep the ones whose Propostas or Datas Relevantes changed since the last run.
3. Post Número, ranking with Fornecedor and Valor Global Equalizado, and Período Recursal to your CRM webhook.

### Taxa de Acesso expiry reminder

Starts: Every Monday at 9:00, Brasília time

1. Check your access fee subscription in Minha Assinatura.
2. Stop if the subscription expires more than 14 days from today.
3. Email you the CNPJ, the expiry date and the payment options offered.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get open public opportunities” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "petronect.com.br/get_open_opportunities",
    "input": {
      "keyword": "válvula",
      "abrangencia": "Nacional",
      "local_de_entrega": "RJ",
      "classificacao": "Bens"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "list": "Aberto para Propostas",
    "opportunities": [
      {
        "numero": "7009912345",
        "objeto": "Fornecimento de válvulas esfera 4 pol.",
        "sub_status": "Publicada",
        "empresa": "Acme Energia S.A.",
        "abrangencia": "Nacional",
        "data_inicio": "2026-11-10",
        "data_fim": "2026-11-28"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Petronect’s own options

Since 27 March 2025 Petronect's API Store offers APIs de Oportunidades Públicas: structured data on Petrobras public opportunities for your own systems. It is reached through Minha Petronect and needs an active Petronect registration and a paid-up Taxa de Acesso. Proposals and the rest of the process are handled in the portal.

| Option | What it covers | What it takes |
| --- | --- | --- |
| API Store (APIs de Oportunidades Públicas) | Updated data on Petrobras public opportunities, delivered in a structured format to your systems. | Active registration in Petronect and Minha Petronect, and the Taxa de Acesso paid up. No price is published. |
| Minha Petronect | A free platform for analysing Petrobras licitações, with Match Relevância and Integração de CNPJ. | A free Minha Petronect account, registered separately at minhapetronect.com.br. |
| Petronect by hand | Aberto para Propostas and Concluídas lists, opportunity details, Envio de Proposta, Acompanhamento de Proposta and Sala de Colaboração. | A Petronect user for your company. Public opportunities need the Taxa de Acesso, a monthly subscription per CNPJ paid by boleto. |

Read on November 12, 2026: [API Store launch announcement](https://www.petronect.com.br/irj/go/km/docs/pccshrcontent/Site%20Content%20(Legacy)/Portal2018/pt/Noticia_Inovacao_4.html), [Taxa de Acesso](https://www.petronect.com.br/irj/go/km/docs/pccshrcontent/Site%20Content%20(Legacy)/Portal2018/pt/taxa-de-acesso.html), [Conheça a Minha Petronect](https://www.petronect.com.br/irj/go/km/docs/pccshrcontent/Site%20Content%20(Legacy)/Portal2018/pt/conheca-minha-petronect.html).

## Signing in to Petronect

Petronect signs in users that your company adds to its account, each with a password that can be reset from the portal. Minha Petronect has its own separate account. With Fous you sign in once through Petronect's own sign-in with your own user: the login is sealed with AES-256, never returned by the API or written to logs, and an expired session is signed back in.

## Worth knowing

- **The Taxa de Acesso is per CNPJ and can lapse**: The Taxa de Acesso is charged per subscriber CNPJ as a monthly subscription paid by boleto. If the boleto is not confirmed by the expiry date, access is blocked, so a check on Minha Assinatura is worth scheduling.
- **The fee covers public opportunities only**: Petronect charges the Taxa de Acesso only for taking part in oportunidades públicas. Other processes, such as dispensa, do not require it.
- **The open list ends at the proposal deadline**: Aberto para Propostas holds only opportunities whose Data fim for proposals has not passed. Once it passes they leave the list, and finished tenders appear in Concluídas with the ranked Propostas.
- **Orders and invoices go through Ariba**: Petrobras' supplier channel points suppliers to SAP Business Network (Ariba) for purchase orders and invoices, so those records are not in Petronect's opportunity lists.

## More in Procurement

- [Basware Portal](https://fous.com/automate/basware-portal.md)
- [BtoBプラットフォーム 請求書](https://fous.com/automate/infomart-btob-platform-invoice.md)
- [Tungsten Network](https://fous.com/automate/tungsten-network.md)
- [Taulia supplier portal](https://fous.com/automate/taulia-supplier-portal.md)
- [OpenInvoice](https://fous.com/automate/openinvoice.md)
- [Tipalti Supplier Hub](https://fous.com/automate/tipalti-supplier-hub.md)
- [Coupa Supplier Portal](https://fous.com/automate/coupa-supplier-portal.md)
- [JAGGAER Supplier Network](https://fous.com/automate/jaggaer-supplier-network.md)
- [SAP Business Network](https://fous.com/automate/sap-business-network.md)
- [Oracle Fusion Cloud Supplier Portal](https://fous.com/automate/oracle-fusion-cloud-supplier-portal.md)
- [Workday supplier portal](https://fous.com/automate/workday-supplier-portal.md)
- [Nalanda](https://fous.com/automate/nalanda.md)
- [Avetta](https://fous.com/automate/avetta.md)
- [ISNetworld](https://fous.com/automate/isnetworld.md)

Other industries: [CONTPAQi](/automate/contpaqi), [Meta Business Suite and Ads Manager](/automate/meta-business-suite-and-ads-manager), [Autossimo](/automate/autossimo), [FMCDealer](/automate/fmcdealer), [The Work Number](/automate/the-work-number), [BuildingConnected](/automate/buildingconnected).

## Frequently asked questions

### Does Petronect have an API?

Yes, for public opportunities. Since 27 March 2025 the API Store offers APIs de Oportunidades Públicas through Minha Petronect, for suppliers with an active registration and a paid-up Taxa de Acesso. Proposals and the rest of the bidding process stay in the portal.

### Who has to pay the Taxa de Acesso?

Suppliers taking part in public opportunities pay it, per CNPJ, as a monthly subscription paid by boleto. The payment options are in Minha Assinatura, and processes such as dispensa do not require it.

### Can I see the results of a Petronect tender?

Yes. A concluded opportunity in Concluídas lists the Propostas in ranked order with CNPJ/CPF, Fornecedor, Porte ME/EPP and Valor Global Equalizado, plus the Lances and the Datas Relevantes such as Divulgação de Resultado Mais Recente. A method you build can read those for each Número you follow.

### Where are Petrobras purchase orders and invoices?

On SAP Business Network (Ariba). Petrobras' supplier channel sends suppliers there for purchase orders and invoices, while Petronect handles registration, opportunities and proposals.

### Is Fous affiliated with Petrobras?

No. Fous is an independent product. You use it with your own Petronect account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Petronect (Petrobras). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.