GuideLab Docs
Orders

Issue a delivery note (DDT) for an order

Freezes the parties, destination, items and transport details into a DDT. Issued in Fatture in Cloud when the lab's grant carries the delivery-note scope (the provider assigns the number asynchronously), otherwise numbered and issued by the platform immediately.

POST
/orders/{id}/delivery-notes

Freezes the parties, destination, items and transport details into a DDT. Issued in Fatture in Cloud when the lab's grant carries the delivery-note scope (the provider assigns the number asynchronously), otherwise numbered and issued by the platform immediately.

Authorization

__Secure-guidelab-prod.session_token<token>

Production session cookie set for the guidelab.co domain by Better Auth

In: cookie

Path Parameters

id*string

Order ID

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/orders/string/delivery-notes" \  -H "Content-Type: application/json" \  -d '{    "transport": {      "causale": "string",      "mezzo": "mittente",      "colli": 1,      "porto": "franco"    },    "issueDate": "string"  }'
{  "id": "string",  "orderId": "string",  "provider": "platform",  "status": "pending",  "number": "string",  "issueDate": "string",  "providerPdfUrl": "string",  "snapshot": {    "version": 1,    "capturedAt": "string",    "orderNumber": "string",    "issuer": {      "organizationId": "string",      "name": "string",      "companyNumber": "string",      "taxRegistrationNumber": "string",      "address": "string",      "addressLine2": "string",      "city": "string",      "state": "string",      "postcode": "string",      "country": "string",      "phone": "string",      "email": "string",      "eInvoiceCode": "string",      "certifiedEmail": "string"    },    "customer": {      "organizationId": "string",      "name": "string",      "companyNumber": "string",      "taxRegistrationNumber": "string",      "address": "string",      "addressLine2": "string",      "city": "string",      "state": "string",      "postcode": "string",      "country": "string",      "phone": "string",      "email": "string",      "eInvoiceCode": "string",      "certifiedEmail": "string"    },    "destination": {      "name": "string",      "address": "string",      "addressLine2": "string",      "city": "string",      "state": "string",      "postcode": "string",      "country": "string"    },    "items": [      {        "orderItemId": "string",        "description": "string",        "quantity": 0,        "unitPrice": "string",        "taxRate": "string"      }    ],    "transport": {      "causale": "string",      "mezzo": "mittente",      "vettore": "string",      "colli": 0,      "pesoKg": "string",      "aspettoBeni": "string",      "porto": "franco",      "startAt": "string",      "notes": "string"    },    "taxMode": "none"  },  "createdAt": "string"}
Empty
Empty
Empty
Empty
Empty
Empty

Create draft order POST

Creates a new draft order with optional line items and wizard state for multi-step order creation. The draft is owned by the authenticated user and can be resumed later.

Put order on hold POST

Places an order on hold with a specified hold reason from the lab's configured reasons. Optionally creates file reupload requirements if the hold reason requires it. Only labs can put orders on hold. Sends a notification to the clinic.