Mantén tu inventario al día en Vitrifarm

Cómo funciona

1. 1

   Solicitas acceso

   Nos escribes y habilitamos tu farmacia. Te entregamos, en privado y de forma segura, la dirección del servicio (endpoint) y tu clave de acceso (API key) personal.

2. 2

   Tu sistema envía el inventario

   El sistema de tu farmacia envía tu lista de productos (código, nombre, precio y existencia) mediante una solicitud web (POST en formato JSON).

3. 3

   Se refleja al instante

   Actualizamos precios y stock de tu farmacia de inmediato y guardamos un historial con el antes/después de cada envío.

Qué debes preparar

Tu sistema debe generar una lista de productos, donde cada producto tiene estos campos:

Además, en cada envío se incluye el farmaciaId de tu farmacia (te lo entregamos junto con tu clave).

• farmaciaIdobligatorio— Identificador de tu farmacia. Te lo entregamos nosotros; indica a cuál farmacia corresponde el envío.
• codigo (SKU)obligatorio— Código o SKU del producto. Es la llave para casar tu producto con el nuestro; debe ser estable en el tiempo.
• nombreobligatorio— Nombre del producto tal como lo manejas.
• precioobligatorio— Precio de venta en USD (ejemplo: 4.50). Usa punto decimal.
• existenciaobligatorio— Unidades disponibles en stock (número entero).
• marcaopcional— Laboratorio o marca. Puede venir vacío: nos guiamos por el SKU.
• precioCopopcional— Precio en pesos colombianos (COP), número entero. Opcional; puede venir vacío.

Opcionalmente puedes incluir replace: si lo pones en true, el envío se considera tu inventario completo y cualquier producto que no incluyas queda como sin stock. Si no lo indicas (o es false), solo se actualizan los productos que envíes.

Ejemplo del cuerpo (JSON)

Así se ve la información que enviarías. El farmaciaId, la dirección del servicio y la clave te los damos por privado.

{
  "farmaciaId": "ID_DE_TU_FARMACIA",
  "replace": false,
  "productos": [
    {
      "codigo": "7591234567890",
      "nombre": "Acetaminofén 500mg x10",
      "precio": 1.20,
      "existencia": 45,
      "marca": "Genven",
      "precioCop": 4800
    },
    {
      "codigo": "7590987654321",
      "nombre": "Ibuprofeno 400mg x10",
      "precio": 2.10,
      "existencia": 30
    }
  ]
}

Ejemplo de conexión (cURL)

Ejemplo genérico. Sustituye los valores entre < > por los que te entregamos.

# Reemplaza <ENDPOINT>, <TU_API_KEY> y <TU_FARMACIA_ID>
# por los datos que te entregamos en privado.

curl -X POST <ENDPOINT> \
  -H "Authorization: Bearer <TU_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "farmaciaId": "<TU_FARMACIA_ID>",
    "replace": false,
    "productos": [
      {
        "codigo": "7591234567890",
        "nombre": "Acetaminofén 500mg x10",
        "precio": 1.20,
        "existencia": 45,
        "marca": "Genven",
        "precioCop": 4800
      }
    ]
  }'

Respuesta exitosa

HTTP/1.1 200 OK

{
  "ok": true,
  "farmacia": "Farmacia Ejemplo",
  "recibidos": 120,      // productos que enviaste
  "aplicados": 118,      // actualizados o creados
  "productosNuevos": 3,  // SKUs nuevos que se crearon
  "omitidos": 2,         // filas sin código o sin nombre
  "retiradosSinStock": 0,// solo aplica si enviaste replace: true
  "errores": []
}

Respuestas de error

Todas devuelven un JSON con el campo error y el código HTTP correspondiente.

# 401 — falta la API key o está revocada
{ "error": "API key inválida o revocada." }

# 400 — falta el id de la farmacia
{ "error": "Falta 'farmaciaId' (el id de la farmacia que te entregamos)." }

# 400 — falta la lista de productos
{ "error": "Falta el arreglo 'productos'." }

# 403 — la key no puede actualizar esa farmacia
{ "error": "Tu API key no está autorizada para esa farmacia." }

# 404 — el farmaciaId no existe
{ "error": "Farmacia no encontrada (revisa el 'farmaciaId')." }

# 413 — demasiados productos en un envío
{ "error": "Máximo 20000 productos por envío." }

# 429 — demasiadas solicitudes seguidas
{ "error": "Demasiadas solicitudes. Reintenta en un momento." }

Requisitos técnicos

• Poder hacer una solicitud HTTP POST con cuerpo JSON desde tu sistema o servidor.
• Programar el envío automático según la frecuencia recomendada (arriba).
• Enviar como máximo 20.000 productos por envío (si tienes más, divídelo en lotes).