Este artículo explica el flujo técnico y operativo para administrar la validación de recetas médicas en órdenes provenientes de la vertical de Pharma de Mercado Libre a través de la API de Multivende.
Introducción
Los merchants que comercializan medicamentos o productos de salud bajo condición de receta médica pueden automatizar el proceso de revisión, aprobación y rechazo de recetas mediante los servicios de integración de Multivende. A través de la API, puedes:
Consultar y descargar el archivo PDF de la receta.
Validar el documento.
Notificar la Aceptación (para continuar con la venta) o el Rechazo (lo que provocará la cancelación automática del pedido por parte de Mercado Libre).
Identificar una venta Pharma via API
Cuando un comprador realiza un pedido en Mercado Libre que incluye un producto clasificado en la categoría Pharma, en el detalle de la venta (GET Checkout) el campo tag traerá el valor pharma.
Consulta las prescripciones asociadas a una venta mediante el endpoint: Get checkout prescriptions by checkout id
O puedes obtener el listado de ventas que contienen recetas asociadas, utilizando el endpoint GET Checkout Prescriptions consultando por fecha límite de entrega al courier o fecha de última actualización del despacho.
Parámetros opcionales de Consulta (Query Params)
_decision_status: Filtra por estado de la receta (WAITING_VALIDATION,ACCEPTED,REJECTED)._checkout_id: ID interno de la venta en Multivende._external_id: ID del pedido en Mercado Libre.
Campos clave de la respuesta (entries)
_id: Identificador único de la receta/prescripción en Multivende.decisionStatus: Estado actual de la receta (WAITING_VALIDATION,ACCEPTED,REJECTED).fileStatus: Cuando el valor es"available", la receta en formato PDF está lista para ser descargada desdedownloadUrl.CheckoutItemPrescriptions: Arreglo que vincula la receta con los productos específicos (Product) del pedido.DeliveryOrder.handlingDateLimit: Fecha y hora límite para procesar y preparar la orden.
A partir del identificador de la prescripción puedes consultar el detalle de una receta mediante el endpoint: GET checkout prescription by id.
Aceptar una receta médica
Al aceptar la receta, el estado cambia a ACCEPTED y Mercado Libre avanzará el pedido a la etapa de empaque y despacho. Esta aceptación se realiza mediante el endpoint POST Accept checkout prescription
Rechazar una receta médica
Si el archivo adjunto no cumple con los requisitos legales o médicos, debes notificar el rechazo indicando la causa específica dentro del cuerpo de la petición. Mercado Libre cancelará la orden de compra automáticamente. El rechazo de la receta médica se hace mediante el endpoint POST Reject checkout prescription
{
"reason": "seller_reject_file_expired"
}
Motivos de Rechazo (reason)
| Código de Motivo (reason) | Descripción legible para el usuario |
seller_reject_file_expired |
La receta médica se encuentra vencida. |
seller_reject_file_invalid_product |
El medicamento prescrito no corresponde al producto comprado. |
seller_reject_file_quantity |
La dosis o cantidad indicada no coincide con las unidades del pedido. |
seller_reject_file_data |
Los datos del médico, firma o cédula son inválidos o incompletos. |
seller_reject_file_already_used |
La receta adjunta ya fue utilizada en una compra anterior. |
seller_reject_file_invalid |
El archivo no corresponde a una receta médica o la imagen es ilegible. |
Consideraciones Críticas e Importantes
Estado Irreversible: Una vez que una receta pasa a estado
ACCEPTEDoREJECTED, el estado no puede modificarse ni reevaluarse.Límite de Tiempo (
handlingDateLimit): La validación de la receta debe realizarse estrictamente antes de la fecha/hora límite estipulada en el campohandlingDateLimitde la orden de entrega (DeliveryOrder). Si no se procesa a tiempo, el pedido corre riesgo de ser cancelado por retraso logístico en el marketplace.Descarga del Archivo: Asegúrate de validar que
fileStatussea"available"antes de intentar consumir el enlace directo suministrado endownloadUrl.
Resumen de Endpoints y Acciones
| Paso | Endpoint / Acción |
Descripción
|
|---|---|---|
| Entrada | Venta Pharma en Mercado Libre | El comprador realiza la compra y sube la receta. |
| Consulta | Get checkout prescriptions by checkout id or Get checkout prescriptions | Obtiene la lista de recetas pendientes (WAITING_VALIDATION). |
| Revisión | downloadUrl | El farmacéutico descarga y revisa el documento PDF de la receta. |
| Aprobación | POST Accept checkout prescription | Notifica la validez de la receta para continuar con el despacho. |
| Rechazo |
POST Reject checkout prescription |
Informa el motivo de rechazo. Mercado Libre cancela la orden. |
Importante
Equipo Integraciones API Multivende
0 comentarios
El artículo está cerrado para comentarios.