Fonctionnement
Le connecteur permet d'extraire au format JSON toutes les factures qui ont été exportées en comptabilité dans un intervalle de temps défini par l'utilisateur.
C'est un connecteur de sortie particulier qui ne met pas à jour le statut de la facture, il peut donc être activé en même temps qu'un autre connecteur de sortie (par exemple extraction comptable) sur la même entité légale.
Déclenchement de l'extraction
Le connecteur est conçu pour alimenter régulièrement une base d'analyse tierce (BI) a partir des données extraites par Conciliator.
Son déclenchement n'est pas automatique, il se fait par le biais d'un appel API sur l'URL: https://app.expert.conciliator.ai/api/v0/connectors/on-demand/bi
Paramètres de la commande
start: Timestamp debut en UTC.Formats possibles : ['yyyy-MM-dd' ; 'yyyy-MM-dd_HH:mm:ss' ][obligatoire] : si pas renseigné → erreur
end: Timestamp fin (exclu) en UTC correspondant au timestamp d’export du connecteur principalFormats possibles : ['yyyy-MM-dd' ; 'yyyy-MM-dd_HH:mm:ss' ][optionnel] : 'now' pour l'extraction prend toutes les données de "start" à maintenant.
Résultat de la commande
JSON, format standard incluant Invoice, Invoice Line, Supplier, Entity, Classification
Une fois l'extraction terminé un fichier zip nommé " BI_export_{date-du-jour}.zip " sera ajouté dans le répertoire à partir duquel la commande a été lancée.
Exemple de commande terminée qui a créé le fichier "BI_export_2019-04-16.zip".
Le fichier ZIP contient 1 fichier JSON par facture.
Exemple de fichier JSON
Nom du fichier: ce6be376-f2c6-40c8-89f1-3bef339b7b84.json
Contenu du fichier:
{
"id": "ce6be376-f2c6-40c8-89f1-3bef339b7b84",
"documentId": "ce6be376-f2c6-40c8-89f1-3bef339b7b84",
"exportedStatus": "EXPORTED",
"exportedTimestamp": "2019-11-06_12:27:24",
"entity": {
"id": "262929ec-a9a6-424a-a90e-f1dc3e7740fc",
"identifier": "DH",
"name": "Dhatim",
"address": null,
"fiscStart1": "2019-01-01",
"fiscEnd1": "2019-12-31",
"fiscStart2": null,
"fiscEnd2": null,
"siret": "50841287100032",
"vat_free": false
},
"supplier": {
"id": "b3b45c34-3431-488d-ac37-32a6939e8ab3",
"identifier": "f42ad188-33c9-4ed9-81e4-c606f172c696",
"name": "ORANGE",
"vatNumber": "FR89380129866",
"address": "78 RUE OLIVIER DE SERRES 75015 PARIS FRANCE",
"city": "PARIS",
"siret": "38012986646850",
"siren": "380129866",
"countryCode": null,
"bankCoodinates": null,
"metadata": {
"compte_fournisseur": "0ORANGE"
}
},
"recipient": {
"id": "8407f534-1676-4e85-a34f-5eb24d8770a2",
"identifier": "47804c15-9c47-47a2-9fe7-a44b36bf22a5",
"name": "DHATIM",
"vatNumber": "FR52508412871",
"address": "104 BOULEVARD DU MONTPARNASSE 75014 PARIS FRANCE",
"city": "75014 PARIS",
"siret": "50841287100032",
"siren": "508412871",
"countryCode": null,
"bankCoodinates": null,
"metadata": {}
},
"file": "DH - Dhatim/scan_37894265_original.pdf",
"reference": "1793365696",
"type": "invoice",
"subType": "PURCHASE",
"date": "2019-10-08",
"subject": null,
"orderNumber": null,
"totalExclTax": 20.83,
"totalInclTax": 24.99,
"totalTax": 4.16,
"totalPayable": null,
"totalDiscount": null,
"name": "DH - Dhatim/scan_37894265_original.pdf",
"sourceFile": "pdf",
"advance": null,
"contact": null,
"metadata": {},
"lines": [
{
"id": "9874f75e-e250-4984-b665-f6788505b716",
"supplier": {
"id": "8407f534-1676-4e85-a34f-5eb24d8770a2",
"identifier": "47804c15-9c47-47a2-9fe7-a44b36bf22a5",
"name": "DHATIM",
"vatNumber": "FR52508412871",
"address": "104 BOULEVARD DU MONTPARNASSE 75014 PARIS FRANCE",
"city": "75014 PARIS",
"siret": "50841287100032",
"siren": "508412871",
"countryCode": null,
"bankCoodinates": null,
"metadata": {}
},
"periodStart": null,
"periodEnd": null,
"priceCode": null,
"pageNumber": 2,
"linePosition": 1,
"header": null,
"description": "abonnements, forfaits et options TVA 20%",
"quantity": null,
"quantity2": null,
"quantity3": null,
"unitPrice": null,
"taxCode": null,
"taxRate": 20,
"amountExclTax": 20.825,
"amountInclTax": 24.99,
"amountTax": 4.165,
"discount": null,
"advanceLine": null,
"metadata": {},
"classification": [
{
"category": {
"id": "254900f5-b511-4bd3-8190-cf93d17dc0b0",
"parent": null,
"name": "44566000 - TVA d\\u00e9ductible/Services",
"hierarchy": "compte_tva_pro",
"metadata": {
"supplier_country": "FR",
"product_type": "SERVICE",
"code_tva_coll": null,
"code_tva": null,
"sub_type": "PURCHASE",
"tva_coll": null,
"tax_rate": null
}
},
"label": "compte_tva_pro",
"ratio": 1.0,
"training": false,
"created": "2019-10-11T14:25:29.984029Z",
"updated": "2019-11-06T11:26:24.630816Z",
"userName": null,
"metadata": {}
},
{
"category": {
"id": "66088853-64c7-481d-b254-4dbf05600b98",
"parent": null,
"name": "62600000 - Frais postaux et t\\u00e9l\\u00e9com.",
"hierarchy": "plan_compta_pro",
"metadata": {
"recoverable_vat": null,
"product_type": "SERVICE",
"rate": null,
"analytic": null,
"sub_type": "PURCHASE"
}
},
"label": "plan_compta_pro",
"ratio": 0.26562793691251596,
"training": false,
"created": "2019-10-11T14:25:28.725654Z",
"updated": "2019-10-11T14:25:28.725654Z",
"userName": null,
"metadata": {}
},
{
"category": {
"id": "66088853-64c7-481d-b254-4dbf05600b98",
"parent": null,
"name": "62600000 - Frais postaux et t\\u00e9l\\u00e9com.",
"hierarchy": "plan_compta_pro",
"metadata": {
"recoverable_vat": null,
"product_type": "SERVICE",
"rate": null,
"analytic": null,
"sub_type": "PURCHASE"
}
},
"label": "plan_compta_pro",
"ratio": 1.0,
"training": true,
"created": "2019-11-06T11:26:23.342099Z",
"updated": "2019-11-06T11:26:23.342099Z",
"userName": "pdechastellier@dhatim.com",
"metadata": {}
}
]
}
],
"dueDate": null,
"paymentTerms": null,
"currency": "EUR",
"bankCoordinates": null,
"numContract": null,
"importedTimestamp": "2019-10-10_22:40:47",
"vatIntracom": "FR89380129866"
}