Listar Recetas

Consulta recetas registradas por filtros temporales y por profesional o paciente.

Endpoint GET /v1/recetas/listar

Soporta paginación y filtros. Requiere autenticación.

Parámetros (query)

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
fecha_desde	string (ISO 8601)	Sí	"2025-08-01T00:00:00-03:00"	Fecha/hora desde.
fecha_hasta	string (ISO 8601)	Sí	"2025-08-31T23:59:59-03:00"	Fecha/hora hasta.
matricula	string	—	"43822"	Matrícula del profesional (opcional).
documento	string	—	"32123456"	Documento del paciente (opcional).
page	integer	—	1	Página (1-based).
per_page	integer	—	50	Elementos por página (máx. 200).

Ejemplo - curl

curl -G "https://api.asystir.com/v1/recetas/listar" \
  -H "X-API-Key: TU_API_KEY" \
  -H "X-API-Secret: TU_API_SECRET" \
  --data-urlencode "fecha_desde=2025-08-01T00:00:00-03:00" \
  --data-urlencode "fecha_hasta=2025-08-31T23:59:59-03:00" \
  --data-urlencode "matricula=43822" \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=50"

Ejemplo - JavaScript (fetch)

const params = new URLSearchParams({
  fecha_desde: "2025-08-01T00:00:00-03:00",
  fecha_hasta: "2025-08-31T23:59:59-03:00",
  matricula: "43822",
  page: "1",
  per_page: "50"
});
const r = await fetch(`https://api.asystir.com/v1/recetas/listar?${params}`, {
  headers: { "X-API-Key": "TU_API_KEY", "X-API-Secret": "TU_API_SECRET" }
});
console.log(await r.json());

Ejemplo - Visual Basic .NET

Dim client As New HttpClient()
client.DefaultRequestHeaders.Add("X-API-Key", "TU_API_KEY")
client.DefaultRequestHeaders.Add("X-API-Secret", "TU_API_SECRET")
Dim url = "https://api.asystir.com/v1/recetas/listar?fecha_desde=2025-08-01T00:00:00-03:00&fecha_hasta=2025-08-31T23:59:59-03:00&matricula=43822&page=1&per_page=50"
Dim resp = Await client.GetAsync(url)
Console.WriteLine(Await resp.Content.ReadAsStringAsync())

Respuesta de éxito (200)

{
  "success": true,
  "data": {
    "total": 2,
    "page": 1,
    "per_page": 50,
    "items": [
      {
        "id_transaccion": "D846FFE8284155D-000000000000007E",
        "id_de_receta": "REC-2025-0001",
        "cuir": "102500420201010000123456789012345678901",
        "fecha_creacion": "2025-08-21T14:30:00-03:00",
        "matricula_profesional": "43822",
        "documento_paciente": "32123456",
        "estado": "COMPLETED"
      },
      {
        "id_transaccion": "B823992F03ED2DE-000000000000004F",
        "id_de_receta": "REC-2025-0002",
        "cuir": "102500420201010000123456789012345678902",
        "fecha_creacion": "2025-08-28T09:10:00-03:00",
        "matricula_profesional": "43822",
        "documento_paciente": "40123456",
        "estado": "PENDING"
      }
    ]
  }
}

Errores comunes

• 400 Bad Request — fecha_desde/fecha_hasta inválidas o invertidas.
• 401/403 — Autorización.
• 500 — Error interno.

Notas

• Las respuestas contienen campos resumidos; utilice GET /v1/recetas/{id_transaccion} (si se implementa) para detalle completo.
• Soportamos filtros por estado (estado=COMPLETED|PENDING|FAILED) si requiere.

---