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"
}
Avez-vous trouvé votre réponse?