# Module Vérificateur
## Upload d'un ou plusieurs fichiers
`POST` `/verifier/upload`
#### Headers
| Name | Type | Description |
| ----------------------------------------------- | --------------- | ----------- |
| Authorization\* | Bearer \ | |
#### Request Body (form-data)
| Name | Type | Description |
| -------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| workflowId\* | string | Identifiant technique du workflow (e.g : default\_workflow) |
| siret | string | SIRET d'un tiers. Si non présent dans la base Open-Capture, tentative de le créer depuis la base INSEE |
| vat\_number | string | Numéro de TVA d'un tiers. Si non présent dans la base Open-Capture, tentative de le créer depuis la base européenne |
| siren | string | SIREN d'un tiers. Si non présent dans la base Open-Capture, tentative de le créer depuis la base INSEE |
| returnUniqueUrl | Boolean | Si `true`, retourne un URL unique d'accès au viewer du Vérificateur pour traitement du document sans authentification. Un token est également retourné pour vérifier l'état du processus. |
| files\* | FileStorage | |
{% tabs %}
{% tab title="200: OK " %}
```json
[
{
"filename": "YOUR_FILE_1.pdf",
"token": "XXXXXX_XXXXXXXX_XXXXXXX",
"uniqueUrl":"http://localhost/opencapture/edissyum/dist/#/verifier/viewer_token/XXXXX.XXXXX.XXXXXXX"
},
{
"filename": "YOUR_FILE_2.pdf",
"token": "XXXXXX_XXXXXXXX_XXXXXXX"
}
]
```
{% endtab %}
{% tab title="400: Bad Request Paramètre obligatoire manquant ou erreur inconnue lors du traitement" %}
{% endtab %}
{% tab title="403: Forbidden returnUniqueUrl est à true mais le paramétrage de l'URL unique est erroné" %}
{% endtab %}
{% endtabs %}
## Récupération des documents
`GET` `verifier/documents/list`
#### Path Parameters
| Name | Type | Description |
| ---------------- | ------ | --------------------------------------------------------------------------------------- |
| time | String | Récupérer les documents du jour, d'hier ou plus vieux (`today`, `yesterday` ou `older`) |
| search | String | Fitrer les documents sur le numéro de facture ou le nom du tier |
| form\_id | String | Filtrer les documents par formulaire |
| status | String | Filtrer les documents par status |
| allowedCustomers | String | Filtrer les documents par compte client associé |
| allowedSuppliers | String | Filtrer les documents par compte tiers associé |
#### Headers
| Name | Type | Description |
| ----------------------------------------------- | --------------- | ----------- |
| Authorization\* | Bearer \ | |
{% tabs %}
{% tab title="200: OK " %}
```json
{
"documents": [
{
"customer_id": 1,
"datas": {
"address1": "19 RUE VACON",
"address2": null,
"city": "Marseille",
"country": "France",
"document_date": "15/12/2016",
"document_due_date": "14/01/2017",
"duns": null,
"form_id": 3,
"invoice_number": "INV-001510",
"lines_count": 0,
"name": "Calinda Software",
"no_rate_amount": 2042.5,
"postal_code": 13001,
"quotation_number": "AM161941219-1607",
"siren": "493811251",
"siret": "49381125100047",
"taxes_count": 1,
"total_ht": 2042.5,
"total_ttc": 2451.0,
"total_vat": "408.50",
"vat_amount": "408.50",
"vat_number": "FR71510268261",
"vat_rate": 20.0
},
"date": "09-05-2023 à 15:29:47",
"default_form": false,
"document_id": 791,
"enabled": true,
"facturx": false,
"facturx_level": null,
"filename": "09052023_152946_b0fa2928eb7a448cb05f187e60c1de05.pdf",
"form_id": 3,
"form_label": "Formulaire par défaut",
"full_jpg_filename": "e31e0ee3-172b-4559-b42c-d64584187846-001.jpg",
"id": 3,
"img_width": 2481,
"label": "Formulaire par défaut",
"labels": {},
"locked": false,
"locked_by": "admin",
"module": "verifier",
"nb_pages": 2,
"original_filename": "CALINDA_INV-001510_bbeq.pdf",
"outputs": [
"1",
"3"
],
"pages": {
"document_date": 1,
"document_due_date": 1,
"invoice_number": 1,
"no_rate_amount": 1,
"quotation_number": 1,
"total_ht": 1,
"total_ttc": 1,
"vat_rate": 1
},
"path": "/var/docservers/opencapture/edissyum/verifier/original_pdf//2023/05",
"positions": {
"document_date": {
"height": 32,
"width": 737,
"x": 197,
"y": 605
},
"document_due_date": {
"height": 40,
"width": 2087,
"x": 197,
"y": 825
},
"invoice_number": {
"height": 40,
"width": 2095,
"x": 194,
"y": 243
},
"no_rate_amount": {
"height": 48,
"width": 594,
"x": 1664,
"y": 2831
},
"quotation_number": {
"height": 47,
"width": 2089,
"x": 197,
"y": 920
},
"siren": "",
"total_ht": {
"height": 48,
"width": 594,
"x": 1664,
"y": 2831
},
"total_ttc": {
"height": 34,
"width": 515,
"x": 1743,
"y": 3060
},
"vat_rate": {
"height": 33,
"width": 593,
"x": 1665,
"y": 2949
}
},
"purchase_or_sale": "purchase",
"register_date": "Tue, 09 May 2023 15:29:47 GMT",
"settings": {
"allow_automatic_validation": false,
"automatic_validation_data": "only_ocr",
"delete_documents_after_outputs": true,
"supplier_verif": false,
"unique_url": {
"allow_supplier_autocomplete": true,
"change_form": true,
"create_supplier": true,
"enable_supplier": true,
"expiration": 7,
"refuse_document": true,
"validate_document": true
}
},
"status": "OK",
"supplier_id": 1,
"supplier_name": "Calinda Software",
"thumb": "B64 THUMB"
}
]
}
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://edissyum.gitbook.io/open-capture/technique/web-services/module-verificateur.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.