PDF Splitter endpoint [new]
In - pdf with multiple invoices\receipts
Out - a list of separate documents
New endpoint:
POST https://:.veryfi.com/api/v8/partner/documents-set-async
Response body
{
"id": " "
}
What is expected:
Veryfi will split the original PDF and process them separately.
When processed, a notification will be sent to client’s webhook similar to async processing.
Notes:
If in your use case you don't use async and don't need a webhook notification you can still use https://devapi.veryfi.com/api/v8/partner/documents-set-async without adding "async": ture / false and having a webhook setup.
Sample of a webhook notification:
{
"event": "document.created",
"data": {"id": [1031, 1032, 1033],
"created": "2022-06-01 20:00:00"
}
"id" will contain a list of separate child documents created from the original parent, which can be queried with GET documents:
GET https://devapi.veryfi.com/api/v8/partner/documents/1031
GET https://devapi.veryfi.com/api/v8/partner/documents/1032
Known limitations:
Splitting is based on:
-Page numbers (present on all pages)
-Invoice number (if the invoice number is different -> new document)
-File size 20 Mb max
-Page number 100 max
-Endpoint uses the v8 model, if you use v7 you can still process using v8 and by running a GET request call v7
GET https://devapi.veryfi.com/api/v7/partner/documents/1032
- JSON fields for document "is_child" of "parent_of" not yet displayed, so a webhook notification is the only source to see the child documents.
Additional Resources:
-Webhooks/async: https://faq.veryfi.com/en/articles/5588143-webhooks-and-asynchronous-processing
-v7 vs v8: https://faq.veryfi.com/en/articles/6120104-api-version-7-vs-8
This is a very beginning of splitting functionality, we appreciate your feedback submitted to support@veryfi.com with the "id" and stating what worked and what didn't. Your feedback helps us improve.