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

Request

Partially updates an existing Product Supplier. Only provided fields will be updated.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productSupplierIdstringrequired

Product Supplier unique identifier (UUID)

Bodyapplication/jsonrequired
contractPricestring

Contracted unit price from this supplier, as a decimal string.

Example: "100.00"
expectedPricestring

Expected unit price from this supplier, as a decimal string.

Example: "100.00"
extensionsobject

Vendor- or practice-specific extensions.

isActiveboolean

Whether this product-supplier relationship is currently active.

isDefaultSupplierboolean

Whether this supplier is the default supplier for the product.

lastSupplierUpdateAtstring or null

Timestamp of the last update received from the supplier for this product, if known.

Example: "2025-01-01T00:00:00.000Z"
listPricestring or null

Supplier list price, as a decimal string. May be null if unknown.

Example: "100.00"
productIdstring

Reference to the product associated with this supplier relationship.

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

Supplier-specific code or SKU for this product.

supplierContactIdstring

Reference to the supplier contact entity.

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

Reference to the tax rate applied to this product when supplied by this supplier.

Example: "123e4567-e89b-12d3-a456-426614174000"
unitOfMeasurestring or null

Unit of measure used by this supplier for pricing and ordering (e.g., 'box', 'vial').

unitsPerOuternumber

Number of sellable units contained in one outer/pack from this supplier.

curl -i -X PATCH \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product-supplier/{productSupplierId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contractPrice": "100.00",
    "expectedPrice": "100.00",
    "extensions": {},
    "isActive": true,
    "isDefaultSupplier": true,
    "lastSupplierUpdateAt": "2025-01-01T00:00:00.000Z",
    "listPrice": "100.00",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "supplierCode": "string",
    "supplierContactId": "123e4567-e89b-12d3-a456-426614174000",
    "taxRateId": "123e4567-e89b-12d3-a456-426614174000",
    "unitOfMeasure": "string",
    "unitsPerOuter": 0
  }'

Responses

Product Supplier updated successfully

Bodyapplication/json
contractPricestringrequired

Contracted unit price from this supplier, as a decimal string.

Example: "100.00"
createdAtstring(date-time)required

Timestamp when this product-supplier record was created.

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

Expected unit price from this supplier, as a decimal string.

Example: "100.00"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this product-supplier relationship is currently active.

isDefaultSupplierbooleanrequired

Whether this supplier is the default supplier for the product.

lastSupplierUpdateAtstring or null(date-time)required

Timestamp of the last update received from the supplier for this product, if known.

Example: "2025-01-01T00:00:00.000Z"
listPricestring or nullrequired

Supplier list price, as a decimal string. May be null if unknown.

Example: "100.00"
productIdstringrequired

Reference to the product associated with this supplier relationship.

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

Canonical identifier for this product-supplier relationship.

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

Supplier-specific code or SKU for this product.

supplierContactIdstringrequired

Reference to the supplier contact entity.

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

Reference to the tax rate applied to this product when supplied by this supplier.

Example: "123e4567-e89b-12d3-a456-426614174000"
unitOfMeasurestring or nullrequired

Unit of measure used by this supplier for pricing and ordering (e.g., 'box', 'vial').

unitsPerOuternumberrequired

Number of sellable units contained in one outer/pack from this supplier.

updatedAtstring(date-time)required

Timestamp when this product-supplier record was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "contractPrice": "100.00", "createdAt": "2025-01-01T00:00:00.000Z", "expectedPrice": "100.00", "extensions": {}, "isActive": true, "isDefaultSupplier": true, "lastSupplierUpdateAt": "2025-01-01T00:00:00.000Z", "listPrice": "100.00", "productId": "123e4567-e89b-12d3-a456-426614174000", "productSupplierId": "123e4567-e89b-12d3-a456-426614174000", "supplierCode": "string", "supplierContactId": "123e4567-e89b-12d3-a456-426614174000", "taxRateId": "123e4567-e89b-12d3-a456-426614174000", "unitOfMeasure": "string", "unitsPerOuter": 0, "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

productSupplierIdstringrequired

