Cómo leer el catálogo
- El tipo tiene la forma
com.masnet.<objeto>.<hecho>.v<mayor>. El objeto (tercer segmento) decide el esquema dedata; el dominio decide qué permiso de datos autoriza el evento. - Un destino se suscribe por tipo y solo recibe los de los dominios que la empresa le otorgó, con los grupos de campos otorgados.
- Son compatibles dentro de una versión mayor: agregar campos opcionales, tipos de evento o valores a enumeraciones abiertas. Un cambio incompatible crea
.v2, que se publica en paralelo.
Grupos de campos
| Grupo | Contenido |
|---|---|
public | Datos publicados por Mercado Público: códigos, organismo, fechas oficiales y montos publicados. |
business | Datos comerciales de la empresa: estados, decisiones, ofertas, contratos, órdenes de compra, hitos, garantías y plazos. Se incluye al otorgar el dominio. |
confidential | Márgenes esperados, precios base y reglas de precio. Se excluye hasta que el administrador lo otorga con confirmación explícita. |
people | Responsables y firmantes: identificador, nombre y correo de personas. Se excluye hasta que el administrador lo otorga con confirmación explícita. |
Nunca se exporta: texto libre de comentarios, notas, conversaciones, justificaciones y glosas internas; contenido de archivos y URL firmadas; datos de KIM, indicaciones y respuestas de IA; marcas personales; borradores; secretos y credenciales; telemetría y navegación.
Tipos por dominio
bids
Dominio bids. Permiso de datos y scope de lectura read:bids.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.bid.submitted.v1 | La oferta queda presentada en Mercado Público. | bid |
com.masnet.bid.withdrawn.v1 | La oferta se retira del portal. | bid |
com.masnet.bid.submission_failed.v1 | El envío de una oferta al portal termina fallido o abandonado. | bid |
com.masnet.bid.portal_changed.v1 | Se resuelve una diferencia entre lo presentado en el portal y lo registrado en Masnet. | bid |
awards
Dominio awards. Permiso de datos y scope de lectura read:awards.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.award.detected.v1 | Masnet identifica una posible adjudicación de la empresa. | award |
com.masnet.award.confirmed.v1 | La empresa confirma la adjudicación con su evidencia. | award |
com.masnet.award.dismissed.v1 | La empresa descarta una adjudicación detectada. | award |
com.masnet.award.result_published.v1 | Mercado Público publica el resultado de una licitación en la que la empresa participó. | award |
contracts
Dominio contracts. Permiso de datos y scope de lectura read:contracts.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.contract.created.v1 | Se registra un contrato. | contract |
com.masnet.contract.updated.v1 | Cambian la cabecera, las fechas, los montos o la formalización de un contrato. | contract |
com.masnet.contract.status_changed.v1 | El estado de un contrato cambia por cualquier camino. | contract |
com.masnet.purchase_order.linked.v1 | Una orden de compra queda vinculada a un contrato. | purchase_order |
com.masnet.purchase_order.unlinked.v1 | Se rechaza o se retira el vínculo de una orden de compra. | purchase_order |
com.masnet.contract.renewed.v1 | Se registra un contrato como renovación de otro. | contract |
com.masnet.contract.amendment_recorded.v1 | Se registra una modificación contractual. | contract |
com.masnet.contract.line_changed.v1 | Cambia una línea adjudicada de un contrato. | contract |
com.masnet.purchase_order.status_changed.v1 | Una orden de compra vinculada cambia de estado en Mercado Público. | purchase_order |
com.masnet.milestone.scheduled.v1 | Se programa un hito de un contrato. | milestone |
com.masnet.milestone.rescheduled.v1 | Cambia la fecha planificada de un hito. | milestone |
com.masnet.milestone.completed.v1 | Un hito se completa. | milestone |
com.masnet.milestone.due_soon.v1 | Faltan N días o menos para la fecha de un hito pendiente. Umbral configurable por destino (1, 3, 7, 15 o 30 días), 7 días por omisión. | milestone |
com.masnet.milestone.overdue.v1 | Un hito pendiente pasó su fecha planificada. | milestone |
com.masnet.contract.incident_recorded.v1 | Se registra un incidente o reclamo de pago de un contrato; la descripción libre no se exporta. | contract |
com.masnet.contract.incident_resolved.v1 | Se resuelve un incidente de un contrato. | contract |
guarantees
Dominio guarantees. Permiso de datos y scope de lectura read:guarantees.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.guarantee.created.v1 | Se registra un instrumento de garantía. | guarantee |
com.masnet.guarantee.updated.v1 | Cambian el monto, el emisor, las fechas, el número de documento o el propósito de una garantía. | guarantee |
com.masnet.guarantee.status_changed.v1 | El estado de una garantía cambia. | guarantee |
com.masnet.guarantee.expiring.v1 | Faltan 30, 15 o 7 días para el vencimiento de una garantía vigente. | guarantee |
com.masnet.guarantee.expiry_reached.v1 | Llega el vencimiento de una garantía sin devolución ni reemplazo. | guarantee |
com.masnet.guarantee.reimbursement_recorded.v1 | Se registra un reembolso o su reversa sobre una garantía. | guarantee |
com.masnet.guarantee.requirement_created.v1 | Se registra el requerimiento de garantía de una licitación. | guarantee |
opportunities
Dominio opportunities. Permiso de datos y scope de lectura read:opportunities.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.opportunity.created.v1 | Se abre una oportunidad de seguimiento sobre una licitación. | opportunity |
com.masnet.opportunity.stage_changed.v1 | Una oportunidad cambia de etapa. | opportunity |
com.masnet.opportunity.decision_recorded.v1 | Se registra o reemplaza la decisión de participar (ir, no ir o aplazar). | opportunity |
com.masnet.opportunity.owner_changed.v1 | Cambian los responsables de una oportunidad. Requiere el grupo de campos people. | opportunity |
tenders
Dominio tenders. Permiso de datos y scope de lectura read:tenders.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.tender.status_changed.v1 | Una licitación seguida cambia de estado en Mercado Público. | tender |
com.masnet.tender.closing_date_changed.v1 | Cambia la fecha de cierre oficial de una licitación seguida. | tender |
com.masnet.tender.questions_answered.v1 | Se publican respuestas nuevas en el foro de una licitación seguida. | tender |
com.masnet.tender.documents_changed.v1 | Cambian los anexos o aclaraciones de una licitación seguida (solo metadatos). | tender |
com.masnet.tender.match_found.v1 | Una licitación abierta coincide con el catálogo de la empresa. El puntaje es un rango relativo, no una probabilidad. | tender |
deadlines
Dominio deadlines. Permiso de datos y scope de lectura read:deadlines.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.deadline.scheduled.v1 | Se programa un plazo de una licitación o un caso. | deadline |
com.masnet.deadline.changed.v1 | Cambia o se cancela un plazo. | deadline |
com.masnet.deadline.due_soon.v1 | Faltan N días o menos para un plazo programado. Umbral configurable por destino (1, 3, 7, 15 o 30 días), 3 días por omisión. | deadline |
audit
Dominio audit. Permiso de datos y scope de lectura read:audit.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.audit.integration_changed.v1 | Cambia la configuración de una integración: destinos, permisos, credenciales o declaraciones. Nunca incluye valores secretos. | audit |
com.masnet.audit.user_actions.v1 | Lote de acciones de los usuarios de la empresa, para sistemas de monitoreo. | audit |
com.masnet.audit.member_access_changed.v1 | Un miembro es invitado, removido, o cambia de rol o de permisos. | audit |
documents
Dominio documents. Permiso de datos y scope de lectura read:documents.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.document.signature_requested.v1 | Se solicita la firma de un documento. | document |
com.masnet.document.signature_completed.v1 | El documento queda firmado por todos los firmantes requeridos. | document |
com.masnet.document.signature_rejected.v1 | Un firmante rechaza la firma de un documento. | document |
catalog
Dominio catalog. Permiso de datos y scope de lectura read:catalog.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.catalog_item.created.v1 | Se crea un producto del catálogo de la empresa. | catalog_item |
com.masnet.catalog_item.updated.v1 | Cambian campos publicados de un producto del catálogo; informa los grupos de campos que cambiaron dentro del permiso otorgado. | catalog_item |
com.masnet.catalog_item.deactivated.v1 | Un producto del catálogo se desactiva. | catalog_item |
prices
Dominio prices. Permiso de datos y scope de lectura read:prices.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.price_rule.changed.v1 | Se crea, cambia o elimina una regla de precio. | price_rule |
exports
Dominio exports. Permiso de datos y scope de lectura read:exports.
| Tipo | Cuándo se emite | Esquema |
|---|---|---|
com.masnet.export.completed.v1 | Termina una exportación solicitada. | export |
Evento de prueba
com.masnet.integration.test.v1 no pertenece a ningún dominio ni requiere permiso. Véase Webhooks.
Umbrales de aviso
Los tipos due_soon admiten un umbral por destino de 1, 3, 7, 15, 30 días. Valores por omisión: milestone 7 y deadline 3.
com.masnet.opportunity.owner_changed.v1 requiere el grupo people: sin él no se entrega.
Esquemas JSON
Cada objeto tiene un esquema JSON (borrador 2020-12) del miembro data, publicado en la URL que el envoltorio declara en dataschema. Solo describen campos verificados y admiten propiedades adicionales (additionalProperties: true). x-masnet-group indica el grupo de campos de cada propiedad.
| Objeto | Esquema | Eventos |
|---|---|---|
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" }Procedencia
El catálogo se genera desde un archivo de datos versionado (integrations-snapshot.json) que registra la revisión c2ca4e785df8 de api-daas. Se regenera con node scripts/snapshot-integrations-catalog.mjs <ruta-de-api-daas>.