> For the complete documentation index, see [llms.txt](https://docs.fulfillmenttools.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fulfillmenttools.com/documentation/apis/api-reference/signatures.md).

# Signatures

Endpoints to create a PDF pickup receipt from a captured signature.

## Create a signature pickup-receipt PDF

> This part of the API is in Alpha status. For details, see the \<a href="<https://docs.fulfillmenttools.com/documentation/apis/api-versioning-and-lifecycle#lifecycle-overview>" target="\_blank">API release lifecycle documentation\</a>.\<br />\<br />Generates a PDF pickup receipt containing order, retailer, customer and item details, with a blank rectangle reserved for the signature.

```json
{"openapi":"3.0.1","info":{"title":"fulfillmenttools","version":"VERSIONLESS"},"tags":[{"description":"Endpoints to create a PDF pickup receipt from a captured signature.","name":"Signatures"}],"servers":[{"url":"https://{tenant}.api.fulfillmenttools.com","variables":{"tenant":{"default":"your-tenant-name"}}}],"security":[{"BearerToken":[]}],"components":{"securitySchemes":{"BearerToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SignatureForCreation":{"properties":{"companyAddress":{"allOf":[{"$ref":"#/components/schemas/SignatureCompanyAddress"}],"description":"Address of the retailer issuing the receipt."},"deliveryAddress":{"allOf":[{"$ref":"#/components/schemas/SignatureDeliveryAddress"}],"description":"Address of the customer the receipt is printed for."},"facilityName":{"description":"Name of the specific facility the customer picked up the order from.","type":"string"},"facilityTimeZoneId":{"description":"IANA time zone id for setting the signed time. If not present defaulted to Europe/Berlin.","pattern":"^[A-Za-z_]+(?:/[A-Za-z0-9_+-]+){0,2}$","type":"string"},"items":{"items":{"$ref":"#/components/schemas/SignatureItem"},"maxItems":100,"type":"array"},"orderInformation":{"$ref":"#/components/schemas/SignatureOrderInformation"},"pickupDateTime":{"description":"Date and time the customer picked up the order, fixing the moment the risk passes (§ 446 BGB).","format":"date-time","type":"string"},"signatureImage":{"allOf":[{"$ref":"#/components/schemas/SignatureImage"}],"description":"The signature image to draw into the signature rectangle. Optional, but if provided both base64 and type must be set."},"signeeName":{"description":"Name of the person who signed for and picked up the order.","type":"string"}},"required":["companyAddress","facilityName","orderInformation","deliveryAddress","items","pickupDateTime","signeeName"],"title":"SignatureForCreation","type":"object","description":"SignatureForCreation"},"SignatureCompanyAddress":{"properties":{"city":{"type":"string"},"country":{"type":"string"},"houseNumber":{"type":"string"},"name":{"description":"Name of the retailer/company.","type":"string"},"postalCode":{"type":"string"},"street":{"type":"string"}},"required":["name","street","houseNumber","postalCode","city","country"],"title":"SignatureCompanyAddress","type":"object","description":"SignatureCompanyAddress"},"SignatureDeliveryAddress":{"properties":{"city":{"type":"string"},"companyName":{"type":"string"},"firstName":{"type":"string"},"houseNumber":{"type":"string"},"lastName":{"type":"string"},"personalTitle":{"type":"string"},"postalCode":{"type":"string"},"street":{"type":"string"}},"required":["street","houseNumber","postalCode","city"],"title":"SignatureDeliveryAddress","type":"object","description":"SignatureDeliveryAddress"},"SignatureItem":{"properties":{"id":{"type":"string"},"quantity":{"type":"string"},"substitutes":{"description":"Title of the item which is substituted through this item.","type":"string"},"title":{"type":"string"}},"required":["id","title","quantity"],"title":"SignatureItem","type":"object","description":"SignatureItem"},"SignatureOrderInformation":{"properties":{"orderDate":{"description":"The date the order was created.","format":"date-time","type":"string"},"orderNumber":{"description":"An identifier for the order (tenantOrderId or a shorter order number).","type":"string"}},"required":["orderNumber"],"title":"SignatureOrderInformation","type":"object","description":"SignatureOrderInformation"},"SignatureImage":{"properties":{"fileContent":{"description":"Base64-encoded signature (PNG, JPG/JPEG image, or single-page PDF) to draw into the signature rectangle.","type":"string"},"type":{"description":"File type of base64.","enum":["PNG","JPG","JPEG","PDF"],"type":"string"}},"required":["fileContent","type"],"title":"SignatureImage","type":"object","description":"SignatureImage"},"ApiError":{"items":{"$ref":"#/components/schemas/ErrorInner"},"type":"array","xml":{"name":"ApiError"},"title":"ApiError","description":"ApiError"},"ErrorInner":{"properties":{"description":{"type":"string"},"requestVersion":{"description":"The version provided within an invalid request.","format":"int64","type":"integer"},"summary":{"type":"string"},"version":{"format":"int64","type":"integer"}},"required":["summary"],"type":"object","title":"ErrorInner","description":"ErrorInner"}}},"paths":{"/api/signatures":{"post":{"deprecated":false,"description":"This part of the API is in Alpha status. For details, see the <a href=\"https://docs.fulfillmenttools.com/documentation/apis/api-versioning-and-lifecycle#lifecycle-overview\" target=\"_blank\">API release lifecycle documentation</a>.<br /><br />Generates a PDF pickup receipt containing order, retailer, customer and item details, with a blank rectangle reserved for the signature.","operationId":"createSignaturePdf","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignatureForCreation"}}},"required":true},"responses":{"201":{"content":{"application/pdf":{"schema":{"format":"binary","type":"string"}}},"description":"Successfully created the signature PDF."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid input. See response for details."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Your user is not allowed to operate against this API instance"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Your user, although recognized, is not authorized to use this endpoint"}},"summary":"Create a signature pickup-receipt PDF","tags":["Signatures"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fulfillmenttools.com/documentation/apis/api-reference/signatures.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.