Product Supplier unique identifier (UUID)

Bodyapplication/jsonrequired
contractPricestringrequired

Contracted unit price from this supplier, as a decimal string.

Example: "100.00"
expectedPricestringrequired

Expected unit price from this supplier, as a decimal string.

Example: "100.00"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this product-supplier relationship is currently active.

isDefaultSupplierbooleanrequired

Whether this supplier is the default supplier for the product.

lastSupplierUpdateAtstring or null

Timestamp of the last update received from the supplier for this product, if known.

Example: "2025-01-01T00:00:00.000Z"
listPricestring or null

Supplier list price, as a decimal string. May be null if unknown.

Example: "100.00"
productIdstringrequired

Reference to the product associated with this supplier relationship.

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

Supplier-specific code or SKU for this product.

supplierContactIdstringrequired

Reference to the supplier contact entity.

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

Reference to the tax rate applied to this product when supplied by this supplier.

Example: "123e4567-e89b-12d3-a456-426614174000"
unitOfMeasurestring or null

Unit of measure used by this supplier for pricing and ordering (e.g., 'box', 'vial').

unitsPerOuternumberrequired

Number of sellable units contained in one outer/pack from this supplier.

curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/product-supplier/{productSupplierId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "contractPrice": "100.00",
    "expectedPrice": "100.00",
    "extensions": {},
    "isActive": true,
    "isDefaultSupplier": true,
    "lastSupplierUpdateAt": "2025-01-01T00:00:00.000Z",
    "listPrice": "100.00",
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "supplierCode": "string",
    "supplierContactId": "123e4567-e89b-12d3-a456-426614174000",
    "taxRateId": "123e4567-e89b-12d3-a456-426614174000",
    "unitOfMeasure": "string",
    "unitsPerOuter": 0
  }'

Responses

Product Supplier replaced successfully

Bodyapplication/json
contractPricestringrequired

Contracted unit price from this supplier, as a decimal string.

Example: "100.00"
createdAtstring(date-time)required

Timestamp when this product-supplier record was created.

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

Expected unit price from this supplier, as a decimal string.

Example: "100.00"
extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Whether this product-supplier relationship is currently active.

isDefaultSupplierbooleanrequired

Whether this supplier is the default supplier for the product.

lastSupplierUpdateAtstring or null(date-time)required

Timestamp of the last update received from the supplier for this product, if known.

Example: "2025-01-01T00:00:00.000Z"
listPricestring or nullrequired

Supplier list price, as a decimal string. May be null if unknown.

Example: "100.00"
productIdstringrequired

Reference to the product associated with this supplier relationship.

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

Canonical identifier for this product-supplier relationship.

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

Supplier-specific code or SKU for this product.

supplierContactIdstringrequired

Reference to the supplier contact entity.

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

Reference to the tax rate applied to this product when supplied by this supplier.

Example: "123e4567-e89b-12d3-a456-426614174000"
unitOfMeasurestring or nullrequired

Unit of measure used by this supplier for pricing and ordering (e.g., 'box', 'vial').

unitsPerOuternumberrequired

Number of sellable units contained in one outer/pack from this supplier.

updatedAtstring(date-time)required

Timestamp when this product-supplier record was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "contractPrice": "100.00", "createdAt": "2025-01-01T00:00:00.000Z", "expectedPrice": "100.00", "extensions": {}, "isActive": true, "isDefaultSupplier": true, "lastSupplierUpdateAt": "2025-01-01T00:00:00.000Z", "listPrice": "100.00", "productId": "123e4567-e89b-12d3-a456-426614174000", "productSupplierId": "123e4567-e89b-12d3-a456-426614174000", "supplierCode": "string", "supplierContactId": "123e4567-e89b-12d3-a456-426614174000", "taxRateId": "123e4567-e89b-12d3-a456-426614174000", "unitOfMeasure": "string", "unitsPerOuter": 0, "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Permanently deletes a Product Supplier record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

productSupplierIdstringrequired

Product Supplier unique identifier (UUID)

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

Responses

Product Supplier 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