AEC Tenders icon

AEC Tenders

Fetches public construction tenders from Brazil's PNCP

Actions4

Overview

The "AEC Tenders" node fetches public construction tender data from Brazil's National Public Procurement Portal (PNCP). Specifically, the "Tender" resource with the "List with Open Proposals" operation retrieves tenders that are currently accepting proposals. This is useful for companies and professionals in the construction and engineering sectors who want to discover active bidding opportunities in Brazil.

Typical use cases include:

  • Monitoring open public tenders by Brazilian state to identify relevant business opportunities.
  • Automating alerts or workflows based on new or ongoing tenders accepting proposals.
  • Integrating tender data into CRM or project management systems for bid tracking.

For example, a construction company could use this node to list all open tenders in São Paulo (SP) state to find projects they can bid on.

Properties

Name Meaning
State (UF) Optional Brazilian state code filter to limit results to a specific state (e.g., SP, RJ).
Return All Boolean flag indicating whether to return all available results or limit the output.
Limit Maximum number of results to return if "Return All" is false. Minimum value is 1.

Output

The node outputs an array of JSON objects representing individual tenders with open proposals. Each tender object includes detailed standardized fields such as:

  • pncpId: Unique identifier of the tender in PNCP.
  • procuringEntityName: Name of the entity issuing the tender.
  • procuringEntityCNPJ: CNPJ (Brazilian company ID) of the procuring entity.
  • tenderObject: Description of the contract object.
  • tenderModality: Type/modality of the tender.
  • tenderSituation: Current status of the tender.
  • publicationDate: Date when the tender was published.
  • proposalOpeningDate: Date when proposals will be opened.
  • estimatedTotalValue: Estimated total value of the tender in BRL.
  • Location details: municipality code and name, state code and name.
  • Legal and procedural information.
  • Links to the original portal tender page.
  • Metadata fields like risk score, urgency level, data quality assessment, and category classification.

This rich structured output enables downstream processing, filtering, and analysis of tender opportunities.

The node does not output binary data.

Dependencies

  • Requires access to the PNCP public API at https://pncp.gov.br/api/consulta.
  • Needs an internet connection to make HTTP requests.
  • No special credentials are explicitly required, but the node expects valid API access (likely via an API key or token configured in n8n credentials).
  • The node handles rate limiting and retries internally.

Troubleshooting

Common Issues

  • Invalid or missing parameters: For example, if the state code is malformed or limit is out of range.
  • API rate limits exceeded: The PNCP API enforces request limits; excessive calls may result in temporary blocking.
  • Network connectivity problems: Unable to reach the PNCP API due to internet issues.
  • Timeouts: Requests taking too long may time out, especially with large queries.

Error Messages and Resolutions

  • "Rate limit exceeded. Try again in X seconds": Wait the specified time before retrying.
  • "Invalid request parameters": Check and correct input parameters such as dates, CNPJ format, or state codes.
  • "Unauthorized access": Verify API authentication credentials are correctly set up.
  • "Tender not found with the provided parameters": Confirm the tender identifiers or filters used are accurate.
  • "Timeout in connecting to PNCP API": Reduce query size or try again later.
  • "Empty response from PNCP API": Possibly a temporary server issue; retry after some time.

Links and References

Discussion