Skip to content

AHDS Store API (1.0)

Animal Health Data Store - V1 API Documentation

Overview
Languages
Servers
Mock server

https://docs.heydonto.com/_mock/apis/animal-health/openapi/

Local Development

http://localhost:8083/

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

Fully replaces an existing Product. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productIdstringrequired

Product unique identifier (UUID)

Bodyapplication/jsonrequired
codestringrequired

Practice-specific product code or SKU.

concentrationnumberrequired

Concentration value of the product (e.g., 50 for 50 mg/mL).

concentrationDilutednumberrequired

Concentration value after dilution, if applicable.

concentrationDilutedUnitstringrequired

Unit of measure for the diluted concentration numerator.

concentrationDilutedVolumestringrequired

Volume unit for the diluted concentration denominator.

concentrationUnitstringrequired

Unit of measure for the concentration numerator (e.g., mg).

concentrationVolumestringrequired

Volume unit for the concentration denominator (e.g., mL).

defaultDosageCalculationMethodstringrequired

Default method used to calculate dosage (e.g., perKg, perAnimal).

defaultInfusionRatePerstringrequired

Default infusion rate basis (e.g., perHour, perDay).

defaultRouteOfAdministrationstringrequired

Default route of administration (e.g., oral, IV, IM).

descriptionstringrequired

Detailed description of the product.

extensionsobjectrequired

Vendor- or practice-specific extensions.

hasCostPricebooleanrequired

Whether the product has a direct cost price configured.

isActivebooleanrequired

Whether the product is active and available for use.

isConstantRateInfusionbooleanrequired

Whether the product is typically administered as a constant rate infusion.

isContainerbooleanrequired

Whether the product is a container for other products.

isDerivedPricebooleanrequired

Whether the product price is derived from other configuration.

isPurchasedbooleanrequired

Whether the product can be purchased from suppliers.

isSoldbooleanrequired

Whether the product can be sold to clients.

lowestDispensableQuantitynumberrequired

Smallest quantity that can be dispensed.

lowestDispensableUnitstringrequired

Unit for the lowest dispensable quantity (e.g., tablet, mL).

namestringrequired

Human-readable product name.

productGroupIdstringrequired

Identifier of the product group/category this product belongs to.

Example: "123e4567-e89b-12d3-a456-426614174000"
productTypestringrequired

Type/category of product.

Enum"standard""medication""vaccination""diagnostic""integratedDiagnostic""procedure"
sheetGroupIdstringrequired

Identifier of the sheet/group this product belongs to.

Example: "123e4567-e89b-12d3-a456-426614174000"
sheetGroupNamestringrequired

Human-readable name of the sheet/group.

stockLevelobjectrequired

Aggregated stock level information for this product.

trackingLevelstringrequired

Inventory tracking level for this product.

Enum"none""product""batch"
warningstringrequired

Warning or caution text associated with the product.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product/{productId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "string",
    "concentration": 0,
    "concentrationDiluted": 0,
    "concentrationDilutedUnit": "string",
    "concentrationDilutedVolume": "string",
    "concentrationUnit": "string",
    "concentrationVolume": "string",
    "defaultDosageCalculationMethod": "string",
    "defaultInfusionRatePer": "string",
    "defaultRouteOfAdministration": "string",
    "description": "string",
    "extensions": {},
    "hasCostPrice": true,
    "isActive": true,
    "isConstantRateInfusion": true,
    "isContainer": true,
    "isDerivedPrice": true,
    "isPurchased": true,
    "isSold": true,
    "lowestDispensableQuantity": 0,
    "lowestDispensableUnit": "string",
    "name": "string",
    "productGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "productType": "standard",
    "sheetGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "sheetGroupName": "string",
    "stockLevel": {},
    "trackingLevel": "none",
    "warning": "string"
  }'

Responses

Product replaced successfully

Bodyapplication/json
codestringrequired

Practice-specific product code or SKU.

concentrationnumberrequired

Concentration value of the product (e.g., 50 for 50 mg/mL).

