Recorrido
- Masnet entrega el evento
com.masnet.price_request.requested.v1al destino del canal, o lo deja en el registro de eventos si el canal no tiene webhook. - El sistema responde 2xx al webhook y procesa la solicitud de forma asíncrona.
- Si
truncatedincluyelines, lee todas las líneas conGET …/price-requests/{id}/lines. - Cotiza y envía una sola respuesta con
POST …/price-requests/{id}/responseantes derespond_by. - Masnet aplica cada línea en una sola transacción y devuelve el resultado por línea. La solicitud queda
appliedaunque alguna línea tenga problemas.
Requisitos
- Una integración de producción de la empresa designada como canal de solicitudes de precios. Solo una integración por empresa puede serlo; la designación y el retiro exigen segundo factor y quedan auditados. Una integración de ambiente
testno puede ser canal, pero sí recibe la solicitud de prueba. - La designación otorga el dominio
price_requests: el cliente de API usaread:price_requestspara leer ywrite:price_requestspara responder.read:price_requestsincluye los productos y precios vigentes de las líneas de la oferta. - El destino del canal queda suscrito al tipo
com.masnet.price_request.requested.v1. Sin destino, el sistema lee el evento del registro de eventos conread:events. - El cliente se autentica como en el resto de la API de datos; base:
https://daas.masnet.com/api/v1/integrations.
El evento llega firmado como cualquier webhook de Masnet. Verifique la firma antes de interpretar el cuerpo: Node.js, Python, Java o C#.
El evento
data.object es un objeto price-request.v1: la licitación, la oferta, el plazo y hasta 200 líneas. Cada línea trae su line_key, la descripción y la cantidad del comprador, y el producto y el precio que la oferta tiene hoy.
{
"specversion": "1.0",
"id": "evt_01JD3K8W5F2Q9X7M4N6P8R0T2V",
"type": "com.masnet.price_request.requested.v1",
"subject": "price_request/0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10",
"dataschema": "https://masnet.com/developers/schemas/price_request/v1.json",
"data": {
"object": {
"contract_version": "price-request.v1",
"id": "0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10",
"status": "requested",
"requested_at": "2026-11-17T14:02:11Z",
"respond_by": "2026-11-17T14:32:11Z",
"requested_by": {
"id": "5d1e9a3c-2b7f-4c6d-8e0a-1f2b3c4d5e6f"
},
"tender": {
"code": "1075963-358-LP26",
"purchase_channel": "LP",
"title": "Adquisición de medicamentos oncológicos",
"status": "published",
"buyer": {
"code": "7248",
"name": "Hospital Regional",
"rut": "61.608.000-0"
}
},
"bid": {
"id": "9f8e7d6c-5b4a-4321-8fed-cba987654321",
"name": "Oferta principal",
"kind": "principal",
"currency": "CLP"
},
"lines_total": 3,
"lines": [
{
"line_key": "a3f1c0de5b7e4f2a9c1d8e6b4a2f0c19",
"item_number": 1,
"tender_item_id": "8812345",
"buyer": {
"description": "Afatinib 40 mg comprimido",
"quantity": "120",
"unit": "Unidad"
},
"offer": {
"status": "offered",
"product": {
"catalog_item_id": "90211",
"internal_code": "AF-40",
"name": "Afatinib 40 mg x 30"
},
"unit_price": {
"value": "15400.00",
"currency": "CLP"
},
"price_requested": true
}
},
{
"line_key": "b9c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0",
"item_number": 2,
"tender_item_id": "8812346",
"buyer": {
"description": "Ondansetrón 8 mg comprimido",
"quantity": "600",
"unit": "Unidad"
},
"offer": {
"status": "not_started",
"product": null,
"unit_price": null,
"price_requested": true
}
},
{
"line_key": "c004e1f2a3b4c5d6e7f8091a2b3c4d5e",
"item_number": 3,
"tender_item_id": "8812347",
"buyer": {
"description": "Filgrastim 300 mcg jeringa prellenada",
"quantity": "40",
"unit": "Unidad"
},
"offer": {
"status": "offered",
"product": {
"catalog_item_id": "90377",
"internal_code": "FG-300",
"name": "Filgrastim 300 mcg"
},
"unit_price": null,
"price_requested": true
}
}
],
"truncated": [],
"links": {
"self": "https://daas.masnet.com/api/v1/integrations/data/price-requests/0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10",
"lines": "https://daas.masnet.com/api/v1/integrations/data/price-requests/0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10/lines",
"response": "https://daas.masnet.com/api/v1/integrations/data/price-requests/0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10/response"
}
},
"previous": null,
"changed_fields": [],
"actor": {
"type": "user"
},
"evidence": "masnet_record"
}
}line_keyidentifica la línea de la oferta y es la clave que la respuesta debe devolver.offer.price_requestedindica si la línea pide precio. Una línea sin producto viaja como contexto: el sistema puede proponer producto y precio.respond_byes el plazo de la respuesta. Los reintentos de entrega del evento también terminan en esa hora, no a las 72 horas de los demás eventos.webhook-idse conserva en los reintentos; descarte los repetidos con 2xx. La misma solicitud no se vuelve a emitir.
Leer todas las líneas
Si la solicitud tiene más de 200 líneas, truncated incluye lines y el evento trae solo las primeras. Lea la lista completa por páginas de hasta 500 líneas, en orden de item_number; next_cursor es opaco y vale null en la última página.
GET /api/v1/integrations/data/price-requests/0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10/lines?limit=500 HTTP/1.1
Host: daas.masnet.com
Authorization: Bearer <token con read:price_requests>
HTTP/1.1 200 OK
{ "lines": [ … ], "next_cursor": "500:a3f1c0de5b7e4f2a9c1d8e6b4a2f0c19" }GET …/price-requests/{id} devuelve el mismo objeto con su estado vigente y, si ya se aplicó, el resumen y los resultados por línea. Una solicitud de otra integración o de otra empresa responde 404.
Responder
POST /api/v1/integrations/data/price-requests/0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10/response HTTP/1.1
Host: daas.masnet.com
Authorization: Bearer <token con write:price_requests>
Content-Type: application/json
Idempotency-Key: COT-2026-00123-1
{
"contract_version": "price-response.v1",
"erp_reference": "COT-2026-00123",
"currency": "CLP",
"lines": [
{
"line_key": "a3f1c0de5b7e4f2a9c1d8e6b4a2f0c19",
"result": "priced",
"product": {
"internal_code": "AF-40"
},
"unit_price": "15100.00"
},
{
"line_key": "b9c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0",
"result": "priced",
"product": {
"internal_code": "ON-08"
},
"unit_price": "820.00",
"note": "Precio con stock en Santiago"
},
{
"line_key": "c004e1f2a3b4c5d6e7f8091a2b3c4d5e",
"result": "unavailable",
"note": "Sin stock"
}
]
}resultespriced(conproductyunit_price) ounavailable(con unanoteopcional). Un sistema que no puede cotizar responde todas las líneasunavailable; no hay otro camino de rechazo.productlleva exactamente una de las clavescatalog_item_id,internal_codeoexternal_id.external_idsolo vale si la integración canal tiene fuente de catálogo. Toda clave debe coincidir con un solo producto activo del catálogo de la empresa.unit_pricees un decimal en texto, positivo, con hasta 14 enteros y 4 decimales. Nada se redondea.currencydebe ser la moneda de la oferta.notees texto plano de hasta 500 caracteres. La respuesta admite hasta 2000 líneas, cadaline_keyuna sola vez, y un cuerpo de 4 MiB como máximo.Idempotency-Keyes obligatorio: de 1 a 255 caracteres ASCII visibles. Use la misma clave al reintentar la misma respuesta.- La cantidad es la del comprador y la respuesta no la cambia; tampoco reactiva una línea en "No ofertar".
Resultado por línea
La respuesta aceptada devuelve 200 con el resumen y el resultado de cada línea:
{
"price_request_id": "0b7d5c2e-6f1a-4c4e-9a37-1f8f3c2d9e10",
"status": "applied",
"replayed": false,
"summary": {
"total": 3,
"by_result": {
"price_set": 1,
"product_added": 1,
"no_price": 1
}
},
"lines": [
{
"line_key": "a3f1c0de5b7e4f2a9c1d8e6b4a2f0c19",
"line_number": 1,
"result": "price_set"
},
{
"line_key": "b9c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0",
"line_number": 2,
"result": "product_added"
},
{
"line_key": "c004e1f2a3b4c5d6e7f8091a2b3c4d5e",
"line_number": 3,
"result": "no_price"
}
],
"rejected_lines": []
}result | Cuándo | Qué cambia en la oferta |
|---|---|---|
price_set | Mismo producto, precio nuevo | El precio, con procedencia del ERP |
product_added | Línea sin producto; el sistema trae producto y precio | Producto y precio |
product_replaced | Producto distinto del que tenía la línea | Producto y precio |
unchanged | Mismo producto y mismo precio | Nada |
no_price | result: unavailable | Nada; la oferta muestra la nota |
not_returned | Línea pedida que la respuesta no trae | Nada |
invalid | Precio que no cumple el formato o moneda distinta de la oferta | Nada |
product_unknown | Clave sin producto activo, o external_id sin fuente de catálogo | Nada |
product_ambiguous | La clave coincide con más de un producto activo | Nada |
line_fixed | El campo está fijado por aprobación | Nada |
line_changed | La línea cambió desde que se envió la solicitud | Nada; la oferta muestra la propuesta |
line_not_offered | La línea está en "No ofertar" | Nada; la oferta muestra la propuesta |
rejected_unknown_line | El line_key no es de la solicitud | Nada |
Plazo, reintentos y errores
| Respuesta | Cuándo | Qué hacer |
|---|---|---|
200 con replayed: true | Repetición del mismo contenido ya aplicado (cabecera Idempotent-Replayed: true) | Nada: es el resultado guardado, sin volver a aplicar |
503 con Retry-After | La transacción no terminó; nada quedó aplicado | Reintentar con la misma Idempotency-Key y el mismo cuerpo |
| PRICE_RESPONSE_INVALID (400) | El cuerpo no cumple price-response.v1; issues indica dónde | Corregir el cuerpo |
| idempotency_key_required (400) | Falta Idempotency-Key o no cumple su formato | Enviar la cabecera |
| PRICE_REQUEST_NOT_AWAITING (409) | La solicitud se canceló o su entrega falló | No reintentar |
| PRICE_REQUEST_EXPIRED (409) | Venció respond_by | No reintentar; la persona puede pedir de nuevo |
| PRICE_RESPONSE_CONFLICT (409) | Ya se aplicó otra respuesta con otro contenido | No reintentar: gana la primera aceptada |
{
"type": "https://masnet.com/developers/errors/PRICE_REQUEST_EXPIRED",
"title": "Plazo vencido",
"status": 409,
"detail": "Venció el plazo de respuesta de la solicitud (respond_by).",
"code": "PRICE_REQUEST_EXPIRED",
"correlation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}Las respuestas de error usan RFC 9457, como el resto de la API; el catálogo completo está en Errores. Mientras la solicitud está abierta, las líneas pedidas quedan bloqueadas en la oferta; al vencer, cancelarse o responderse se liberan.
Solicitud de prueba
La prueba del destino envía una solicitud de contenido fijo con un id test_… de 32 dígitos hexadecimales. No nace de una oferta ni bloquea líneas. El sistema la lee y la responde por las mismas rutas.
- La respuesta devuelve 200 con
status: validatedytest: true: el resultado de cada línea según las reglas anteriores, con las claves de producto buscadas en el catálogo de la empresa en solo lectura. Nada se aplica. - Se puede responder durante 30 minutos, más 5 de gracia; después responde
PRICE_REQUEST_EXPIRED. - Vale para integraciones de producción y de prueba, sean o no canal.
Esquemas
- price-request.v1: el objeto de la solicitud, en el evento y en la lectura.
- price-response.v1: el cuerpo de la respuesta y el resultado aplicado (
$defs/applied). - El
dataschemadel evento es price_request, que describedata. Los dos esquemas son copia byte a byte de los que valida Masnet.