Skip to main content

Transfer Lab Visit Invoice (v1)

Method & Path​

POST /api/v1/{workspaceId}/labs/visits/{labVisitId}/invoice/transfer

Description​

Create a client invoice from a lab visit invoice and link it to the visit. The visit status becomes invoiced.

note

Backend route: /:workspaceId/labs/visits/:labVisitId/invoice/transfer

Authentication​

Required: Workspace Owner or Staff with labs.run.

Headers​

  • Authorization: Bearer <token>
  • Content-Type: application/json

Path Parameters​

NameTypeRequiredDescription
workspaceIdstringنعمWorkspace ID
labVisitIdstringنعمLab visit ID

Response 200 OK​

{
  "labVisit": {
    "id": "64f1a0a6a2d4f3c8b6f9a123",
    "labVisitStatus": "invoiced",
    "linkedClientInvoiceId": "64f1a0a6a2d4f3c8b6f9a888"
  },
  "clientInvoiceId": "64f1a0a6a2d4f3c8b6f9a888"
}

Common Errors​

  • 400 Bad Request: Invalid identifiers or parameters.
  • 401 Unauthorized: Missing/invalid auth token.
  • 403 Forbidden: Staff lacks labs.run.
  • 404 Not Found: Visit not found.
  • 422 Unprocessable Entity: Visit is cancelled or cannot be transferred.
  • 500 Internal Server Error: Unexpected error.