concentrationDilutednumberrequired

Concentration value after dilution, if applicable.

concentrationDilutedUnitstringrequired

Unit of measure for the diluted concentration numerator.

concentrationDilutedVolumestringrequired

Volume unit for the diluted concentration denominator.

concentrationUnitstringrequired

Unit of measure for the concentration numerator (e.g., mg).

concentrationVolumestringrequired

Volume unit for the concentration denominator (e.g., mL).

createdAtstring(date-time)required

Timestamp when the product was created.

Example: "2025-01-01T00:00:00.000Z"
defaultDosageCalculationMethodstringrequired

Default method used to calculate dosage (e.g., perKg, perAnimal).

defaultInfusionRatePerstringrequired

Default infusion rate basis (e.g., perHour, perDay).

defaultRouteOfAdministrationstringrequired

Default route of administration (e.g., oral, IV, IM).

descriptionstringrequired

Detailed description of the product.

extensionsobjectrequired

Vendor- or practice-specific extensions.

hasCostPricebooleanrequired

Whether the product has a direct cost price configured.

isActivebooleanrequired

Whether the product is active and available for use.

isConstantRateInfusionbooleanrequired

Whether the product is typically administered as a constant rate infusion.

isContainerbooleanrequired

Whether the product is a container for other products.

isDerivedPricebooleanrequired

Whether the product price is derived from other configuration.

isPurchasedbooleanrequired

Whether the product can be purchased from suppliers.

isSoldbooleanrequired

Whether the product can be sold to clients.

lowestDispensableQuantitynumberrequired

Smallest quantity that can be dispensed.

lowestDispensableUnitstringrequired

Unit for the lowest dispensable quantity (e.g., tablet, mL).

namestringrequired

Human-readable product name.

productGroupIdstringrequired

Identifier of the product group/category this product belongs to.

Example: "123e4567-e89b-12d3-a456-426614174000"
productIdstringrequired

Canonical stable identifier for the product.

Example: "123e4567-e89b-12d3-a456-426614174000"
productTypestringrequired

Type/category of product.

Enum"standard""medication""vaccination""diagnostic""integratedDiagnostic""procedure"
sheetGroupIdstringrequired

Identifier of the sheet/group this product belongs to.

Example: "123e4567-e89b-12d3-a456-426614174000"
sheetGroupNamestringrequired

Human-readable name of the sheet/group.

stockLevelobjectrequired

Aggregated stock level information for this product.

trackingLevelstringrequired

Inventory tracking level for this product.

Enum"none""product""batch"
updatedAtstring(date-time)required

Timestamp when the product was last modified.

Example: "2025-01-01T00:00:00.000Z"
warningstringrequired

Warning or caution text associated with the product.

Response
application/json
{ "code": "string", "concentration": 0, "concentrationDiluted": 0, "concentrationDilutedUnit": "string", "concentrationDilutedVolume": "string", "concentrationUnit": "string", "concentrationVolume": "string", "createdAt": "2025-01-01T00:00:00.000Z", "defaultDosageCalculationMethod": "string", "defaultInfusionRatePer": "string", "defaultRouteOfAdministration": "string", "description": "string", "extensions": {}, "hasCostPrice": true, "isActive": true, "isConstantRateInfusion": true, "isContainer": true, "isDerivedPrice": true, "isPurchased": true, "isSold": true, "lowestDispensableQuantity": 0, "lowestDispensableUnit": "string", "name": "string", "productGroupId": "123e4567-e89b-12d3-a456-426614174000", "productId": "123e4567-e89b-12d3-a456-426614174000", "productType": "standard", "sheetGroupId": "123e4567-e89b-12d3-a456-426614174000", "sheetGroupName": "string", "stockLevel": {}, "trackingLevel": "none", "updatedAt": "2025-01-01T00:00:00.000Z", "warning": "string" }

Request

Permanently deletes a Product record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productIdstringrequired

Product unique identifier (UUID)

curl -i -X DELETE \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product/{productId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Product deleted successfully

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations