How to read the catalog
- The type has the form
com.masnet.<object>.<fact>.v<major>. The object (third segment) determines the schema ofdata; the domain determines which data permission authorizes the event. - A destination subscribes by type and receives only the types of the domains the company granted to it, with the granted field groups.
- Within a major version the following are compatible: adding optional fields, event types, or values to open enumerations. An incompatible change creates
.v2, published in parallel.
Field groups
| Group | Content |
|---|---|
public | Data published by Mercado Público: codes, buyer, official dates and published amounts. |
business | Company business data: statuses, decisions, bids, contracts, purchase orders, milestones, guarantees and deadlines. Included when the domain is granted. |
confidential | Expected margins, base prices and price rules. Excluded until the administrator grants it with explicit confirmation. |
people | Owners and signers: identifier, name and email of people. Excluded until the administrator grants it with explicit confirmation. |
Never exported: free text of comments, notes, conversations, justifications and internal remarks; file contents and signed URLs; KIM data, prompts and AI answers; personal marks; drafts; secrets and credentials; telemetry and navigation.
Types by domain
bids
Domain bids. Data permission and read scope read:bids.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.bid.submitted.v1 | The bid is submitted on Mercado Público. | bid |
com.masnet.bid.withdrawn.v1 | The bid is withdrawn from the portal. | bid |
com.masnet.bid.submission_failed.v1 | Submitting a bid to the portal ends as failed or abandoned. | bid |
com.masnet.bid.portal_changed.v1 | A difference between what was submitted on the portal and what is recorded in Masnet is resolved. | bid |
awards
Domain awards. Data permission and read scope read:awards.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.award.detected.v1 | Masnet identifies a possible award to the company. | award |
com.masnet.award.confirmed.v1 | The company confirms the award with its evidence. | award |
com.masnet.award.dismissed.v1 | The company dismisses a detected award. | award |
com.masnet.award.result_published.v1 | Mercado Público publishes the result of a tender in which the company participated. | award |
contracts
Domain contracts. Data permission and read scope read:contracts.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.contract.created.v1 | A contract is recorded. | contract |
com.masnet.contract.updated.v1 | The header, dates, amounts or formalization of a contract change. | contract |
com.masnet.contract.status_changed.v1 | The status of a contract changes by any path. | contract |
com.masnet.purchase_order.linked.v1 | A purchase order is linked to a contract. | purchase_order |
com.masnet.purchase_order.unlinked.v1 | The link of a purchase order is rejected or withdrawn. | purchase_order |
com.masnet.contract.renewed.v1 | A contract is recorded as a renewal of another. | contract |
com.masnet.contract.amendment_recorded.v1 | A contract amendment is recorded. | contract |
com.masnet.contract.line_changed.v1 | An awarded line of a contract changes. | contract |
com.masnet.purchase_order.status_changed.v1 | A linked purchase order changes status on Mercado Público. | purchase_order |
com.masnet.milestone.scheduled.v1 | A contract milestone is scheduled. | milestone |
com.masnet.milestone.rescheduled.v1 | The planned date of a milestone changes. | milestone |
com.masnet.milestone.completed.v1 | A milestone is completed. | milestone |
com.masnet.milestone.due_soon.v1 | N days or fewer remain until the date of a pending milestone. Threshold configurable per destination (1, 3, 7, 15 or 30 days), 7 days by default. | milestone |
com.masnet.milestone.overdue.v1 | A pending milestone passed its planned date. | milestone |
com.masnet.contract.incident_recorded.v1 | An incident or payment claim of a contract is recorded; the free-text description is not exported. | contract |
com.masnet.contract.incident_resolved.v1 | A contract incident is resolved. | contract |
guarantees
Domain guarantees. Data permission and read scope read:guarantees.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.guarantee.created.v1 | A guarantee instrument is recorded. | guarantee |
com.masnet.guarantee.updated.v1 | The amount, issuer, dates, document number or purpose of a guarantee change. | guarantee |
com.masnet.guarantee.status_changed.v1 | The status of a guarantee changes. | guarantee |
com.masnet.guarantee.expiring.v1 | 30, 15 or 7 days remain until a valid guarantee expires. | guarantee |
com.masnet.guarantee.expiry_reached.v1 | A guarantee reaches its expiry date without return or replacement. | guarantee |
com.masnet.guarantee.reimbursement_recorded.v1 | A reimbursement or its reversal is recorded on a guarantee. | guarantee |
com.masnet.guarantee.requirement_created.v1 | The guarantee requirement of a tender is recorded. | guarantee |
opportunities
Domain opportunities. Data permission and read scope read:opportunities.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.opportunity.created.v1 | A follow-up opportunity is opened on a tender. | opportunity |
com.masnet.opportunity.stage_changed.v1 | An opportunity moves to another stage. | opportunity |
com.masnet.opportunity.decision_recorded.v1 | The decision to participate (go, no go or defer) is recorded or replaced. | opportunity |
com.masnet.opportunity.owner_changed.v1 | The owners of an opportunity change. Requires the people field group. | opportunity |
tenders
Domain tenders. Data permission and read scope read:tenders.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.tender.status_changed.v1 | A followed tender changes status on Mercado Público. | tender |
com.masnet.tender.closing_date_changed.v1 | The official closing date of a followed tender changes. | tender |
com.masnet.tender.questions_answered.v1 | New answers are published in the forum of a followed tender. | tender |
com.masnet.tender.documents_changed.v1 | The attachments or clarifications of a followed tender change (metadata only). | tender |
com.masnet.tender.match_found.v1 | An open tender matches the company catalog. The score is a relative range, not a probability. | tender |
deadlines
Domain deadlines. Data permission and read scope read:deadlines.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.deadline.scheduled.v1 | A deadline of a tender or case is scheduled. | deadline |
com.masnet.deadline.changed.v1 | A deadline changes or is cancelled. | deadline |
com.masnet.deadline.due_soon.v1 | N days or fewer remain until a scheduled deadline. Threshold configurable per destination (1, 3, 7, 15 or 30 days), 3 days by default. | deadline |
audit
Domain audit. Data permission and read scope read:audit.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.audit.integration_changed.v1 | The configuration of an integration changes: destinations, permissions, credentials or declarations. It never includes secret values. | audit |
com.masnet.audit.user_actions.v1 | Batch of actions by the company users, for monitoring systems. | audit |
com.masnet.audit.member_access_changed.v1 | A member is invited, removed, or changes role or permissions. | audit |
documents
Domain documents. Data permission and read scope read:documents.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.document.signature_requested.v1 | A document signature is requested. | document |
com.masnet.document.signature_completed.v1 | The document is signed by all required signers. | document |
com.masnet.document.signature_rejected.v1 | A signer rejects the signature of a document. | document |
catalog
Domain catalog. Data permission and read scope read:catalog.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.catalog_item.created.v1 | A product is created in the company catalog. | catalog_item |
com.masnet.catalog_item.updated.v1 | Published fields of a catalog product change; it reports the field groups that changed within the granted permission. | catalog_item |
com.masnet.catalog_item.deactivated.v1 | A catalog product is deactivated. | catalog_item |
prices
Domain prices. Data permission and read scope read:prices.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.price_rule.changed.v1 | A price rule is created, changed or deleted. | price_rule |
exports
Domain exports. Data permission and read scope read:exports.
| Type | When it is emitted | Schema |
|---|---|---|
com.masnet.export.completed.v1 | A requested export finishes. | export |
Test event
com.masnet.integration.test.v1 belongs to no domain and requires no permission. See Webhooks.
Notice thresholds
The due_soon types accept a per-destination threshold of 1, 3, 7, 15, 30 days. Defaults: milestone 7 and deadline 3.
com.masnet.opportunity.owner_changed.v1 requires the people group: without it, it is not delivered.
JSON Schemas
Each object has a JSON Schema (draft 2020-12) of the data member, published at the URL that the envelope declares in dataschema. They describe only verified fields and allow additional properties (additionalProperties: true). x-masnet-group states the field group of each property.
| Object | Schema | Events |
|---|---|---|
bid | /developers/schemas/bid/v1.json | 4 |
award | /developers/schemas/award/v1.json | 4 |
contract | /developers/schemas/contract/v1.json | 8 |
purchase_order | /developers/schemas/purchase_order/v1.json | 3 |
guarantee | /developers/schemas/guarantee/v1.json | 7 |
opportunity | /developers/schemas/opportunity/v1.json | 4 |
tender | /developers/schemas/tender/v1.json | 5 |
milestone | /developers/schemas/milestone/v1.json | 5 |
deadline | /developers/schemas/deadline/v1.json | 3 |
audit | /developers/schemas/audit/v1.json | 3 |
document | /developers/schemas/document/v1.json | 3 |
catalog_item | /developers/schemas/catalog_item/v1.json | 3 |
price_rule | /developers/schemas/price_rule/v1.json | 1 |
export | /developers/schemas/export/v1.json | 1 |
integration | /developers/schemas/integration/v1.json | 1 |
{ "dataschema": "https://masnet.com/developers/schemas/contract/v1.json" }Provenance
The catalog is generated from a versioned data file (integrations-snapshot.json) that records revision c2ca4e785df8 of api-daas. It is regenerated with node scripts/snapshot-integrations-catalog.mjs <path-to-api-daas>.