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

Request

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

Security
bearer
Path
siteIdnumberrequired

Site identifier

paymentIdstringrequired

Payment unique identifier (UUID)

Bodyapplication/jsonrequired
allocatedAmountstringrequired

Total amount of the payment that has been allocated to invoices.

Example: "100.00"
amountstringrequired

Total payment amount as a decimal string.

Example: "100.00"
availableAmountstringrequired

Unallocated portion of the payment that is still available.

Example: "100.00"
cashAmountstringrequired

Portion of the payment that was paid in cash, if applicable.

Example: "100.00"
cashChangestringrequired

Change returned to the client for cash payments, if applicable.

Example: "100.00"
clientIdstringrequired

Identifier of the client associated with this payment.

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

Internal comments or notes about the payment.

currencystringrequired

ISO 4217 currency code for the payment amount.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether the payment record is active.

linkedInvoicesArray of objects(LinkedInvoiceDto)required

Invoices to which this payment has been allocated.

linkedInvoices[].​allocatedAmountstringrequired

Amount of this payment allocated to the invoice.

Example: "100.00"
linkedInvoices[].​invoiceIdstringrequired

Identifier of the linked invoice.

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

Identifier for the owning organization or practice.

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

Calendar date the payment was received or processed.

Example: "2025-01-01"
paymentDetailsstringrequired

Free-text or structured details about the payment method (e.g., last 4 digits, reference number).

paymentMethodstringrequired

Method used to make the payment.

Enum"cash""card""check""bank_transfer""online""other"
roundingFactorstringrequired

Rounding adjustment applied to the payment, if any.

Example: "100.00"
statusstringrequired

Lifecycle status of the payment.

Enum"pending""completed""cancelled""refunded""failed"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/payment/{paymentId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "allocatedAmount": "100.00",
    "amount": "100.00",
    "availableAmount": "100.00",
    "cashAmount": "100.00",
    "cashChange": "100.00",
    "clientId": "123e4567-e89b-12d3-a456-426614174000",
    "comments": "string",
    "currency": "string",
    "extensions": {},
    "isActive": true,
    "linkedInvoices": [
      {
        "allocatedAmount": "100.00",
        "invoiceId": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "ownershipId": "123e4567-e89b-12d3-a456-426614174000",
    "paymentDate": "2025-01-01",
    "paymentDetails": "string",
    "paymentMethod": "cash",
    "roundingFactor": "100.00",
    "status": "pending"
  }'

Responses

Payment replaced successfully

Bodyapplication/json
allocatedAmountstringrequired

Total amount of the payment that has been allocated to invoices.

Example: "100.00"
amountstringrequired

Total payment amount as a decimal string.

Example: "100.00"
availableAmountstringrequired

Unallocated portion of the payment that is still available.

Example: "100.00"
cashAmountstringrequired

Portion of the payment that was paid in cash, if applicable.

Example: "100.00"
cashChangestringrequired

Change returned to the client for cash payments, if applicable.

Example: "100.00"
clientIdstringrequired

Identifier of the client associated with this payment.

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

Internal comments or notes about the payment.

createdAtstring(date-time)required

Timestamp when the payment record was created.

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

ISO 4217 currency code for the payment amount.

extensionsobjectrequired

Vendor- or practice-specific extensions.

isActivebooleanrequired

Indicates whether the payment record is active.

linkedInvoicesArray of objects(LinkedInvoiceDto)required

Invoices to which this payment has been allocated.

linkedInvoices[].​allocatedAmountstringrequired

Amount of this payment allocated to the invoice.

Example: "100.00"
linkedInvoices[].​invoiceIdstringrequired

Identifier of the linked invoice.

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

Identifier for the owning organization or practice.

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

Calendar date the payment was received or processed.

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

Free-text or structured details about the payment method (e.g., last 4 digits, reference number).

paymentIdstringrequired

Canonical unique identifier for the payment.

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

Method used to make the payment.

Enum"cash""card""check""bank_transfer""online""other"
roundingFactorstringrequired

Rounding adjustment applied to the payment, if any.

Example: "100.00"
statusstringrequired

Lifecycle status of the payment.

Enum"pending""completed""cancelled""refunded""failed"
updatedAtstring(date-time)required

Timestamp when the payment record was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "allocatedAmount": "100.00", "amount": "100.00", "availableAmount": "100.00", "cashAmount": "100.00", "cashChange": "100.00", "clientId": "123e4567-e89b-12d3-a456-426614174000", "comments": "string", "createdAt": "2025-01-01T00:00:00.000Z", "currency": "string", "extensions": {}, "isActive": true, "linkedInvoices": [ { … } ], "ownershipId": "123e4567-e89b-12d3-a456-426614174000", "paymentDate": "2025-01-01T00:00:00Z", "paymentDetails": "string", "paymentId": "123e4567-e89b-12d3-a456-426614174000", "paymentMethod": "cash", "roundingFactor": "100.00", "status": "pending", "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Permanently deletes a Payment record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

paymentIdstringrequired

Payment unique identifier (UUID)

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

Responses

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