Public Routes

Products

Searchable lookup fields:
- EAN key
- Base product name
Filterable field set:
- base__diseases=INT (Disease ID)
- base__category=INT (Category ID)
- base__pharmaceutical_company=INT (Pharma company ID)
- is_active=BOOL (True returns products that can be bought)
- has_shortage=BOOL (False returns products that are available and not in shortage)
- min_price=DOUBLE
- max_price=DOUBLE
- id__in=INTs separated by commas
- ean_key__in=EANs separated by commas
Ordering fields:
- created_at This is the default by descending order
- updated_at Last updated date
- base__name By alphabetical order of name
- price By prices

Request:
curl --request GET \\
  --url API_URL/api/products/ \\
  --header 'Accept: application/json' \\
  --header 'X-API-Key: {Client API Key}'

Response:
Status Code: 200 OK
{
"count": INT,
"next": "API_URL/api/products/?page=2",
"previous": null,
"results": [
      {
          "id": INT, // Product primary key
          "base": {
              "id": INT, // Base product primary key
              "name": STRING, // Name
              "pharmaceutical_company": {
                  "name": STRING
              },
              "category": {
                  "name": STRING
              },
              "medical_information": {
                  "active_ingredient": STRING,
									"is_generic": BOOL,
									"group_number": INT,
									"requires_prescription": BOOL,
              }
          },
          "price": DOUBLE,
          "default_image": URL,
          "is_active": BOOL,
          "has_shortage": BOOL,
          "ean_key": STRING,
          "presentation": STRING
      },
	...,
	]
}

Example response:

GET: API_URL/api/products/?limit=10&search=Vitamina%20E%20Caps

{
...,
"results":[
{
    "id": 17917,
    "base": {
        "id": 8312,
        "name": "Vitamina E 500 Sup Alim 30 Caps",
        "pharmaceutical_company": {"id": 670,"name": "NAT HEALTH"},
        "category": {"id": 270,"name": "Vitaminas y Minerales"},
        "tags": [],
        "medical_information": null
    },
    "price": "73.00",
    "default_image": IMAGE_URL,
    "is_active": true,
    "has_shortage": false,
    "ean_key": "7501853800432",
    "presentation": ""
},
{
    "id": 16030,
    "base": {
        "id": 6579,
        "name": "Vitamina E 850Mg Caps C30",
        "pharmaceutical_company": {"id": 555,"name": "PROGELA"},
        "category": {"id": 270,"name": "Vitaminas y Minerales",},
        "tags": [],
        "medical_information": null
    },
    "price": "51.00",
    "default_image": IMAGE_URL,
    "is_active": true,
    "has_shortage": false,
    "ean_key": "7503008344617",
    "presentation": ""
}]
}

Pharmaceutical Companies

Searchable lookup fields:
- name
Filterable field set:
- available True/False. If True exclude Companies without any inactive/shortage products
Ordering fields:
- updated_at This is the default by descending order
- name By alphabetical order of name

Request:
curl --request GET \\
  --url API_URL/api/pharmaceutical-companies/ \\
  --header 'Accept: application/json' \\
  --header 'X-API-Key: {Client API Key}'

Response:
Status Code: 200 OK
{
"count": INT,
"next": "API_URL/api/pharmaceutical-companies/?page=2",
"previous": null,
"results":[
{
    "id": INT, // Product primary key
    "name": STRING, // Name
},...
]

Diseases

Searchable lookup fields:
- name
Ordering fields:
- updated_at This is the default by descending order
- name By alphabetical order of name

Request:
curl --request GET \\
  --url API_URL/api/diseases/ \\
  --header 'Accept: application/json' \\
  --header 'X-API-Key: {Client API Key}'

Response:
Status Code: 200 OK
{
"count": INT,
"next": "API_URL/api/diseases/?page=2",
"previous": null,
"results":[
{
    "id": INT, // Product primary key
    "name": STRING, // Name
    "is_chronic": BOOL
},...
]

Calculate

This service calculates the purchase order totals and estimated delivery date The products and quantities are specified inside an array of DETAIL objects. Each detail has {"product": ID, "quantity":INT}. The shipping methods vary depending on the zip code, they can be seen under the array of shipping_method_options. The structure of this object is like so:

SHIPPING_METHOD
- "id" : The primary key of the object.
- "method": The type of shipping method, currently available options are: "local", "standard" and "express".
- min_delivery_days: Minimum amount of working days to deliver the order.
- max_delivery_days: Maximum amount of working days to deliver the order.

The zip code, shipping method ID, and current DateTime will be used to calculate the expected_delivery_date.

Request:
curl --request POST \\
  --url API_URL/api/orders/calculate/ \\
  --header 'Accept: application/json' \\
	--header 'Content-Type: application/json' \\
  --header 'X-API-Key: {Client API Key}'
	--data \\
		{
		"details":[{"product":INT,"quantity":INT} ...], REQUIRED
		"store": 1, OPTIONAL // To be picked up at Vitau's store.
		"zipcode": STRING, OPTIONAL // To be delivered to this zip code.
		"coupon": STRING, OPTIONAL // Coupon code
		"shipping_method": INT, OPTIONAL // Selected shipping method from the valid methods for this zip code.
		...
		}

Response:
Status Code: 201 Created
{
"subtotal": DOUBLE,
"shipping_price": DOUBLE,
"shipping_discount": DOUBLE,
"coupon": {
	"code": STRING,
	"value": DOUBLE // Between 0 and 1 is a percentage, else has a fixed value.
},
"discount":DOUBLE,
"iva":DOUBLE,
"total": DOUBLE,
"shipping_method_options":
	[{
		"id": INT,
		"company": STRING,
		"method": ENUM, [STANDARD, EXPRESS, LOCAL, DEFAULT]
		"min_delivery_days": INT,
		"max_delivery_days": INT,
		"price": DOUBLE
	}..],
"selected_shipping_method": INT, // When not included in request payload defaults to cheapest default method.
"errors": OBJECT, // Key value pairs of possible errors.
"expected_delivery_date": UTC DATETIME,
"max_delivery_date": UTC DATETIME,
"details":
	[{
    "product": INT,
    "quantity": INT,
    "subtotal": DOUBLE,
    "discount": DOUBLE,
    "iva":DOUBLE,
    "total": DOUBLE
	}...],
}

Error messages

Product does not exist

Status Code: 400 Bad Request
{
"details": [
	{"product": ["Clave primaria {INT} inválida - objeto no existe."]}
	...,
]
}

Coupon is not valid will return a 201 response but with an error object, however, it would calculate totals and deliveries excluding the desired discount.

Status Code: 201
{
"subtotal": DOUBLE,
...,
"errors": {
	"coupon": "Coupon does not exist"
},
...,
}

Documentation

Resources

Products

Example response:

Categories

Pharmaceutical Companies

Diseases

Calculate

Error messages

​Products

​Example response:

​Categories

​Pharmaceutical Companies

​Diseases

​Calculate

​Error messages

Products

Example response:

Categories

Pharmaceutical Companies

Diseases

Calculate

Error messages