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
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

suppliedIdstringrequired

Supplied unique identifier (UUID)

Bodyapplication/jsonrequired
batchNumberstringrequired

Batch or lot number associated with the supplied product.

clientProvidedIdstringrequired

Optional client-supplied identifier for this supplied record.

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

Expiry date of the supplied batch, if applicable.

Example: "2025-01-01"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether this supplied record is active (not fully reversed or deleted).

locationIdstringrequired

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

productIdstringrequired

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobjectrequired
quantity.​valuenumberrequired

Numeric value

quantity.​unitstringrequired

Unit of measure

quantity.​systemstring

Unit system URI

referenceNumberstringrequired

External reference such as supplier invoice number or delivery note.

suppliedAtstringrequired

Date and time when the product was supplied/received into inventory.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobjectrequired

Cost per unit of the supplied product.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/supplied/{suppliedId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "batchNumber": "string",
    "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000",
    "expiryDate": "2025-01-01",
    "extensions": {},
    "isActive": true,
    "locationId": "123e4567-e89b-12d3-a456-426614174000",
    "notes": "string",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "quantity": {
      "value": 0,
      "unit": "string",
      "system": "string"
    },
    "referenceNumber": "string",
    "suppliedAt": "2025-01-01T00:00:00.000Z",
    "supplierId": "123e4567-e89b-12d3-a456-426614174000",
    "totalCost": {},
    "unitCost": {}
  }'

Responses

Supplied replaced successfully

Bodyapplication/json
batchNumberstringrequired

Batch or lot number associated with the supplied product.

clientProvidedIdstringrequired

Optional client-supplied identifier for this supplied record.

Example: "123e4567-e89b-12d3-a456-426614174000"
createdAtstring(date-time)required

Timestamp when this record was created in the source system.

Example: "2025-01-01T00:00:00.000Z"
expiryDatestring(date-time)required

Expiry date of the supplied batch, if applicable.

Example: "2025-01-01T00:00:00Z"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether this supplied record is active (not fully reversed or deleted).

locationIdstringrequired

Inventory location or store where the product was supplied.

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

Free-text notes about this supplied record.

productIdstringrequired

Reference to the product that was supplied.

Example: "123e4567-e89b-12d3-a456-426614174000"
quantityobjectrequired
quantity.​valuenumberrequired

Numeric value

quantity.​unitstringrequired

Unit of measure

quantity.​systemstring

Unit system URI

referenceNumberstringrequired

External reference such as supplier invoice number or delivery note.

suppliedAtstring(date-time)required

Date and time when the product was supplied/received into inventory.

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

Canonical identifier for this supplied inventory record.

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

Reference to the supplier providing the product.

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

Total cost for this supplied line (quantity × unitCost).

unitCostobjectrequired

Cost per unit of the supplied product.

updatedAtstring(date-time)required

Timestamp when this record was last updated in the source system.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "batchNumber": "string", "clientProvidedId": "123e4567-e89b-12d3-a456-426614174000", "createdAt": "2025-01-01T00:00:00.000Z", "expiryDate": "2025-01-01T00:00:00Z", "extensions": {}, "isActive": true, "locationId": "123e4567-e89b-12d3-a456-426614174000", "notes": "string", "productId": "123e4567-e89b-12d3-a456-426614174000", "quantity": { "value": 0, "unit": "string", "system": "string" }, "referenceNumber": "string", "suppliedAt": "2025-01-01T00:00:00.000Z", "suppliedId": "123e4567-e89b-12d3-a456-426614174000", "supplierId": "123e4567-e89b-12d3-a456-426614174000", "totalCost": {}, "unitCost": {}, "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Permanently deletes a Supplied record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

suppliedIdstringrequired

Supplied unique identifier (UUID)

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

Responses

Supplied 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