Download OpenAPI specification:
Contrato REST propuesto entre Recetron y el sistema de Farmacia Santa Catalina (MIT Group).
Esta especificación es una propuesta basada en lo que vimos del sistema y en supuestos nuestros: los nombres, formas y datos exactos quedan abiertos para que MIT los defina o corrija. El principio rector: pedimos únicamente la información que Recetron necesita para armar y enviar un presupuesto completo — leer los catálogos para referenciar por id, crear el presupuesto, y releerlo. Los precios y cálculos viven siempre del lado del sistema de MIT.
Todas las rutas van prefijadas por /v1 (ver servers).
Convenciones: referencias por id siempre; pull-only (sin callbacks);
la conversión presupuesto→receta/pedido la hace el personal a mano.
| q | string Filtro "contiene" sobre código o descripción (como la grilla de búsqueda). |
| updated_since | string <date-time> Solo registros modificados después de este instante (ISO 8601). |
| limit | integer Default: 100 |
| cursor | string |
{- "data": [
- {
- "id": "00986/010",
- "descripcion": "MAGNESIO CARBONATO PESADO X 1",
- "unidad": "mg",
- "dosis_minima": 0,
- "dosis_maxima": 0,
- "tipo": "Otros",
- "precio_costo": 0,
- "activa": true,
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_cursor": "string"
}| q | string Filtro "contiene" sobre código o descripción (como la grilla de búsqueda). |
| updated_since | string <date-time> Solo registros modificados después de este instante (ISO 8601). |
| limit | integer Default: 100 |
| cursor | string |
{- "data": [
- {
- "id": 1073,
- "descripcion": "ACIDO HIALURONICO 0.2% F.A.ESTERIL X 10CC",
- "tipo": "generica",
- "drogas": [
- {
- "droga_id": "string",
- "dosis": 0,
- "unidad": "mg"
}
], - "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_cursor": "string"
}| q | string Filtro "contiene" sobre código o descripción (como la grilla de búsqueda). |
| updated_since | string <date-time> Solo registros modificados después de este instante (ISO 8601). |
| limit | integer Default: 100 |
| cursor | string |
{- "data": [
- {
- "id": 4,
- "descripcion": "COMPRIMIDOS (HASTA DE 5 COMP) y GOMITAS 2,5 ml",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_cursor": "string"
}| q | string Filtro "contiene" sobre código o descripción (como la grilla de búsqueda). |
| updated_since | string <date-time> Solo registros modificados después de este instante (ISO 8601). |
| limit | integer Default: 100 |
| cursor | string |
{- "data": [
- {
- "id": 0,
- "nombre": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_cursor": "string"
}| q | string Filtro "contiene" sobre código o descripción (como la grilla de búsqueda). |
| updated_since | string <date-time> Solo registros modificados después de este instante (ISO 8601). |
| limit | integer Default: 100 |
| cursor | string |
{- "data": [
- {
- "id": 0,
- "nombre": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_cursor": "string"
}| q | string Filtro "contiene" sobre código o descripción (como la grilla de búsqueda). |
| updated_since | string <date-time> Solo registros modificados después de este instante (ISO 8601). |
| limit | integer Default: 100 |
| cursor | string |
{- "data": [
- {
- "id": 0,
- "nombre": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_cursor": "string"
}| Idempotency-Key required | string <uuid> UUID; repetir la misma clave devuelve el presupuesto ya creado. |
| medico_id required | integer or null Null si el médico no está en el catálogo (va en observaciones). |
| paciente_id required | integer or null Null si el cliente es nuevo (va en observaciones). |
| consultorio_id | integer Default: 1 |
| observaciones required | string Siempre comienza con "Creado vía Recetron". |
required | Array of objects non-empty |
{- "medico_id": 101,
- "paciente_id": 18003072,
- "consultorio_id": 1,
- "observaciones": "Creado vía Recetron — cliente: María Pérez",
- "lineas": [
- {
- "formula_id": 1,
- "forma_farmaceutica_id": 4,
- "cantidad_unidades": 30,
- "cantidad_frascos": 1,
- "volumen_por_unidad": 1,
- "drogas": [
- {
- "droga_id": "00986/010",
- "dosis": 200,
- "unidad": "mg",
- "droga_prescripta_id": "00986/010",
- "dosis_prescripta": 200
}
]
}
]
}{- "id": 526715,
- "numero": 28691,
- "estado": "pendiente",
- "valid_until": "2026-08-06",
- "lineas": [
- {
- "formula_id": 1,
- "descripcion": "FORMULA GENERICA 8",
- "precio": 2500,
- "insumos": [
- {
- "codigo": "1800010",
- "descripcion": "CAJAS FRASCOS",
- "cantidad": 1,
- "precio": 300
}, - {
- "codigo": "1800007",
- "descripcion": "etiquetas y tinta",
- "cantidad": 2,
- "precio": 100
}
]
}
], - "total_receta": 2500,
- "control_calidad": 0,
- "total_insumos": 500,
- "total": 3000
}| id required | integer |
{- "id": 0,
- "numero": 0,
- "estado": "pendiente",
- "valid_until": "2019-08-24",
- "lineas": [
- {
- "formula_id": 0,
- "descripcion": "string",
- "precio": 0,
- "insumos": [
- {
- "codigo": "string",
- "descripcion": "string",
- "cantidad": 0,
- "precio": 0
}
]
}
], - "total_receta": 0,
- "control_calidad": 0,
- "total_insumos": 0,
- "total": 0
}